Pinterest, Tag y Conversions API

Tracking de conversiones server-side vía Pinterest Conversions API. Pinterest Tag-ID emparejado con un conversion access token. Modo híbrido opcional carga el tag de navegador para cookies first-party, deduplicado vía event_id.

Requisitos

• Cuenta de Pinterest Business con acceso de admin al Ad Account.
• Pinterest Tag existente, o permiso para crear uno.
• Aproximadamente 5 minutos.

1. Localizar o crear el Pinterest Tag-ID

• Abre Pinterest Ads Manager en ads.pinterest.com.
• Ads → Conversions → Conversion sources.
• Selecciona el Pinterest Tag para este dominio o pulsa Add conversion source → Pinterest Tag para crear uno.
• El Tag-ID (numérico de 13 dígitos, a veces "TID") aparece en la página de detalle. Cópialo.

2. Generar un conversion access token

• En la misma página del Tag, baja a Generate conversion token (o API access, el wording cambia entre versiones de la UI).
• Pulsa Generate token. El token se muestra UNA vez. Cópialo inmediatamente, no hay forma de recuperarlo después, tendrías que revocar y regenerar.
• El token está ligado al Tag, scope ads:write y no caduca.

3. Pegar credenciales en Beaconry

WordPress Admin → Beaconry → Tracking → Pinterest. Pega Tag-ID y conversion access token, guarda.

El token se guarda cifrado en reposo con AES-256-GCM (ligado a los auth salts de WordPress). Alternativa con constantes: BCNR_PINTEREST_TAG_ID y BCNR_PINTEREST_ACCESS_TOKEN en wp-config.php.

4. (Opcional) Definir un Test Event Code

La CAPI de Pinterest acepta un campo opcional test_event_code en cada evento. Genera uno en Ads Manager → Conversions → Events history → Test events y pégalo en Beaconry. Mientras esté definido, los eventos aparecen en la pestaña Test Events en lugar de irse a producción. Quita el código antes de lanzar la campaña.

5. Enviar el evento de prueba

Pulsa Enviar evento de prueba de Pinterest en la pestaña Tracking. Beaconry dispara un page_visit síncrono vía CAPI y reporta la respuesta inline.

HTTP 200 con num_events_received: 1 significa que las credenciales funcionan. Con Test Event Code definido, el evento aparece en Conversions → Events history → Test events en pocos segundos. Sin código, Pinterest agrega los eventos con hasta 30 minutos de latencia antes de aparecer en el reporting.

Modo híbrido, Pinterest Tag

CAPI server-side por sí sola cubre el 100 por ciento de los visitantes con consentimiento. El modo híbrido carga el Pinterest Tag de navegador (s.pinimg.com/ct/core.js) en paralelo para que Pinterest vea la cookie first-party _pinterest_ct. Beaconry envía el mismo event_id por evento desde ambos lados, Pinterest deduplica para evitar doble conteo.

Activar en Beaconry → Tracking → Pinterest → Modo híbrido. Mejor match-rate, algo más de bytes para el visitante. Apagado por defecto.

Qué se envía automáticamente

Beaconry mapea los nombres canónicos de eventos GA4 al vocabulario estándar de Pinterest:

Todos los payloads llevan PII hasheado (em, ph, ge, ln, fn, ct, st, zp, country) más identificadores first-party (el _pinterest_ct de Pinterest cuando esté disponible, IP y User-Agent).

Troubleshooting

• "Invalid access token": token revocado o generado bajo otro Tag. Regenera en la página del Tag y reemplaza en Beaconry.
• "num_events_received: 0": el Tag-ID y el token pertenecen a Tags distintos. Pinterest liga los tokens por Tag, una pareja cruzada da un HTTP 200 silencioso con cero eventos contados.
• Llegan eventos pero las columnas de ROAS quedan vacías: Pinterest necesita el Product Group ID del catálogo en content_ids para Dynamic Product Ads. Beaconry usa los IDs de producto de WooCommerce por defecto. Si tu catálogo usa otros IDs (Merchant Center, SKUs), define el override en Forms & Commerce → Fuente de Product ID.
• El contador se dispara tras activar el modo híbrido: dedup-mismatch. Comprueba que el mismo event_id aparece en el log de Beaconry (servidor) y en el debugger del Pinterest Tag (navegador) para la misma sesión.