Saltar al contenido
Tecrübetecrube.com
Herramientas del asistente · Configuración y campañas

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éditos

Cuentas 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éditos

Campañ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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas
statusOpcionalactive | paused | archived—
nameOpcionalstringfiltrar por nombre de campaña (mín. 3 caracteres)

openai_ads_performance_report

Lectura2 créditos

Informe 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas
levelOpcionalad_account | campaign | ad_group | ad—
daysOpcionalinteger (1–365)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
dailyOpcionalboolean—
campaign_idsOpcionalarray<string>—

chatgpt_ads_details

Lectura1 créditos

Todos 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas
idObligatoriostringcmpn_…, adgrp_… o ad_…
hints_limitOpcionalinteger (1–2000)—
hints_offsetOpcionalinteger (0–…)—

chatgpt_ads_geo_lookup

Lectura1 créditos

Busca 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas
queryObligatoriostring—
limitOpcionalinteger (1–100)—

chatgpt_ads_insights

Lectura2 créditos

Informe 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas
scope_idOpcionalstringid cmpn_/adgrp_/ad_ opcional para acotar el informe
levelOpcionalad_account | campaign | ad_group | ad—
daysOpcionalinteger (1–365)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
granularityOpcionalnone | hourly | daily | monthly—
segmentOpcionalnone | country | device | platform | product—
include_zeroOpcionalbooleanañade filas sin impresiones (sin segmento)
conversionsOpcionalbooleanañade conversiones, CPA, CVR, ventas atribuidas y ROAS
limitOpcionalinteger (1–2000)—
offsetOpcionalinteger (0–…)—

chatgpt_ads_spend_limits

Lectura1 créditos

Lí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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas

chatgpt_ads_conversion_setup

Lectura1 créditos

Seguimiento 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas
check_recent_eventsOpcionalboolean—

chatgpt_ads_ad_preview

Lectura1 créditos

Muestra 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas
ad_idObligatoriostring—

list_chatgpt_ads_custom_audiences

Lectura1 créditos

Lista las audiencias personalizadas de ChatGPT Ads de la cuenta: ID, nombre, estado y revisión. Solo lectura.

ParámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — required only when several ChatGPT Ads accounts are connected

diagnose_chatgpt_ads_delivery

Lectura2 créditos

Explica 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas
campaign_idOpcionalstring—
check_landing_pagesOpcionalboolean—

Herramientas de escritura14 herramientas

update_openai_ads_campaign_status

Escritura2 créditos

Pausa 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas
campaign_idObligatoriostringcmpn_…
statusObligatoriopause | 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éditos

Establece 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas
campaign_idObligatoriostringcmpn_…
daily_budgetObligatorionumbernuevo 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éditos

Conecta 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ámetroTipoDescripción
api_keyOpcionalstringclave de la API de OpenAI Ads de una cuenta publicitaria
confirmOpcionalboolean—

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éditos

Lista 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ámetroTipoDescripción
actionOpcionallist | recheck | disconnect | set_default—
ad_account_idOpcionalstringadacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas
confirmOpcionalboolean—

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éditos

Crea 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas
nameObligatoriostring—
daily_budgetOpcionalnumber—
lifetime_budgetOpcionalnumber—
objectiveOpcionalimpressions | clicks | conversions—
descriptionOpcionalstring—
include_locationsOpcionalarray<string>id de ubicación de chatgpt_ads_geo_lookup
exclude_locationsOpcionalarray<string>id de ubicación de chatgpt_ads_geo_lookup
platformsOpcionalarray<ios_app | android_app | web | desktop_web | ios_web | android_web>—
custom_audience_idsOpcionalarray<string>—
excluded_custom_audience_idsOpcionalarray<string>—
startOpcionalstringfecha y hora ISO 8601 (UTC si no hay desfase)
endOpcionalstringfecha y hora ISO 8601 (UTC si no hay desfase)
conversion_event_setting_idsOpcionalarray<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éditos

Cambia 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas
campaign_idObligatoriostring—
nameOpcionalstring—
daily_budgetOpcionalnumber—
lifetime_budgetOpcionalnumber—
statusOpcionalactive | paused—
include_locationsOpcionalarray<string>id de ubicación de chatgpt_ads_geo_lookup
exclude_locationsOpcionalarray<string>id de ubicación de chatgpt_ads_geo_lookup
locations_modeOpcionalreplace | add | remove—
platformsOpcionalarray<ios_app | android_app | web | desktop_web | ios_web | android_web>—
startOpcionalstringfecha y hora ISO 8601 (UTC si no hay desfase)
endOpcionalstringfecha y hora ISO 8601 (UTC si no hay desfase)
conversion_event_setting_idsOpcionalarray<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éditos

Crea 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas
campaign_idObligatoriostring—
nameObligatoriostring—
max_bidOpcionalnumbermoneda de la cuenta: CPM con facturación por impresiones, CPC por clics, CPA en campañas de conversión
billing_eventOpcionalimpression | click—
strategyOpcionalfixed_bid | maximize_clicks | maximize_conversions—
allow_high_bidOpcionalboolean—
context_hintsOpcionalarray<string>—
descriptionOpcionalstring—

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éditos

Cambia 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas
ad_group_idObligatoriostring—
nameOpcionalstring—
max_bidOpcionalnumber—
strategyOpcionalfixed_bid | maximize_clicks | maximize_conversions—
allow_high_bidOpcionalboolean—
context_hintsOpcionalarray<string>—
hints_modeOpcionalreplace | 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éditos

Crea 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas
ad_group_idObligatoriostring—
nameObligatoriostring—
titleObligatoriostring3-50 caracteres
bodyObligatoriostringmáx. 100 caracteres
target_urlObligatoriostring—
image_urlOpcionalstringimagen https pública; OpenAI la descarga
file_idOpcionalstring—

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éditos

Cambia 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas
ad_idObligatoriostring—
nameOpcionalstring—
titleOpcionalstring—
bodyOpcionalstring—
target_urlOpcionalstring—
image_urlOpcionalstring—

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éditos

Pausa, 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas
kindOpcionalcampaign | ad_group | ad—
idObligatoriostring—
actionObligatoriopause | 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éditos

Crea 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — solo es obligatorio si hay varias cuentas de ChatGPT Ads conectadas
nameObligatoriostring—
event_typeObligatoriopage_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_idObligatoriostringid de la fuente de píxel (clidsrc_…)
custom_event_nameOpcionalstring—

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éditos

Crea 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
actionObligatoriocreate | add | remove | archive—
audience_idOpcionalstringcaud_… (not for create)
nameOpcionalstring—
descriptionOpcionalstring—
emailsOpcionalarray<string>hashed before sending
phonesOpcionalarray<string>+country code; hashed before sending
gaidsOpcionalarray<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éditos

Crea, 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ámetroTipoDescripción
ad_account_idOpcionalstringadacct_… — obligatorio solo cuando hay varias cuentas de ChatGPT Ads conectadas
actionObligatoriocreate | update | delete | set_daily | delete_daily—
window_idOpcionalstring—
start_dateOpcionalstringYYYY-MM-DD, inclusive
end_dateOpcionalstringYYYY-MM-DD, exclusivo
amountOpcionalnumbermoneda de la cuenta
nameOpcionalstring—
io_idOpcionalstring—
no_end_dateOpcionalbooleanlí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.