La API de conversiones de TikTok (Events API) debe ejecutarse junto al Pixel y con deduplicación adecuada para recuperar conversiones perdidas y mejorar la optimización. En la práctica, esto significa enviar cada acción por ambos canales con un único event_id. El resultado esperado es más conversiones reportadas y señales más fiables para que el algoritmo optimice las campañas.
En resumen:
- La integración del Event API de TikTok debe hacerse junto con el Pixel y usando un
event_idúnico para evitar duplicados y mejorar la cobertura de conversiones.- Es imprescindible mantener la estructura y el
event_idconsistentes en ambos canales para que funcione correctamente la deduplicación.- Se recomienda enviar eventos en el orden correcto y con identificadores hashados, generando un UUID para eventos no transaccionales y usando
order_idpara compras.- La deduplicación funciona con una ventana de 48 horas, y errores frecuentes incluyen usar diferentes formatos de
event_ido enviarlos solo desde un canal.- La implementación puede hacerse mediante integración directa, GTM en modo servidor o plataformas de gestión, según las necesidades de control y recursos técnicos.
Tabla de contenidos
- Qué es TikTok Events API y cómo complementa al Pixel
- Beneficios clave para la medición y optimización
- Requisitos técnicos y formato mínimo de eventos
- Mapeo de eventos y buenas prácticas para ecommerce
- Deduplicación y eventid: cómo funciona y errores comunes
- Opciones de implementación: API directa, server-side GTM y plataformas
- Privacidad y consentimiento en el EEE: obligaciones y diseño del flujo
- Pruebas y validación en Events Manager antes de activar optimización
- Checklist de despliegue: flujo práctico de implementación paso a paso
- Experiencia práctica en integraciones y optimización para TikTok Shop
- Cuándo externalizar la implementación y cuándo mantenerla in-house
- Oferta de ForLives para implementar conversiones y escalar ventas en TikTok Shop
- Preguntas frecuentes
- Fuentes
Qué es TikTok Events API y cómo complementa al Pixel
Events API es un canal servidor a servidor: enviamos eventos como JSON directamente desde nuestro backend hacia TikTok, sin depender del navegador del usuario. El Pixel, en cambio, se ejecuta en el cliente y por eso pierde eventos cuando intervienen bloqueadores de anuncios, restricciones de navegador o fallos de carga del script.
TikTok recomienda ejecutar ambos canales de forma simultánea, no sustituir uno por otro:
- El Pixel aporta señales de comportamiento en tiempo real y contexto del navegador.
- Events API corrige la pérdida de eventos por bloqueadores, cookies de terceros restringidas o errores de red.
- Juntos, ofrecen una cobertura de conversión más completa para el aprendizaje del algoritmo.
Beneficios clave para la medición y optimización
Combinar ambos canales mejora tres aspectos concretos: cobertura, consolidación y coincidencia de usuarios.
- Capturamos conversiones que el Pixel no registra por bloqueadores o fallos de carga.
- Consolidamos datos de fuentes online, offline y CRM en un mismo flujo de eventos.
- Mejoramos la coincidencia de usuarios enviando identificadores hasheados junto al evento.
TikTok recomienda explícitamente combinar Events API con el Pixel para campañas de conversión web, según la documentación oficial de TikTok For Business, que describe la arquitectura recomendada para capturar conversiones perdidas y consolidar señales de distintas fuentes.
Requisitos técnicos y formato mínimo de eventos
Para que un evento sea procesable, TikTok exige credenciales y una estructura concreta. Obtenemos el Pixel ID y el access token desde Events Manager, y cada solicitud debe incluir event_source, event_source_id y un array data[] con los campos obligatorios por evento.
Los identificadores de usuario (correo, teléfono) deben normalizarse antes de aplicarles SHA-256, y el hash resultante se envía en minúsculas, según especifica el SDK oficial de TikTok Business.
| Campo | Obligatorio | Descripción |
|---|---|---|
pixel_code | sí | identificador del Pixel asociado a la cuenta |
event | sí | nombre del evento (purchase, add_to_cart, etc.) |
timestamp | no | formato ISO 8601, opcional |
event_id | condicional | necesario cuando hay solapamiento con Pixel |
Mapeo de eventos y buenas prácticas para ecommerce
Para que el embudo quede correctamente medido, enviamos los eventos en el orden en que ocurre la navegación real del comprador.
- Registrar
view_itemcuando el usuario visualiza la ficha de producto. - Enviar
add_to_cartcon el identificador de producto y el valor correspondiente. - Capturar
begin_checkoutal iniciar el proceso de pago. - Confirmar
purchaseincluyendovalueycurrency, junto con elorder_idcomoevent_id.
Para eventos no transaccionales como view_item o add_to_cart, generamos un UUID en el momento de la acción y lo llevamos a ambos canales (Pixel y Events API) para asegurar que la deduplicación funcione, tal como recomienda la guía técnica de implementación de Events API. En el caso de purchase, usar el order_id real como event_id evita duplicados cuando el mismo pedido se confirma por dos rutas distintas.
Consejo profesional: verifica que el event_id enviado desde el servidor sea exactamente igual, carácter a carácter, al enviado por el Pixel en el navegador.
Deduplicación y event_id: cómo funciona y errores comunes
La ventana de fusión es de 5 minutos y la de deduplicación completa es de 48 horas: cuando dos eventos coinciden en esas tres variables dentro de ese plazo, se conserva el primero recibido y se descarta el resto, según detalla la guía de EndFrame sobre configuración server-side.
- Usar un
session_iden lugar del identificador de la conversión concreta provoca que eventos distintos se fusionen por error. - Enviar
event_idsolo desde un canal (Pixel o servidor) anula la deduplicación y genera conteos duplicados. - Cambiar el formato del
event_identre entornos (mayúsculas, espacios) rompe la coincidencia exacta que exige TikTok.
La solución práctica es simple: un único event_id por acción de usuario, generado una sola vez y reutilizado en ambos canales. Profundizamos en este mecanismo en nuestra guía sobre cómo evitar la doble contabilización de ventas en TikTok Shop.
Opciones de implementación: API directa, server-side GTM y plataformas
Existen tres rutas habituales, cada una con un equilibrio distinto entre control y velocidad de puesta en marcha.
- La integración directa contra el endpoint de Events API ofrece máximo control del payload, pero exige mantenimiento continuo de código propio.
- Google Tag Manager en modo servidor (sGTM) reduce la carga de desarrollo mediante plantillas, aunque requiere hosting y monitorización del contenedor.
- Plataformas de datos de cliente con un interruptor de destino simplifican el envío, a cambio de menor flexibilidad para personalizar campos.
TikTok mantiene una plantilla oficial para configurar el envío vía GTM, que incluye generación de access token y mapeo de eventos guiado. Para equipos sin ingeniería dedicada, la ruta server-side GTM suele ser el punto de partida más razonable; para operaciones con volumen alto y necesidad de lógica personalizada, la integración directa compensa el esfuerzo adicional.
Privacidad y consentimiento en el EEE: obligaciones y diseño del flujo
Procesar eventos en el servidor no elimina las obligaciones legales de consentimiento. El Comité Europeo de Protección de Datos aclara que el artículo 5(3) de la directiva ePrivacy puede aplicarse a tecnologías similares a las cookies, y que instruir al terminal del usuario para enviar identificadores puede requerir consentimiento aunque el procesamiento final ocurra en servidor.
- El consentimiento debe solicitarse antes de activar el envío de identificadores, no después.
- El diseño del flujo debe permitir granularidad por tipo de dato y registro auditable de cada decisión.
- La arquitectura debe soportar la retirada del consentimiento sin romper el resto de la medición.
Pruebas y validación en Events Manager antes de activar optimización
Antes de usar los datos para optimizar campañas, validamos cada evento con las herramientas que ofrece TikTok.
- Generar un
test_event_codeen Events Manager y usarlo en el Event Builder para confirmar que los eventos llegan correctamente. - Revisar el mapeo de campos, la coincidencia de
order_identre Pixel y servidor, y los avisos deevent_iddesemparejado. - Confirmar que la tasa de coincidencia de usuarios se mantiene estable durante varios días antes de activar la optimización basada en esos eventos.
Solo cuando estas tres comprobaciones son consistentes durante un periodo de observación consideramos la integración lista para producción.
Checklist de despliegue: flujo práctico de implementación paso a paso
El proceso completo, desde cero hasta monitorización en producción, sigue una secuencia concreta.
- Crear o seleccionar el Pixel en Events Manager y generar el access token asociado.
- Definir la estrategia de
event_idpor tipo de evento (UUID para no transaccionales,order_idpara compras). - Implementar el hashing de identificadores, validar con
test_event_codey monitorizar resultados en Events Manager.
Consejo profesional: documenta el esquema de nombres de eventos y propiedades antes de escribir una sola línea de código: ahorra más tiempo que cualquier optimización posterior.
Experiencia práctica en integraciones y optimización para TikTok Shop
Trabajamos auditorías de nicho, integración técnica, optimización de catálogo y producción de contenido shoppable y lives para marcas con producto físico. Nuestro proceso de validación inicial dura 10 días y permite confirmar si un catálogo se adapta a TikTok Shop antes de comprometer presupuesto en campañas de mayor escala.
Cuándo externalizar la implementación y cuándo mantenerla in-house
La decisión depende de tres factores: recursos de ingeniería disponibles, urgencia del lanzamiento y necesidad de auditar cada evento internamente. Mantener la integración en casa tiene sentido si ya existe un equipo técnico dedicado a medición. Externalizar evita invertir en infraestructura propia cuando el objetivo es lanzar rápido; el siguiente paso razonable es solicitar una auditoría de viabilidad antes de decidir.
Oferta de ForLives para implementar conversiones y escalar ventas en TikTok Shop
Si prefieres no montar esta infraestructura por tu cuenta, en ForLives nos encargamos de la integración técnica y la optimización continua como parte de nuestros servicios de agencia, con un proceso de validación inicial de 10 días centrado exclusivamente en marcas con producto físico.
Nuestra oferta cubre desde la auditoría de nicho y competencia hasta la gestión de programas de afiliados, contenido shoppable y transmisiones en vivo. Consulta nuestra página de servicios para solicitar un diagnóstico o revisa la Forliveshopping si buscas escalar ventas en TikTok Shop de forma integral.
Preguntas frecuentes
¿Existe una API oficial de TikTok para rastrear conversiones?
Sí, TikTok ofrece Events API como canal oficial servidor a servidor para enviar eventos de conversión directamente desde el backend de una marca. Se usa junto al Pixel, no en su lugar, para mejorar la cobertura de medición.
¿Merece la pena implementar la API de conversiones?
Sí, en la mayoría de los casos: recupera conversiones que el Pixel pierde por bloqueadores o restricciones de navegador y aporta señales adicionales al algoritmo de optimización. El esfuerzo de implementación se justifica especialmente en cuentas con presupuesto publicitario relevante.
¿Es gratuita la API de TikTok?
El uso de Events API no tiene coste de licencia propio: es parte de las herramientas de medición disponibles para cualquier cuenta publicitaria de TikTok. El coste real proviene del desarrollo o la contratación de la integración técnica, no del acceso a la API en sí.
¿Es gratuita la API de conversiones de Meta?
Esa pregunta corresponde a la plataforma de Meta, no a TikTok, y no forma parte del alcance de esta guía. Para TikTok, la API de conversiones (Events API) no cobra por su uso dentro de una cuenta publicitaria activa.
Fuentes
- js_sdk/docs/PixelTrackBody.md
- TikTok Events API: How to Set Up Server-Side Conversions | EndFrame
- Guidelines 02/2023 on Technical Scope of Art. 5(3) of ePrivacy Directive