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

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

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

Campañ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ámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión
daysOpcionalinteger (1–90)últimos N días en UTC, incluido hoy (por defecto 30)
statusOpcionalactive | paused | archived | draft—

pinterest_performance_report

Lectura1 créditos

Rendimiento 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ámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión
daysOpcionalinteger (1–90)últimos N días en UTC, incluido hoy (por defecto 30)
start_dateOpcionalstringYYYY-MM-DD (UTC), como máximo 90 días atrás; se usa con end_date
end_dateOpcionalstringYYYY-MM-DD (UTC), como máximo 90 días después de start_date
levelOpcionalaccount | campaign—
granularityOpcionaltotal | day | week | month—
campaign_idsOpcionalarray<string>solo con level=campaign; por defecto: las campañas activas y en pausa de la cuenta

diagnose_pinterest_delivery

Lectura1 créditos

Diagnó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ámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión
campaign_idObligatoriostringid de campaña de Pinterest (list_pinterest_campaigns)

Herramientas de escritura5 herramientas

update_pinterest_campaign_status

Escritura2 créditos

Pausa 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ámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Pinterest; 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_pinterest_campaign_budget

Escritura2 créditos

Establece 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ámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión
campaign_idObligatoriostring—
daily_budgetObligatorionumbernuevo 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éditos

Crea 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ámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión
nameObligatoriostring—
daily_budgetObligatorionumber—
objective_typeOpcionalAWARENESS | CONSIDERATION | WEB_CONVERSION | CATALOG_SALES | VIDEO_COMPLETION | SALES | LEADS—
billable_eventOpcionalCLICKTHROUGH | IMPRESSION | VIDEO_V_50_MRC—
pin_idOpcionalstringpin que se va a promocionar; sin él solo se crean la campaña y el grupo de anuncios
creative_typeOpcionalREGULAR | VIDEO | SHOPPING | CAROUSEL | IDEA | COLLECTION—
destination_urlOpcionalstring—
bidOpcionalnumber—
placement_groupOpcionalALL | SEARCH | BROWSE | OTHER—
ad_group_nameOpcionalstring—
ad_nameOpcionalstring—
audienceOpcionalobjectcountries, 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éditos

Enví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ámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión
event_nameObligatorioadd_to_cart | checkout | custom | lead | page_visit | search | signup | view_category | watch_video | add_payment_info | initiate_checkout | subscribe—
action_sourceOpcionalweb | app_android | app_ios | offline—
emailOpcionalstring—
phoneOpcionalstring—
external_idOpcionalstring—
client_ip_addressOpcionalstring—
client_user_agentOpcionalstring—
event_idOpcionalstringid compartido con la etiqueta de Pinterest para evitar el doble recuento
event_timeOpcionalinteger—
event_source_urlOpcionalstring—
valueOpcionalnumber—
currencyOpcionalstring—
order_idOpcionalstring—
testOpcionalbooleanvalida 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éditos

Crea 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ámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Pinterest; por defecto: la cuenta seleccionada en la conexión
actionOpcionalcreate | delete—
nameOpcionalstring—
audience_typeOpcionalVISITOR | ENGAGEMENT | CUSTOMER_LIST | ACTALIKE—
descriptionOpcionalstring—
audience_idOpcionalstring—
ruleOpcionalobjectaudience 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.