How to set up a secure data connection with TikTok through Blotout
TikTok for Business offers many tools that let you share the actions people take on your website with TikTok. When you share these events with TikTok, you can better optimize your campaigns and measure ad performance.
This article describes how to setup a secure data connection through Blotout. Blotout supports the TikTok Pixel and Events API.
For more information on these connection tools, please review the following resources:
Incorporación
No es necesario que configures tu Píxel de TikTok por separado, ya que Blotout lo cargará.
TikTok tiene siete campos:
Pixel ID (ID del píxel) (obligatorio): ID del píxel al que te gustaría atribuir.
Advertiser ID (ID del anunciante) (obligatorio): ID del anunciante que se necesita para la sincronización de la audiencia.
oAuth (obligatorio): un token que autoriza a EdgeTag para el acceso a la API de TikTok.
Browser pixel (Píxel del navegador) (opcional): si lo activas, inyectaremos automáticamente el píxel del navegador de TikTok y enviaremos los mismos eventos desde el navegador y el servidor. Es esencial que añadas el mismo ID de evento a los dos eventos, ya que eso permitirá a TikTok eliminar el duplicado. Si no lo habilitas, es posible que estés enviando eventos duplicados desde los píxeles existentes, lo que inflará tus eventos de compra.
Offline Event Set ID (ID del conjunto de eventos offline) (opcional): ID del conjunto que se usará para las conversiones offline.
Purchase Event (Evento de compra) (opcional): puedes seleccionar cómo aparecerá el evento de compra en los informes de TikTok. Puedes elegir entre CompletePayment y PlaceAnOrder.
Event test code (Código de prueba de eventos) (opcional): introduce el código de prueba proporcionado para tu píxel en el Administrador de eventos con el fin de probar los eventos y verificar si todo se ha recopilado correctamente. Debes eliminar este código de prueba cuando actives EdgeTag, ya que, de lo contrario, los eventos no se registrarán.
LDU (opcional): si lo habilitas, puedes notar un efecto en el tamaño de las audiencias de California, Colorado, Connecticut, Delaware, Florida, Indiana, Iowa, Kentucky, Maryland, Minnesota, Montana, Nebraska, Nueva Jersey, Nuevo Hampshire, Oregón, Tennessee, Texas, Utah y Virginia, así como en la eficacia de sus campañas, porque los datos de LDU no se usan con fines de optimización. LDU es una función que da a las empresas más control sobre el uso de los datos de sus eventos en los sistemas de TikTok. Para obtener más información, consulta el artículo relativo al uso limitado de los datos.
Para encontrar el ID del píxel:
Ve a TikTok Ads Manager. Pasa el cursor por la opción Herramientas y haz clic en Administrador de eventos para abrir el Administrador de eventos.
En el lado derecho, en Descripción de los conjuntos de datos, haz clic en el píxel que quieras usar.
Copia el valor del ID del píxel y pégalo en el campo correspondiente en Blotout.
ID del anunciante
En TikTok Ads Manager, haz clic en el menú desplegable de la cuenta situado en la esquina superior derecha del encabezado. Copia el ID de la cuenta publicitaria correcta que desees usar con Blotout.
ID del conjunto de eventos offline
Como en el caso del ID del píxel, tienes que ir a la sección de eventos. En lugar de Eventos web, selecciona Eventos offline. Copia el ID del conjunto de eventos offline correcto que desees usar.
Configuración del navegador
Cuando uses nuestro SDK a través del paquete npm, tendrás que añadir otro paquete para que este proveedor funcione correctamente. Debes instalar @blotoutio/providers-tiktok-sdk.
Después de instalarlo, tendrás que añadirlo a tu llamada init.
Ejemplo
# Code Snippet
import { init } from '@blotoutio/edgetag-sdk-js'
import tiktok from '@blotoutio/providers-tiktok-sdk'
init({
edgeURL: 'https://d.mysite.com',
disableConsentCheck: true,
providers: [tiktok]
})
Eventos
Estos son los eventos estándar que recomienda TikTok.
Puedes encontrar los eventos estándar en nuestra guía.
Evento | Acción |
|---|---|
ClickButton | Cuando se hace clic en un botón. |
AddToWishlist | Cuando se añade un artículo a la lista de deseos. |
Contactar | Cuando se produce un contacto o una consulta. |
Descargar | Cuando se hace clic en un botón para abrir una página de descarga externa del navegador. |
SubmitForm | Cuando se envía un formulario. |
CompleteRegistration | Cuando se completa un registro. |
Para todos los eventos anteriores, hay campos opcionales, como los de la siguiente lista, que se pueden enviar.
Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
currency | string | no | Código ISO 4217 |
value | number | no | Valor del pedido o los artículos vendidos, que es el precio total del pedido |
búsqueda | string | no | Cadena de texto que se ha buscado |
contenidos | Contents[] | no | Artículos relacionados en un evento web |
Definiciones de tipos
Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
id | string | sí | ID del artículo del producto. |
quantity | number | no | Número de artículos. |
item_price | number | no | Precio de un solo artículo. |
title | string | no | Nombre de la página/producto. |
category | string | no | Categoría de la página/producto. |
price | string | sí | El valor de la propiedad del objeto content_type se debe establecer en product o en product_group. Si vas a realizar el seguimiento de eventos asociados a productos individuales, define el valor como product. Si vas a realizar el seguimiento de eventos asociados a grupos de productos, defínelo como “product_group” en su lugar. |
A continuación, puedes ver un ejemplo de la carga útil que debes usar para que el proveedor procese correctamente este evento concreto, que no está definido en nuestros eventos estándar.
Ejemplos
// Browser example
edgetag('tag', 'AddToCart', { value: 10.0, currency: 'USD' })
// Node example
import { tag } from '@blotoutio/edgetag-sdk-js'
tag('AddToCart', { value: 10.0, currency: 'USD' })
