ChatGPT Ads tools
ChatGPT ad accounts connected with the OpenAI Ads API: campaign list, performance report, budget and status changes.
Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont le texte anglais d'origine vu par l'assistant.
Outils de lecture3 outils
list_openai_ads_accounts
Lecture1 créditsConnected 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.
Cet outil ne prend aucun paramètre.
list_openai_ads_campaigns
Lecture1 créditsChatGPT 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.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
statusFacultatif | active | paused | archived | — |
nameFacultatif | string | filter by campaign name (min 3 chars) |
openai_ads_performance_report
Lecture2 créditsChatGPT 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.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
levelFacultatif | ad_account | campaign | ad_group | ad | — |
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
dailyFacultatif | boolean | — |
campaign_idsFacultatif | array<string> | — |
Outils d'écriture2 outils
update_openai_ads_campaign_status
Écriture2 créditsPause 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.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
campaign_idObligatoire | string | cmpn_… |
statusObligatoire | pause | activate | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_openai_ads_campaign_budget
Écriture2 créditsSet 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.
| Paramètre | Type | Description |
|---|---|---|
ad_account_idFacultatif | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
campaign_idObligatoire | string | cmpn_… |
daily_budgetObligatoire | number | new daily budget in the account currency (not micros) |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.