Snapchat, Snap Pixel y Conversions API

Tracking de conversiones server-side para Snapchat Ads. Snap Pixel-ID emparejado con un token de Conversions API. Modo híbrido opcional carga el Snap Pixel de navegador para cookies first-party. Deduplicado vía event_id dentro de la ventana de 48 horas de Snapchat.

Requisitos

• Cuenta de Snapchat Ads Manager con rol Admin u Operator sobre el Ad Account.
• Snap Pixel existente asociado a tu dominio.
• Aproximadamente 5 minutos.

1. Localizar el Snap Pixel-ID

• Abre Snapchat Ads Manager en ads.snapchat.com.
• Events Manager → Web Events.
• Selecciona el Snap Pixel para este dominio. Si no existe ninguno, créalo en + New Pixel.
• El Pixel-ID (formato UUID, 36 caracteres con guiones) aparece en el header del Pixel. Cópialo.

2. Generar un token CAPI de larga duración

• En la misma página del Pixel: Settings → Conversions API → Generate token.
• Snapchat emite un token de larga duración, scoped al Pixel, con el claim snapchat-marketing-api. En operación normal no caduca, pero puede revocarse manualmente.
• El token se muestra UNA vez. Cópialo inmediatamente. No hay mecanismo de recuperación posterior, tendrías que revocar y regenerar.

3. Pegar credenciales en Beaconry

WordPress Admin → Beaconry → Tracking → Snapchat. Pega Snap Pixel-ID y token CAPI, guarda.

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

4. (Opcional) Definir un Test Event Code

La CAPI de Snapchat acepta un campo test_event_code por evento. En Events Manager → Test events, copia el código SC_TEST_* que Snap muestra para tu Pixel. Pégalo en Beaconry. Mientras esté definido, los eventos aparecen en 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 Snapchat. Beaconry dispara un PAGE_VIEW síncrono vía CAPI y reporta la respuesta inline.

HTTP 200 con "status": "SUCCESS" significa que las credenciales funcionan. Con Test Event Code definido, el evento aparece en Events Manager → Test events en pocos segundos. Sin código, Snapchat agrega con hasta 30 minutos de latencia antes de que el evento aparezca en el reporting.

Sobre el click identifier

Snapchat añade ?sc_at=... (el Snap Click ID) a cada landing URL de clic-de-anuncio. Beaconry lo captura en la primera carga y lo persiste en la cookie nl_ext junto a fbclid, gclid, ttclid y msclkid. Cada evento server-side incluye entonces click_id para una atribución limpia. Sin sc_at en la sesión, Snapchat cae a matching por PII hasheado (email, teléfono), sigue funcionando pero con menor confidence.

Modo híbrido, Snap Pixel

CAPI server-side por sí sola cubre el 100 por ciento de los visitantes con consentimiento. El modo híbrido carga el Snap Pixel de navegador (sc-static.net/scevent.min.js) en paralelo para que Snapchat vea la cookie first-party _scid. Beaconry envía el mismo event_id por evento desde ambos lados. Snapchat deduplica para evitar doble conteo dentro de una ventana de 48 horas.

Activar en Beaconry → Tracking → Snapchat → 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 eventos canónicos GA4 al vocabulario estándar de Snapchat:

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

Troubleshooting

• "AUTHORIZATION_FAILED": token revocado o generado bajo otro Pixel. Regenera en la página Settings del Pixel y reemplaza en Beaconry.
• "INVALID_PIXEL_ID": el Pixel-ID perdió los guiones del UUID. Snap solo acepta el formato UUID canónico. Vuelve a copiarlo desde Events Manager con guiones.
• Eventos aceptados pero sin atribución: el visitante nunca llegó con ?sc_at=.... Las visitas directas no lo tienen. El fallback de Snapchat necesita email o teléfono hasheado en el evento, lo que Beaconry envía automáticamente cuando WooCommerce o un formulario los aportan.
• El contador se dispara tras activar el modo híbrido: la deduplicación opera en una ventana de 48 horas por event_id. Verifica que el mismo ID está logueado en Beaconry y en el debugger del Snap Pixel para la misma sesión.