> ## Documentation Index
> Fetch the complete documentation index at: https://6f524b4-productmetrics.manicule.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://6f524b4-productmetrics.manicule.dev/docs/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://6f524b4-productmetrics.manicule.dev/docs/api/mcp.
> Every agent surface: https://6f524b4-productmetrics.manicule.dev/docs/.well-known/llms-manifest.json

# Magento ChatGPT Ads server-side tracking (OpenAI Conversions API) (/docs/tracking/server-side/magento-openai)

<!-- agent-signals: reading_time_min: 4 · est_tokens: 1683 · updated: 2026-11-16 -->
Related: [Shopify server-side tracking for Google Ads](/docs/tracking/server-side/shopify-google-ads.md), [WooCommerce server-side tracking for Google Ads](/docs/tracking/server-side/woocommerce-google-ads.md), [Magento server-side tracking for Google Ads](/docs/tracking/server-side/magento-google-ads.md), [Lightspeed server-side tracking for Google Ads](/docs/tracking/server-side/lightspeed-google-ads.md), [Shopware server-side tracking for Google Ads](/docs/tracking/server-side/shopware-google-ads.md), [Server-side tracking for Google Ads on any website with Cloudflare](/docs/tracking/server-side/cloudflare-google-ads.md)

> Send every paid Magento order to your ChatGPT Ads pixel from the server, through the OpenAI Conversions API.

Every paid Magento order is confirmed from your store's own order data and sent [from Product Metrics' server](/docs/concepts/server-side-tracking) to your **ChatGPT Ads pixel** as `order_created`. This is [server-side, adblocker-proof conversion tracking](/docs/features/ad-blocker-proof-tracking).

## Prerequisites

* **[Editor or admin](/docs/using/team#1-choose-a-role)** on the property in Product Metrics, with Pro (Full Signal Tracking).
* **A developer** to install the Product Metrics module on your server. Magento is the one platform that needs one.
* **Access to ChatGPT Ads Manager → Conversions**, to copy your Pixel ID and create a Conversions API key.

## Set it up with AI



Paste the prompt into your assistant.



First connect the Product Metrics MCP server ([https://www.productmetrics.io/mcp](https://www.productmetrics.io/mcp); see [Connect your assistant](/docs/mcp/connect)).

**Claude or ChatGPT:** "Set up server-side conversion tracking for my Magento store in ChatGPT Ads with Product Metrics. Check my setup status first, walk me through each open step, and give me the link when I need to click something."

**Claude Code or Codex:** "Set up server-side conversion tracking for my Magento store in ChatGPT Ads with Product Metrics. Use the Product Metrics MCP server, or the productmetrics CLI with --json and the Product Metrics skills if they are installed (run `productmetrics help agents` first), and tell me when a step needs me in a browser."

## In the app

### 1. Connect your Magento store and ChatGPT Ads

* **Store:** create the module configuration under **Ecommerce platforms → Connect Magento**, have your developer install the module, then verify the store view and link it to your property. See [Magento](/docs/platforms/magento).
* **ChatGPT Ads:** in Ads Manager → **Conversions**, copy your **Pixel ID** and create a Conversions API key, then add both under **Tracking → OpenAI Conversions API → Connect OpenAI**. See [ChatGPT Ads](/docs/channels/openai).



![The Add OpenAI destination form with Pixel ID, Conversions API key and the Send events to OpenAI switch, then the saved OpenAI Conversions API destination showing Active, the key Accepted by OpenAI and Sending On.](/docs/_assets/12b7f9404eb89a50f8e9b3cf2d8a9f079571fe77837c0fd77099cf9d8ef774f9)

*Figure: Add OpenAI destination: paste the Pixel ID and Conversions API key, keep Send events to OpenAI on.*

**You should see:** under **Manage Magento**, the connection is **Active** and your property is linked; the app says **OpenAI accepted the test event**.

### 2. Set your consent banner

Magento's cookie restriction notice does not grant consent. Choose OneTrust, Cookiebot, Usercentrics or Osano under **Tracking → Configure consent**, or have your developer pass the visitor's choices to Product Metrics.

ChatGPT Ads has no consent mode: an event is only sent with marketing consent (ad user data). Without ad personalisation consent, the event is sent marked as opted out. See [Consent](/docs/concepts/consent).

**You should see:** **Tracking → Configure consent** names the banner your store shows.

### 3. Check it works

**Place a paid test order** with marketing cookies accepted in the connected store view with your payment provider's test mode, and allow a few minutes for cron.

**You should see:** under **Manage Magento**, the desired and active revision numbers are the same, and the order appears for the linked property. More checks: [Check tracking works](/docs/using/check-tracking).

## Events sent

| On Magento            | Sent to ChatGPT Ads as                                      | Carries                                                  |
| --------------------- | ----------------------------------------------------------- | -------------------------------------------------------- |
| Paid order            | `order_created`                                             | Revenue, products, the transaction ID as `id`            |
| Add to cart           | `items_added`                                               | Products, and the value when your storefront reports one |
| Checkout started      | `checkout_started`                                          | Products, and the value when your storefront reports one |
| Ad click from ChatGPT | `oppref` (from the `__oppref` cookie)                       | Needs ad storage consent                                 |
| Browser               | `obref` (from the `__obref` cookie), IP address, user agent | `obref` needs ad storage consent                         |

ChatGPT Ads accepts events up to 7 days old, so past orders are not imported, and later refunds don't revise sent events.

## Troubleshooting

### Orders are missing in ChatGPT Ads

Check that **Tracking → Configure consent** names the banner your store actually shows: Product Metrics sends an order only with the consent this page lists. See [Consent](/docs/concepts/consent).

## FAQ

### Do I need a developer for ChatGPT Ads on Magento?

Once, to install the Product Metrics module and make sure Magento cron runs. The module then sends order changes every two minutes.

### Can I keep the OpenAI Pixel on Magento?

Yes. OpenAI deduplicates on Pixel ID, event name and event ID, and keeps the first event it receives. `order_created` uses the order transaction ID, so it deduplicates on its own.

### Can I bid on profit in ChatGPT Ads?

Yes. POAS and LTV bidding work on ChatGPT Ads: see [POAS bidding on Magento in ChatGPT Ads](/docs/bidding/poas/magento-openai).

### Does ChatGPT Ads get new and returning customers?

Not yet. ChatGPT Ads gets revenue, profit (POAS) and LTV through the OpenAI Conversions API; new and returning customer bidding runs in Google Ads and Meta.

## Where next

* [Magento](/docs/platforms/magento): the full store setup
* [ChatGPT Ads (OpenAI)](/docs/channels/openai): every event, consent, limits and troubleshooting
* [OpenAI Conversions API on Magento](/docs/tracking/enhanced-conversions/magento-openai): the customer data sent with each event
* [POAS bidding on Magento in ChatGPT Ads](/docs/bidding/poas/magento-openai): send profit too
* [Server-side conversion tracking](/docs/features/ad-blocker-proof-tracking)
* On the website: [Full Signal Tracking](https://www.productmetrics.io/server-side-tracking), [ad blocker conversion tracking check](https://www.productmetrics.io/ad-blocker-conversion-tracking), [first-party cookie](https://www.productmetrics.io/glossary/first-party-cookie), [Product Metrics for Magento](https://www.productmetrics.io/platforms/magento)

Developers: do the same with the [CLI](/docs/cli/commands#destinations) or the [API](/docs/api/destinations/set-openai).
