> ## Documentation Index
> Fetch the complete documentation index at: https://af7f4b7-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://af7f4b7-productmetrics.manicule.dev/docs/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://af7f4b7-productmetrics.manicule.dev/docs/api/mcp.
> Every agent surface: https://af7f4b7-productmetrics.manicule.dev/docs/.well-known/llms-manifest.json

# Shopify ChatGPT Ads server-side tracking (OpenAI Conversions API) (/docs/tracking/server-side/shopify-openai)

<!-- agent-signals: reading_time_min: 8 · est_tokens: 2959 · updated: 2026-11-17 -->
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 Shopify order to your ChatGPT Ads pixel from the server, through the OpenAI Conversions API.

Every paid Shopify 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).



* **Store:** [Shopify](/docs/platforms/shopify). The Product Metrics app installed, with its app embed on.
* **Channel:** [ChatGPT Ads](/docs/channels/openai). Your Pixel ID and a Conversions API key from Ads Manager.
* **Result:** Every paid order sent to your pixel through the OpenAI Conversions API.

## Prerequisites

* **[Editor or admin](/docs/using/team#1-choose-a-role)** on the property in Product Metrics.
* **Your Shopify store connected**: a Shopify login that can install apps and edit the theme, the Product Metrics app installed with its app embed on, the store linked to your property, and your subscription started in the app with **Create subscription** (billed through Shopify). See [Shopify](/docs/platforms/shopify).
* **Access to ChatGPT Ads Manager → Conversions**, to copy your Pixel ID and create a Conversions API key.

## In the app

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

**Store:** install the Product Metrics app from the Shopify App Store, select **Link Shopify store** and turn on its app embed and link it to your property. See [Shopify](/docs/platforms/shopify).



1. **Open Ecommerce platforms.** Go to **Integrations → Ecommerce platforms** and select **Connect** on **Shopify**.

2. **Start the setup.** The Shopify page lists three steps: connect your store, verify the app and link a property. Select **Connect Shopify**.

   ![The Shopify page under Integrations → Ecommerce platforms: 0 of 3 steps done, step 1 Connect your store with the Connect Shopify button, then Verify the app and Link a property, and a Setup guide button.](/docs/_assets/9af617bb0e806b577a6dfdad7049aefdf2941ee94a1ada092429474c785e4119)

3. **Install the app from Shopify.** Select **Open Shopify App Store** and install Product Metrics. In Shopify, select **Install** and approve the permissions it lists (orders, products, customers, themes, and a checkout pixel).

   ![The Connect Shopify dialog: install Product Metrics from Shopify, then link the store to your existing Product Metrics account. Shopify owns installation and store authorisation; after installing the app, you sign in to Product Metrics to select the company and tracking-ready property. Cancel and Open Shopify App Store buttons.](/docs/_assets/7f5fa9b1f168b5384f4820bc14c59c9b1324045000c5619120b8ec59e47117c6)

4. **Sign in to link the store.** In the Product Metrics app in Shopify, select **Connect Product Metrics account** and sign in, or create an account if you are new.

   ![The Product Metrics sign-in page, opened from Shopify to link the store.](/docs/_assets/5971d5f5a51faa299ca7473c014610d32282696d8456b4ef2537a07e117deb6e)

5. **Choose workspace and accounts.** Pick the workspace and the Google Ads accounts this store belongs to, or create a new workspace, then select **Link Shopify store**. The app then asks you to save its **app embed**: select **Open theme editor**, turn on **Product Metrics** under **App embeds** and select **Save**.

   ![The link step: the workspace and the Google Ads accounts this Shopify store belongs to, an option to create a new workspace, and the Link Shopify store button.](/docs/_assets/9359696727d58018f7a62e5b990e7364536f44271d69fe16b9400a879fce8191)

   *Example data.*

6. **Follow the setup guide.** Select **Setup guide** on the Shopify page for every step, with screenshots.

   ![The Shopify setup guide panel in Product Metrics, with every setup step and its screenshots.](/docs/_assets/8bbe57b29752b33c6b770377fda8e184a713183e03a8dfc71109c4d2b01d87cb)

**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).



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

2. **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.](/docs/_assets/9beddba3e6c5fc92a86b169438cda4bfa6fbf521d985d1ae6f98d7071ce844b0)

3. **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:** the Shopify app says **You're set up**, with ticks for **Shopify permissions**, **App embed** and **Checkout pixel**; the app says **OpenAI accepted the test event**.

### 2. Set your consent banner

On Shopify, Product Metrics reads consent from **Shopify Customer Privacy** (choose it under **Tracking → Configure consent**). 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).



1. **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.](/docs/_assets/09a584afb1797a0439b68310c4d6085412eafebba1524c019f42a90f3ed4ea37)

2. **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.](/docs/_assets/b385237058280a34dca53f7f1e42704faa9a8aee59024bd5baafc2211e201e7e)

3. **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.](/docs/_assets/f0a8d61eaa086657ce840c85899df48d5f3a7a52fb6c552710f93b1482b90e72)

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

### 3. Check it works

In the Shopify app, open **Tracking** in the app menu and select **Run tracking test**: each check shows **Passing**, **Needs attention** or **Listening**. Then **place and pay for a test order** with marketing cookies accepted; it is sent once Shopify marks it paid.

**You should see:** **Tracking is live on your store**, which means Product Metrics has seen your storefront. More checks: [Check tracking works](/docs/using/check-tracking).

## 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 Shopify 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 Shopify 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."

## Events sent

| On Shopify            | 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

| Problem                               | Fix                                                                                                                                                                                             |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **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 script tag for ChatGPT Ads on Shopify?

No. The app embed loads the script through Shopify's app proxy under `/apps/` on your store domain, and the app's checkout pixel reports the purchase.

### Can I keep the OpenAI Pixel on my Shopify store?

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 Shopify in ChatGPT Ads](/docs/bidding/poas/shopify-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



* [Shopify](/docs/platforms/shopify): the full store setup
* [ChatGPT Ads (OpenAI)](/docs/channels/openai): every event, consent, limits and troubleshooting
* [OpenAI Conversions API on Shopify](/docs/tracking/enhanced-conversions/shopify-openai): the customer data sent with each event
* [POAS bidding on Shopify in ChatGPT Ads](/docs/bidding/poas/shopify-openai): send profit too
* [Server-side conversion tracking](/docs/features/ad-blocker-proof-tracking): Every platform and channel

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 Shopify](https://www.productmetrics.io/platforms/shopify)

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