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

El pixel de TikTok es un fragmento de código que pones en tu sitio para avisarle a TikTok qué hace la gente que llega desde tus anuncios. Con esos datos mides tus campañas, optimizas hacia una acción concreta y armas audiencias. La API de eventos manda esa misma información desde tu servidor. TikTok recomienda usar los dos juntos y desduplicarlos con un mismo `event_id`, para que una compra no se cuente dos veces.

## ¿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.

## ¿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.

## ¿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).

> **Un pixel por sitio.** Todos los eventos que lleguen a un código de pixel se ven juntos en ese pixel. Si mezclas dos sitios en el mismo, después no vas a poder separar sus resultados con claridad.

## ¿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.

![Diagrama 1-bit de cuatro pasos en orden: 1 ViewContent, ve un producto; 2 AddToCart; 3 InitiateCheckout; 4 Purchase, compra con valor y moneda, resaltado.](https://cesarcuellar.com/blog/media/posts/pixel-de-tiktok/pixel-eventos-v2.webp)

FIG. 1 · Los eventos del recorrido de compra, en orden. Purchase es el que lleva valor y moneda.

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](/blog/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).

## ¿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).

Diagrama animado: la misma compra llega a TikTok por el pixel (navegador) y por la API de eventos (servidor). Con el mismo event_id TikTok cuenta una sola compra; sin él, la cuenta dos veces.

¿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.

> **Síntoma de que algo falla.** Si TikTok reporta casi el doble de compras que tu tienda, revisa la desduplicación. Si reporta muchas menos, revisa que el evento de compra se dispare en la página correcta y que la API esté mandando datos.

## ¿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.

## Datos 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).

## Por 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](/blog/palabras-clave-negativas-google-ads) cumplen un papel parecido del otro lado. Cuidan que lo que pagas sea lo que te sirve.

## Preguntas frecuentes

### ¿Qué eventos del pixel de TikTok configuro primero?

En una tienda, los cuatro del recorrido de compra con sus nombres estándar, desde ViewContent hasta Purchase. En la compra manda valor y moneda para poder medir tu retorno.

### ¿Necesito la API de eventos si ya tengo el pixel?

No es obligatoria, pero TikTok la recomienda como segundo canal junto al pixel. Ayuda a recuperar conversiones que el pixel pierde por problemas de conexión o del navegador.

### ¿Cómo conecto el pixel de TikTok con Shopify?

En el Administrador de eventos eliges Conectar fuente de datos > Web > Integraciones de socio. Ahí seleccionas Shopify y sigues los pasos de la plataforma.

### ¿Por qué TikTok cuenta mis compras dos veces?

Casi siempre porque el pixel y la API mandan la misma compra sin el mismo event_id. Manda el mismo event_id y el mismo nombre de evento por los dos lados para que TikTok los desduplique.

### ¿Puedo optimizar una campaña con un evento personalizado?

No. TikTok aclara que los eventos personalizados sirven para informes y audiencias, pero no para optimizar campañas. Para optimizar usa un evento estándar.

## Fuentes

1. [Acerca del Píxel de TikTok](https://ads.tiktok.com/help/article/tiktok-pixel?lang=es). Centro de ayuda de TikTok for Business. Consultado el 2026-11-02.
2. [Acerca de la API de eventos](https://ads.tiktok.com/help/article/events-api?lang=es). Centro de ayuda de TikTok for Business. Consultado el 2026-11-02.
3. [Cómo comenzar a utilizar la API de eventos](https://ads.tiktok.com/help/article/getting-started-events-api?lang=es). Centro de ayuda de TikTok for Business. Consultado el 2026-11-02.
4. [Cómo configurar y verificar el Píxel de TikTok](https://ads.tiktok.com/help/article/get-started-pixel?lang=es). Centro de ayuda de TikTok for Business. Consultado el 2026-11-02.
5. [Acerca de los eventos estándar en TikTok Ads Manager](https://ads.tiktok.com/help/article/standard-events-parameters?lang=es). Centro de ayuda de TikTok for Business. Consultado el 2026-11-02.
6. [Acerca de los eventos personalizados en TikTok Ads Manager](https://ads.tiktok.com/help/article/custom-events?lang=es). Centro de ayuda de TikTok for Business. Consultado el 2026-11-02.
7. [Acerca de la desduplicación de eventos](https://ads.tiktok.com/help/article/event-deduplication?lang=es). Centro de ayuda de TikTok for Business. Consultado el 2026-11-02.
8. [Event deduplication](https://business-api.tiktok.com/portal/docs/event-deduplication/v1.3). TikTok API for Business. Consultado el 2026-11-02.
9. [Resolución de problemas con la Ayuda del píxel](https://ads.tiktok.com/help/article/tiktok-pixel-helper-2.0?lang=es). Centro de ayuda de TikTok for Business. Consultado el 2026-11-02.
10. [Acerca de la Correspondencia avanzada para web](https://ads.tiktok.com/help/article/advanced-matching-web?lang=es). Centro de ayuda de TikTok for Business. Consultado el 2026-11-02.
11. [Acerca del uso de cookies con el Píxel de TikTok](https://ads.tiktok.com/help/article/using-cookies-with-tiktok-pixel?lang=es). Centro de ayuda de TikTok for Business. Consultado el 2026-11-02.
12. [Setup guide for Web (Events API 2.0)](https://business-api.tiktok.com/portal/docs/setup-guide-for-web/v1.3). TikTok API for Business. Consultado el 2026-11-02.
13. [Expanded Shopify integration strengthens ad performance for merchants](https://www.tiktok.com/business/en-US/blog/shopify-ecommerce-integration-pixel-events-api). TikTok for Business. Consultado el 2026-11-02.