The OpenAI Ads connector tools in Mark (Optimizely Agent Platform) give you direct access to your OpenAI (ChatGPT) advertising performance data. Use them to retrieve campaign, ad group, and ad-level metrics, then ask Mark 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, a Mark administrator must configure the OpenAI Ads connector in Mark (Optimizely Agent Platform) using an OpenAI Ads API key. On the Connectors page, click Configure on the OpenAI Ads tile and complete the steps. Administrators only need to configure the OpenAI Ads connector once.
Use cases
The following use cases show how you can use OpenAI Ads connector tools in Mark 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 Mark with OpenAI Ads
Get your OpenAI Ads API key
Connect this connector to your OpenAI (ChatGPT) ad account using an 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.
Configure the OpenAI Ads connector
When you click Configure, Mark opens the Configure OpenAI Ads dialog. If the connector is not installed yet, an Install modal displays first. The dialog then has two steps: Settings, where you enter the details the connector needs to authenticate, and Tools, where you choose which tools to enable.
As a Mark administrator, complete the following steps:
Go to Connectors.
(Optional) Enter OpenAI Ads in the Enter name field, or use the Provider, Active Status, and Provider Type filters to find the connector.
Click Configure on the OpenAI Ads tile.
Note
The Install modal only displays if the connector is not installed yet. Installing adds the connector to your organization and makes its tools available. You install a connector once, for everyone.
On the Settings step, complete the following, and then click Next. The app stores these settings and applies them to everyone in your organization.
Enter your OpenAI API Key.
(Optional) Disable the write tools to prevent Mark from executing live changes in your ad account. Keep the write tools enabled for automated actions, such as updating bids and budgets.
On the Tools step, select the tools that users can use by default, and then click Save. Each tool displays its type, such as Read, Create, Update, or Delete. Use the search field to find a tool, or click Deselect all to clear the selection. Tools that you do not select still display on the connector's Tools tab, but remain disabled until you select them.
After you configure the connector, the OpenAI Ads tile displays Connect for you and for every Mark user in your organization. Click Connect to connect it.
The OpenAI Ads connector tools use this account-level API key for authentication. Individual Mark users do not need to connect a personal OpenAI Ads login before using these tools.
OpenAI Ads connector tools
After an administrator configures the OpenAI Ads connector, call the following tools in Mark. 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, Mark 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.