The OpenAI Ads Connector is used to send data to the OpenAI Ads Measurement Pixel and the OpenAI Ads Conversions API.
Prerequisites
You will need the following to complete the setup successfully:
- OpenAI Ads Pixel ID
- OpenAI Ads Conversion API access token
- Conversion events created in OpenAI Ads Manager
Retrieve your Pixel ID
- Log in to your OpenAI Ads Manager account.
- In the left-hand menu, go to Tools → Conversions.
- Click Create in the top right corner and select Data Source.
- Enter a name for your data source, set the type to Web, and click Create.
- You will be shown a Pixel ID. Copy it for use in the connector setup.
Retrieve your Conversion API access token
- In OpenAI Ads Manager, go to Tools → Conversions.
- Click Conversion keys in the top right corner.
- Click Create new key, give it a name, and click Create.
- Copy the access token that is displayed. You will need this in the connector setup.
Create conversion events in OpenAI Ads Manager
:::Info
Unlike most ad platform connectors, OpenAI Ads requires you to manually create each conversion event in Ads Manager before events sent from Tracklution will start to populate them. Events may be flowing correctly from Tracklution, but if the corresponding conversion event has not been created in OpenAI Ads Manager, it will not show up in your reporting.
:::
For each event you want to track, create a corresponding conversion event in OpenAI Ads Manager:
- Log in to your OpenAI Ads Manager account.
- In the left-hand menu, go to Tools → Conversions.
- Select the Conversion Events tab.
- Click Create in the top right corner and select Conversion Event.
- In the Base Event dropdown, select the event you want to track. Use the table below to match Tracklution standard events to their OpenAI Ads equivalents.
- Enter a name for the conversion event.
- Under Data source, select the data source (pixel) you created in the previous step.
- Click Create.
- Repeat for each event you want to track.
Event name mapping
| Tracklution Standard Event | OpenAI Ads Event Name |
|---|
| PageView | Page viewed |
| ViewContent | Contents viewed |
| AddToCart | Items added |
| InitiateCheckout | Checkout started |
| Purchase | Order created |
| Lead | Lead created |
| CompleteRegistration | Registration completed |
| StartTrial | Trial started |
| Subscribe | Subscription created |
| Tracklution Custom Event | OpenAI Ads Event Name |
|---|
| CustomEventName | Custom event name |
Set up the OpenAI Ads Connector in Tracklution
- Go to your tracking container dashboard and open the Connectors section.
- Click Add on the OpenAI Ads Connector card.
- Enter your OpenAI Pixel ID and OpenAI API Token.
- When you are ready to start sending data, toggle Set to live and click Create. If you want to save your settings first and go live later, click Create without toggling the switch, then come back to enable it.
:::Warning
Before activating the OpenAI Ads Connector: if you have previously added the OpenAI Ads Measurement Pixel to your website's header, footer, or via GTM, you must remove or deactivate it first. Otherwise the pixel will fire twice, leading to inconsistent data in your reporting. The OpenAI Ads Connector in Tracklution includes both the Pixel and the Conversions API, which allows OpenAI Ads to deduplicate events.
:::
Once the connector is live, your collected data will be sent to both the OpenAI Ads Measurement Pixel and the Conversions API.
Troubleshooting
Issues with a connector? Visit our Troubleshooting and FAQ to find answers to the most common issues for each connector.
