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

Herramientas de Snapchat

Cuentas publicitarias, campañas e informes de rendimiento de Snapchat; los cambios de estado y presupuesto diario pasan por vista previa y aprobación y se pueden deshacer.

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 lectura4 herramientas

list_snapchat_ad_accounts

Lectura1 créditos

Cuentas de Snapchat Ads accesibles con el inicio de sesión conectado, en todas sus organizaciones: account_id, nombre, moneda, zona horaria, estado, organización y cuál está seleccionada. Solo lectura; connected=false si Snapchat no está conectado.

Esta herramienta no recibe parámetros.

list_snapchat_campaigns

Lectura1 créditos

Campañas de Snapchat Ads de la cuenta: id, nombre, estado, objetivo, presupuesto diario y límite de gasto total (moneda de la cuenta), calendario, estado de entrega, además de gasto, impresiones, swipes y conversiones de compra de los últimos N días completos. Solo lectura; nunca inventa cifras (stats=null si Snapchat no devolvió ninguna).

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Snapchat; por defecto: la cuenta seleccionada en la conexión
daysOpcionalinteger (1–31)últimos N días completos, terminando ayer; por defecto 7
statusOpcionalactive | paused—

snapchat_performance_report

Lectura1 créditos

Rendimiento de Snapchat Ads de hasta 31 días completos en la zona horaria de la cuenta: totales, desglose por campaña y filas diarias opcionales con gasto, impresiones, swipes, compras, valor de compra y añadidos al carrito. No incluye el día de hoy. Solo lectura; nunca inventa cifras.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Snapchat; por defecto: la cuenta seleccionada en la conexión
daysOpcionalinteger (1–31)últimos N días completos, terminando ayer; por defecto 7
campaign_idOpcionalstringlimita el informe a una campaña
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD; como máximo ayer
granularityOpcionaltotal | daypor defecto total

diagnose_snapchat_delivery

Lectura1 créditos

Diagnóstico de entrega EN VIVO de una campaña de Snapchat Ads. Llámala primero cuando el usuario informe de que la campaña no se entrega, está en pausa, pendiente, limitada o rechazada. Lee la cuenta publicitaria, la campaña, sus conjuntos de anuncios (códigos de estado de entrega, presupuesto, estrategia de puja, puja, valor de ROAS, ritmo) y anuncios (estado de revisión y motivos de rechazo), además del registro de cambios de la campaña y la estimación de puja de Snap; devuelve una lista de hallazgos (ámbito, código de Snap, categoría, evidencia) y cannot_read con lo que no se leyó. Solo lectura.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Snapchat; por defecto: la cuenta seleccionada en la conexión
campaign_idObligatoriostringid de campaña de Snapchat (list_snapchat_campaigns)

Herramientas de escritura3 herramientas

update_snapchat_campaign_status

Escritura2 créditos

Pausa o activa una campaña de Snapchat Ads. Se aplica cuando el usuario lo pide, queda en el registro de auditoría y se puede deshacer con undo_action.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Snapchat; por defecto: la cuenta seleccionada en la conexión
campaign_idObligatoriostring—
statusObligatoriopause | activate—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_snapchat_campaign_budget

Escritura2 créditos

Establece el presupuesto diario de una campaña de Snapchat Ads (moneda de la cuenta, mínimo 20). Se bloquean los aumentos superiores al 50 % por cambio o 2× en 24 horas; se puede deshacer con undo_action si la campaña ya tenía un presupuesto diario.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Snapchat; por defecto: la cuenta seleccionada en la conexión
campaign_idObligatoriostring—
daily_budgetObligatorionumbernuevo presupuesto diario en la moneda de la cuenta, mínimo 20

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_snapchat_campaign

Escritura5 créditos

Crea una campaña de Snapchat junto con su grupo de anuncios (segmentación, presupuesto, objetivo de optimización, estrategia de puja); ambos se crean en pausa. El anuncio necesita antes una creatividad subida a Snapchat, por lo que no se crea aquí. Se aplica cuando el usuario lo pide; para publicarla, update_snapchat_campaign_status.

ParámetroTipoDescripción
account_idOpcionalstringSnapchat ad account id; defaults to the connection's selected account
nameObligatoriostring—
daily_budgetObligatorionumberen la moneda de la cuenta, mínimo 5 (el límite de Snapchat es 5.000.000 micro)
objectiveOpcionalBRAND_AWARENESS | WEB_CONVERSION | APP_INSTALL | APP_CONVERSION | CATALOG_SALES | ENGAGEMENT | LEAD_GENERATION | VIDEO_VIEW | PROMOTE_PLACES | PROMOTE_STORIES—
optimization_goalOpcionalIMPRESSIONS | SWIPES | LANDING_PAGE_VIEW | PIXEL_PAGE_VIEW | PIXEL_ADD_TO_CART | PIXEL_PURCHASE | PIXEL_SIGNUP | LEAD_FORM_SUBMISSIONS | VIDEO_VIEWS | APP_INSTALLS—
bid_strategyOpcionalAUTO_BID | LOWEST_COST_WITH_MAX_BID | TARGET_COST—
bidOpcionalnumber—
pixel_idOpcionalstring—
ad_squad_nameOpcionalstring—
start_timeOpcionalstringISO 8601 UTC, e.g. 2026-12-01T00:00:00.000Z
audienceOpcionalobjectcountries, age_min, age_max, genders

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.