¿Qué es el pixel de TikTok y cómo configurarlo con la API de eventos?

§ 01¿Qué es el pixel de TikTok y para qué sirve?

Según la Ayuda de TikTok, el pixel sirve para medir el tráfico de tu sitio, medir el rendimiento de tus anuncios y optimizar campañas para encontrar clientes nuevos (fuente 1). Cada vez que alguien hace una acción que configuraste, como pagar, el pixel manda un evento a TikTok.

Para hacerlo, el pixel usa información que expone cualquier navegador, como la hora del evento y la dirección IP (fuente 1). También lee qué anuncio trajo a la persona y las cookies del sitio (fuente 1). Con eso TikTok intenta unir lo que pasó en tu sitio con alguien que vio tu anuncio.

Sin pixel ni API de eventos no puedes usar el objetivo de conversiones web en TikTok Ads Manager. TikTok lo pone como requisito previo (fuente 2). Si tu campaña tiene que vender o conseguir registros en tu sitio, esto va antes que el primer anuncio.

§ 02¿Qué es la API de eventos y necesitas los dos?

La API de eventos manda los eventos desde tu servidor, no desde el navegador de la persona. TikTok explica por qué importa. Los problemas de conexión y las diferencias entre navegadores hacen que el pixel deje de reportar algunas conversiones, y la API recupera parte de ellas (fuente 2).

La recomendación oficial es usar pixel y API de eventos al mismo tiempo, con desduplicación activada (fuente 2). TikTok pide tres cosas para que la combinación funcione (fuente 2):

1. Mandar los mismos eventos y parámetros por los dos lados, a lo largo de todo el recorrido del cliente.
2. Mandar las claves de correspondencia que tengas, para que TikTok pueda unir más eventos con usuarios.
3. Activar la desduplicación, que se explica más abajo.

Empezar solo con el pixel sí se puede. Es lo más rápido, y para muchas tiendas pequeñas es el primer paso real porque no necesita un servidor propio ni un desarrollador dedicado. Solo ten en cuenta que vas a medir menos conversiones de las que pasan, en una proporción que depende de tus visitantes.

La API también pide más trabajo previo. TikTok sugiere definir con tu equipo técnico y legal qué eventos y qué datos de clientes vas a compartir antes de conectarla (fuente 3). Hay tres formas de integrarla (fuente 3):

• Con una plataforma de comercio que ya tenga la integración, como Shopify.
• Con un socio de datos, como un gestor de etiquetas o un CRM.
• Directo con la API, si necesitas más control sobre qué datos salen.

Mi criterio es empezar por la integración oficial si tu tienda está en una plataforma que la tiene. En la app de TikTok para Shopify eliges un nivel para compartir datos. El básico usa solo el pixel, y los dos niveles de arriba suman la API de eventos y la correspondencia avanzada (fuente 13). Así tienes pixel y API sin escribir código. Lo que pierdes es control sobre qué evento sale y en qué momento.

Pasaría a la configuración manual en dos casos. Uno, cuando necesitas un evento que la integración no manda. Dos, cuando otra herramienta ya manda eventos al mismo pixel. Lo que no haría es dejar la integración y un código propio mandando la misma compra al mismo pixel. Si cada uno usa su propio `event_id`, TikTok no puede saber que son la misma venta y la cuenta dos veces.

§ 03¿Cómo crear el pixel?

Todo se hace desde el Administrador de eventos. Los pasos, según la Ayuda de TikTok (fuente 4):

1. En TikTok Ads Manager, ve a Herramientas > Administrador de eventos.
2. Haz clic en Conectar fuente de datos y elige Web.
3. Escribe la URL de tu sitio.
4. Elige Integraciones de socio o Configuración manual.
5. Crea el pixel y ponle nombre. TikTok recomienda que coincida con tu sitio o dominio, con un máximo de 128 caracteres.

Si eliges un socio, TikTok te lleva a la lista de plataformas compatibles (Google Tag Manager es una de ellas) y sigues los pasos de esa plataforma (fuente 4). Si eliges la configuración manual, instalas el código base en tu sitio y después configuras los eventos (fuente 4).

Para los eventos hay dos caminos en la configuración manual (fuente 4). El Creador de eventos no necesita desarrollador, aunque sí tienes que poder instalar el código base. El código personalizado da más control sobre cuándo se dispara cada evento, pero lo escribe alguien que conozca tu sitio.

Si creaste el pixel y no terminaste de instalarlo, puedes volver a la configuración. En Herramientas > Eventos > Eventos web da clic en Gestionar. Luego elige el pixel y usa el botón "Finalizar la configuración del píxel" (fuente 4).

§ 04¿Qué eventos configurar primero?

TikTok recomienda configurar los eventos de todo el recorrido del cliente, desde que ve un producto hasta que compra (fuente 1). En una tienda en línea, un orden razonable para empezar es este, con los nombres de evento estándar que usa TikTok (fuente 5):

1. ViewContent, cuando alguien ve una página importante, como la de un producto.
2. AddToCart, cuando agrega un artículo al carrito.
3. InitiateCheckout, cuando empieza a pagar.
4. Purchase, cuando termina la compra. TikTok lo recomienda cuando hacer el pedido y pagar son el mismo paso.

