Herramientas de Pinterest
Cuentas publicitarias, campañas e informes de rendimiento de Pinterest; los cambios de estado y presupuesto 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_pinterest_ad_accounts
Lectura1 créditosCuentas de Pinterest Ads accesibles con el inicio de sesión de Pinterest conectado: account_id, nombre, moneda, país, zona horaria, permisos y cuál está seleccionada. Solo lectura; connected=false si Pinterest no está conectado.
Esta herramienta no recibe parámetros.
list_pinterest_campaigns
Lectura1 créditosCampañas de Pinterest Ads de la cuenta: id, nombre, estado, objetivo, presupuesto diario y total (moneda de la cuenta), además de gasto, impresiones de pago, clics de pago y conversiones de los últimos N días (máx. 90). Por defecto, activas y en pausa. Solo lectura; una métrica null significa que Pinterest no devolvió ningún valor, nunca se inventan cifras.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión |
daysOpcional | integer (1–90) | últimos N días en UTC, incluido hoy (por defecto 30) |
statusOpcional | active | paused | archived | draft | — |
pinterest_performance_report
Lectura1 créditosRendimiento de Pinterest Ads de la cuenta o por campaña: gasto (moneda de la cuenta), impresiones de pago, clics de pago, conversiones, CTR y CPC, en total o por día, semana o mes, hasta 90 días. Solo lectura; nunca se inventan cifras.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión |
daysOpcional | integer (1–90) | últimos N días en UTC, incluido hoy (por defecto 30) |
start_dateOpcional | string | YYYY-MM-DD (UTC), como máximo 90 días atrás; se usa con end_date |
end_dateOpcional | string | YYYY-MM-DD (UTC), como máximo 90 días después de start_date |
levelOpcional | account | campaign | — |
granularityOpcional | total | day | week | month | — |
campaign_idsOpcional | array<string> | solo con level=campaign; por defecto: las campañas activas y en pausa de la cuenta |
diagnose_pinterest_delivery
Lectura1 créditosDiagnóstico de entrega EN VIVO de una campaña de Pinterest Ads. Llámala primero cuando el usuario informe de que la campaña no se entrega, está en pausa, pendiente o rechazada. Lee la campaña, sus grupos de anuncios (estado resumido, presupuesto, estrategia de puja, puja, objetivo de CPA, modo de aprendizaje) y anuncios (estado de revisión, motivos de rechazo); devuelve una lista de hallazgos (ámbito, código de Pinterest, categoría, evidencia) y cannot_read con lo que la API no expone. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión |
campaign_idObligatorio | string | id de campaña de Pinterest (list_pinterest_campaigns) |
Herramientas de escritura5 herramientas
update_pinterest_campaign_status
Escritura2 créditosPausa o activa una campaña de Pinterest Ads. Se aplica cuando el usuario lo pide, queda en el registro de auditoría y se puede deshacer con undo_action.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión |
campaign_idObligatorio | string | — |
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_pinterest_campaign_budget
Escritura2 créditosEstablece el presupuesto diario de una campaña de Pinterest Ads (moneda de la cuenta). Solo funciona en campañas con presupuesto diario a nivel de campaña; se rechazan las campañas con presupuesto total o con presupuesto en el grupo de anuncios. Se bloquean los aumentos superiores al 50 % por cambio o 2× en 24 horas; se puede deshacer con undo_action.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión |
campaign_idObligatorio | string | — |
daily_budgetObligatorio | number | nuevo presupuesto diario en la moneda de la cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_pinterest_campaign
Escritura5 créditosCrea una campaña de Pinterest con su grupo de anuncios y, si se indica un id de pin, el anuncio; los tres se crean en pausa. El presupuesto diario está en el grupo de anuncios (flujo sin CBO de Pinterest). Se aplica cuando el usuario lo pide; para publicarla, update_pinterest_campaign_status.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión |
nameObligatorio | string | — |
daily_budgetObligatorio | number | — |
objective_typeOpcional | AWARENESS | CONSIDERATION | WEB_CONVERSION | CATALOG_SALES | VIDEO_COMPLETION | SALES | LEADS | — |
billable_eventOpcional | CLICKTHROUGH | IMPRESSION | VIDEO_V_50_MRC | — |
pin_idOpcional | string | pin que se va a promocionar; sin él solo se crean la campaña y el grupo de anuncios |
creative_typeOpcional | REGULAR | VIDEO | SHOPPING | CAROUSEL | IDEA | COLLECTION | — |
destination_urlOpcional | string | — |
bidOpcional | number | — |
placement_groupOpcional | ALL | SEARCH | BROWSE | OTHER | — |
ad_group_nameOpcional | string | — |
ad_nameOpcional | string | — |
audienceOpcional | object | countries, age_min, age_max, genders, locales |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
send_pinterest_conversion_event
Escritura1 créditosEnvía a Pinterest un evento de conversión del lado del servidor (Conversions API): las compras y los registros se miden aunque la etiqueta del navegador esté bloqueada. El correo y el teléfono se normalizan y se cifran con SHA-256 dentro de Tecrübe; usar el mismo event_id que la etiqueta evita el doble recuento.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión |
event_nameObligatorio | add_to_cart | checkout | custom | lead | page_visit | search | signup | view_category | watch_video | add_payment_info | initiate_checkout | subscribe | — |
action_sourceOpcional | web | app_android | app_ios | offline | — |
emailOpcional | string | — |
phoneOpcional | string | — |
external_idOpcional | string | — |
client_ip_addressOpcional | string | — |
client_user_agentOpcional | string | — |
event_idOpcional | string | id compartido con la etiqueta de Pinterest para evitar el doble recuento |
event_timeOpcional | integer | — |
event_source_urlOpcional | string | — |
valueOpcional | number | — |
currencyOpcional | string | — |
order_idOpcional | string | — |
testOpcional | boolean | valida la petición pero no registra el evento |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_pinterest_audience
Escritura2 créditosCrea o elimina una audiencia de Pinterest: visitantes del sitio desde la etiqueta, personas que interactuaron con la cuenta, una lista de clientes o una audiencia similar (actalike). Tarda horas en llenarse. Se aplica cuando el usuario lo pide.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión |
actionOpcional | create | delete | — |
nameOpcional | string | — |
audience_typeOpcional | VISITOR | ENGAGEMENT | CUSTOMER_LIST | ACTALIKE | — |
descriptionOpcional | string | — |
audience_idOpcional | string | — |
ruleOpcional | object | audience rule, e.g. {"visitor_source_id": "<tag id>"} |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.