¿Qué es la Events API de TikTok?
La Events API de TikTok permite que un servidor envíe los eventos de un sitio web directamente a TikTok, junto a los eventos que el píxel de TikTok envía desde el navegador del comprador. Para las conexiones de sitios web, TikTok recomienda usarla junto con el píxel. También puedes encontrarla con el nombre de TikTok Conversions API.
Con WeProfit, una compra de Shopify llega a TikTok como CompletePayment, enviada desde los servidores de WeProfit al píxel que conectes. Otros eventos de la tienda siguen la misma vía, como ViewContent, AddToCart e InitiateCheckout; la tabla que aparece más abajo en esta página los enumera.
TikTok cambió el nombre de CompletePayment a Purchase en mayo de 2025. Sigue aceptando CompletePayment, lo convierte por su cuenta y lo muestra como Purchase en los informes, en la creación de audiencias y en la optimización. TikTok está incluido en todos los planes de WeProfit, junto con Meta, Google, Pinterest, Snapchat, X Ads, Microsoft (piloto), Reddit, LinkedIn y Taboola.
Conecta TikTok en WeProfit
Primero conecta tu tienda de Shopify y activa la incrustación de la app de WeProfit, para que los eventos de la tienda online lleguen a WeProfit. El envío a TikTok necesita dos datos de TikTok: el ID del píxel, que TikTok también llama código del píxel, y un token de acceso de la Events API. Para el envío no hace falta una cuenta publicitaria de TikTok; esa cuenta solo se necesita para importar el gasto publicitario.
- En TikTok Ads Manager, pasa el cursor sobre Tools, abre Events Manager y selecciona el píxel de tu sitio web. Copia el ID del píxel.
- Abre la pestaña Settings del píxel, desplázate hasta Events API y haz clic en Generate Access Token. Copia el token.
- En WeProfit, abre Redes publicitarias > TikTok y selecciona Agregar destino. Escribe el ID del píxel (código del píxel) y el token de acceso de la Events API. La etiqueta es opcional y te ayuda cuando conectas más de un píxel.
- Deja vacío el campo Condiciones para enviar todos los eventos elegibles, o agrega condiciones como país, evento, valor del pedido, producto, URL de la página o campaña para limitar lo que recibe este píxel. Luego selecciona Conectar TikTok.
- Para hacer antes una prueba, abre Test Events del píxel en TikTok Events Manager, copia su código de evento de prueba en el campo Código de evento de prueba del destino, guarda y selecciona Enviar prueba. WeProfit muestra si TikTok aceptó la prueba.
- Mientras haya un código de evento de prueba configurado, todos los eventos reales de ese píxel van a la herramienta de prueba de TikTok y es posible que no cuenten para tus anuncios. WeProfit muestra Modo de prueba activado y desactiva el código 24 horas después de que lo configures; borra el código cuando termines de probar y los eventos volverán a enviarse como reales.
¿Qué eventos de la tienda llegan a TikTok?
En Shopify, la incrustación de la app de WeProfit registra las vistas de página, las vistas de producto y los agregados al carrito de la tienda online, y el píxel web de WeProfit registra los pasos del checkout. WeProfit los envía a TikTok desde su servidor a medida que los procesa. Las compras vienen del webhook de pedidos de Shopify, y la compra de cada pedido se envía como máximo una vez a cada píxel conectado.
Los eventos de la tienda online llegan a WeProfit a través del proxy de aplicaciones de Shopify, en el propio dominio de tu tienda, así que las listas de bloqueo dirigidas a dominios de seguimiento no suelen detenerlos. Eso no significa que se registre cada visita.
Las búsquedas, los leads, los registros y los eventos personalizados solo llegan a TikTok cuando tu sitio los envía con la llamada track de WeProfit; en Shopify no se registran automáticamente. Un evento personalizado se envía con su propio nombre, recortado a 64 caracteres. Los leads se envían como SubmitForm, que TikTok renombró Lead en mayo de 2025 y que convierte igual que CompletePayment. Los reembolsos, las eliminaciones del carrito y los eventos del paso de envío no se envían a TikTok, y nada retira una compra que TikTok ya recibió.
Cada compra lleva el total del pedido tal como lo informa Shopify, en la moneda del pedido, los productos como artículos con su ID, cantidad, precio unitario y título, y el ID del pedido de Shopify. Comprueba en TikTok Events Manager cuáles de estos eventos recibe tu píxel.
| Evento de la tienda | Evento de TikTok |
|---|---|
| Page view | Pageview |
| Product or content view | ViewContent |
| Search | Search |
| Add to cart | AddToCart |
| Checkout started | InitiateCheckout |
| Payment information added | AddPaymentInfo |
| Purchase | CompletePayment |
| Lead | SubmitForm |
| Sign up | CompleteRegistration |
Datos del cliente que se envían con cada evento
Para ayudar a TikTok a asociar un evento con un usuario de TikTok, WeProfit envía los datos que tiene el evento. En una compra de Shopify, son el correo electrónico y el número de teléfono del comprador que figuran en el pedido, con hash SHA-256, y la dirección IP y el agente de usuario. Cuando WeProfit los tiene, también envía el ID de clic de TikTok (ttclid), la cookie _ttp y un ID externo, un hash SHA-256 del ID de visitante de WeProfit. TikTok no recibe nombres ni direcciones de WeProfit.
Los eventos del navegador no llevan correo electrónico ni número de teléfono, salvo que tu sitio identifique al comprador con la llamada identify de WeProfit, y el píxel web de WeProfit para Shopify no envía datos del cliente. La dirección IP y el agente de usuario se envían sin hash, como espera la Events API.
TikTok agrega el ID de clic ttclid a la URL de tu página de destino cuando alguien hace clic en tu anuncio, y WeProfit lo lee ahí. La cookie _ttp viene del propio píxel de TikTok: WeProfit no carga ese píxel, así que la cookie solo existe cuando tu tienda lo ejecuta.
Píxel de TikTok y Events API: evita contar dos veces
TikTok cuenta una sola vez la copia del navegador y la copia del servidor de un mismo evento cuando ambas llegan al mismo píxel con el mismo nombre de evento y el mismo ID de evento. Conserva la primera copia que recibe y combina o descarta las copias que llegan después, dentro de un plazo de 48 horas.
WeProfit no carga el píxel de TikTok. Envía los eventos de TikTok solo desde su servidor, cada uno con su propio ID de evento. Una compra se envía como pur_ seguido de un código de la tienda y el ID del pedido de Shopify, por ejemplo pur_a1b2c3d4-6012345678901, una vez por pedido y píxel, y un reintento reutiliza ese ID.
Otra herramienta que envíe al mismo píxel, como la propia app de TikTok para Shopify o código del píxel en tu tema, informa sus propios ID de evento. No serán iguales a los de WeProfit, así que TikTok no puede emparejar las dos copias por ID de evento y puede contar el evento dos veces. La app de TikTok para Shopify, por ejemplo, comparte los eventos de tu tienda con tu píxel según el nivel de uso compartido de datos que elijas: Standard usa el píxel de TikTok, y Enhanced y Maximum agregan la Events API.
Antes de conectar un píxel, haz una lista de todas las herramientas que le envían eventos y decide cuál envía cada evento. Deja un solo emisor de compras por píxel y luego compara una compra de prueba en TikTok Events Manager con el registro de envíos de WeProfit.
Comprueba el envío en el registro de envíos de CAPI
Abre Redes publicitarias > TikTok en WeProfit y desplázate hasta el registro de envíos de CAPI. Enumera cada evento del lado del servidor enviado a TikTok con las columnas Creado, Evento, Destino, ID de evento, Estado, Intentos y Error, y puedes filtrar por destino, evento y estado. El filtro Purchase también encuentra CompletePayment.
El registro muestra el ID de evento propio de WeProfit, por ejemplo pur_6012345678901; TikTok lo recibe con el código de la tienda, por ejemplo pur_a1b2c3d4-6012345678901. El registro no tiene columna de valor, así que comprueba el valor de una compra en la página Eventos de WeProfit. La página Pedidos muestra el envío de cada pedido a cada red conectada en su columna Redes, y el widget Estado del seguimiento resume los envíos del lado del servidor de las últimas 24 horas como Enviados, En curso / reintentando y Fallidos.
El estado enviado significa que TikTok aceptó el evento. No demuestra que TikTok lo haya asociado con un usuario ni que haya atribuido el pedido a un anuncio. Si TikTok rechaza el token de acceso, WeProfit pausa la conexión y muestra un banner; un token nuevo o una prueba correcta con Enviar prueba la vuelven a activar.
| Estado | Qué significa |
|---|---|
| pendiente | En cola y todavía sin enviar. |
| enviado | TikTok aceptó el evento. |
| fallido | Un problema temporal. WeProfit reintenta automáticamente durante unas horas, con el mismo ID de evento. |
| descartado | WeProfit dejó de intentarlo: TikTok rechazó el evento, con su mensaje en la columna Error, o se agotaron los intentos. |
| omitido (desactivado) | El destino estaba desactivado o pausado cuando le tocó el turno al evento. Los eventos omitidos mientras está desactivado no se envían más tarde. |
| omitido (antes de la instalación) | La compra de un pedido realizado antes de instalar WeProfit. Nunca se envía. |
El gasto publicitario de TikTok junto a tus pedidos
El envío de conversiones y el gasto publicitario son conexiones distintas. Para llevar el gasto de TikTok a tus informes de ganancias, abre Ganancias > Gasto publicitario > Cuentas publicitarias en WeProfit, selecciona Conectar cuenta publicitaria y elige TikTok Ads. Conectar con TikTok pide acceso de solo lectura; después elige las cuentas de anunciante y si cuentan para esta tienda todas las campañas o solo las seleccionadas.
WeProfit importa el gasto diario de TikTok por campaña, con los nombres de las campañas: 30 días al conectar y, después, cada hora vuelve a leer los últimos 3 días, que TikTok todavía puede corregir. El gasto en otra moneda se convierte a la moneda de tu tienda con el tipo de cambio de referencia del día.
El gasto se guarda por campaña y día, así que el ROAS, el POAS y la ganancia después de los anuncios llegan hasta el nivel de campaña, no al de grupos de anuncios ni al de anuncios. En Atribución, la ganancia por campaña asocia el gasto sincronizado de TikTok con los pedidos atribuidos por ID o por nombre de campaña. Si además registras a mano el gasto de TikTok de los mismos días, WeProfit te avisa de que puede contarse dos veces.
Detalle por campaña de tus anuncios de TikTok
WeProfit clasifica una visita como TikTok Ads cuando lleva el ID de clic ttclid de TikTok, o utm_source=tiktok con un utm_medium de pago. Con URL Auto-attach de TikTok activado, también lee el ID y el nombre de la campaña. Para el detalle por grupo de anuncios y por anuncio, agrega la plantilla de URL de WeProfit para TikTok a la URL de destino de cada anuncio, después del signo de interrogación. En los anuncios Smart+, usa wpadid=__ADID_V2__ en lugar de wpadid=__CID__.
Las plantillas solo se aplican a los clics nuevos. En la atribución propia de WeProfit, un clic en un anuncio cuenta durante 30 días y gana el clic más reciente, lo que funciona como el modelo de último clic con una ventana de 30 días para los clics en anuncios. TikTok atribuye las conversiones según su propia configuración de atribución, así que sus cifras y las de WeProfit pueden diferir para los mismos pedidos.
utm_source=tiktok&utm_medium=paid&utm_campaign=__CAMPAIGN_NAME__&utm_term=__AID_NAME__&utm_content=__CID_NAME__&wpcid=__CAMPAIGN_ID__&wpasid=__AID__&wpadid=__CID__&wpplc=__PLACEMENT__