ChatGPT Ads · Adako docs

Connecting

ChatGPT Ads authenticates with an advertiser API key, not OAuth. Copy the key from the ChatGPT Ads Manager under Settings, then open Connections and paste it into the ChatGPT Ads card.

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.

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: campaign, ad group, image upload and one chat card ad, in that order, all paused. 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, bidding, context hints, copy and destination.
Pause and resume at campaign, ad group and ad level.

Archiving is permanent

chatgpt_archive_campaign cannot be undone and needs an explicit confirmation flag. When you mean stop, pause instead: the history stays and it can be resumed.

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 100 characters. They steer where ads appear.

A prompt that works

example

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 lifetime budget is required on a campaign. A daily cap is optional.
The platform floor is 1.00 in the account currency for both limits.
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.