ChatGPT Ads and Microsoft's Conversions API: sending Matomo conversions server-side

· 6 min read ·

Topics: Campaigns & advertising

Ad platforms spend your budget according to the conversions they get to see. Whatever the pixel in the browser does not report is missing from their bidding: ad blockers, browser restrictions and declined cookies swallow part of the orders and enquiries before they reach the platform. That is why the large ad platforms offer a Conversions API. The conversion then comes straight from your server instead of the browser.

Two platforms have just joined. OpenAI shows ads in ChatGPT and has published its own Conversions API to measure them. Microsoft opened the Conversions API of Microsoft Advertising to all ad accounts on 28 October 2026. This article explains what both offer and how to send conversions from Matomo to them, without another pixel on your website.

The flow in three steps: a visitor clicks an ad and the landing page carries the click ID oppref from ChatGPT Ads or msclkid from Microsoft. Matomo then records a goal or an ecommerce order. The Conversions API plugin sends it server-side, with consent per platform, to OpenAI's Conversions API for ChatGPT Ads, for example as order_created, and to the UET Conversions API of Microsoft Advertising, for example as purchase.
From the ad click through Matomo to the platform, without another pixel.

What a Conversions API does#

With a Conversions API, the conversion is reported by a server rather than the visitor's browser: your shop, your CRM or your web analytics. The report contains what the platform needs for attribution:

  • What happened, for example an order or an enquiry, with value and currency.
  • When and on which page.
  • Who clicked, through the ad's click ID or through hashed customer data such as email address or phone number.

Matomo records your conversions anyway: as a goal or as an ecommerce order. So the data is already on your server. What is missing is the way from Matomo to the ad platform.

ChatGPT Ads: reporting conversions to OpenAI#

OpenAI measures ads in ChatGPT with two building blocks: a pixel for the website and a Conversions API for reports from the server. You set up both in OpenAI Ads Manager under Conversions. For the Conversions API you create a key there; OpenAI must have enabled your ad account for it.

Every conversion has an event type at OpenAI. For websites these include:

Conversion in Matomo Event type at OpenAI
Ecommerce order order_created
Contact form, enquiry lead_created
Registration, account created registration_completed
Appointment booked appointment_scheduled
Subscription started subscription_created
Trial started trial_started

If none fits, you send a custom event under a name of lowercase letters, digits, _ and -.

For attribution OpenAI uses the identifier oppref. The OpenAI pixel stores it in the cookie __oppref. Hashed email addresses and phone numbers can be sent as well, plus IP address and user agent. A conversion may be at most seven days old when it is reported.

OpenAI decides in which countries ChatGPT ads run and which accounts can use the Conversions API. Check this in Ads Manager before you plan the integration.

Microsoft Advertising: the Conversions API for all accounts#

Microsoft measures conversions with the UET tag. The Conversions API complements it: instead of the tag in the browser, your server reports the conversion to the same UET tag. Since 28 October 2026 it is open to all ad accounts.

To use it, open the UET tag in Microsoft Advertising, choose "Use Conversions API" and create a token. You send the conversion under the event name your conversion goal in Microsoft Advertising waits for, for example purchase or lead. Attribution uses the click ID msclkid and hashed customer data.

How the conversions get there from Matomo#

Our plugin Conversions API sends Matomo goals and ecommerce orders server-side to ChatGPT Ads, Microsoft Advertising, Google Ads, Meta, LinkedIn and X. It supports ChatGPT Ads from version 5.1.0 for Matomo 5 and 6.0.0-beta.3 for Matomo 6. It has supported Microsoft Advertising since version 0.4.0 and now also sends the page URL of every conversion.

Setup in five steps:

  1. Add a destination. Under Administration → Websites → Conversions API you choose the platform and enter the credentials: pixel ID and key for ChatGPT Ads, UET tag ID and token for Microsoft Advertising.
  2. Map your goals. You map each Matomo goal and the ecommerce order to the platform's event type or event name, orders with their revenue.
  3. Test the connection. The test checks the credentials with the platform. For ChatGPT Ads it lets OpenAI validate a sample conversion without saving it.
  4. Pass consent. Your consent banner reports the decision via Matomo Tag Manager, Google Consent Mode or the JavaScript API. The keys are openai for ChatGPT Ads and microsoft for Microsoft Advertising.
  5. Schedule sending. A cron job running every minute sends the conversions close to real time. Without it, Matomo's hourly task sends them.

The plugin recognises clicks by itself: msclkid for Microsoft and oppref for ChatGPT Ads, each from the landing page URL. With consent for ChatGPT Ads it also reads the OpenAI pixel's cookie __oppref. It attributes a later conversion to the click, also across several visits and after a login.

If the platform's pixel keeps running alongside, a shared event ID prevents double counting. In the plugin you choose, for example, the order ID under Deduplication with an existing pixel and pass the same number to the pixel.

The send log shows what went to which platform and when, with the platforms' error messages and the option to retry a transfer.

Server-side does not mean without consent. The plugin sends only to the platforms the visitor consented to, decided per platform. A visitor who declines ChatGPT Ads but accepts Google is reported to Google only. If a visitor answers only after the conversion, it waits up to 24 hours for the decision.

By default, Google Consent Mode applies to Google only. Whether it also releases Microsoft, ChatGPT Ads and the other platforms is set per website.

Customer data such as email address and phone number is normalised and hashed in Matomo; plain text is never stored. The plugin deletes IP address, user agent and hashes after sending, at the latest after seven days, click IDs after 90 days.

Limits#

  • Access and countries: OpenAI decides whether your account can use its Conversions API and where ChatGPT ads run.
  • Time window: OpenAI accepts conversions up to seven days after the event. With a cron job every minute that is no issue, after a longer outage it is.
  • No campaign names: a Conversions API reports conversions to the platform. Which campaign works in Matomo is still shown by the campaign parameters in your links. Our UTM builder Feinwerk Campaigns builds these UTM links for every channel by one naming convention and checks every landing page before the campaign starts. For single ad links, the free campaign URL builder is enough. The ready-made suffix for Microsoft Advertising is in the free UTM templates for ad platforms.

Conclusion#

ChatGPT Ads adds a new ad platform, and Microsoft opens its Conversions API to everyone. If Matomo already records your conversions, you need no further pixel for this: the Conversions API sends them server-side, and only with consent, to every platform you use. The documentation describes the setup in detail.

Peter Boehlke

About the author

Peter Boehlke

Founder of feinwerk · Matomo specialist since 2009

Peter Boehlke has been working with Matomo since 2009: as a member of the Matomo team, a contributor to the open-source project and an Implementation Partner in the Matomo partner program. With feinwerk, he runs Matomo instances up to high-traffic scale, develops his own Plugins for Matomo and advises on tag management, tracking concepts and privacy-compliant measurement.

  • Matomo since 2009
  • Matomo Implementation Partner
  • Matomo contributor
  • Own Plugins for Matomo

Related product

Plugins for Matomo

Extensions we develop ourselves, sold through our own platform and maintained across Matomo major versions.

Browse the Plugins for Matomo ↗

Matching plugins

Plugins for Matomo from our own development that fit this topic.

Advertising from €59 per month

Conversions API

Conversions API transfers your Matomo goals and ecommerce orders server-side to Google Ads, Meta, LinkedIn, X, Microsoft Advertising, ChatGPT Ads and TikTok: consent-based, with automatic click attribution and without ad pixels on your website.

View in the shop: Conversions API

Hosting from €99 per month · quote to fit

Tell us about your Matomo.

Briefly describe traffic, infrastructure and requirements. Within one business day you get an honest assessment and a quote.

What is it about?