ChatGPT Ads tools
ChatGPT ad accounts connected with the OpenAI Ads API: campaign list, performance report, budget and status changes.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son el texto original en inglés que ve el asistente.
Herramientas de lectura3 herramientas
list_openai_ads_accounts
Lectura1 créditosConnected 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.
Esta herramienta no recibe parámetros.
list_openai_ads_campaigns
Lectura1 créditosChatGPT 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.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
statusOpcional | active | paused | archived | — |
nameOpcional | string | filter by campaign name (min 3 chars) |
openai_ads_performance_report
Lectura2 créditosChatGPT 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.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
levelOpcional | ad_account | campaign | ad_group | ad | — |
daysOpcional | integer (1–365) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
dailyOpcional | boolean | — |
campaign_idsOpcional | array<string> | — |
Herramientas de escritura2 herramientas
update_openai_ads_campaign_status
Escritura2 créditosPause 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.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
campaign_idObligatorio | string | cmpn_… |
statusObligatorio | pause | activate | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_openai_ads_campaign_budget
Escritura2 créditosSet 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.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
campaign_idObligatorio | string | cmpn_… |
daily_budgetObligatorio | number | new daily budget in the account currency (not micros) |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.