Herramientas de ChatGPT Ads
Cuentas publicitarias de ChatGPT conectadas con la OpenAI Ads API: lista de campañas, informe de rendimiento, cambios de presupuesto y estado.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.
Herramientas de lectura11 herramientas
list_openai_ads_accounts
Lectura1 créditosCuentas de ChatGPT Ads (OpenAI Ads) conectadas: ad_account_id, nombre, moneda, zona horaria, estado de la cuenta y de revisión. Cada cuenta se conecta en el panel con su propia clave de la Ads API. Solo lectura; connected=false si no hay ninguna.
Esta herramienta no recibe parámetros.
list_openai_ads_campaigns
Lectura1 créditosCampañas de ChatGPT Ads desde la OpenAI Ads API: id (cmpn_…), nombre, estado, presupuesto diario o total (moneda de la cuenta), tipo de puja, calendario. Solo lectura; devuelve connected=false si no hay cuenta vinculada.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas |
statusOpcional | active | paused | archived | — |
nameOpcional | string | filtrar por nombre de campaña (mín. 3 caracteres) |
openai_ads_performance_report
Lectura2 créditosInforme de entrega de ChatGPT Ads (OpenAI Ads insights): impresiones, clics, gasto, CTR, CPC, CPM por cuenta, campaña, grupo de anuncios o anuncio para un rango de fechas en la zona horaria de la cuenta, opcionalmente por día. Solo lectura; nunca inventa cifras.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas |
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> | — |
chatgpt_ads_details
Lectura1 créditosTodos los detalles de una campaña de ChatGPT Ads (con sus grupos de anuncios), de un grupo de anuncios (pujas, pistas de contexto, anuncios) o de un anuncio (creatividad, revisión), incluidos los problemas de publicación que informa OpenAI. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas |
idObligatorio | string | cmpn_…, adgrp_… o ad_… |
hints_limitOpcional | integer (1–2000) | — |
hints_offsetOpcional | integer (0–…) | — |
chatgpt_ads_geo_lookup
Lectura1 créditosBusca por nombre los id de ubicación de ChatGPT Ads (países, regiones, mercados, códigos postales) para la segmentación geográfica de campañas. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas |
queryObligatorio | string | — |
limitOpcional | integer (1–100) | — |
chatgpt_ads_insights
Lectura2 créditosInforme de publicación de ChatGPT Ads con las opciones de OpenAI: intervalos por hora/día/mes, desgloses por país/dispositivo/plataforma/producto, filas sin impresiones y métricas de conversión, para la cuenta o para una campaña, grupo de anuncios o anuncio. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas |
scope_idOpcional | string | id cmpn_/adgrp_/ad_ opcional para acotar el informe |
levelOpcional | ad_account | campaign | ad_group | ad | — |
daysOpcional | integer (1–365) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
granularityOpcional | none | hourly | daily | monthly | — |
segmentOpcional | none | country | device | platform | product | — |
include_zeroOpcional | boolean | añade filas sin impresiones (sin segmento) |
conversionsOpcional | boolean | añade conversiones, CPA, CVR, ventas atribuidas y ROAS |
limitOpcional | integer (1–2000) | — |
offsetOpcional | integer (0–…) | — |
chatgpt_ads_spend_limits
Lectura1 créditosLímites de gasto de la cuenta de ChatGPT Ads: ventanas por rango de fechas y límites diarios recurrentes, con el gasto hasta ahora y lo que se puede editar. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas |
chatgpt_ads_conversion_setup
Lectura1 créditosSeguimiento de conversiones de ChatGPT Ads: píxeles (fuentes), ajustes de eventos de conversión y las campañas que los usan, además de los eventos recibidos aproximadamente en los últimos 15 minutos. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas |
check_recent_eventsOpcional | boolean | — |
chatgpt_ads_ad_preview
Lectura1 créditosMuestra cómo se ve un anuncio existente de ChatGPT Ads (vista previa temporal de 24 horas) junto con su estado de revisión y los bloqueos de publicación que informa OpenAI. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas |
ad_idObligatorio | string | — |
list_chatgpt_ads_custom_audiences
Lectura1 créditosLista las audiencias personalizadas de ChatGPT Ads de la cuenta: ID, nombre, estado y revisión. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
diagnose_chatgpt_ads_delivery
Lectura2 créditosExplica por qué los anuncios de ChatGPT Ads no obtienen impresiones: revisa el estado de la cuenta y las revisiones, los límites de gasto y cada campaña, grupo de anuncios y anuncio en busca de problemas de publicación de OpenAI (opcionalmente con rastreo de páginas de destino) y devuelve hallazgos priorizados con evidencia, la solución y la herramienta que la aplica. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas |
campaign_idOpcional | string | — |
check_landing_pagesOpcional | boolean | — |
Herramientas de escritura14 herramientas
update_openai_ads_campaign_status
Escritura2 créditosPausa o activa una campaña de ChatGPT Ads. Devuelve una vista previa y un elemento de aprobación; se aplica en OpenAI solo tras la aprobación y se puede deshacer. La activación inicia la entrega solo cuando se cumplen los demás requisitos de OpenAI (revisiones, presupuesto).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas |
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éditosEstablece el presupuesto diario de una campaña de ChatGPT Ads. Pasa por vista previa y aprobación; se bloquean los aumentos superiores al 50 % por cambio o 2× en 24 horas; deshacer restaura el presupuesto anterior. Las campañas con presupuesto total no se modifican.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas |
campaign_idObligatorio | string | cmpn_… |
daily_budgetObligatorio | number | nuevo presupuesto diario en la moneda de la cuenta (no micros) |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
connect_chatgpt_ads
Escritura0 créditosConecta una cuenta publicitaria de ChatGPT Ads (OpenAI Ads): sin clave explica la ruta del panel; con api_key y confirm=true la clave se verifica con OpenAI y se guarda cifrada (solo propietario/administrador). La clave nunca se muestra de vuelta.
| Parámetro | Tipo | Descripción |
|---|---|---|
api_keyOpcional | string | clave de la API de OpenAI Ads de una cuenta publicitaria |
confirmOpcional | boolean | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_chatgpt_ads_accounts
Escritura0 créditosLista las cuentas de ChatGPT Ads conectadas, vuelve a comprobar una frente a OpenAI (estado, revisión, moneda), la desconecta o la convierte en la predeterminada cuando se omite ad_account_id. Desconectar y fijar como predeterminada requieren confirm=true.
| Parámetro | Tipo | Descripción |
|---|---|---|
actionOpcional | list | recheck | disconnect | set_default | — |
ad_account_idOpcional | string | adacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas |
confirmOpcional | boolean | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_chatgpt_ads_campaign
Escritura8 créditosCrea una campaña de ChatGPT Ads (siempre en pausa) con presupuesto diario o total en la moneda de la cuenta, objetivo, ubicaciones, plataformas, audiencias, calendario y objetivo de conversión. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas |
nameObligatorio | string | — |
daily_budgetOpcional | number | — |
lifetime_budgetOpcional | number | — |
objectiveOpcional | impressions | clicks | conversions | — |
descriptionOpcional | string | — |
include_locationsOpcional | array<string> | id de ubicación de chatgpt_ads_geo_lookup |
exclude_locationsOpcional | array<string> | id de ubicación de chatgpt_ads_geo_lookup |
platformsOpcional | array<ios_app | android_app | web | desktop_web | ios_web | android_web> | — |
custom_audience_idsOpcional | array<string> | — |
excluded_custom_audience_idsOpcional | array<string> | — |
startOpcional | string | fecha y hora ISO 8601 (UTC si no hay desfase) |
endOpcional | string | fecha y hora ISO 8601 (UTC si no hay desfase) |
conversion_event_setting_idsOpcional | array<string> | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_chatgpt_ads_campaign
Escritura5 créditosCambia una campaña de ChatGPT Ads: nombre, presupuesto, ubicaciones (sustituir / añadir / quitar), plataformas, programación, eventos de conversión o estado. Los aumentos de presupuesto de más del 50 % se bloquean. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas |
campaign_idObligatorio | string | — |
nameOpcional | string | — |
daily_budgetOpcional | number | — |
lifetime_budgetOpcional | number | — |
statusOpcional | active | paused | — |
include_locationsOpcional | array<string> | id de ubicación de chatgpt_ads_geo_lookup |
exclude_locationsOpcional | array<string> | id de ubicación de chatgpt_ads_geo_lookup |
locations_modeOpcional | replace | add | remove | — |
platformsOpcional | array<ios_app | android_app | web | desktop_web | ios_web | android_web> | — |
startOpcional | string | fecha y hora ISO 8601 (UTC si no hay desfase) |
endOpcional | string | fecha y hora ISO 8601 (UTC si no hay desfase) |
conversion_event_setting_idsOpcional | array<string> | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_chatgpt_ads_ad_group
Escritura5 créditosCrea en pausa un grupo de anuncios en una campaña de ChatGPT Ads con su estrategia de puja, puja máxima y pistas de contexto (cuándo sería útil el anuncio). Las pujas inusualmente altas requieren allow_high_bid. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas |
campaign_idObligatorio | string | — |
nameObligatorio | string | — |
max_bidOpcional | number | moneda de la cuenta: CPM con facturación por impresiones, CPC por clics, CPA en campañas de conversión |
billing_eventOpcional | impression | click | — |
strategyOpcional | fixed_bid | maximize_clicks | maximize_conversions | — |
allow_high_bidOpcional | boolean | — |
context_hintsOpcional | array<string> | — |
descriptionOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_chatgpt_ads_ad_group
Escritura5 créditosCambia el nombre, la puja máxima, la estrategia de puja o las pistas de contexto (sustituir / añadir / quitar) de un grupo de anuncios de ChatGPT Ads. Los saltos de puja de más del 50 % requieren allow_high_bid. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas |
ad_group_idObligatorio | string | — |
nameOpcional | string | — |
max_bidOpcional | number | — |
strategyOpcional | fixed_bid | maximize_clicks | maximize_conversions | — |
allow_high_bidOpcional | boolean | — |
context_hintsOpcional | array<string> | — |
hints_modeOpcional | replace | add | remove | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_chatgpt_ads_ad
Escritura8 créditosCrea en un grupo de anuncios un anuncio de tarjeta de chat de ChatGPT Ads en pausa (título, cuerpo, destino, imagen); OpenAI lo revisa. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas |
ad_group_idObligatorio | string | — |
nameObligatorio | string | — |
titleObligatorio | string | 3-50 caracteres |
bodyObligatorio | string | máx. 100 caracteres |
target_urlObligatorio | string | — |
image_urlOpcional | string | imagen https pública; OpenAI la descarga |
file_idOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_chatgpt_ads_ad
Escritura5 créditosCambia el texto, el destino o la imagen de un anuncio de ChatGPT Ads (el resto de la creatividad se conserva); una creatividad modificada se revisa de nuevo. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas |
ad_idObligatorio | string | — |
nameOpcional | string | — |
titleOpcional | string | — |
bodyOpcional | string | — |
target_urlOpcional | string | — |
image_urlOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
chatgpt_ads_status
EscrituraIrreversible5 créditosPausa, activa o archiva una campaña, grupo de anuncios o anuncio de ChatGPT Ads. Archivar es irreversible y siempre espera aprobación explícita. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas |
kindOpcional | campaign | ad_group | ad | — |
idObligatorio | string | — |
actionObligatorio | pause | activate | archive | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_chatgpt_ads_event_setting
Escritura5 créditosCrea en una fuente de píxel un ajuste de evento de conversión de ChatGPT Ads (qué evento registrado cuenta como conversión), utilizable como objetivo de campaña. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas |
nameObligatorio | string | — |
event_typeObligatorio | page_viewed | contents_viewed | items_added | checkout_started | order_created | lead_created | registration_completed | subscription_created | trial_started | appointment_scheduled | plan_enrollment | app_installed | app_opened | custom | — |
source_idObligatorio | string | id de la fuente de píxel (clidsrc_…) |
custom_event_nameOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_chatgpt_ads_custom_audience
EscrituraIrreversible5 créditosCrea una audiencia personalizada vacía de ChatGPT Ads, añade o quita miembros y la archiva. Solo datos propios con derecho de uso; correo y teléfono se cifran antes de enviarse. No disponible para campañas en el EEE y Suiza.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
actionObligatorio | create | add | remove | archive | — |
audience_idOpcional | string | caud_… (not for create) |
nameOpcional | string | — |
descriptionOpcional | string | — |
emailsOpcional | array<string> | hashed before sending |
phonesOpcional | array<string> | +country code; hashed before sending |
gaidsOpcional | array<string> | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_chatgpt_ads_spend_limit
EscrituraIrreversible5 créditosCrea, cambia o elimina un límite de gasto de una cuenta de ChatGPT Ads (ventana de rango de fechas o límite diario recurrente). Los aumentos de más del 50 % se bloquean; las eliminaciones siempre esperan una aprobación explícita. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_account_idOpcional | string | adacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas |
actionObligatorio | create | update | delete | set_daily | delete_daily | — |
window_idOpcional | string | — |
start_dateOpcional | string | YYYY-MM-DD, inclusive |
end_dateOpcional | string | YYYY-MM-DD, exclusivo |
amountOpcional | number | moneda de la cuenta |
nameOpcional | string | — |
io_idOpcional | string | — |
no_end_dateOpcional | boolean | límite diario sin fecha de fin |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.