Información general sobre la extensión API de eventos web TikTok
La API de eventos TikTok es una interfaz segura API de Edge Network Server que le permite compartir información con TikTok directamente sobre las acciones del usuario en sus sitios web. Puede aprovechar las reglas de reenvío de eventos para enviar datos de Adobe Experience Platform Edge Network a TikTok mediante la extensión de API de eventos web TikTok.
TikTok requisitos previos prerequisites
Para configurar la API de eventos web TikTok para que use la API de eventos TikTok, debe generar un código de píxeles TikTok y un token de acceso.
Debe tener un TikTok válido para la cuenta empresarial a fin de crear un píxel de TikTok mediante la configuración del socio. Vaya a la página de registro TikTok para empresas para registrarse y crear una cuenta si todavía no la tiene.
Debe iniciar sesión en su cuenta empresarial para configurar TikTok píxeles mediante la configuración de socio. Para realizar esto, siga los pasos a continuación:
- Vaya a la pestaña Assets y seleccione Evento.
- En Eventos web, seleccione Administrar.
- Seleccione Configurar eventos web.
- Seleccione Configuración de socio como método de conexión.
Consulte la guía de Introducción a Pixel para obtener más información sobre cómo configurar el píxel TikTok.
Puede generar un token de acceso una vez que el píxel se haya creado correctamente. Para ello, vaya al píxel y seleccione la pestaña Configuración. En la API de eventos, seleccione Generar token de acceso.
Consulte la TikTok guía de introducción para obtener más información sobre cómo configurar el código de píxel y el token de acceso.
Instale y configure la extensión de la API de eventos web TikTok install
Para instalar la extensión, seleccione Extensions en el panel de navegación izquierdo. En la ficha Catálogo, seleccione la extensión de la API TikTok Web Events y, a continuación, seleccione Instalar.
En la siguiente pantalla, escriba los siguientes valores de configuración que generó anteriormente desde el Administrador de anuncios de TikTok:
- Código en píxeles
- Token de acceso
Cuando termine, seleccione Guardar.
Pantalla de configuración de
Configuración de una regla de reenvío de eventos config-rule
Una vez configurados todos los elementos de datos, puede empezar a crear reglas de reenvío de eventos que determinan cuándo y cómo se enviarán los eventos a TikTok.
Cree una nueva regla en su propiedad de reenvío de eventos. En Acciones, agregue una nueva acción y establezca la extensión en Extensión de la API de eventos web de TikTok. Para enviar eventos de Edge Network a TikTok, establezca Tipo de acción en Enviar evento de API de eventos web de TikTok.
Después de la selección, aparecen controles adicionales para configurar aún más el evento, como se describe a continuación. Una vez finalizado, seleccione Conservar cambios para guardar la regla.
Eventos web y parámetros
Los eventos y parámetros web contienen información general sobre el evento. Los eventos estándar son compatibles con las herramientas de integración de TikTok y se pueden usar para generar informes, optimizar conversiones y crear audiencias.
yyyy-MM-dd'T'HH:mm:ss:SSSZ
. Este campo es obligatorio.
Parámetros de contexto de usuario
Los parámetros de contexto de usuario contienen información de cliente que se usa para hacer coincidir eventos de visitantes web con TikTok usuarios. La inclusión de varios tipos de datos coincidentes permite aumentar la precisión de los modelos de segmentación y optimización.
_ttp
, en caso de que las cookies estén habilitadas. El valor _ttp
se puede extraer y utilizar para este campo.ttclid
que se agrega a la dirección URL de la página de aterrizaje cada vez que se selecciona un anuncio en TikTok.
Parámetros de propiedades
Utilice los parámetros de propiedades para configurar propiedades compatibles adicionales.
product
o product_group
a la propiedad del objeto content_type, según cómo configure la fuente de datos al configurar el catálogo de productos.
Deduplicación de eventos deduplication
Se deberán configurar TikTok píxeles para la anulación de duplicación si utiliza el SDK de TikTok píxeles y la extensión de API de eventos web TikTok para enviar los mismos eventos a TikTok.
La deduplicación no es necesaria si se envían distintos tipos de eventos desde el cliente y el servidor sin ninguna superposición. Para asegurarse de que los informes no se vean afectados negativamente, debe asegurarse de deduplicar cualquier evento único compartido por el SDK de píxeles TikTok y la extensión de API de eventos web TikTok.
Al enviar eventos compartidos, asegúrese de que cada evento incluya un ID de píxel, un ID de evento y un nombre. Se combinarán los eventos duplicados que llegan en un plazo de cinco minutos uno del otro. Si el campo de datos estaba ausente del primer evento, se combina con el evento posterior. Se eliminará cualquier evento duplicado recibido en un plazo de 48 horas.
Consulte la documentación de TikTok sobre Anulación de duplicación de eventos para obtener más información sobre este proceso.
Pasos siguientes
En esta guía se explica cómo enviar datos de eventos del lado del servidor a TikTok mediante la extensión de API de eventos web TikTok. Para obtener más información sobre las capacidades de reenvío de eventos en Adobe Experience Platform, consulte la descripción general del reenvío de eventos.