At a glance: ChatGPT Ads, an AppsFlyer integrated partner, is OpenAI's advertising platform. Set up the integration to measure and attribute mobile app installs, in-app events, and website conversions driven by your ChatGPT Ads campaigns.
About the integration with ChatGPT Ads
The AppsFlyer integration with ChatGPT Ads (OpenAI) enables you to measure and attribute app installs, in-app events, and website conversions driven by your ChatGPT Ads campaigns. It supports both mobile app and website measurement.
- Mobile app - AppsFlyer attributes installs and re-engagements to your ChatGPT Ads campaigns, and sends in-app event postbacks.
- Website - AppsFlyer forwards web events, such as page views, content views, and purchases, captured by the AppsFlyer Web SDK to ChatGPT Ads' Conversions API (CAPI), in addition to (or instead of) the ChatGPT Ads JavaScript pixel.
If you also run the ChatGPT Ads pixel on your site, ChatGPT Ads deduplicates the server-side (CAPI) events against the pixel events using a shared event ID, so you can run both in parallel without inflating your conversion counts.
Set up the integration
Set up the integration separately for each mobile app and website you want to measure. You'll need a Pixel ID and API key from your ChatGPT Ads (OpenAI) Ads Manager account for each one.
Prerequisites:
- Before setting up the integration, open an account with ChatGPT Ads.
- Your mobile and website apps set up in AppsFlyer. Learn more
To set up the integration:
-
To activate: In AppsFlyer, from the side menu, select Collaborate > Partner Integrations > Marketplace tab.
To edit: In AppsFlyer, from the side menu, select Collaborate > Partner Integrations > Active integrations tab. - Set up the integration for your:
- Mobile app - attribute installs, re-engagements, and in-app events to ChatGPT Ads campaigns.
- Website - forward web conversion events to ChatGPT Ads' Conversions API, with deduplication against the ChatGPT Ads pixel.
Integrate your mobile app
Use the following steps to set up attribution and in-app event postbacks for ChatGPT Ads on your mobile app.
To integrate your mobile app:
- In AppsFlyer, from the side menu, select Collaborate > Partner Integrations > Marketplace tab.
- Select your mobile app from the drop-down menu.
Note: You'll need to repeat these steps for each platform your app runs on, such as your Android and iOS apps. - Search for ChatGPT Ads (OpenAI) and click Integrate.
- Complete the configuration in the tabs as described below.
Integration tab
Activate partner
To activate the integration:
Turn on the Activate partner toggle.
Important note: The toggle must remain on as long as you work with ChatGPT Ads. Deactivating the integration will turn off attribution and postbacks for your campaigns.
Learn more about partner activation.
General settings
Enter the following credentials:
- Pixel ID - A Pixel is created in your ChatGPT Ads Manager. Get it from the conversions tab in your Ads Manager account.
- API key - An API key is required to authenticate Events API calls. Get it from the conversions tab in your ChatGPT Ads Manager account.
Default postbacks
A postback is a server-to-server notification AppsFlyer sends to ChatGPT Ads to report an attributed event (like an install or in-app action). This section displays your postbacks. Learn how to set install and re-attribution postbacks.
Learn more about the default postbacks setting.
In-app event settings
To be able to send in-app event postbacks to ChatGPT Ads, enter the required credentials:
- Pixel ID
- API key
For details, see General settings above.
In-app event postbacks
Configure in-app event postbacks to send to ChatGPT Ads. Learn more
To enable in-app event postbacks:
Turn on the In-app event postbacks toggle.
In-app event postback window
Define the period after an install, re-attribution, or re-engagement, during which AppsFlyer sends in-app event postbacks to ChatGPT Ads. Learn more
Map your events
To make sure your events match the equivalent events in ChatGPT Ads, map your event names. Learn more
ChatGPT Ads supports the following standard events, plus a Custom fallback for any event not covered below:
| ChatGPT Ads event name | When to use |
|---|---|
| page_viewed | User lands on or views an important page. |
| contents_viewed | User views a specific product, listing, article, or content unit. |
| items_added | User adds one or more items to a cart, bundle, or selection. |
| checkout_started | User starts checkout. |
| order_created | Purchase completed. |
| registration_completed | User finishes account or event registration. |
| lead_created | User submits a lead form or requests contact. |
| appointment_scheduled | User books a meeting, demo, or consultation. |
| trial_started | Free trial starts. |
| subscription_created | Paid subscription starts. |
| app_opened | Mobile app open. |
| custom | Any event not covered by the standard taxonomy. |
Attribution link tab
ChatGPT Ads (OpenAI) supports attribution links. Choose your attribution link type, a single-platform link or a OneLink, then select the attribution link parameters you want to include (for example, Campaign Name and Site ID) and set your click-through lookback window (7 days is the AppsFlyer-recommended default). AppsFlyer generates your attribution link automatically for use in your ChatGPT Ads campaigns.
Note: Your generated link includes openai_int(ChatGPT Ads' integration ID in AppsFlyer).
Learn more about attribution links.
Cost tab
There is currently no cost API integration for ChatGPT Ads.
Ad revenue tab
Ad revenue data can't be pulled from ChatGPT Ads. Use postbacks or UA signals to share ad revenue data for campaign optimization.
Permissions tab
Turn on Ad network permissions to grant ChatGPT Ads team members access to your data. Once enabled, select which individual permissions to grant, such as configuring the integration, accessing retention and cohort reports, or viewing aggregate conversion and revenue data. Note that even if attribution is disabled for ChatGPT Ads, you can still grant permissions.
Learn more about permissions.
Integrate your website
Use the following steps to set up server-side event forwarding to ChatGPT Ads for your website.
To integrate your website:
- In AppsFlyer, from the side menu, select Collaborate > Partner Integrations > Marketplace tab.
- Select your website app from the drop-down menu.
- Search for ChatGPT Ads (OpenAI) and click Integrate.
- Complete the configuration in the integration tab as described below.
Integration tab
Activate partner
To activate the integration:
Turn on the Activate partner toggle.
Important note: The toggle must remain on as long as you work with ChatGPT Ads. Deactivating the integration will turn off event forwarding for your website.
Learn more about partner activation.
In-app event settings
To be able to send event postbacks to ChatGPT Ads, enter the following credentials:
- Pixel ID - A Pixel is created in your ChatGPT Ads Manager. Get it from the conversions tab in your Ads Manager account.
- API key - An API key is required to authenticate Events API calls. Get it from the conversions tab in your ChatGPT Ads Manager account.
In-app event postbacks
Configure event postbacks to send to ChatGPT Ads. Learn more
To enable event postbacks:
Turn on the In-app event postbacks toggle.
Map your events
To make sure your events match the equivalent events in ChatGPT Ads, map your event names. See the standard event table above for the events ChatGPT Ads supports. Learn more
Attribution link tab
ChatGPT Ads (OpenAI) doesn't use external attribution links for website integrations. The AppsFlyer Web SDK measures web events and forwards them directly to ChatGPT Ads' Conversions API, so no link-based attribution setup is needed.
Cost tab
Cost data isn't available for website integrations with ChatGPT Ads.
Ad revenue tab
Ad revenue data isn't available for website integrations with ChatGPT Ads.
Permissions tab
Permissions aren't available for website integrations with ChatGPT Ads.