Hay un problema que nadie te cuenta cuando empiezas a anunciar en TikTok: el píxel solo te da la mitad de los datos. La otra mitad desaparece silenciada por ad blockers, navegadores en modo privado y las restricciones de iOS. Y si no ves esa mitad, estás optimizando tus campañas con información incompleta. Antes de que termine este artículo, entenderás exactamente qué es la API de eventos de TikTok, por qué la necesitas y cómo instalarla paso a paso. Y si en algún punto decides que prefieres que alguien lo haga bien desde el principio, al final te explico cómo lo hacemos en Analytic Pixel Pro.
Qué es la API de eventos de TikTok y por qué existe
El píxel de TikTok es un código que se instala en tu web y envía información a TikTok desde el navegador del usuario. Cuando alguien visita tu página o compra un producto, el píxel lo registra y lo manda a TikTok.
El problema es que ese viaje desde el navegador hasta TikTok puede interrumpirse:
- Los ad blockers lo bloquean.
- Safari y Firefox limitan las cookies de terceros.
- Algunos usuarios tienen configuraciones de privacidad que impiden el rastreo.
- Las restricciones de iOS 14+ reducen la ventana de atribución.
El resultado es que TikTok puede llegar a perderse entre un 20% y un 40% de las conversiones reales, dependiendo de tu audiencia. Y con datos incompletos, el algoritmo optimiza mal, tus campañas rinden menos y tú inviertes más para conseguir menos.
La API de eventos de TikTok (también llamada Events API o TikTok CAPI) es la solución. En lugar de enviar los datos desde el navegador del usuario, los envías desde tu servidor directamente al servidor de TikTok. El viaje es mucho más corto, más seguro y no puede ser bloqueado por ninguna extensión del navegador.
Cuándo necesitas la API de eventos de TikTok
Si inviertes en TikTok Ads y te importa la atribución, la necesitas siempre. Pero hay situaciones donde se vuelve especialmente crítica:
- Tienes una tienda eCommerce y quieres que TikTok vea todas tus compras, no solo las que no bloqueó el navegador.
- Gestionas campañas de performance y necesitas que el algoritmo tenga los datos correctos para optimizar bien.
- Tu audiencia es tecnológica y es probable que usen ad blockers o Safari con ITP activado.
- Inviertes en escalar y necesitas datos fiables para saber qué campañas funcionan de verdad.
En pocas palabras: si el píxel es tu única fuente de datos, estás volando a ciegas.
Los dos componentes que necesitas antes de instalar nada
Antes de tocar ninguna configuración, necesitas tener claro qué piezas entran en juego.
El píxel de TikTok (lado cliente)
El píxel sigue siendo necesario aunque uses la API. Funciona en el navegador y captura datos como el ttclid (el identificador de clic de TikTok) y la cookie _ttp, que sirven para identificar al usuario dentro de la plataforma. Sin estos datos, la deduplicación no funciona bien.
La API de eventos (lado servidor)
La API envía los mismos eventos que el píxel, pero desde tu servidor. Necesita un Access Token para autenticarse con TikTok y tu Pixel ID para saber a qué píxel asociar los eventos.
La clave es que ambos sistemas deben trabajar juntos, no por separado. TikTok usa el Event ID para deduplicar: si recibe el mismo evento desde el navegador y desde el servidor con el mismo ID, lo cuenta una sola vez. Si no configuras la deduplicación bien, inflarás los datos.
Cómo instalar la API de eventos de TikTok paso a paso
Existen varias formas de implementar la API. Te explico la más profesional y escalable: usando Google Tag Manager Server-Side (sGTM). Es la que recomiendo para cualquier negocio que ya tenga volumen de campañas.
Paso 1: Generar el Access Token en TikTok Ads Manager
- Entra en TikTok Ads Manager.
- Ve a Assets → Events → Web Events.
- Selecciona tu píxel.
- Haz clic en Settings y busca la sección Access Token Generation.
- Haz clic en Generate Access Token y cópialo. Lo necesitarás más adelante.
Este token es como la llave que le da permiso a tu servidor para hablar con TikTok. Guárdalo en un lugar seguro.
Paso 2: Copiar tu Pixel ID
En la misma pantalla de configuración del píxel, verás el Pixel ID. Cópialo también. Es el identificador que le dice a TikTok a qué píxel pertenecen los eventos que envías.
Paso 3: Configurar tu contenedor server-side de GTM
Para que la API funcione, necesitas un contenedor servidor en Google Tag Manager. Hay varias formas de montarlo:
- Google Cloud Run (opción nativa de Google).
- Stape o TAGGRS (soluciones gestionadas que simplifican la infraestructura).
Si ya tienes un contenedor servidor funcionando para GA4 o Meta CAPI, el proceso se añade encima de la misma infraestructura.
Paso 4: Añadir la etiqueta de TikTok Events API en GTM Server
- Entra en tu contenedor servidor de GTM.
- Ve a Tags → New → Tag Configuration.
- Busca en la Community Template Gallery la etiqueta TikTok Events API (Official).
- Añade tu Access Token y tu Pixel ID en los campos correspondientes.
- Si vas a hacer pruebas, añade el Test Event Code (lo encuentras en TikTok Events Manager bajo la pestaña Test Events). Recuerda eliminarlo antes de publicar en producción.
Paso 5: Mapear los parámetros del evento
Esta es la parte más importante y donde más errores se cometen. Necesitas asegurarte de que los eventos que envías al servidor contienen la información correcta:
- Nombre del evento:
Purchase,AddToCart,ViewContent,CompleteRegistration, etc. - Event ID: Un identificador único por evento. Es lo que usa TikTok para deduplicar. Debe ser el mismo que el que envía el píxel del navegador.
- Datos del usuario: email, teléfono, IP del usuario, user agent. TikTok los hashea automáticamente en SHA-256.
- Parámetros de producto: valor, moneda, content_id, content_type.
- ttclid y _ttp: El identificador de clic de TikTok y la cookie. Son fundamentales para la atribución.
Paso 6: Configurar el trigger
El trigger define cuándo se dispara la etiqueta de TikTok. Generalmente se configura para que se active con los eventos GA4 que ya vienen de tu contenedor web. Por ejemplo, cuando GA4 registra un evento purchase, ese mismo evento llega al servidor y desde ahí lo reenvías a TikTok.
Paso 7: Configurar la deduplicación
Para que TikTok no cuente el mismo evento dos veces (una del píxel y otra de la API), tienes que pasar el mismo Event ID en ambos lados:
- En el píxel web: genera un ID único (por ejemplo,
purchase_12345_timestamp) y pásalo en el campoevent_iddel píxel. - En el servidor: usa ese mismo ID en la etiqueta de TikTok Events API.
Si no haces esto, TikTok puede duplicar tus conversiones y tus datos serán incorrectos.
Paso 8: Probar antes de publicar
- Usa el modo Preview de GTM para verificar que la etiqueta se dispara correctamente.
- Ve a TikTok Events Manager → Test Events y comprueba que los eventos de servidor aparecen en la pestaña Test Server Events.
- Verifica que el Event Match Quality (EMQ) es alto. Este indicador mide qué tan bien TikTok puede relacionar tus eventos con usuarios reales. Cuanto más alto, mejor atribución.
Paso 9: Publicar
Una vez verificado que todo funciona, publica tu contenedor servidor. A partir de ese momento, empezarás a recuperar las conversiones que el píxel perdía.
Los errores más comunes al instalar la API de TikTok
He visto estas implementaciones muchas veces y siempre aparecen los mismos fallos:
No configurar la deduplicación. Si mandas el mismo evento desde el navegador y desde el servidor sin un Event ID que los vincule, TikTok los conta como dos conversiones distintas. Tus datos se inflan y el algoritmo optimiza sobre mentiras.
Olvidarse del ttclid y el _ttp. Estos valores son los que permiten a TikTok atribuir la conversión al clic del anuncio correcto. Si no los mandas, pierdes atribución.
No hashear los datos del usuario correctamente. TikTok espera que el email y el teléfono vengan en SHA-256 en minúsculas. Si los mandas en texto plano o con mayúsculas, el matching falla.
Publicar con el Test Event Code activo. Si te olvidas de eliminarlo antes de publicar, los datos reales se marcan como tests y pueden no procesarse correctamente.
Usar el contenedor servidor para todo sin el píxel web. La API y el píxel son complementarios. Necesitas ambos para que la deduplicación funcione y para capturar el ttclid.
Cuánto mejoran los datos con la API de eventos
El impacto real depende de tu audiencia y tu sector, pero en general puedes esperar:
- Recuperación de entre un 15% y un 40% de eventos que el píxel perdía.
- Mejora en el Event Match Quality Score, lo que significa mejor atribución.
- Algoritmo de TikTok más eficiente, porque tiene más datos reales para optimizar.
- Audiencias personalizadas más grandes, porque se construyen con más señales.
Estos datos se traducen directamente en un ROAS más alto cuando escales inversión. No porque hayas gastado más, sino porque el algoritmo toma mejores decisiones.
Privacidad y cumplimiento GDPR
La API de eventos de TikTok no te exime del cumplimiento con el GDPR. De hecho, al manejar datos de usuario en el servidor, tienes que asegurarte de:
- Solo enviar datos de usuarios que han dado su consentimiento. El servidor debe saber si el usuario ha aceptado las cookies de marketing antes de mandar sus datos a TikTok.
- Anonimizar o no enviar ciertos datos si el usuario no ha dado consentimiento explícito.
- Documentar el flujo de datos como parte de tu registro de actividades de tratamiento.
Un sistema de gestión de consentimiento (CMP) bien configurado debe controlar qué datos viajan al servidor y bajo qué condiciones.
Por qué tiene sentido que lo configure Analytic Pixel Pro
Instalar la API de eventos de TikTok no es complicado si ya tienes experiencia con GTM server-side, pero hay muchos detalles donde una mala configuración puede costarte datos o generarte duplicaciones que distorsionen todo tu análisis.
En Analytic Pixel Pro implementamos la API de TikTok integrada dentro de un ecosistema de tracking que incluye:
- GTM web y servidor correctamente conectados.
- Deduplicación configurada para que ningún evento se cuente dos veces.
- Integración con el consentimiento para que el tracking respete el GDPR.
- Verificación del Event Match Quality antes de dar por buena la implementación.
- Testing en entorno de pruebas antes de pasar a producción.
Si ya tienes Meta CAPI o GA4 corriendo en servidor, añadir TikTok Events API encima de la misma infraestructura es mucho más eficiente que montarlo por separado.
El objetivo es que cuando escales tu inversión en TikTok, lo hagas sabiendo que cada euro que inviertes está siendo medido correctamente. Puedes contactar con nosotros aquí para revisar tu setup actual y ver qué datos estás perdiendo.
Preguntas frecuentes sobre la API de eventos de TikTok
¿Necesito la API si ya tengo el píxel instalado? Sí. El píxel solo trabaja desde el navegador y está sujeto a bloqueos. La API recupera los eventos que el píxel pierde. Son complementarios, no alternativos.
¿Puedo instalar la API sin Google Tag Manager servidor? Sí. TikTok ofrece una integración directa vía API y también hay soluciones como Stape que simplifican la infraestructura. Pero para negocios que ya usan GTM para otras plataformas, el contenedor servidor es la opción más limpia y escalable.
¿Cuánto tiempo tarda en verse el impacto? Una vez publicada la implementación, TikTok empieza a recibir los eventos de servidor de inmediato. El algoritmo puede tardar entre 24 y 72 horas en procesar el volumen nuevo y ajustar la optimización de las campañas.
¿La API funciona para aplicaciones móviles? TikTok tiene una Events API para apps (versión 2.0) que funciona de forma similar. En este artículo me he centrado en la implementación web, que es la más común para eCommerce y negocios con presencia web.
¿Qué es el Event Match Quality Score? Es una puntuación que TikTok asigna a cada evento para indicar qué tan bien puede relacionarlo con un usuario real de TikTok. Cuanto más alta sea (escala del 1 al 10), mejor atribución tendrás. Se mejora enviando más señales de usuario: email, teléfono, IP, ttclid y _ttp.
