The OpenAI Ads connector tools in Optimizely Opal give you direct access to your OpenAI (ChatGPT) advertising performance data. Use them to retrieve campaign, ad group, and ad-level metrics, then ask Opal to identify wasted spend, model budget scenarios, and flag underperforming creative. This supports data-backed decisions about where to cut, shift, or increase ad spend.
First, an Opal administrator must connect Opal with OpenAI Ads using an OpenAI Ads API key in Optimizely Connect Platform (OCP). After an administrator installs the connector in OCP, you can log in to OpenAI Ads from Opal to access your data. Administrators only need to install the OpenAI Ads connection in OCP once.
Use cases
The following use cases show how you can use OpenAI Ads connector tools in Opal to turn ad performance data into spend and creative decisions.
Spend and budget optimization
Goal – Identify wasted spend and reallocate budget with confidence.
Spend efficiency triage – Use the openai_ads_get_insights and openai_ads_get_conversion_insights tools to pull the last 14 days of performance by campaign and ad group, rank the results by cost per conversion, and flag any ad group where cost per click (CPC) rose while conversions fell.
Find stranded budget – Use the openai_ads_list_campaigns and openai_ads_list_ad_groups tools to review status, budget, and bid across your account, then use openai_ads_list_ads and openai_ads_list_conversion_event_settings to find ad groups that are active with no eligible ads or that are spending with no conversion event attached.
Budget reallocation plan – Use the openai_ads_get_insights and openai_ads_get_conversion_insights tools to compare spend against conversions across all campaigns over the last 30 days and recommend specific dollar amounts to cut or increase, without applying any changes.
Bid and creative performance
Goal – Correct bidding pressure and cut underperforming creative.
Bid pressure check – Use the openai_ads_get_insights tool to show CPC and cost per mille (CPM) trends by ad group over the last 30 days, then use openai_ads_get_ad_group to compare the current bid against conversion value and recommend a corrected maximum bid.
Creative cost check – Use the openai_ads_get_insights and openai_ads_get_conversion_insights tools to rank all ads by cost per conversion over 30 days, use openai_ads_get_ad to pull the copy for the top and bottom three ads, and draft replacement variants with openai_ads_create_ad or openai_ads_update_ad.
Audience and geographic targeting
Goal – Refine who and where your ads reach before you scale spend.
Geo targeting setup – Use the openai_ads_search_geo tool to resolve city, region, or country names into targetable geo IDs before you build a new campaign or ad group.
Audience segment review – Use the openai_ads_list_custom_audiences tool to see which custom audience segments are available, then apply the best-performing segment to a new or existing ad group.
Connect Opal with OpenAI Ads
Install the OpenAI Ads tools in OCP
In the OCP App Directory, complete the following steps:
Locate or click the OpenAI Ads Tools app.
Click Install App.
Configure OpenAI Ads API authentication
Connect this tool to your OpenAI (ChatGPT) ad account using an OpenAI Ads API key.
Go to the Settings > OpenAI Ads Authentication tab.
Enter your OpenAI Ads API key. To get an API key, complete the following steps:
Log in to OpenAI Ads Manager.
Open the Settings tab.
Generate (or copy) an API key.
Enter your OpenAI API Key in the configuration field.
Click Save.
Configure tool permissions
Select the Settings tab.
Expand the Tools Permissions section.
(Optional) Manage write tools:
To prevent Opal from executing live changes in your ad account, disable the optional Write tools.
To enable automated actions (such as updating bids and budgets), keep write tools enabled.
Click Save.
Add the OpenAI Ads connector tools to Opal
After you install the app in OCP and configure API authentication, complete the following steps to connect the tools to Opal:
Select the Settings tab.
Expand Add to Opal.
Click Add to Opal for the Opal account you want to add the OpenAI Ads connector tools to.
Click Remove from Opal to remove the connection.
The OpenAI Ads connector tools use this account-level API key for authentication. Individual Opal users do not need to connect a personal OpenAI Ads login before using these tools.
OpenAI Ads connector tools
After an Opal administrator installs the Opal OpenAI Ads Tool in OCP and configures API authentication, call the following tools in Opal. Click a tool to expand it and learn when to use it, available parameters, and example prompts. If you do not provide a required parameter, Opal prompts you for it.
Account and campaign management
When to use
Permanently retire a campaign you no longer intend to run (cannot be reactivated).
Remove an obsolete or finished campaign from the active set.
Retire a campaign when pausing is not enough (stops its ad groups and ads permanently).
Parameters
campaign_id – The ID of the campaign to archive. Example: "campaign_abc123".
Example prompts
Archive campaign campaign_abc123 permanently.
Retire the "Spring Launch" campaign for good.
Close out and archive our finished holiday campaign.
When to use
Launch a new advertising initiative in OpenAI Ads Manager.
Set up a paused campaign with budget limits (lifetime ceiling and/or average daily) to review before spending.
name – Campaign name (3–1000 characters). Example: "Spring Launch".
(Optional) lifetime_spend_limit_micros – Total lifetime budget cap in micros (min 1,000,000; hard ceiling on total spend). Provide at least one of lifetime or daily spend limit.
(Optional) daily_spend_limit_micros – Average daily budget in micros (min 1,000,000). Note: Spend may reach 2x this on a single day, up to 7x across any 7-day period.
(Optional) bidding_type – Bidding type: impressions or clicks.
(Optional) status – Initial status: active or paused (default: paused).
(Optional) start_time – Start time as an ISO date/datetime in UTC (for example, "2026-06-01").
(Optional) end_time – End time as an ISO date/datetime in UTC (for example, "2026-12-31").
(Optional) description – Free-text description of the campaign.
