ChatGPT Ads

Connecting

ChatGPT Ads authenticates with an advertiser API key, not OAuth. To get one and connect it:

1. Sign in to ChatGPT Ads Manager at ads.openai.com with the ad account Adako should work on.
2. Open Settings → API keys and create a key. It has to come from Ads Manager: a key from the OpenAI developer platform does not work here.
3. Copy the key, open Accounts and paste it into the ChatGPT Ads card. Adako checks it against the ad account before storing anything.

If Settings has no API keys, the account does not have API access yet. Ask OpenAI for it at developers.openai.com/ads.

One key is one advertiser account. A second account means a second key, pasted separately. The key is encrypted server-side and is never sent to your assistant. Removing it from Adako does not revoke it: delete or rotate it in Ads Manager to retire it everywhere.

The account argument is ad_account_id, a string. Money is a decimal in the account currency; the API takes micros and Adako converts.

What it reads

• The account itself: name, website, currency, timezone, status and the platform’s review verdict (chatgpt_get_account).
• What the account may buy: objectives, what it bids towards, what it is billed on, the minimum spend limit and the creative rules (chatgpt_get_account_limits).
• Campaigns, ad groups and ads with status, bidding, spend limits, schedule, geo targeting and any serving issue the platform reports.
• The review verdict and reason on every ad, which is the first place to look when nothing is delivering.
• Measurement pixels, when each last received an event, and the conversion event settings a conversions campaign optimises towards.
• Performance for a window next to the period before it, by campaign, ad group or ad.

What it writes

• chatgpt_launch_ad: image upload, then campaign, ad group and one chat card ad, in that order. The campaign is paused with the ad group and ad active inside it, so turning it on launches it. Costs 8 tasks.
• chatgpt_create_ad_group and chatgpt_create_ad extend a campaign that already exists. Both paused.
• Update a campaign, ad group or ad: names, status, spend limits, max bid, context hints, copy and destination.
• Pause and resume at campaign, ad group and ad level.

The chat card

One format. chatgpt_validate_chat_card checks all of it before anything is created, and it is free.

• Title: 3 to 50 characters.
• Body: up to 100 characters.
• Destination: an https URL up to 2048 characters.
• Image: square, at least 400 px a side, under 10 MB, JPEG, PNG or WebP. The card crops to a square, so a non-square asset is cropped by the platform rather than by you.
• Context hints: up to 20, each up to 200 characters. They steer where ads appear.

A prompt that works

Draft a ChatGPT Ads campaign for {product}, 200 lifetime budget, running in Germany and Austria.
Validate the chat card first, show me the plan, and create it paused.

Limits worth knowing

• A campaign carries a lifetime budget or a daily budget, never both. A daily budget cannot be switched back to a lifetime one.
• The lifetime floor is 1.00 in the account currency. The daily floor depends on the currency and is not published; Adako remembers the amount the platform names and checks it in the preview from then on.
• Geo targeting is a campaign setting. Without it the platform chooses where the campaign runs. Place names are resolved with chatgpt_geo_lookup before any write.
• Objectives are reach, clicks and conversions. A conversions campaign needs a pixel that fires the chosen event.
• There is no search-term or placement report. The useful breakdown is by ad, and the useful diagnosis is the review verdict.