company logo

Help center

Go to Rank Prompt
Powered by
All collectionsIntegrationsOpenAI Ads

OpenAI Ads

Connect your OpenAI Ads account to manage campaigns, ad groups, and ads directly from Rank Prompt.

OpenAI Ads lets you run advertising inside ChatGPT. The Rank Prompt integration pulls your OpenAI Ads account into the app so you can review performance, manage campaigns, and generate AI-assisted creative, all in one place alongside your visibility data.

This is a beta feature available on Pro and above.


What you can do

Once connected, the OpenAI Ads page gives you six tabs:

Tab

Description

Overview

Spend, impressions, clicks, and a per-campaign performance table

Campaigns

View and manage campaigns, ad groups, and individual ads

Audiences

Upload customer lists to include, exclude, or bid differently for the people on them

Product feeds

Send your product catalog so OpenAI can build product ads from it

Conversions

What OpenAI credited to your ads, by campaign, ad group, or ad

Tracking

Pixel and server-side setup, tracking snippets, and a test event sender


Connecting your account

Requirements

  • OpenAI Ads account with an active ad account

  • An OpenAI Ads API key with read (and optionally write) access

  • Pro plan or higher in Rank Prompt

Step 1: get your OpenAI Ads API key

In OpenAI Ads Manager, open Settings and create an Advertiser API key. Each key belongs to one ad account. Copy the key. You'll need it in the next step.

Step 2: connect in Rank Prompt

  1. Open Integrations > Reach customers

  2. On the OpenAI Ads card, click Connect

  3. Paste your API key in the dialog and save

Rank Prompt verifies the key and syncs your account data. Rank Prompt checks the key again every day, so a revoked key shows up as a warning on the page and in your integrations instead of as stale data.

Step 3: open OpenAI Ads

Open Outreach > OpenAI Ads in the sidebar to see your campaigns.


Managing campaigns

From the Campaigns tab you can:

  • Browse campaigns, ad groups, and ads, one section each: pick a campaign and its Ad groups open, pick an ad group and its Ads open

  • View budgets and status

  • See why something is not delivering, in the Delivery column

Use the Refresh button in the page header to pull the latest data from OpenAI Ads at any time.

When the account has no campaigns yet, the Overview shows New campaign, which opens the campaign form right there. Only people who can edit the brand see it.

Budgets

A campaign takes either a daily budget or a lifetime one, never both. Pick daily if you want a steady spend, or if you plan to let OpenAI set the bids. A lifetime budget can be switched to daily later, but not the other way round: OpenAI has no way back, so that would need a new campaign.

Bids

Each ad group either uses a fixed bid, the most you pay for a click or a thousand impressions, or Maximize results, where OpenAI sets each bid to get the most clicks or conversions out of the campaign's daily budget. Maximize results needs a traffic or conversions campaign with a daily budget, and it replaces both the fixed bid and any audience bid adjustments on that ad group.

Where your ads run

Campaign targeting covers three things that work together: locations to deliver in, locations to exclude, and the platforms ChatGPT runs on (desktop browser, iOS and Android browsers, iOS and Android apps). Leave the platforms empty to run everywhere OpenAI serves ads.

Tracking parameters

A campaign can carry a query string that is appended to every landing page URL, the way a UTM template works, so clicks arrive tagged without editing each ad.

Why an ad is not running

The Delivery column on campaigns, ad groups and ads shows what OpenAI reports: budget used up, review not approved, a landing page it could not read, no payment method, and so on. A warning means partial delivery, a red mark means nothing is running.


Account spend limits

The Overview tab shows the ceiling for the whole ad account, which is separate from campaign budgets: a campaign can still have budget left while the account is done spending.

  • A daily allowance caps what the account spends in one day. It renews at midnight in the account's time zone and can run open-ended or up to an end date.

  • A date range caps total spend between two dates. Ranges cannot overlap, and the end date is not counted.

Only the brand owner can change them, and OpenAI enables the feature per ad account.


Ad previews

The ad preview shows your chat card on Desktop or Mobile, today's size or Larger image. OpenAI is testing larger visuals built from your existing creative: a wider card with a bigger image on desktop and a full-width image on mobile. You don't need to change anything, but a sharp square image of 1200 x 1200 px or more holds up best (640 x 640 is the minimum).


AI help with creative

Rank Prompt can help generate ad creative using your visibility data as context.

Credit costs

Action

Credits

Suggest context hints

1 credit

Generate image prompt

1 credit

Generate ad image

1 credit

Generating an image without writing your own prompt runs the image prompt step first, so it costs 2 credits in total. The button shows the full cost before you click.

Credits are deducted from your regular monthly or top-up credit balance.


Audiences

The Audiences tab lets you use your own customer lists in OpenAI Ads.

  • Create an audience from a CSV or TXT file of emails, phone numbers, hashed emails or phones, or Android advertising IDs. A CSV can mix those columns; pick "Detect columns automatically" and OpenAI matches on whichever identifier is filled in. You can also start with an empty audience and add people later.

  • Add, remove, or replace people at any time. Paste identifiers directly for small changes, or upload a file for large ones. Changes are processed asynchronously; the row shows the change until OpenAI reports it finished.

  • Merge two or more ready audiences into a new, independent one.

  • Use them in campaigns: when you create or edit a campaign, include an audience to deliver only to the people on it, or exclude one to keep those people out. On an ad group, add a bid adjustment from 0.1x to 10x for an audience.

