Configura el píxel de TikTok y la Events API en Shopify

¿Cómo añades el píxel de TikTok a Shopify?

Instala la app de TikTok para Shopify, conecta tus cuentas de TikTok y elige un nivel de intercambio de datos: Standard añade el TikTok Pixel, mientras que Enhanced y Maximum añaden la Events API de TikTok y el Advanced Matching, todo sin código. Usa una app de seguimiento en su lugar cuando necesites varios píxeles o quieras ver cada evento que recibe TikTok, y mantén un solo emisor por píxel.

La propia guía de configuración de TikTok (actualizada por última vez en febrero de 2025) describe los pasos. Las páginas de Shopify sobre TikTok cubren TikTok Shop en vez del píxel, así que el centro de ayuda de TikTok es la referencia aquí.

1. Instala la app de TikTok desde la Shopify App Store y luego abre TikTok bajo Sales channels en tu admin de Shopify.
2. Conecta o crea las cuentas de TikTok que pide la app, incluida tu cuenta de TikTok for Business y TikTok Ads Manager.
3. Elige tu nivel de intercambio de datos: Standard, Enhanced o Maximum.
4. Haz clic en Create Pixel para crear un píxel nuevo, o selecciona uno existente.
5. Haz clic en Set Up, añade la ubicación de tu negocio en Company Information y haz clic en Confirm.

La app instala el píxel por ti, así que no hay nada que pegar. Si el código base de TikTok también está en tu tema o en un píxel personalizado de una configuración anterior, elimínalo, o cada evento se enviará dos veces.

¿Qué nivel de intercambio de datos deberías elegir?

Enhanced o Maximum, a menos que quieras compartir menos datos con TikTok: solo esos niveles incluyen la Events API, que TikTok recomienda usar junto al píxel. Standard es solo el píxel.

Fuente: el artículo sobre intercambio de datos de TikTok (actualizado por última vez en febrero de 2025), comprobado el 24 de septiembre de 2026.

Advanced Matching envía datos del cliente, como la dirección de correo electrónico y el número de teléfono, junto con tus eventos, para que TikTok pueda emparejarlos con usuarios de TikTok. Cuando TikTok amplió su integración con Shopify en agosto de 2023, pidió a los usuarios existentes que comprobaran en la app de TikTok que su nivel fuera Enhanced o Maximum (TikTok). Los niveles más altos comparten más datos de tus clientes, así que asegúrate de que tu aviso de privacidad cubra lo que elijas.

¿Qué añade la Events API?

Una copia de servidor a servidor de tus eventos, para que una conversión llegue a TikTok incluso cuando falla el píxel del navegador. TikTok la recomienda como un segundo canal junto al píxel, no como un reemplazo, con las dos copias deduplicadas.

El razonamiento de TikTok: los problemas de conexión y las diferencias entre navegadores le cuestan al píxel algunas conversiones, y con los dos canales funcionando, los eventos siguen llegando por uno cuando el otro falla (About Events API, web setup guide). Un evento del servidor vale tanto como lo que lleva:

• Un token de acceso. Lo generas en TikTok Events Manager, desde Settings de tu píxel.
• El ID de evento del píxel. Una copia del servidor con el mismo nombre de evento e ID de evento que la copia del navegador cuenta una sola vez. Sin ellos, TikTok puede contar las dos.
• Los datos de coincidencia. TikTok empareja los eventos web por el ID de clic de TikTok (ttclid), los datos de Advanced Matching como el correo y el teléfono, y señales como la dirección IP y el user agent. Su guía de configuración también pide enviar el ID de clic y las cookies, y activar las cookies propias y el Automatic Advanced Matching en la pestaña Settings del píxel.

Lo que la Events API no puede hacer es recuperar a los compradores que rechazaron el seguimiento. Enviar sus eventos desde un servidor en lugar de un navegador no los convierte en consentidos. Más sobre qué cambian los eventos del servidor, y qué no: seguimiento desde el servidor en Shopify.

¿Cómo lo configuras con una app de seguimiento?

Conecta la app a tu píxel con un token de acceso de la Events API, y asegúrate de que nada más envíe a ese píxel. Una app de seguimiento se gana su lugar cuando manejas varios píxeles o quieres ver cada evento que recibe TikTok.

cPixel, que nosotros creamos, envía los eventos de TikTok desde sus servidores mediante la Events API: vistas de página, vistas de producto, búsquedas, añadidos al carrito, checkouts, datos de pago añadidos y la compra. Construye la compra a partir del pedido de Shopify, así que no depende de que cargue la página de agradecimiento. Su etiqueta de tienda, que se ejecuta cuando la incrustación de app de cPixel está activa en tu tema, añade solo la vista de página, emparejada con la copia del servidor bajo un mismo ID de evento. Los eventos llevan los datos por los que TikTok empareja, cuando cPixel los tiene: correo y teléfono con hash una vez que el comprador los ha dado, ID de cliente y de dispositivo de Shopify con hash, la cookie _ttp, el ID de clic ttclid, la dirección IP y el user agent.

En la configuración de cPixel pegas el Código de píxel (TikTok lo llama Pixel ID) y el Token de acceso de la Events API, que cPixel exige. Con un Código de evento de prueba (opcional) guardado, Probar conexión envía un evento de prueba real; los pedidos reales nunca llevan el código. Una vez que los eventos empiezan a fluir, la vista En vivo de cPixel muestra cada envío con la respuesta de TikTok. Puedes conectar varios píxeles de TikTok, cada uno configurado de la misma forma. Paso a paso: conecta TikTok a cPixel.

