Skip to content
ChatGPT Ads

Magento customer data for ChatGPT Ads (OpenAI Conversions API)

Send hashed customer data from Magento orders with each ChatGPT Ads event through the OpenAI Conversions API, so ChatGPT Ads can match conversions to people.

With the OpenAI Conversions API, every event Product Metrics sends to your ChatGPT Ads pixel carries the shopper’s customer data from the Magento order, plus the logged-in customer’s details and the guest email the module passes, hashed with SHA-256, and browser references, so ChatGPT Ads can match the conversion to the person who saw or clicked the ad. There is no separate switch: once ChatGPT Ads is connected, each event the visitor consented to includes it.

Set it up with AI

Connect your assistant

First time? Add the Product Metrics MCP server to your assistant, then paste the prompt below.

In Claude, choose Add custom connector; in ChatGPT, Settings → Apps & Connectors. Paste this URL:

https://www.productmetrics.io/mcp

Claude Code: run this in your terminal.

claude mcp add --transport http product-metrics https://www.productmetrics.io/mcp

CodexAll clients and details →

Setting it up with AI takes one prompt and 60 seconds: paste it into your assistant.

Check that Product Metrics sends customer data with my ChatGPT Ads events from my Magento store. Check my setup status first, walk me through each open step, and give me the link when I need to click something.
Check that Product Metrics sends customer data with my ChatGPT Ads events from my Magento store. Check my setup status first, walk me through each open step, and give me the link when I need to click something.
Check that Product Metrics sends customer data with my ChatGPT Ads events from my Magento store. 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.
Check that Product Metrics sends customer data with my ChatGPT Ads events from my Magento store. 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.

Prerequisites

  • Editor or admin on the property in Product Metrics, with Pro (Full Signal Tracking).
  • Your Magento store view connected: Magento 2.4, 2.0 or 1.9 / OpenMage, Magento Admin access, the public HTTPS shop address and the store-view ID, and a developer with access to your server who installs the Product Metrics module (Composer or ZIP), adds the store view’s private configuration file and keeps Magento cron running. The connection reads Active before you link your property. See Magento.
  • Access to ChatGPT Ads Manager → Conversions, to copy your Pixel ID and create a Conversions API key.

In the app

1. Connect your store and ChatGPT Ads

Connect your store with Magento (your developer installs the module). For ChatGPT Ads, copy your Pixel ID in Ads Manager → Conversions and create a Conversions API key, then add both under Tracking → OpenAI Conversions API → Connect OpenAI.

Connect your store, step by step:

Open Ecommerce platforms

Go to Integrations → Ecommerce platforms and select Connect on Magento.

Ecommerce platforms under Integrations, listing the supported store platforms with a Connect button on Magento.

Start the setup

The Magento page lists three steps: connect your store, install the module and link a property. Select Connect Magento.

The Magento page under Integrations → Ecommerce platforms, for Magento 1.9 and 2: 0 of 3 steps done, step 1 Connect your store with the Connect Magento button, then Install the module and Link a property.

Describe your store

Choose your Magento version, enter the Store URL and the numeric Store view ID, then select Create module configuration. Download the configuration file and share it with your developer privately: it holds a private key.

The Connect Magento dialog: Magento version set to Magento 2, a closed Advanced custom checkout mapping section, empty Store URL and Store view ID fields, and the Cancel and Create module configuration buttons.

Install the module

Your developer installs the module. Select Setup guide and choose your Magento version and installation method: it walks your developer through installing the module and verifying the connection.

The Magento setup guide panel, set to Magento 2.4, Composer and Technical: Download Word document, Magento version tabs 2.4, 2.0 (legacy) and 1.9 / OpenMage, Installation method Composer or ZIP upload, Guide mode Technical or Descriptive, and the start of Before you begin.

Then add the ChatGPT Ads destination:

Open Tracking

Go to Integrations → Tracking. Under Destinations, select OpenAI Conversions API.

