Overview
With Sonar Optimize, Triple Whale integrates directly with OpenAI Ads to automatically send enriched, first-party data via the OpenAI Ads Conversions API (CAPI). Connect Sonar Optimize to your OpenAI Ads account and achieve a complete picture of the customers, interactions, and web conversions of your website. Follow this guide to track relevant conversions from your store and optimize your OpenAI Ads campaigns based on real-time data.
Note: Headless Shopify stores as well as stores built on BigCommerce or WooCommerce will require developer implementation in order to enable Sonar Optimize. See the relevant documentation linked in your Sonar settings page.
Configuring Sonar Optimize
To begin setup, navigate to Data → Sonar Enrichment → Integrations in the Triple Whale sidebar. Locate the OpenAI Ads tile and click Connect.
1. Create an API Key in OpenAI Ads Manager
Before connecting, you'll need to generate an API key from your OpenAI Ads Manager account.
In OpenAI Ads Manager, navigate to Settings.
Under the API Keys section, click + Create New Key.
Enter a name for your key (e.g., Triple Whale Sonar Optimize) and click Create.
On the Save Your Key screen, copy the key. Important: This key grants full Ads Management API access and will not be shown again — store it securely before closing this window.
2. Connect OpenAI Ads in Sonar Optimize
In the Sonar Optimize setup wizard, under OpenAI Ads Set up, click Connect.
In the Connect OpenAI Ads modal, paste the API key you generated from OpenAI Ads Manager. Click Save.
Issue an API key in your OpenAI Ads Manager under Settings. Each key is scoped to a single ad account.
Once connected, the OpenAI Ads tile will update. Click Manage to configure your ad account and pixel settings.
3. Select and Activate Your Ad Account
In the Manage OpenAI Ads Connection modal, under the Connection Details tab, your Token Connection Status should display as Active (green).
Under Accounts, locate your OpenAI Ads account and toggle it on to activate it. The status will change from Inactive to Active.
4. Configure CAPI Settings (Pixel ID)
To enable server-side event transmission, you need to provide your OpenAI Ads Pixel ID.
In OpenAI Ads Manager, navigate to Tools → Conversions.
Locate your pixel (e.g., Triple Whale OpenAI Pixel) and click Copy Pixel ID.
Back in Sonar Optimize's Manage OpenAI Ads Connection modal, click the CAPI Settings tab.
Paste the Pixel ID into the Pixel ID field and click Save Settings.
5. Select Your Pixel Destination
Back on the main setup screen, from the OpenAI Ads Pixel Destination dropdown, select the OpenAI Ads Pixel you want to enrich with Sonar data (e.g., Triple Whale OpenAI Pixel (K5quDSb6op9cUdviUERjPk)).
Confirm that the following Triple Pixel components are enabled:
Enable Triple Pixel Theme App Embed (required)
Enable the Triple Pixel Web Pixel Extension (recommended)
Click Save and Continue.
Running a headless Shopify setup? You'll need to modify your Triple Pixel snippet using the instructions linked on the setup page.
6. Send Events for Enrichment
Select which events you want Triple Whale to send to OpenAI Ads for enrichment. The following Standard events are available and recommended:
Page View
View Content
Add to Cart
Initiate Checkout
Purchase
Signup
New Customer Purchase
Return Customer Purchase
You can also send Custom Pixel Events that have been added via your Pixel Settings.
For optimal results, we recommend enabling all standard events. Each event type can be individually toggled on or off based on your campaign needs. Once you have configured your event selection, click Save and Continue to proceed.
7. Exclude Events from Enrichment
By default, any purchase event sent to OpenAI Ads will be used to measure and optimize your campaigns. To avoid sending purchase events unrelated to your OpenAI Ads campaigns, you can configure exclusions on this page.
Exclude recurring subscription purchases (recommended): Add your Recurring Subscription Order Tag (e.g., Subscription Recurring Order) to ensure that repeat subscription purchases are excluded from being sent to OpenAI Ads.
Exclude purchases by order tags: Search for and select any additional order tags you want to exclude.
Add channels you want to exclude (recommended): Select sales channels to exclude (e.g., SHOPIFY_DRAFT_ORDER, POS, and any other non-ad-driven channels).
Select custom sales channels to exclude: Click + Add Sales Channel to add any
custom channels not listed by default.
Click Done when finished.
8. Validate Setup
Once setup is complete, you will be returned to the Sonar Delivery Overview page for OpenAI Ads. You should see:
Status: Connected
Last Configured On: the date you completed setup
Events will begin populating in the Events Log table within 10–20 minutes of completing setup. If you do not see events after that window, confirm that your Triple Pixel Theme App Embed is enabled and that the correct Pixel ID is saved in CAPI Settings.
Delivery Overview
Once Sonar Optimize is enabled for OpenAI Ads, you can monitor data transmission within Triple Whale. In Sonar Settings, click View Details to access the Delivery Overview page. Here, you will see a data table that displays the total number of enriched events, broken out by event type over the chosen time frame. This tells you what data Triple Whale is broadcasting to OpenAI Ads.
After connecting the integration and sending data for a few days, monitor your OpenAI Ads performance for the following improvements:
Improved signal quality and conversion accuracy
More accurate in-platform reporting
Better campaign targeting and audience optimization
Frequently Asked Questions
1. What event types does Sonar Optimize enrich for OpenAI Ads?
Sonar Optimize will send and enrich standard OpenAI Ads web pixel events: Page View, View Content, Add to Cart, Initiate Checkout, Purchase, Signup, New Customer Purchase, and Return Customer Purchase.
2. Do I need to generate a new API key if I already have one connected?
We recommend generating a new API key specifically for your Triple Whale Sonar connection. This ensures a clean, dedicated key for Sonar's server-side event transmission and makes it easier to manage and troubleshoot your integration. Note that each API key is scoped to a single ad account.
3. Should I enable Sonar Optimize if I already have another CAPI enrichment provider connected to OpenAI Ads?
We do not recommend running multiple CAPI services simultaneously. Using multiple CAPI setups can result in duplication of events, which degrades optimization and inflates reporting. We recommend disabling any existing CAPI connections before enabling Sonar Optimize.