How To Setup OpenAI ChatGPT Ads Measurement Pixel

1. Manual Direct Script Code Installation
2. Custom HTML Tag Implementation via Google Tag Manager (GTM)
3. Template-Based Deployment using the Community GTM Tag Template

Technical Overview & How the OpenAI Pixel Works

 +-----------------------------------+ | ChatGPT Ad Click | +-----------------------------------+ | v +-----------------------------------+ | Landing Page (URL containing | | ?oppref=...) | +-----------------------------------+ | v +-----------------------------------+ | OpenAI Measurement Pixel SDK | | Stores __oppref Cookie | +-----------------------------------+ | +-----------------+-----------------+ | | v v +---------------------------+ +---------------------------+ | Standard Event Hits | | Custom Event Hits | | (order_created, lead, etc)| | (quote_requested, etc) | +---------------------------+ +---------------------------+ 

Supported Standard Events & Data Shapes

Method 1: Manual Code Snippet Installation

Step 1: Add the Base SDK Script

<script> (function (w, d, s, u) { if (w.oaiq) return; var q = function () { q.q.push(arguments); }; q.q = []; w.oaiq = q; var js = d.createElement(s); js.async = true; js.src = u; var f = d.getElementsByTagName(s)[0]; f.parentNode.insertBefore(js, f); })(window, document, "script", "https://bzrcdn.openai.com/sdk/oaiq.min.js"); oaiq("init", { pixelId: "<YOUR-PIXEL-ID>", debug: false // Set to true during testing to output logs to console }); </script> 

Step 2: Configure Consent Controls

<script> // Default to false if consent is required and not yet given oaiq("consent", false); oaiq("init", { pixelId: "<YOUR-PIXEL-ID>" }); // Execute this callback after the user grants consent in your CMP banner function onUserAcceptsCookies() { oaiq("consent", true); } </script> 

Step 3: Pass User Data for Enhanced Advanced Matching

oaiq("init", { pixelId: "<YOUR-PIXEL-ID>", user: { email_sha256: "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514", external_id_sha256: "73d83a078369bb4f0971b317aa7797a91cf5c0df1b62161c2e47d75c33ab5b6e", country: "US", city: "san francisco", zip_code: "94107" } }); 

Step 4: Fire Conversion Events

// Example 1: E-commerce Order Completion oaiq("measure", "order_created", { type: "contents", amount: 2599, // Integer or numerical value currency: "USD", contents: [ { id: "sku_123", name: "Starter Bundle", content_type: "product", quantity: 1 } ] }, { event_id: "order_12345" // Optional server-side deduplication ID }); // Example 2: Custom Event Setup oaiq("measure", "custom", { type: "custom" }, { custom_event_name: "quote_requested" } ); 

Method 2: Manual Installation via Google Tag Manager (Custom HTML)

Step 1: Create the Base Pixel Tag

1. Open your GTM Web Container.
2. Click Tags > New, and name it OpenAI Pixel - Base Script.
3. Choose Custom HTML as the Tag Type.
4. Paste the initialisation snippet into the HTML field:

<script> (function (w, d, s, u) { if (w.oaiq) return; var q = function () { q.q.push(arguments); }; q.q = []; w.oaiq = q; var js = d.createElement(s); js.async = true; js.src = u; var f = d.getElementsByTagName(s)[0]; f.parentNode.insertBefore(js, f); })(window, document, "script", "https://bzrcdn.openai.com/sdk/oaiq.min.js"); oaiq("init", { pixelId: "YOUR_PIXEL_ID_HERE" }); </script> 

5. Under Triggering, select Initialisation - All Pages (or Consent Initialisation - All Pages if integrating with a CMP).
6. Save the tag.

Step 2: Create Standard and Custom Event Tags

1. Click Tags > New, and name it OpenAI Pixel - Event - Purchase.
2. Select Custom HTML and paste your event tracking script referencing GTM Data Layer Variables:

<script> window.oaiq && window.oaiq("measure", "order_created", { type: "contents", amount: {{dlv - Order Total}}, currency: "{{dlv - Currency}}", contents: [ { id: "{{dlv - Product SKU}}", content_type: "product", quantity: {{dlv - Quantity}} } ] }, { event_id: "{{dlv - Transaction ID}}" }); </script> 

3. Under Advanced Settings > Tag Sequencing, check Fire a tag before OpenAI Pixel - Event - Purchase fires and select your OpenAI Pixel - Base Script.
4. Add your trigger (e.g., Custom Event trigger matching purchase or pageview trigger for thank-you pages).
5. Save and Publish.

Method 3: Simplified Setup via Google Tag Manager Community Template

+-----------------------------------------------------------------+ ¦ Google Tag Manager Container ¦ ¦ ¦ ¦ +---------------------------------------------------------+ ¦ ¦ ¦ OpenAI Ads Pixel Tag Template ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ Pixel ID: [ YOUR-PIXEL-ID ] ¦ ¦ ¦ ¦ Event Setup: Inherit from DataLayer / Override ¦ ¦ ¦ ¦ [X] Enable Automatic GA4 Mapping ¦ ¦ ¦ ¦ [X] Enable Google Consent Mode (ad_storage) ¦ ¦ ¦ +---------------------------------------------------------+ ¦ +-----------------------------------------------------------------+ 

Step 1: Add the Template to Your Container

1. Navigate to Templates in the GTM sidebar.
2. In the Tag Templates box, click Search Gallery.
3. Search for OpenAI Ads Pixel (e.g., OpenAI Ads Pixel by Stape) and click Add to Workspace.

OpenAI Ads Pixel Template in Google Tag Manager

Step 2: Configure the Main Pixel Tag

1. Go to Tags > New and set the Tag Type to OpenAI Ads Pixel.
2. In the Pixel ID field, paste your OpenAI Pixel ID.
3. Select your Event Name Setup Method:
   
   
   • Inherit from DataLayer: Automatically maps standard GA4 events (e.g., add_to_cart, begin_checkout, purchase) directly to their OpenAI equivalents (items_added, checkout_started, order_created).
   • Override: Manually select a specific standard OpenAI event or define a custom event name.
4. Enable Automatic Event Parameters Mapping. This allows the tag to parse GA4 e-commerce objects, populating amount, currency, and item contents automatically.

ChatGPT/OpenAI Tag Template Settings in Google Tag Manager

Step 3: Configure Consent & Advanced Matching

• Google Consent Mode: Check the option to enable GTM Consent Mode support. When ad_storage consent is denied, the tag prevents script loading until the user explicitly grants permission.
• Advanced Matching: Under the user parameters section, map variables for email_sha256 or external customer IDs to enhance conversion attribution rates.

Step 4: Attach Triggers

• Use Initialisation - All Pages to fire base page view calls.
• Use specific Custom Event Triggers (e.g., purchase, generate_lead) to fire conversion events.

Technical Considerations & Best Practices

1. Content Security Policy (CSP) Headers

Content-Security-Policy: default-src 'self'; script-src 'self' 'nonce-2726c7f26c' https://bzrcdn.openai.com; connect-src 'self' https://bzr.openai.com https://bzrcdn.openai.com; img-src 'self' https://bzr.openai.com; 

2. Deduplication Between Browser (Pixel) and Server (Conversions API)

// Browser Pixel Call oaiq("measure", "order_created", { type: "contents", amount: 2599, currency: "USD" }, { event_id: "order_unique_98765" // SHARED UNIQUE ID }); 

3. Debugging and Verification

• Enable Console Debug Logs: Set debug: true in your oaiq("init", ...) configuration or check JS SDK Debugging Logs within the GTM template to view payload outputs directly in the Developer Tools console.
• Check Cookie Storage: Verify that the __oppref cookie is set correctly upon visiting landing pages containing ad tracking parameters.
• Network Tab Inspection: Look for outbound POST or GET requests targeting [https://bzr.openai.com](https://bzr.openai.com) with 200 HTTP response codes.

Need Help With Your Tracking?

Tags: AI Assistant, LLMs, ChatGPT, Tracking, Data Analytics