Si la app de TikTok sigue enviando al mismo píxel, responde Sí a la pregunta de cPixel ¿También tienes instalada la app oficial de TikTok?, lo que detiene el envío de cPixel a ese píxel, o conecta cPixel a un píxel distinto. Conserva la app de TikTok de todas formas; la regla es un solo emisor por píxel. Más sobre cPixel, que envía las compras de Shopify a siete plataformas publicitarias.

¿Por qué TikTok cuenta las compras dos veces?

Porque dos copias de una misma compra llegaron al mismo píxel sin el mismo nombre de evento e ID de evento, así que TikTok no pudo saber que eran un solo pedido. Eso suele significar que dos herramientas envían a un mismo píxel.

La regla de TikTok, de su documentación para desarrolladores (comprobada el 24 de septiembre de 2026): los eventos con el mismo píxel, nombre de evento y event_id son duplicados. TikTok conserva el primero, descarta las copias recibidas dentro de las 48 horas siguientes y trata de fusionar los datos de una copia recibida dentro de los 5 minutos siguientes con el primero. Su artículo de ayuda sobre deduplicación de eventos (actualizado por última vez en mayo de 2025) da la misma ventana de 48 horas.

Cuando la copia del servidor no tiene ID de evento, TikTok recurre a la cookie _ttp, con límites: solo descarta un evento del servidor si un evento del navegador con el mismo píxel, evento y cookie llegó hasta 5 minutos antes, y nunca descarta un evento del navegador.

La regla de Meta y las comprobaciones para un píxel de Meta están en TikTok y Meta contando compras dos veces.

¿Cómo pruebas los eventos de TikTok?

Envía eventos de prueba desde la pestaña Test Events de TikTok Events Manager mientras configuras todo. Luego haz un pedido real y revisa el método de conexión de cada evento en la pestaña Overview del píxel: Browser, Server, o Server & Browser.

1. En TikTok Events Manager, abre tu píxel y su pestaña Test Events, donde puedes probar eventos del navegador y del servidor y filtrar entre ellos (TikTok).
2. Para eventos del servidor, copia el código de prueba desde Test Events y envíalo como test_event_code con tus solicitudes. Los eventos de prueba aparecen en Event Activity, con cualquier problema de payload. Quita el código antes de salir en vivo (verification guide).
3. Haz un pedido real.
4. En la pestaña Overview del píxel, revisa el Connection Method de cada evento. Server & Browser cuenta una sola vez un evento recibido por ambos canales. Si esa cifra se mantiene baja mientras los dos canales envían el evento, comprueba que ambas copias lleven el mismo ID de evento.
5. Revisa la pestaña Diagnostics, que enumera los problemas que TikTok ha encontrado y su gravedad.

TikTok dice que los datos de eventos no se muestran en tiempo real. Deja pasar hasta 10 minutos para que se actualicen los conteos de eventos, y hasta 2 horas para que un evento se procese por completo, antes de decidir que algo está roto (TikTok). Un evento también se muestra como activo solo una vez que se ha disparado: en un hilo de la comunidad de 2023, un comerciante que usaba la app de TikTok solo vio las vistas de página marcadas como activas, y los demás eventos aparecieron después de que ocurrieran las vistas de producto y los añadidos al carrito.

Si TikTok Pixel Helper no muestra nada, las causas son las mismas que con Meta: consulta TikTok Pixel Helper no muestra nada.

Preguntas frecuentes

¿CompletePayment o Purchase?

Purchase, para cualquier cosa que configures ahora. TikTok renombró CompletePayment a Purchase para eventos web desde el 1 de mayo de 2025, y su lista de eventos admitidos de la Events API ahora muestra Purchase. Las configuraciones existentes no necesitan cambiar: TikTok convierte los nombres antiguos automáticamente y muestra los nuevos en los informes (updated standard events). Uses el nombre que uses, envía el mismo desde el píxel y desde la Events API, porque el nombre forma parte de la clave de deduplicación de TikTok. cPixel todavía envía CompletePayment, que TikTok acepta y reporta como Purchase; envía la compra solo desde su servidor, así que no hay ninguna copia del navegador cuyo nombre deba coincidir.

¿Qué es ttclid?

El ID de clic de TikTok, un parámetro que TikTok añade a la URL de tu página de destino cuando alguien hace clic en tu anuncio. El TikTok Pixel lo guarda en una cookie propia llamada ttclid, y TikTok recomienda encarecidamente enviarlo con cada evento de la Events API para que las conversiones se vinculen de vuelta al clic. Si lo guardas tú mismo, TikTok sugiere conservarlo 28 días o más y reemplazarlo cuando llegue un clic más reciente (Send TikTok Click ID). Su compañera, la cookie _ttp, guarda un identificador del navegador. TikTok dice que ambas cookies duran 13 meses desde su último uso, y las cookies propias están activas de forma predeterminada en la configuración del píxel (cookies).

¿Puedo añadir el píxel a mano?

Sí, como píxel personalizado en Settings → Customer events, que llega al checkout y a la página de agradecimiento. Shopify aclara que los píxeles personalizados requieren JavaScript y no cuentan con soporte de Shopify (custom pixels). El código pegado en tu tema solo se ejecuta en páginas fuera del checkout (theme layouts), y Additional scripts ya no se ejecuta en la página de agradecimiento (Additional scripts stopped running). Un píxel añadido a mano solo envía desde el navegador, ya que la Events API necesita un servidor. Si mudas un píxel, elimina la copia antigua: Shopify señala el seguimiento del mismo evento más de una vez como un problema común de migración (migrating pixels).