Integración · destino
TikTok Ads
TikTok Pixel y Events API con coincidencia por ttclid y deduplicación.
Cómo llegan los eventos a TikTok
Todas las rutas terminan en el mismo sitio: el motor de políticas comprueba la finalidad de consentimiento que exige este destino, elimina lo que no puede salir y el worker entrega con el ID de evento compartido.
- Etiqueta de navegador: la carga el snippet de Track tras el consentimiento; el script del proveedor nunca está en tu plantilla y nunca se carga sin la finalidad requerida.
- API de servidor: el worker entrega con reintentos, comprobaciones de salud, clasificación de errores y una vista previa del payload con los secretos ocultos en cada intento.
- Conversiones offline: los eventos de servidor marcados como offline (oportunidades de CRM, pedidos telefónicos, compras en tienda física) llegan a esta plataforma con la fuente de acción offline del proveedor.
- Híbrido: la etiqueta de navegador y la petición de servidor comparten un ID de evento; la plataforma deduplica por event_id.
Qué se envía
Solo lo que configures en el mapeo de eventos, y solo después de que el motor de políticas haya autorizado el evento para este destino.
- Nombre del evento y marca de tiempo, mapeados desde los eventos estándar de Track a los nombres de evento de la plataforma.
- El ID de evento compartido en el campo event_id de la plataforma, para que las entregas de navegador y de servidor cuenten una sola vez.
- IDs de clic que puede recibir esta plataforma: ttclid. Los IDs de clic de otros proveedores nunca se reenvían.
- ID de pedido, valor, moneda y artículos en los eventos de tipo compra.
- Identificadores con hash SHA-256 (correo electrónico, teléfono, ID externo) para el matching, solo con el consentimiento requerido y solo si se han capturado.
- El estado del consentimiento con el que se recogió el evento, cuando la plataforma acepta señales de consentimiento.
Nunca se envía
- Correos electrónicos, teléfonos o nombres en claro: los identificadores se convierten en hash en la ingesta.
- Valores inferidos: lo desconocido sigue siendo desconocido, no se adivina nada.
- Eventos recogidos sin la finalidad que exige este destino.
- Secretos: los tokens viven en el almacén cifrado y nunca llegan al navegador, al asistente ni a un log.
Datos técnicos
- Campo de deduplicación
event_id— event_id- IDs de clic
ttclid- Finalidad del consentimiento
- Marketing
- Versión de API fijada
v1.3- Estado de implementación
- Implementada · verificada contra la documentación del proveedor · verificada el 2026-09-03
- Documentación del proveedor
- Documentación de la API de TikTok
Qué necesitas
Los identificadores públicos se pueden escribir en el chat o en el asistente paso a paso; los secretos pasan por la tarjeta segura de credenciales o por OAuth y se guardan cifrados.
Identificadores públicos
- pixel_id
- Código del píxel
Credenciales
- Token de acceso a la API
access_token— guardado en el almacén cifrado
Consentimiento
Requiere la finalidad de marketing. Sin ella no se carga nada en el navegador ni se envía nada desde el servidor. El consentimiento inferido nunca se exporta, y las señales de exclusión de Global Privacy Control bloquean la entrega.
Configuración en pocos pasos
El asistente ejecuta las comprobaciones detalladas. Tú ves los hitos que necesitan una decisión tuya.
Introduce los identificadores
Añade los IDs públicos de la plataforma. Los formatos se validan contra la documentación del proveedor antes de guardar nada.
Conecta las credenciales
Pega el token en la tarjeta segura o conecta la cuenta mediante OAuth. Los secretos van directamente al almacén cifrado.
Mapea y prueba
Los eventos estándar vienen premapeados a los nombres de evento de la plataforma. Un evento de prueba marcado recorre el pipeline real y muestra la respuesta del proveedor.
Publica
Revisa el diff, aprueba y publica una versión de configuración firmada. Si hace falta, vuelve atrás con un clic.
De Tracking Knowledge
Guías escritas por el equipo que construye este conector.
TikTok Events API 2.0: píxel más eventos de servidor con ttclid, _ttp y un event_id compartido
Cómo configurar juntos el píxel de TikTok y la Events API: token de acceso, código del píxel, el payload de /event/track/, claves de coincidencia, deduplicación y códigos de evento de prueba.
Tutorial · 3 min de lectura
Deduplicación que resiste la realidad: ID de evento, ID de pedido y qué clave usa realmente cada plataforma
Una tabla plataforma por plataforma de las claves de deduplicación — Meta, Google Ads, GA4, TikTok, Microsoft, LinkedIn, Pinterest, Snapchat, Reddit, X, CM360 — y la estrategia de dos claves que mantiene honesto el tracking híbrido.
Referencia · 4 min de lectura
IDs de clic y ventanas de atribución: qué parámetros capturar, cuánto tiempo conservarlos y dónde guardarlos
Una referencia de los IDs de clic publicitarios (gclid, gbraid, wbraid, dclid, msclkid, fbclid, ttclid, li_fat_id, rdt_cid, epik, ScCid, twclid, tblci, ob_click_id, IDs de afiliación), cómo el consentimiento condiciona su captura, en qué se diferencian las ventanas de atribución de cada plataforma y cómo debería caducar el almacenamiento first-party.
Referencia · 4 min de lectura
Preguntas
¿Puedo usar solo el modo servidor?
Sí. Elige el modo servidor en el asistente paso a paso; el script del proveedor nunca se carga y el matching se basa en identificadores con hash e IDs de clic capturados por el tracker.
¿Cómo se evitan los duplicados?
La etiqueta de navegador y la petición de servidor llevan el mismo ID de evento, y las compras añaden el ID de pedido. El worker también deduplica los eventos de origen repetidos antes de la entrega.
¿Qué pasa si cambia la API del proveedor?
Las versiones de API se fijan de forma centralizada con la fecha de verificación; los avisos de retirada aparecen en la salud del destino mucho antes de que se retire un endpoint.
Conecta TikTok
Configúralo con el asistente paso a paso o deja que el asistente de IA lo haga en el chat.