ChatGPT Ads tools
ChatGPT ad accounts connected with the OpenAI Ads API: campaign list, performance report, budget and status changes.
Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind der englische Originaltext, den der Assistent sieht.
Lese-Tools3 Tools
list_openai_ads_accounts
Lesen1 CreditsConnected 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.
Dieses Tool hat keine Parameter.
list_openai_ads_campaigns
Lesen1 CreditsChatGPT 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
statusOptional | active | paused | archived | — |
nameOptional | string | filter by campaign name (min 3 chars) |
openai_ads_performance_report
Lesen2 CreditsChatGPT 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
levelOptional | ad_account | campaign | ad_group | ad | — |
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
dailyOptional | boolean | — |
campaign_idsOptional | array<string> | — |
Schreib-Tools2 Tools
update_openai_ads_campaign_status
Schreiben2 CreditsPause 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
campaign_idPflicht | string | cmpn_… |
statusPflicht | pause | activate | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_openai_ads_campaign_budget
Schreiben2 CreditsSet 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.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
campaign_idPflicht | string | cmpn_… |
daily_budgetPflicht | number | new daily budget in the account currency (not micros) |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.