Si lo que buscas son registros, los equivalentes son eventos como SubmitForm, CompleteRegistration o Contact (fuente 5). Elige el que corresponde al momento en que tu negocio ya tiene el dato del cliente.

Dos detalles evitan problemas después:

• Manda valor y moneda en las compras. Purchase y AddToCart admiten los parámetros value y currency (fuente 5). Sin ellos TikTok cuenta compras pero no sabe cuánto valen, y no podrás calcular tu retorno real contra tu ROAS de equilibrio.
• Usa eventos estándar para lo que vas a optimizar. Los eventos personalizados sirven para informes y audiencias, pero TikTok aclara que no se pueden usar para optimizar campañas (fuente 6). Tampoco deben llevar el nombre de un evento estándar ni pasar de 50 caracteres (fuente 6).

§ 05¿Qué es la desduplicación y por qué importa?

Cuando el pixel y la API de eventos mandan la misma compra, TikTok recibe dos copias. La desduplicación es lo que evita que esa venta aparezca dos veces en tus informes.

Para que funcione, los dos lados tienen que mandar el mismo `event_id` con el mismo nombre de evento (fuente 7). TikTok conserva el primero de los eventos que reconoce como copias de una misma conversión. A ese primero le suma la información de las copias (fuente 7). La guía para desarrolladores lo detalla. Las copias que llegan dentro de 48 horas del primer evento se descartan, y si una copia llega en los primeros 5 minutos, TikTok intenta pasarle sus datos al primero, por ejemplo un correo que el primero no traía (fuente 8).

¿Cuándo es obligatoria? Depende de cómo repartas los eventos (fuente 7):

• Si mandas eventos distintos por cada lado, por ejemplo AddToCart solo por pixel y Purchase solo por la API, la desduplicación es opcional.
• Si mandas el mismo evento por los dos lados, es obligatoria.

Hay un respaldo. Si no mandas `event_id` desde la API, TikTok intenta desduplicar con la cookie `_ttp`, que el pixel guarda cuando tienes activadas las cookies propias (fuente 8). Para eso tienes que mandar el valor de esa cookie en cada evento de la API. Este respaldo tiene una ventana de 5 minutos y solo descarta eventos de la API, nunca del pixel (fuente 8). Sirve como red de seguridad, pero el `event_id` es el método que TikTok describe primero.

§ 06¿Cómo comprobar que funciona?

TikTok ofrece la extensión de Chrome Ayuda del píxel (TikTok Pixel Helper). Revisa la instalación con detalle y te dice qué corregir (fuente 9). Entre los errores que detecta (fuente 9):

• El código del pixel no está en el encabezado de la página. Va lo más arriba posible, idealmente dentro de `<head>`.
• El ID del pixel no existe en tu cuenta.
• Las cookies propias no están activadas. Se activan desde la configuración del pixel en el Administrador de eventos.
• El valor de la compra trae símbolos de moneda o comas. También avisa cuando falta la moneda.
• El correo no está en minúsculas o el teléfono no está en formato internacional E.164.

Para la API de eventos, TikTok pide validar la configuración con sus herramientas de diagnóstico web dentro del Administrador de eventos una vez que esté instalada (fuente 3).

Antes de lanzar, haz una compra de prueba en tu sitio con la extensión abierta. Revisa que aparezcan los eventos del recorrido en orden y que la compra traiga valor y moneda. Si también usas la API, confirma que esa compra llegue una sola vez al Administrador de eventos.

Cuando reviso un pixel, lo primero que busco es una compra contada dos veces, porque infla el retorno y nadie se queja de un número que se ve bien. Después reviso que la compra traiga valor y moneda, y al final que se dispare en la página de confirmación y no al dar clic en pagar. Recarga la página de gracias en tu prueba. Si cada recarga manda una compra con un `event_id` nuevo, la desduplicación no la va a frenar.

§ 07Datos de clientes y privacidad

La correspondencia avanzada une datos como correo y teléfono con los eventos de tu sitio. La automática detecta campos de formulario y cifra lo que escribe el visitante con SHA-256. La manual te deja elegir qué datos mandar en el código de cada evento (fuente 10). TikTok recomienda usar las dos, salvo en sectores regulados como finanzas o salud, donde sugiere solo la manual (fuente 10).

La API de eventos también pide cifrar con SHA-256 el correo y el teléfono. El teléfono se normaliza antes al formato E.164, con código de país (fuente 12). TikTok también pide no mandar datos confidenciales de tus visitantes en ningún evento (fuente 5). Si tu sitio usa un banner de consentimiento de cookies, revisa que el pixel respete lo que elige el visitante; TikTok sugiere usar plataformas de gestión de consentimiento si no tienes desarrolladores (fuente 11).

§ 08Por dónde empezar

Crea el pixel desde el Administrador de eventos con la integración de tu plataforma, si tienes una. Configura los cuatro eventos de compra con valor y moneda. Revisa con la Ayuda del píxel que todos se disparen y que las cookies propias estén activas. Cuando eso esté limpio, conecta la API de eventos mandando los mismos eventos con el mismo `event_id`. Si también anuncias en Búsqueda, las palabras clave negativas en Google Ads cumplen un papel parecido del otro lado. Cuidan que lo que pagas sea lo que te sirve.