# The ChatGPT ads pixel: what it does, how to install it and fix it

Source: https://gptads.ae/guides/chatgpt-ads-pixel/
Author: Ahmad Alshareefi, Big AL Consulting, Dubai
Updated: 2026-09-21. Checked against OpenAI documentation: 2026-09-21

> What the OpenAI Pixel captures, how to install it, the shared event ID with the Conversions API, testing it properly and the failures that show up most.

## The short version

The OpenAI Pixel is the JavaScript snippet that sits on your website and reports conversion events back to Ads Manager. It captures the oppref click reference automatically, can detect and hash matching information from your own forms, and works best paired with the Conversions API using the same event ID on both sides. This guide is about the Pixel specifically. For the wider measurement picture, including WhatsApp and phone leads, see our [conversion tracking guide](/guides/conversion-tracking/).

## What the Pixel actually does

Once installed, the Pixel does three things. It fires the conversion events you configure it to send, on the pages where the real action happens. It reads the oppref parameter OpenAI appends to a landing page URL on an ad click, and stores it in a first party cookie so a later conversion on your site can be tied back to that click. And, where automatic advanced matching is enabled, it detects supported customer information already present in recognisable forms on your site, normalises it and hashes it with SHA-256 in the browser before sending it, without raw customer information ever leaving the browser.

## Installing it, step by step

Create a data sourceIn Ads Manager, open the Conversions section and create a data source. This generates your Pixel ID and Conversions API key together.
Place the Pixel snippetInstall it on every page where a measurable action can happen, not only the homepage. This includes product pages, lead forms and confirmation pages.
Confirm it initialises with the correct Pixel IDUse debug mode while testing, so you can see the Pixel load and fire before you trust any live data.
Configure the standard conversion event that matches your goalA purchase, a sign up, a lead submission, or whatever the real business action is.
Attach the finished conversion event to your campaignBefore traffic starts. A correctly built event sitting unattached to a campaign will not be picked up.

## Installing through a tag manager

Deploying the Pixel through Google Tag Manager is supported, as long as the tag manager loads the Pixel snippet on the correct pages and does not block or reorder the initialisation and event calls. If the tag manager prevents the Pixel from loading reliably, whether because of load order, consent gating or a script conflict, install the snippet directly on the page instead, or move the event to server side measurement through the Conversions API.

## Events the Pixel sends, and the shared event ID

OpenAI does not publish a fixed list of standard event names, but its event quality guidance groups conversion activity into three stages, and a healthy setup usually has events firing in more than one.

| Stage | What it covers | Example |
| --- | --- | --- |
| Browsing | Viewing content | Someone opens a pricing or product page from the ad |
| Intermediate action | Adding items, starting checkout, submitting a lead | A quote form is submitted, a chat is opened |
| Completed outcome | Completing an order, starting a trial, booking an appointment | A purchase or a booking is confirmed |

For resilient measurement, send the same conversion through the Pixel and the Conversions API together. When you do, use the same event ID on both. That is what lets OpenAI deduplicate the two copies of the same action into one counted conversion, instead of reporting it twice. Two teams sending the same event with different event IDs is one of the more common causes of inflated conversion counts we see.

## Automatic advanced matching

When a click reference alone is not enough to connect a conversion back to an ad, matching information helps close the gap. Automatic advanced matching (AAM) does this without a separate development project: the Pixel detects supported customer information already entered into recognisable forms on your site, normalises and hashes it with SHA-256 in the browser, and includes it with the conversion event. OpenAI states plainly that raw customer information is not sent to OpenAI through this feature, and no changes to your existing Pixel implementation are required to turn it on. Only send information you are permitted to share, and only after the consent your own privacy notice requires.

## Testing the Pixel properly

Do not trust a Pixel until you have walked its full journey once, end to end.

Click your own ad, or a link carrying an oppref style parameter, in a private browser windowConfirm the landing page loads and the Pixel fires on page view.
Complete the real action the event is meant to captureA lead form, a checkout, a booking. Do not simulate it from a test page that skips the actual flow.
Check the click reference survivedConfirm oppref, or the underlying cookie it set, is still present at the point the conversion event fires. Redirects, language switchers and some consent tools strip it silently.
Confirm the event appears in Ads ManagerAllow 24 to 48 hours, since OpenAI states conversions specifically need that window to appear, even though impressions and clicks can show within minutes.

## Why the Pixel shows 0, or seems to be missing events

Event name or type mismatchA firing, accepted event can still report 0 if it does not match the conversion event configured for the campaign. For custom events the exact name has to match, not just the display name shown in the interface.
Lost click referenceRedirect chains, link shorteners and some consent banners strip oppref before the Pixel ever sees it on the confirmation page.
Browser blockingThe Pixel is a browser side script, so ad blockers, tracking protection and slow page loads can all cause it to miss events the Conversions API would have caught server side.
No backfill after a fixOpenAI is explicit that historical events sent under a broken configuration will not retroactively count once you correct it. You need fresh, eligible traffic to see the fix reflected.

## Pixel versus Conversions API, side by side

| | OpenAI Pixel | Conversions API |
| --- | --- | --- |
| Where it runs | In the browser | On your server |
| Strength | Fast to install, captures oppref automatically | Not affected by browser blockers or ad blocking |
| Weakness | Can lose events to privacy features | Needs development work, and your own handling of oppref |
| Best use | Every site, as a baseline | Sites with a CRM, checkout or booking system worth connecting server side |

