Qué es la Events API de TikTok
Es el canal oficial para enviar eventos a TikTok directamente desde tus sistemas. Complementa al píxel de TikTok, que mide en el navegador, y permite mandar eventos que el píxel no ve: una venta cerrada por teléfono, una oportunidad cualificada en el CRM, una compra en tienda física.
TikTok la usa para medir resultados y para entrenar la optimización de las campañas. Como en el resto de plataformas, la calidad de lo que envías condiciona lo que el algoritmo aprende.
Qué datos lleva un evento
| Dato | Para qué sirve |
|---|---|
| Nombre del evento | Qué ha pasado: formulario enviado, compra completada, etc. |
| Fecha y hora | Cuándo ocurrió |
| Fuente del evento | Si viene de la web, de una app o de un sistema externo como un CRM |
ttclid | Identificador del clic en el anuncio, que llega en la URL de aterrizaje |
ttp | Cookie del píxel de TikTok en el navegador |
| Correo y teléfono con hash | Para relacionar el evento con la persona |
| Valor y moneda | Para optimizar por ingresos |
| Identificador de evento | Para deduplicar si el mismo evento llega por píxel y por API |
Revisa en la documentación vigente los nombres exactos de los campos y de los eventos estándar, porque TikTok los actualiza.
Cómo configurarla paso a paso
- Crea o localiza tu píxel en el Administrador de eventos de TikTok; su identificador será el origen de datos de la API.
- Obtén un token de acceso desde la configuración de la Events API.
- Captura el
ttclidal aterrizar y guárdalo con el lead en tu CRM. Sin él, la atribución a un anuncio concreto es mucho más difícil. - Define los eventos de negocio que vas a enviar (lead, lead cualificado, venta) y su valor.
- Envía y prueba con la herramienta de prueba de eventos y comprueba que aparecen con los datos esperados.
- Revisa la calidad que TikTok indica para cada evento y corrige lo que falte.
Cómo evitar duplicados entre píxel y API
Si envías el mismo evento por píxel y por la Events API, TikTok necesita poder reconocer que es el mismo. La vía habitual es mandar el mismo nombre de evento y el mismo identificador de evento por ambos canales. Si no coinciden, el informe cuenta dos conversiones donde hubo una.
Para los eventos que solo existen en el CRM (una venta cobrada, por ejemplo), no hay duplicado posible: solo llegan por la API.
Errores típicos con la Events API de TikTok
- No guardar el
ttclidal capturar el lead y descubrirlo cuando ya no se puede recuperar. - Enviar eventos sin valor y luego querer optimizar por ingresos.
- Datos personales sin normalizar antes del hash.
- Dar por hecho que un lead de TikTok equivale a un cliente. Muchas veces el volumen es alto y la cualificación, baja; sin enviar la venta de vuelta, la plataforma no distingue.
- Enviar leads de prueba con datos ficticios a la cuenta real.
Para qué negocios compensa
Compensa sobre todo cuando el cierre no ocurre en la web: servicios con llamada, formación con asesor, inmobiliaria, salud privada, B2B. En estos casos el píxel solo ve el formulario, y TikTok acaba optimizando por quien rellena formularios, no por quien paga. Mandar de vuelta la oportunidad cualificada y la venta corrige ese sesgo.
TikTok Pixel Helper: qué es y cómo comprobar que el píxel dispara
TikTok Pixel Helper es una extensión de Chrome que, según la ayuda de TikTok for Business, sirve para verificar y resolver problemas en la instalación del píxel: revisa errores y da recomendaciones en tres niveles (píxel, evento y parámetro).
- Instala la versión más reciente desde la Chrome Web Store (usa la que enlaza la ayuda de TikTok).
- Abre tu web con la extensión activa y recorre la acción que debe disparar el evento, por ejemplo enviar el formulario.
- Mira qué avisa la extensión y aplica la sugerencia del nivel correspondiente.
Entre los avisos que recoge la ayuda: código del píxel no instalado en el encabezado, identificador de píxel no válido, nombre de evento vacío o no válido, correo o teléfono con formato incorrecto, o falta de value o currency en eventos de compra.
Sus límites. La extensión trabaja sobre la página abierta en tu navegador, así que solo puede ver lo que el píxel dispara ahí. Un evento enviado desde un servidor o un CRM por la Events API no pasa por esa página y no aparecerá en la extensión. Para esos eventos, comprueba el Administrador de eventos: según su ayuda, la pestaña de eventos de prueba permite filtrar entre eventos de navegador y de servidor, y el resumen indica si el método de conexión es solo navegador, solo servidor o ambos.
Cómo lo resuelve Acelera Sales
Acelera Sales mide tu publicidad hasta la venta cobrada en el CRM y devuelve esa venta a las plataformas con su API de conversiones. Hay conectores listos para Meta, Google/YouTube, TikTok, LinkedIn, Microsoft y Pinterest, y se conecta con cualquier CRM, con tu web y con los canales donde habla el cliente (WhatsApp, llamadas, chat). Para TikTok, Acelera Sales guarda el ttclid y los datos del contacto cuando entra el lead, sigue la oportunidad en el CRM y envía a la Events API el evento de venta cobrada con su valor, evitando duplicados. También vigila la calidad que la plataforma asigna a esos eventos y la corrige si baja. Mira la integración con TikTok Ads o la demo.
Fuentes
Preguntas frecuentes
¿Qué es la Events API de TikTok?
Es la interfaz para enviar a TikTok eventos de tu negocio desde un servidor o un CRM, sin depender del navegador del visitante.
¿Sustituye al píxel de TikTok?
No necesariamente. Puede usarse junto al píxel, compartiendo el identificador de evento para evitar duplicados, o sola para eventos que ocurren fuera de la web.
¿Qué es el ttclid?
Es el identificador del clic en un anuncio de TikTok, que se añade a la URL de aterrizaje. Guardarlo con el lead permite atribuir después la venta a ese anuncio.
¿Puedo enviar ventas cerradas por teléfono a TikTok?
Sí, ese es uno de los usos principales. Hay que haber guardado el identificador de clic y los datos de contacto cuando entró el lead.
¿Cómo sé si TikTok recibe bien mis eventos?
Con la herramienta de prueba de eventos y la información de calidad del Administrador de eventos, que indica qué datos recibe y cuáles faltan.
¿Qué es TikTok Pixel Helper?
Es una extensión de Chrome que ayuda a verificar y resolver problemas del píxel de TikTok en tu web. No muestra los eventos enviados por la Events API desde un servidor: esos se revisan en el Administrador de eventos.