Connect OpenAI

You need a Pixel ID and a Conversions API key from ChatGPT Ads Manager → Conversions. Select Connect OpenAI, enter them, keep Send events to OpenAI on and select Add destination.

The OpenAI Conversions API panel in Tracking, Not configured: what Product Metrics sends to your ChatGPT Ads pixel, the Pixel ID and Conversions API key you need from ChatGPT Ads Manager → Conversions, and the Connect OpenAI button.

Use custom events in OpenAI

In ChatGPT Ads Manager → Conversions, create a conversion with the matching custom event name for each value you want to measure: pm_order_revenue, pm_order_profit, pm_revenue_ltv or pm_profit_ltv.

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

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.

Open Tracking

Go to Integrations → Tracking. The checklist shows six steps: start by connecting your store, or use Cloudflare Tracking if you have no store platform.

Tracking in Product Metrics with the Complete your tracking setup checklist of six steps, starting with Connect your store.

Follow the next step

Once your store is connected and linked, the checklist opens the next open step. Each step says what it does.

The Complete your tracking setup checklist in Tracking: 3 of 6 essential steps completed, with Connect your store, Link the store to this property and Install storefront tracking ticked, and Configure consent open as step 4 with the consent platform still Not configured.

Configure consent

Under Configure consent, pick the cookie consent platform your storefront uses. The storefront script collects nothing until the visitor agrees.

The Configure consent step in the tracking checklist, with the list of consent platforms to choose from.

ChatGPT Ads has no consent mode: an event is only sent with marketing consent (ad user data), and the ChatGPT Ads click and browser references also need ad storage consent. Without ad personalisation consent, the event is sent marked as opted out. See Consent.

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

3. Check an order

Place a test order with all cookies accepted, then open Tracking → OpenAI Conversions API.

You should see: your ChatGPT Ads pixel connected and delivering events, and your paid test order listed.

There is no report of the hashed fields themselves: ChatGPT Ads receives them only inside each event. Delivery errors show in the app under OpenAI reported a problem.

Fields sent

Where each field comes from on Magento:

Customer dataFromSent to ChatGPT Ads as
Email addressThe Magento orderemails_sha256
Phone numberThe Magento orderphone_numbers_sha256: digits with country code, no +
First and last nameThe Magento orderfirst_names_sha256, last_names_sha256: lowercase, no spaces or punctuation
Customer IDYour store’s customer IDexternal_ids_sha256
Postal code, countryThe Magento orderpostal_codes, countries, unhashed as ChatGPT Ads asks
IP address, user agentThe visitor’s browserip_address, user_agent, unhashed
Browser referenceThe __obref cookieobref, unmodified
Ad clickThe __oppref cookieoppref, unmodified

Raw email addresses, phone numbers, names and customer IDs never leave Product Metrics. A postal code with characters ChatGPT Ads doesn’t accept is left out rather than failing the event.

Troubleshooting

ProblemFix
Orders are missing in ChatGPT AdsCheck that Tracking → Configure consent names the banner your store actually shows (step 2).

FAQ

Can I keep the OpenAI Pixel on my site?

Yes. OpenAI deduplicates on Pixel ID, event name and event ID, and keeps the first event it receives.

No. Choose OneTrust, Cookiebot, Usercentrics or Osano under Tracking → Configure consent, or have your developer pass the visitor’s choices. Without marketing consent, no event is sent to ChatGPT Ads.

Can ChatGPT Ads bid on new or returning customers?

Not yet: ChatGPT Ads has no new or returning customer conversions. POAS and LTV bidding work through the OpenAI Conversions API.

Are past orders and refunds sent to ChatGPT Ads?

No. OpenAI accepts events up to 7 days old, so historical orders aren’t imported, and later refunds and cancellations don’t revise events already sent.

Where next

On the website: Full Signal Tracking, first-party cookie, Product Metrics for Magento

Developers: do the same with the CLI or the API.