ChatGPT Ads Setup

Connect ChatGPT Ads to TrueTracked in two parts. The ad account connection imports your spend and reporting, so ChatGPT Ads shows up in your attribution reports next to the orders it drove. TrueSignal then sends your conversions to OpenAI's Conversions API from our servers, alongside the ChatGPT browser pixel, which TrueTracked loads for you.

Step 1: Connect your ChatGPT Ads account

1. In ChatGPT Ads Manager, go to Settings > API Keys and create a key
2. In TrueTracked, go to Settings > Integrations and click Connect on the ChatGPT Ads card
3. Paste the key and click Connect. TrueTracked checks it with OpenAI and shows the ad account's name

Each key belongs to one ad account. To connect a second account, create a key in that account and connect it the same way. If a key stops working, open the card and paste a new one.

Step 2: Get your Pixel ID and Conversions API key

1. In ChatGPT Ads Manager, open Conversions
2. Copy the Pixel ID of the pixel you want to use
3. Create a Conversions API key for it and copy it

Step 3: Add ChatGPT Ads in TrueSignal

1. Go to Settings > TrueSignal and click Connect on the ChatGPT Ads card
2. Enter the Pixel ID and the Conversions API key
3. Click Connect. TrueTracked checks the pair with OpenAI before saving, so a wrong key or Pixel ID is caught here

Step 4: Create the matching conversion events

TrueSignal sends a fixed set of five events. Create the ones you want to use in Ads Manager with these event names. You can also see this list, with copy buttons, under Events we send on the ChatGPT Ads card in TrueSignal.

A campaign's conversion count only includes its goal event, so for purchase campaigns set order_created as the goal.

Step 5: Add the tracking parameters to your ads

In Ads Manager, paste these into the URL parameters of each ad group or ad. You can also copy them from Settings > Tracking Parameters in TrueTracked.

tt_source=chatgpt&tt_adid={ad_id}&utm_source=chatgpt&utm_medium=cpc&utm_campaign={campaign_id}&utm_content={ad_group_id}&utm_term={ad_id}

The tt_ parameters tie each click to its ad, and TrueTracked works out the ad group and campaign from there. The UTM half is OpenAI's own default template, and utm_source=chatgpt is what keeps paid clicks separate from organic ChatGPT traffic, which arrives as chatgpt.com. See Tracking Parameters for more.

Step 6: Verify

1. Click one of your ChatGPT ads and check that the landing page URL carries tt_source=chatgpt and tt_adid
2. Place a test order from that visit
3. In TrueTracked, check that the order appears on the Attribution page under ChatGPT Ads
4. In Ads Manager, check that the conversion appears against the ad. OpenAI's reporting is not instant, so allow some time

Troubleshooting

• The key is rejected when you save: Check that you used a Conversions API key in TrueSignal and an Advertiser API key in Integrations. The two are not interchangeable. Then check the Pixel ID belongs to the same account as the key.
• Conversions counted twice: Remove any ChatGPT pixel installed through your theme, Google Tag Manager or another app. TrueTracked already loads it.
• Paid clicks show as referral or direct: The ad is missing the URL parameters from Step 5, or utm_source was changed from chatgpt.
• Older orders were not sent: OpenAI only accepts events from the last 7 days, so older events are skipped.
• The ad account shows an error: The Advertiser API key was deleted or revoked. Open the ChatGPT Ads card in Settings > Integrations and paste a new key.