TikTok Events API v1.3

Seguimiento server-side de las conversiones de TikTok

Sus conversiones salen de su servidor hacia la API de Eventos de TikTok, no del navegador de un visitante que quizá bloquea el píxel. La compra la dispara el pedido validado, no una página de agradecimiento que el cliente puede no cargar nunca.

Los identificadores se normalizan y luego se cifran antes del envío: TikTok recibe lo necesario para vincular la conversión a una persona, nunca la dirección en sí.

Enviado desde su servidor Identificadores cifrados antes del envío Alojado en la UE
El camino de una compra
Su tienda El pedido se valida en el servidor, no en una página de agradecimiento
Dispatcher DataFirefly Consentimiento verificado, identificadores normalizados y cifrados
TikTok Events API v1.3 CompletePayment, con el importe y los productos
Pageview AddToCart CompletePayment SubmitForm
El problema

Dónde pierde una tienda sus conversiones de TikTok

El píxel de TikTok depende de una cadena frágil: el navegador carga el script, lo ejecuta y nada lo bloquea por el camino.

El píxel no se carga

Bloqueadores, navegadores restrictivos, una conexión móvil que se corta a media sesión: el evento nunca existe, y TikTok optimiza con lo que queda.

La compra depende de una página

El píxel se dispara en la página de confirmación. Quien cierra la pestaña tras pagar sí ha comprado, y la conversión nunca salió.

Un emparejamiento pobre cuesta ROAS

Sin identificador utilizable, TikTok no vincula la conversión a un perfil. La campaña parece peor de lo que es y el algoritmo aprende con datos incompletos.

Instalación

Tres pasos, y nada que reescribir

El conector se instala en su tienda; el resto se ajusta en la consola.

1: Instalar el conector

El módulo PrestaShop, el plugin WooCommerce o la extensión Shopware, descargados desde su consola. Sin escribir código.

2: Pegar dos valores

El código del píxel y el token, tomados de su propia cuenta de TikTok. Se cifran en reposo y no vuelven a aparecer en ninguna página.

3: Comprobar en Test Events

Sus eventos llegan a la pantalla de pruebas de TikTok antes de pasar a producción.

Correspondencias

Lo que recibe TikTok, evento por evento

Doce de nuestros eventos tienen un nombre oficial en TikTok. Los que no lo tienen no se envían a este destino: van a los demás, sin error ni pérdida.

Nuestro nombre Nombre en la plataforma
page_viewPageview
view_contentViewContent
add_to_cartAddToCart
initiate_checkoutInitiateCheckout
add_payment_infoAddPaymentInfo
purchaseCompletePayment
leadSubmitForm
complete_registrationCompleteRegistration
searchSearch
add_to_wishlistAddToWishlist
contactContact
subscribeSubscribe
Los límites

Lo que TikTok no sabrá hacer

Cada destino tiene un vocabulario cerrado, salvo uno. Esto es lo que implica, dicho antes de que lo descubra.

Los eventos sin nombre en TikTok no se envían

TikTok no tiene equivalente oficial para una cita, un compartido o una candidatura. Esos eventos no se le envían: van a sus otros destinos, sin error. Preferimos no enviar nada antes que forzarlos a un nombre parecido que falsearía sus cifras.

La calidad de emparejamiento depende de usted

TikTok vincula la conversión a un perfil gracias a los identificadores que su tienda nos transmite. Un pedido sin correo electrónico sale igualmente, pero empareja peor. La consola le muestra esa cobertura día a día.

Verificable

Lo que la consola le mostrará para este destino

Un argumento que podemos sostener porque la página existe: no tiene que creernos, lo mira.

Cada evento, con la respuesta de la plataforma

El Inspector lista lo que salió, lo que el destino hizo con ello y el motivo exacto de un rechazo. Un identificador inválido o un token caducado se leen en claro, el mismo día.

La cobertura de identificadores

Cuántos de sus eventos llevaban con qué vincular la conversión a una persona. Eso decide la calidad de emparejamiento y, por tanto, el ROAS que leerá en el anunciante.

Los periodos en que no salió nada

La anomalía más costosa y la más discreta: un panel vacío se lee como una mala semana, nunca como una avería. La consola los nombra.

Requisitos

Lo que necesita

Dos valores, de su propia cuenta de TikTok. Nunca le pedimos su contraseña.

El código del píxel

TikTok Ads Manager → Assets → Events → Web Events → su píxel. Es el «Event Source ID».

Un token de acceso

Generado en la configuración de la Events API de la misma pantalla. Cifrado en reposo y nunca visible en una página.

Un código de evento de prueba (opcional)

Para ver llegar sus eventos a Test Events antes de pasar a producción.

Privacidad

Lo que no sale de nuestra infraestructura

Un producto que maneja datos de clientes debe decir dónde se detiene.

Los identificadores se cifran antes del envío

Normalizados y luego cifrados aquí: el destino recibe una huella, nunca el correo electrónico ni el teléfono.

El consentimiento decide, también del lado del servidor

Cada evento lleva el estado registrado por su banner. Un rechazo sigue siendo un rechazo: pasar por el servidor no elude nada.

Alojado en la Unión Europea

El dispatcher, la base de datos y la consola están en Alemania. Sus tokens se cifran en reposo y no vuelven a aparecer en claro en ninguna página.

Sin sorpresas

Sencillo de instalar y sin coste añadido

Es una decisión de diseño, no una promesa comercial: no hay nada que alojar ni nada que desbloquear plan a plan.

Un módulo, como los demás

El conector se instala como cualquier otra extensión de su tienda. Nada que alojar: ningún contenedor que alquilar, ningún servidor que mantener, ningún subdominio que configurar.

Todos los destinos, en todos los planes

Incluido el gratuito. Los planes solo se diferencian por el número de sitios y de eventos: ningún destino está reservado a un nivel, aunque sea lo habitual.

Empezar no cuesta nada

El plan gratuito cubre un sitio y 10 000 eventos al mes, sin tarjeta. Nada se rompe si supera la cuota.

Ce qu'on nous demande

Questions fréquentes

¿Sigue siendo necesario el píxel de TikTok?

Sí, y es intencionado. El píxel y el envío de servidor llevan el mismo identificador de evento, así que TikTok los une en vez de contar dos veces. El píxel aporta el contexto del navegador, el servidor garantiza que la compra llegue aunque el píxel no haya podido ejecutarse.

¿Se contarán mis conversiones dos veces?

No. La deduplicación se apoya en el identificador de evento, que fijamos a partir del número de pedido. Dos envíos del mismo pedido llevan el mismo identificador: TikTok se queda con uno.

¿Qué datos personales se envían?

Los identificadores se normalizan y luego se cifran antes de salir de nuestra infraestructura: TikTok recibe una huella, nunca la dirección. Nada sale sin el consentimiento que registró su banner.

¿Qué ocurre si TikTok rechaza un evento?

El Inspector de su consola muestra el rechazo con el mensaje exacto de TikTok. Un token caducado se ve el mismo día, no en el balance mensual.

Conecte este destino en unos minutos

El plan gratuito incluye todos los destinos. Sin compromiso y sin tarjeta.