OpenAI Ads

Create Connection in adtribute

1. Open the adtribute App.
2. Go to Sources › Connections and click on “Create Connection”.
3. Search for “OpenAI Ads” and select it.
4. Name the Connection as you like, e.g. the Account Name.

The first step, “UTM Settings”, shows the UTM parameters below. Set them up in OpenAI Ads, then click “I did that”.

Implement UTM Parameters

adb_ad_source=openai&adb_campaign_id={campaign_id}&adb_adgroup_id={ad_group_id}&adb_ad_id={ad_id}

Set up these parameters in your OpenAI Ads account, so that every click on your ads opens your website with them in the URL. adtribute matches each click to its ad by adb_ad_id.

Note

You can also click “I did that” first and set up the parameters later. You don’t need to save them: you find them at any time in the connection, tab “Configuration”, step “UTM Settings”, and copy them with the clipboard icon.

OpenAI Ads Connection Flow

You connect OpenAI Ads with an Ads API key, which you create in the settings of OpenAI Ads Manager.

1. In the step “Connect OpenAI Ads”, enter your Ads API key in the field “API Key”.
2. Click “Connect”.

adtribute checks the key with OpenAI Ads right away. If OpenAI Ads doesn’t accept it, adtribute shows the error “Invalid API key”.

A connection brings in the ad account its API key belongs to. To bring in another ad account, create another connection with a key of that account.

Complete Connection

After a successful connection, the sidebar closes and you find the OpenAI Ads connection among your connections under Sources › Connections. It shows “Awaiting data” until the first data has arrived, then “Connected”.

What adtribute brings in

The data arrives in the channel “OpenAI Ads” under Definitions › Channels, one row per ad and day, with these metrics:

Metric	What it holds
OpenAI Ads Spend	The amount spent on the ad, in your organization’s currency
OpenAI Ads Impressions	The number of impressions of the ad
OpenAI Ads Clicks	The number of clicks on the ad
OpenAI Ads Conversions	The number of conversions OpenAI Ads reports for the ad
OpenAI Ads Attributed Sales	The order-created attributed sales value OpenAI Ads reports for the ad, in your organization’s currency

Each row also holds the ID and name of the ad account, and the ID, name and status of the campaign, the ad group and the ad.

Conversions and attributed sales are the numbers OpenAI Ads reports, not adtribute’s attribution (see data discrepancies).

• Days: a day is a day in your ad account’s timezone.
• Updates: every 15 minutes, adtribute pulls today and yesterday from OpenAI Ads. Every night, it reloads the last seven days, because OpenAI Ads keeps updating past days: spend is finalized after the clicks, and conversions come in a day or more later.
• History: the first sync loads the past 365 days, but nothing before 15 April 2026.
• Names and statuses: campaigns, ad groups and ads show with their latest name and status. A change you make during the day shows from the next day.

How clicks become touchpoints

adtribute records a visit from an OpenAI ad as an OpenAI Ads touchpoint when:

• adtribute tracks your website through a connected Domain, and
• the URL of the page the click opens carries adb_ad_source=openai.

adtribute matches the touchpoint to its ad by the ad ID in adb_ad_id, so the touchpoint shows with the ad’s campaign, ad group and ad. The “OpenAI Ads Touchpoint” appears under Definitions › Touchpoints as soon as both your Domain connection and your OpenAI Ads connection are connected, in whichever order you connect them.

Caution

A visit with adb_ad_source=openai but without adb_ad_id still counts as an OpenAI Ads touchpoint, but its “OpenAI Ads Ad ID” reads “Wrong adtribute Matching Parameters” and adtribute can’t match it to an ad. Use the whole template above.