TikTok Events API con Beaconry: ttclid entra, catorce eventos salen

TikTok Events API 2.0 sobre el endpoint REST de WordPress. Pixel ID + access token, ttclid auto-capturada de la URL, los 14 eventos estándar listos out of the box. Ninguno de los defaults "Recommended" arriesgados RGPD de TikTok es necesario.

Setup, dos strings

Pixel ID y access token. Genera ambos en TikTok Ads Manager → Tools → Events → Web Events. Usa el método de conexión "TikTok Pixel + Events API (Recommended)" para mantener el modo híbrido disponible. Salta el snippet HTML del pixel del navegador, Beaconry no lo necesita.

Pega ambos en Beaconry → Tracking → TikTok, guarda. Haz clic en "Enviar evento de prueba TikTok". HTTP 200 con code: 0 significa que las credenciales funcionan.

ttclid: la señal de atribución más fuerte de TikTok

Cuando un visitante aterriza desde un anuncio de TikTok, la URL tiene ?ttclid=.... Beaconry la captura en el primer page-view, la persiste en la cookie first-party nl_ext (gated por consentimiento, expira a 90 días, scoped a tu dominio). Cada evento server-side posterior incluye ttclid en el payload de Events API, sin importar cuántas páginas haya navegado el visitante en medio.

Para el matching de TikTok, ttclid es la señal más fuerte. Mejor que PII hasheada, mejor que IP+UA. Si solo pudieras enviar una señal, ttclid sería la elección correcta. Beaconry envía ttclid más todo lo demás, así que no tienes que elegir.

14 eventos out of the box

Los 14 eventos estándar de TikTok están soportados con auto-mapeo desde eventos de WordPress. Los más usados:

• Pageview en cada page-load consentido.
• ViewContent al 50 % scroll + 10 segundos de engagement.
• AddToCart, InitiateCheckout, AddPaymentInfo, CompletePayment de WooCommerce.
• Lead de envíos de formulario Kadence/Fluent.
• CompleteRegistration del hook user-register de WP.
• Subscribe de eventos de formulario newsletter.
• Más Search, Contact, Download, ClickButton, AddToWishlist para casos nicho.

Lo que Beaconry pone en OFF por ti

El wizard de onboarding de TikTok intenta dejar activos por defecto tres toggles arriesgados RGPD. Los defaults de Beaconry los esquivan todos:

• Automatic Advanced Matching off. Beaconry hashea los mismos campos server-side bajo tu control, solo en envíos de formulario reales.
• Cookies first-party (gestionadas por TikTok) off. La cookie _ttp solo se setea si activas el modo híbrido explícitamente, e incluso entonces vía el nl-data-gate gated por consentimiento.
• Enhanced data postback off. Los eventos de Beaconry son explícitos y auditables, no se envía ningún "contexto adicional" opaco.

Tú sigues poniendo estos toggles dentro de la UI de TikTok (Beaconry no puede togglear settings del lado Meta o TikTok), pero la documentación deja claro qué apagar. Mira el artículo de TikTok Events API para el recorrido completo.

Modo híbrido, opcional

Para TikTok, el modo híbrido carga el pixel del navegador junto al dispatch server-side. Ambos disparan el mismo evento con la misma event_id, TikTok deduplica dentro de una ventana de 24 horas. Boost de match-rate cuando las cookies first-party del visitante (_ttp) están disponibles.

Apagado por defecto, recomendado encendido para audiencias retail B2C con tasas de adblock bajas. Salta para audiencias B2B y dev (el pixel del navegador se bloquea de todas formas).

Lo que sigues configurando en TikTok

• Test Event Code para staging. Genéralo en TikTok Events Manager → Test Events. Pégalo en el campo Test Event Code de Beaconry. Quítalo antes del lanzamiento.
• Ventanas de atribución de conversión, configuradas en tu nivel de campaña. TikTok por defecto: 7 días click + 1 día view; las campañas B2B suelen beneficiarse de ventanas de 28 días click.

Para llevar

TikTok con Beaconry es el más limpio de los cinco canales: dos strings que pegar, ttclid auto-capturada, 14 eventos auto-mapeados, ninguno de los defaults invasivos de TikTok requeridos. El artículo sobre defaults de onboarding TikTok cubre las elecciones de configuración en la UI de TikTok; este artículo trata sobre lo que Beaconry hace de tu lado.