For the complete documentation index, see llms.txt. This page is also available as Markdown.

Ads

Analyze OpenAI Ads performance and create or manage ad resources with enabled Playbook tools.

Use OpenAI Ads in Playbooks to inspect account performance, prepare campaign briefs, and recommend changes. Where write tools are enabled, a Playbook can also create and manage campaigns, ad groups, and ads.

Creating, editing, activating, and archiving ads through Playbooks requires separate enablement. Access to performance reporting does not automatically include write tools. Contact your AirOps team about availability.

How to Configure

  1. Open the Playbook editor.

  2. Type / in the Section where you want to work with ads.

  3. Select OpenAI Ads.

  4. Select or connect the required OpenAI Ads authentication. Use an API key from ChatGPT Ads Manager.

  5. Specify the account or resources, date range, and metrics to analyze. For enabled write tools, describe the exact resources and settings to create or change.

Capabilities

Task
Supported behavior

Analyze performance

Retrieve account, campaign, ad group, and ad-level insights.

Manage campaigns

Create, inspect, edit, and archive campaigns where write tools are enabled.

Manage ad groups

Create groups under a campaign, inspect or edit their settings, and archive them where enabled.

Manage ads

Upload creative images, create ads, and inspect, edit, or archive existing ads where enabled.

Extend a campaign

Add ad groups and ad variants to an existing campaign where enabled.

Review and activation

Playbook creation tools create campaigns, ad groups, and ads in a paused state. The activation flow asks you to review the exact resources, budget, targeting, and creative before choosing Activate now or Keep paused.

The archive flow identifies the exact resource and offers Archive or Keep. Review edits carefully: changes to existing active resources affect the connected ad account.

Parameters

Task
Required context
Additional guidance

Analyze

Connected account

Campaign, ad group, or ad IDs; date range; daily breakdown; metrics to compare

Create campaign

Name, objective, and budget

Targeting, exclusions, scheduling, and instructions to keep resources paused

Create ad group

Parent campaign, name, and bid settings

Context hints describing the audience or situation

Create ad

Parent ad group, copy, destination, and creative image

Brand Kit guidance and the variants to test

Edit or archive

Exact existing resource

The requested changes and review instructions

Examples

Compare performance

Create a paused campaign

For a workspace with write tools enabled:

For competitor research without an ad-account connection, use the observed Ads MCP tools. These query the ads AirOps observes in tracked ChatGPT answers.

Last updated

Was this helpful?