OpenAI Ads (ChatGPT) Attribution and CAPI

Follow
Avatar
Samar Perka
Updated
Setting Up ChatGPT Ads 
Attribution & Conversions API 
Set up Tracking Link and Postback Configuration  

 

This article details how to setup OpenAI Ads (ChatGPT) campaigns with Singular's Attribution and Conversions API for mobile app campaigns, PC/Console installs, and Web campaigns.

 

Overview

Singular's web-to-app attribution solutions empower marketers to run web campaigns that drive app installs across Mobile, PC, and Console platforms. Singular's OpenAI Ads web-to-app integration supports the Direct to Store flow described in our Web to App Guide here .

Add ChatGPT Partner Configuration in Singular 

Add ChatGPT Ads Partner Configuration in Singular

  1. Go to Singular > Attribution > Partner Configuration 
  2. Click " Add a Partner ", and type and choose " OpenAI Ads (ChatGPT) "
  3. In the dialog, choose your App and App/Website (platform) to configure. Mobile, Web, PC, and Console apps are supported with this integration
  4. Paste in your app's "Pixel ID" and "Conversions API Key" from your OpenAI Ads Manager. 
     
     
  5. Optionally configure any additional events to send OpenAI and map them to an "OpenAI Event Name" 

     
  6. Click " Save " to finish.
Event Attributes required for "OpenAI Ads (ChatGPT)"

Event attributes required for the "OpenAI Ads (ChatGPT)" integration

To enable the OpenAI Ads (ChatGPT) integration, please implement and send the following case-sensitive event attributes.

Mobile

Send the following event attributes:

  • ehash : The SHA-256 hash of the user's email address after trimming leading and trailing whitespace and converting it to lowercase.
  • external_id_hash (optional): The SHA-256 hash of a stable, pseudonymous customer identifier from your system.
    • If possible, send both ehash and external_id_hash to improve matching. If ehash is not available, send external_id_hash at a minimum.

Web

Send the following event attributes:

  • page_url (required): The full URL of the page where the event occurred (for example, https://shop.example.com/checkout/confirmation).
  • ehash : The SHA-256 hash of the user's email address after trimming leading and trailing whitespace and converting it to lowercase.
  • external_id_hash (optional): The SHA-256 hash of a stable, pseudonymous customer identifier from your system.
    • page_url is required. For user fields, if possible, send both ehash and external_id_hash to improve matching. If ehash is not available, send external_id_hash at a minimum.
Create Singular Link for "ChatGPT Ads" 

Create Singular Link for "ChatGPT Ads"

  1. Go to Singular > Attribution > Manage Links 
  2. Select your mobile app from the list of apps on the left
  3. Select "Create Link" -> Link Type "Partner" -> Source Name "OpenAI Ads (ChatGPT)" 
  4. Continue through the step-by-step link creation.
  5. Click "Generate" 
  6. Copy the "Click-through Tracking Link" for the next step
Set up your OpenAI Ads (ChatGPT Ads) Campaign 

Set up your OpenAI Ads (ChatGPT Ads) Campaign

  1. In OpenAI Ads Manager, create a campaign and continue to the Ad Group step.
  2. Enter the Singular Link created above in the "Default Ad Destination URL":

FAQ

How does Singular report ChatGPT attributions? 

Once an attribution is tracked, ChatGPT attributions are reported as follows:

  • Source = "ChatGPT"
  • Tracker Source Name = "ChatGPT"
Where can you find the Pixel ID? 
  1. Navigate to the OpenAI Conversions page.
  2. Select "Create", and choose "Data Source":  
  3. Once done, copy the new Pixel ID:
Where can you find the Conversions API Key? 
  1. Navigate to the OpenAI Conversions page.
  2. Select "Conversion keys", and choose "Create new key": 

     
  3. Copy your new key to Singular's Partner Configuration:

     
What data does Singular send via API? 
Parameter Details
event_name
  • A standard event or custom event name. This field is automatically mapped to the Singular Event Name. This value is used to assist OpenAI in the deduplication of events. The event_id parameter is also used in deduplication.
hashed email
  • Optional
  • Hashed email may be passed as a Singular instrumented event attribute "ehash"
  • Hashed email value must be normalized and SHA 256 hashed
hashed external user ID
  • Optional
  • Hashed external ID may be passed as a Singular instrumented event attribute "external_id_hash"
IP address
  • The Client IP Address
user agent
  • The Client User-Agent
For Deduplication of Events (Optional) 
event_id
  • Required Parameter for Deduplication
  • Pass the event_id value to Singular in the Event Arguments using an attribute name: " eventId ".
  • The event_id parameter must by added to your events from both the Conversions API and the OpenAI Pixel.
  • The event_id parameter is an identifier that can uniquely distinguish between similar events.