Araç referansı — Reklam

ChatGPT Ads araçları

OpenAI Ads API ile bağlanan ChatGPT reklam hesapları: kampanya listesi, performans raporu, bütçe ve durum değişiklikleri.

Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü özgün İngilizce metinlerdir.

Okuma araçları3 araç

list_openai_ads_accounts

Okuma1 kredi

Connected ChatGPT Ads (OpenAI Ads) accounts: ad_account_id, name, currency, time zone, account and review status. Each account is connected in the panel with its own Ads API key. Read only; connected=false when none.

Bu araç parametre almaz.

list_openai_ads_campaigns

Okuma1 kredi

ChatGPT Ads campaigns from the OpenAI Ads API: id (cmpn_…), name, status, daily or lifetime budget (account currency), bidding type, schedule. Read only; returns connected=false when no account is linked.

Parametre	Tip	Açıklama
`ad_account_id`İsteğe bağlı	string	adacct_… — required only when several ChatGPT Ads accounts are connected
`status`İsteğe bağlı	active \| paused \| archived	—
`name`İsteğe bağlı	string	filter by campaign name (min 3 chars)

openai_ads_performance_report

Okuma2 kredi

ChatGPT Ads delivery report (OpenAI Ads insights): impressions, clicks, spend, CTR, CPC, CPM per account, campaign, ad group or ad for a date range in the account time zone, optionally per day. Read only; never invents numbers.

Parametre	Tip	Açıklama
`ad_account_id`İsteğe bağlı	string	adacct_… — required only when several ChatGPT Ads accounts are connected
`level`İsteğe bağlı	ad_account \| campaign \| ad_group \| ad	—
`days`İsteğe bağlı	integer (1–365)	—
`start_date`İsteğe bağlı	string	YYYY-MM-DD
`end_date`İsteğe bağlı	string	YYYY-MM-DD
`daily`İsteğe bağlı	boolean	—
`campaign_ids`İsteğe bağlı	array<string>	—

Yazma araçları2 araç

update_openai_ads_campaign_status

Yazma2 kredi

Pause or activate a ChatGPT Ads campaign. Returns a preview and an approval item; applied on OpenAI only after approval, and undoable. Activation starts delivery only when OpenAI's other requirements (reviews, budget) are met.

Parametre	Tip	Açıklama
`ad_account_id`İsteğe bağlı	string	adacct_… — required only when several ChatGPT Ads accounts are connected
`campaign_id`Zorunlu	string	cmpn_…
`status`Zorunlu	pause \| activate	—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_openai_ads_campaign_budget

Yazma2 kredi

Set a ChatGPT Ads campaign's daily budget. Goes through preview and approval; increases above 50% per change or 2× within 24 hours are blocked; undo restores the previous budget. Lifetime-budget campaigns are not changed.

Parametre	Tip	Açıklama
`ad_account_id`İsteğe bağlı	string	adacct_… — required only when several ChatGPT Ads accounts are connected
`campaign_id`Zorunlu	string	cmpn_…
`daily_budget`Zorunlu	number	new daily budget in the account currency (not micros)

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.