OpenAI reports audience sizes as ranges, never exact counts. Around 25,000 matched people are needed before an audience can be included in a campaign or used for bid adjustments; smaller lists still work for exclusions. Audiences are not available for campaigns that deliver in the European Economic Area or Switzerland, and the feature has to be enabled on your OpenAI ad account. Only upload first-party data you have the right to use for advertising.


Conversion tracking

The Tracking tab sets up an OpenAI pixel and a server-side key, and gives you the snippets to paste on your site: the install snippet for every page, a conversion snippet for the page where the action happens, and an optional advanced-matching snippet for sites that already know who the visitor is. In a purchase, each item's amount is the price of one unit and the event's amount is the total. The tab reads in sections (Setup, Conversions, Snippets, Install check, Test event); Test event sends a sample server-side event in test mode; you can type customer details and they are hashed in your browser the way OpenAI expects.

Check the install fetches one of your pages and tells you whether the pixel can run there. Click Watch for events under it and the events OpenAI receives from your pixel and your server show up as they arrive, for five minutes, so you can test a purchase and see it land.

Already using a measurement partner? AppsFlyer, Adjust, Branch, Singular, Kochava, Airbridge, Tenjin, Triple Whale, Northbeam, DV Rockerbox, Fospha, Measured, INCRMNTAL, Hightouch, Tealium and LiveRamp can send your conversions to ChatGPT Ads too. If a partner and your server both send the same purchase, OpenAI counts it twice unless both carry the same event ID. Send each event from one place, or give both the same order or event ID.

The Conversions tab shows what OpenAI credited to your ads over the last 7 or 30 full days:

  • Attribution settings at the top: the click window (7, 14 or 30 days), whether conversions after seeing an ad count (1 day), and whether a conversion is filed on the ad's day or the conversion's. The defaults are Ads Manager's, so the numbers match it.

  • Tiles: conversions (from a click plus after seeing an ad), from a click, after seeing an ad, attributed sales, cost per conversion and ROAS. Billing and conversion bidding count only conversions from a click.

  • Warnings, each with a button to fix it: no events in the period, a campaign bidding for conversions without a conversion event, campaigns or ads that are not delivering. On that last one, See why opens the ad's preview in Campaigns > Ads, with the reasons it isn't delivering listed at the top.

  • Below them, three sections: Breakdown, a table by campaign, ad group, or ad; Trend and goals, each attributed event by day and how many active campaigns bid for conversions; and the Delivery log of what your server forwarded.

The same numbers, with conversions, cost per conversion and ROAS, appear in the Overview and Campaigns tables (last 30 full days) and in each campaign's breakdown.


Disconnecting

Only the brand owner can disconnect. To remove your OpenAI Ads connection:

  1. Open OpenAI Ads from the sidebar

  2. Click Settings in the top right

  3. Click Disconnect

  4. Confirm

You can also disconnect from the OpenAI Ads card in Integrations > Reach customers. Below the Pro plan the OpenAI Ads page keeps only the connection, with its Disconnect button, so you can always remove your key.

This deletes your saved API key and the campaign, ad and performance data Rank Prompt had cached. Your active campaigns continue running in OpenAI. Only the Rank Prompt sync is removed.


Troubleshooting

"Connection revoked" banner

Your API key was rejected by OpenAI on the last sync. This usually means the key was rotated or deleted in OpenAI. Generate a new key in OpenAI Ads and reconnect from Settings on the OpenAI Ads page.

"Trouble reaching OpenAI Ads" banner

OpenAI did not answer on the last try. The page shows the most recent cached data. Click Refresh, or wait: Rank Prompt tries again on its own, and only warns you when OpenAI keeps failing.

No campaigns showing

Ensure your OpenAI Ads account has at least one campaign created, or click New campaign on the Overview to create one here. If campaigns exist but don't appear, click Refresh to force a fresh fetch.


Plan requirements

OpenAI Ads is available on Pro plan and above.

Plan

OpenAI Ads

Free

No

Starter

No

Pro

Yes

Agency

Yes

Agency Plus

Yes


FAQ

Does connecting Rank Prompt affect my live ads?

No. Rank Prompt reads your campaign data and can help you generate creative, but connecting or disconnecting does not pause, modify, or delete any live campaigns in OpenAI.

Can team members manage OpenAI Ads?

Team members with Editor access can connect an account, manage creative settings, use the Campaigns tab, and manage audiences. Team members with Viewer access can see data but not make changes. Account spend limits are owner-only, and a product feed's upload history shows to editors, because it carries links to the uploaded files. On the Product feeds tab the history is its own section, Upload history, with when each file was uploaded, when OpenAI finished processing it, the rows it took in or rejected, and what to fix.

Why does the Audiences tab say the feature isn't enabled?

OpenAI turns custom audiences on per ad account. Ask your OpenAI account team to enable them; nothing needs to change in Rank Prompt.

Can I see ChatGPT Ads numbers in the API, MCP or Agent Mode?

Yes, from the Pro plan. The API and MCP read performance, attributed conversions and campaigns with the read:ads scope, and Agent Mode can answer questions about them. Keys and MCP connections made before October 2026 need a new key or a reconnect to get the scope.

Do I need separate API keys per brand?

Yes. Each brand in Rank Prompt has its own OpenAI Ads connection with its own API key, matching each brand to its corresponding OpenAI Ads account.


Next steps

  • Integrations overview: all available integrations

  • Credit usage: how credits work


Questions?

Email [email protected] and I'll help.

Did this answer your question?
😞
😐
😁