Using both, with matching event IDs, is OpenAI's own recommendation for the most complete picture. If your business already uses a partner tool such as Triple Whale or Hightouch, see our [measurement partners guide](/guides/measurement-partners/) for connecting one of those directly instead of building a custom server integration. For what a poor event quality score actually means and how to fix it, see [understanding and improving event quality](/guides/event-quality/).

## How the Pixel feeds your event quality score

Every data source, meaning every Pixel and Conversions API pairing you set up, gets its own daily event quality assessment in Ads Manager. It is a diagnostic, not a performance prediction: OpenAI states the score and its warnings highlight areas of your setup worth reviewing, and do not by themselves predict campaign performance or guarantee that a conversion will match to an ad. Several of the warnings that show up trace straight back to how the Pixel was installed rather than to the Conversions API side.

- **Limited email or customer ID information** usually means the Pixel is not picking up matching information from your forms, either because automatic advanced matching is off or because your form fields are not in a recognisable format.
- **Ad click information missing or cannot be connected** points at oppref being lost somewhere in your redirect chain before the Pixel reads it.
- **Limited Pixel and Conversions API activity** means OpenAI has not observed enough accepted events from either channel to assess them, which is worth checking early rather than waiting weeks into a campaign to notice nothing is arriving.

The score refreshes daily using seven complete calendar days of data, with time allowed for recent events to arrive, so a change you make today will not clear a warning immediately. Confirm new events are arriving correctly first, then give the assessment window time to catch up.

## Common Pixel installation mistakes

Our own observations from installing and auditing ChatGPT ads pixels, not platform facts.

- **Installing the Pixel only on the homepage.** It needs to sit on every page where a measurable action actually happens, including deep pages a homepage visitor never sees.
- **Skipping debug mode before trusting live data.** A silent failure, wrong Pixel ID, script blocked by a consent tool, event never firing, looks identical to zero conversions from a genuinely quiet campaign unless you have watched it fire once yourself.
- **Building the Pixel and the Conversions API with different event ID logic.** If one system generates an event ID from an order number and the other from a timestamp, OpenAI cannot match the two copies and will count the same action twice.
- **Assuming the Pixel alone is enough for a business that converts off site.** A browser pixel can only see what happens in the browser. Anything closed on a call, on WhatsApp, or in person never reaches it without a server side event added afterward.

## UAE and Gulf specifics

Two things trip up UAE sites more than the Pixel mechanics themselves. First, many UAE ecommerce and services sites route traffic through a language switcher between Arabic and English versions of a page, and that redirect is exactly the kind of hop that strips oppref if it is not built to preserve query parameters. Test the actual path an Arabic language user takes, not just the English one. Second, UAE service businesses that close leads on WhatsApp or by phone rather than on the website itself will find the Pixel alone captures very little, since the real outcome happens off site, days later. In that case the Pixel installation above is only step one; the outcome still needs to travel back through the Conversions API from your CRM once a lead becomes a sale. That fuller pattern, including preserving the original click timestamp, is covered in our [conversion tracking guide](/guides/conversion-tracking/).

## Quick answers

**What is the ChatGPT ads pixel?**
The OpenAI Pixel, a JavaScript snippet installed on your website that captures conversion events and the oppref click reference so OpenAI can measure results from ChatGPT ads.

**Where do I get my Pixel ID?**
In Ads Manager, under the Conversions section, create a data source. This gives you both a Pixel ID and a Conversions API key together.

**Do I need the Pixel if I already use the Conversions API?**
OpenAI recommends using both together for more resilient measurement, since each recovers events the other one misses. The Pixel is quick to install and captures the click reference automatically; the Conversions API is not affected by browser blockers.

**What is the shared event ID for?**
When the same conversion is sent through both the Pixel and the Conversions API, using the same event ID lets OpenAI deduplicate it into one conversion instead of counting it twice.

**Can I install the Pixel through Google Tag Manager?**
Yes, as long as the tag manager loads the Pixel snippet on the right pages and does not block or reorder its initialisation and event calls. If it prevents reliable loading, install the snippet directly instead.

**Why does my Pixel show 0 conversions even though it is firing?**
A firing, accepted event can still show 0 if it does not match the conversion event configured for the campaign. For standard events the type must match; for custom events the name must match exactly, not just the display name.

**Does automatic advanced matching require a code change?**
No. The Pixel detects supported customer information already present in recognisable forms on your site, then normalises and hashes it in the browser with SHA-256 before sending it. OpenAI states raw customer information is not sent through this feature.

## Sources

- OpenAI Help Center, Conversion Measurement: https://help.openai.com/en/articles/20001409-conversion-measurement
- OpenAI Help Center, Measure Results: https://help.openai.com/en/articles/20001214-measure-results
- OpenAI Help Center, Understand and Improve Event Quality: https://help.openai.com/en/articles/20001513-understand-and-improve-event-quality
- OpenAI Help Center, Conversion-optimized Campaigns: https://help.openai.com/en/articles/20001412-conversion-optimized-campaigns
- OpenAI Help Center, Troubleshooting Common Issues: https://help.openai.com/en/articles/20001217-troubleshooting-common-issues