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

# Lightspeed customer data for ChatGPT Ads (OpenAI Conversions API) (/docs/tracking/enhanced-conversions/lightspeed-openai)

<!-- agent-signals: reading_time_min: 8 · est_tokens: 3121 · updated: 2026-11-17 -->
Related: [Shopify enhanced conversions for Google Ads](/docs/tracking/enhanced-conversions/shopify-google-ads.md), [WooCommerce enhanced conversions for Google Ads](/docs/tracking/enhanced-conversions/woocommerce-google-ads.md), [Magento enhanced conversions for Google Ads](/docs/tracking/enhanced-conversions/magento-google-ads.md), [Lightspeed enhanced conversions for Google Ads](/docs/tracking/enhanced-conversions/lightspeed-google-ads.md), [Shopware enhanced conversions for Google Ads](/docs/tracking/enhanced-conversions/shopware-google-ads.md), [Enhanced conversions for Google Ads on any website with Cloudflare](/docs/tracking/enhanced-conversions/cloudflare-google-ads.md)

> Send hashed customer data from Lightspeed 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 Lightspeed order**, 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.



* **Store:** [Lightspeed](/docs/platforms/lightspeed). An API key from Lightspeed, then a Cloudflare sign-in.
* **Channel:** [ChatGPT Ads](/docs/channels/openai). Your Pixel ID and a Conversions API key from Ads Manager.
* **Result:** Hashed customer data and browser references on every ChatGPT Ads event.

## Set it up with AI



Setting it up with AI takes one prompt and 60 seconds: paste it 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:** "Check that Product Metrics sends customer data with my ChatGPT Ads events from my Lightspeed shop. 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:** "Check that Product Metrics sends customer data with my ChatGPT Ads events from my Lightspeed shop. 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](/docs/using/team#1-choose-a-role)** on the property in Product Metrics, with Pro (Full Signal Tracking).
* **Your Lightspeed eCom (C-Series) shop connected**: a back-office administrator login (an API key can't sign in), the shop's cluster, hostname and numeric Shop ID, and an enabled API key with its secret that has Read on Content, Products, Customers and Orders, and Read and Write on Settings and Tracking. The shop can't already be connected to another workspace, and it reads **Active** with **Configuration is current** before you link your property. See [Lightspeed](/docs/platforms/lightspeed).
* **Your shop domain on Cloudflare**, with its DNS record proxied (the orange cloud), and a workspace admin who signs in to Cloudflare once.
* **Access to ChatGPT Ads Manager → Conversions**, to copy your Pixel ID and create a Conversions API key.

## In the app

### 1. Connect your shop and ChatGPT Ads

Connect your shop with [Lightspeed](/docs/platforms/lightspeed). For [ChatGPT Ads](/docs/channels/openai), 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:



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

   ![Ecommerce platforms under Integrations, listing the supported store platforms with a Connect button on Lightspeed.](/docs/_assets/0c05b9d4decc1de6535ef457c54dfe27804efbe9a7b5ca7c20d0a46bb3f8ff15)

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

   ![The Lightspeed page under Integrations → Ecommerce platforms: 0 of 3 steps done, step 1 Connect your store with the Connect Lightspeed button, then Verify the connection and Link a property.](/docs/_assets/8d91ee07b543eef0b937594ab6d687baf56be4cedec1b58cec69f9a34376b52d)

3. **Enter your shop details.** Choose the **Cluster**, then enter the **Store hostname**, **Shop ID**, **API key** and **API secret**. You create the API key in the Lightspeed back office under **Settings → Store Settings → Developers**.

   ![The Connect Lightspeed dialog: Cluster set to Europe, then empty Store hostname, Shop ID, API key and API secret fields, each with where to find it in the Lightspeed back office, including the API key permissions, and the Cancel and Connect Lightspeed buttons.](/docs/_assets/11453e2e2b52149b29209d41615ebfae944f3ad5954e9e11c06183e9cbd9e1a4)

4. **Connect the store.** Select **Connect Lightspeed**. Product Metrics checks the key, saves the connection, registers its order webhooks and detects your shop language.

   ![The Lightspeed page after Connect Lightspeed, with the store's connection, credential and installation status.](/docs/_assets/6102e9bc56937e92684b3c198bcd8b98d1430bb9cc855791abe843bfb265eb29)

   *Example data.*

5. **Follow the setup guide.** Select **Setup guide** for every step in the Lightspeed back office, including the permissions the API key needs.

   ![The Lightspeed setup guide panel in Product Metrics: every step in the Lightspeed back office, including the permissions the API key needs.](/docs/_assets/bad196dcafbc326d06548c2adc21db9d10b37fd1f653881f22abdf9be16fd627)

Then add the ChatGPT Ads destination:



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:** **Connection status**, **Credential status** and **Installation status** read **Active**, **Configured** and **Active**, publication reads **Configuration is current**, and the gateway says **Gateway setup complete**; the app says **OpenAI accepted the test event**.

### 2. Set your consent banner

On Lightspeed, Product Metrics reads consent from the banner chosen under **Tracking → Configure consent** (OneTrust, Cookiebot, Usercentrics or Osano).



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)

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](/docs/using/consent#chatgpt-ads).

**You should see:** **Tracking → Configure consent** names the banner your shop 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 Lightspeed:

| Customer data          | From                    | Sent to ChatGPT Ads as                                                         |
| ---------------------- | ----------------------- | ------------------------------------------------------------------------------ |
| Email address          | The Lightspeed order    | `emails_sha256`                                                                |
| Phone number           | The Lightspeed order    | `phone_numbers_sha256`: digits with country code, no `+`                       |
| First and last name    | The Lightspeed order    | `first_names_sha256`, `last_names_sha256`: lowercase, no spaces or punctuation |
| Customer ID            | Your shop's customer ID | `external_ids_sha256`                                                          |
| Postal code, country   | The Lightspeed order    | `postal_codes`, `countries`, unhashed as ChatGPT Ads asks                      |
| IP address, user agent | The visitor's browser   | `ip_address`, `user_agent`, unhashed                                           |
| Browser reference      | The `__obref` cookie    | `obref`, unmodified                                                            |
| Ad click               | The `__oppref` cookie   | `oppref`, 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

| Problem                               | Fix                                                                                                                            |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Orders are missing in ChatGPT Ads** | Check that **Tracking → Configure consent** names the banner your store actually shows ([step 2](#2-set-your-consent-banner)). |

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

### Which consent does ChatGPT Ads need on Lightspeed?

ChatGPT Ads has no consent mode: an event is only sent with marketing consent (ad user data), and the click and browser references also need ad storage. Without ad personalisation consent, the event is sent marked as opted out. On Lightspeed, Product Metrics reads it from the banner you choose: OneTrust, Cookiebot, Usercentrics or Osano.

### 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



* [Lightspeed](/docs/platforms/lightspeed): the full shop setup
* [ChatGPT Ads (OpenAI)](/docs/channels/openai): every event, consent, limits and troubleshooting
* [Server-side conversion tracking on Lightspeed for ChatGPT Ads](/docs/tracking/server-side/lightspeed-openai): The same setup in ChatGPT Ads
* [Customer data on every channel](/docs/features/enhanced-conversions): the same customer data as Enhanced Conversions for Google Ads and the Meta Conversions API
* [Consent](/docs/concepts/consent): What each consent choice lets through

On the website: [Full Signal Tracking](https://www.productmetrics.io/server-side-tracking), [first-party cookie](https://www.productmetrics.io/glossary/first-party-cookie), [Product Metrics for Lightspeed](https://www.productmetrics.io/platforms/lightspeed)

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