TikTok Events API v1.3

Tracking server-side das conversões TikTok

As suas conversões saem do seu servidor para a API de Eventos da TikTok, não do navegador de um visitante que talvez bloqueie o píxel. A compra é despoletada pela encomenda validada, não por uma página de agradecimento que o cliente pode nunca carregar.

Os identificadores são normalizados e depois cifrados antes do envio: a TikTok recebe o suficiente para ligar a conversão a uma pessoa, nunca o endereço em si.

Enviado a partir do seu servidor Identificadores cifrados antes do envio Alojado na UE
O caminho de uma compra
A sua loja A encomenda é validada do lado do servidor, não numa página de agradecimento
Dispatcher DataFirefly Consentimento verificado, identificadores normalizados e cifrados
TikTok Events API v1.3 CompletePayment, com o valor e os produtos
Pageview AddToCart CompletePayment SubmitForm
O problema

Onde uma loja perde as suas conversões TikTok

O píxel da TikTok depende de uma cadeia frágil: o navegador carrega o script, executa-o, e nada o bloqueia pelo caminho.

O píxel não carrega

Bloqueadores, navegadores restritivos, uma ligação móvel que cai a meio: o evento nunca existe, e a TikTok otimiza com o que resta.

A compra depende de uma página

O píxel dispara na página de confirmação. Quem fecha o separador depois de pagar comprou, e a conversão nunca saiu.

Uma correspondência fraca custa ROAS

Sem identificador utilizável, a TikTok não liga a conversão a um perfil. A campanha parece pior do que é e o algoritmo aprende com dados incompletos.

Instalação

Três passos, e nada para reescrever

O conector instala-se na sua loja; o resto define-se na consola.

1: Instalar o conector

O módulo PrestaShop, o plugin WooCommerce ou a extensão Shopware, descarregados da sua consola. Sem escrever código.

2: Colar dois valores

O código do píxel e o token, retirados da sua própria conta TikTok. São cifrados em repouso e nunca reaparecem numa página.

3: Verificar em Test Events

Os seus eventos chegam ao ecrã de testes da TikTok antes de passar a produção.

Correspondências

O que a TikTok recebe, evento a evento

Doze dos nossos eventos têm um nome oficial na TikTok. Os que não têm não são enviados para este destino: vão para os outros, sem erro nem perda.

O nosso nome Nome na plataforma
page_viewPageview
view_contentViewContent
add_to_cartAddToCart
initiate_checkoutInitiateCheckout
add_payment_infoAddPaymentInfo
purchaseCompletePayment
leadSubmitForm
complete_registrationCompleteRegistration
searchSearch
add_to_wishlistAddToWishlist
contactContact
subscribeSubscribe
Os limites

O que a TikTok não saberá fazer

Cada destino tem um vocabulário fechado, exceto um. É isto que implica, dito antes de o descobrir.

Os eventos sem nome na TikTok não são enviados

A TikTok não tem equivalente oficial para uma marcação, uma partilha ou uma candidatura. Esses eventos não lhe são enviados: vão para os seus outros destinos, sem erro. Preferimos não enviar nada a forçá-los num nome próximo que falsearia os seus números.

A qualidade de correspondência depende de si

A TikTok liga a conversão a um perfil graças aos identificadores que a sua loja nos transmite. Uma encomenda sem endereço de e-mail sai à mesma, mas corresponde pior. A consola mostra-lhe essa cobertura dia a dia.

Verificável

O que a consola lhe mostrará para este destino

Um argumento que podemos sustentar porque a página existe: não tem de acreditar em nós, olha.

Cada evento, com a resposta da plataforma

O Inspector lista o que saiu, o que o destino fez com isso e o motivo exato de uma recusa. Um identificador inválido ou um token expirado leem-se em claro, no próprio dia.

A cobertura dos identificadores

Quantos dos seus eventos levavam com que ligar a conversão a uma pessoa. É isso que decide a qualidade de correspondência e, portanto, o ROAS que lerá no anunciante.

Os períodos em que nada saiu

A anomalia mais dispendiosa e a mais discreta: um painel vazio lê-se como uma semana fraca, nunca como uma avaria. A consola nomeia-os.

Requisitos

O que precisa

Dois valores, da sua própria conta TikTok. Nunca lhe pedimos a palavra-passe.

O código do píxel

TikTok Ads Manager → Assets → Events → Web Events → o seu píxel. É o «Event Source ID».

Um token de acesso

Gerado na configuração da Events API do mesmo ecrã. Cifrado em repouso e nunca visível numa página.

Um código de evento de teste (opcional)

Para ver os seus eventos chegar a Test Events antes de passar a produção.

Privacidade

O que não sai da nossa infraestrutura

Um produto que manipula dados de clientes deve dizer onde para.

Os identificadores são cifrados antes do envio

Normalizados e depois cifrados aqui: o destino recebe uma impressão, nunca o endereço de e-mail ou o número de telefone.

O consentimento decide, também do lado do servidor

Cada evento leva o estado registado pelo seu banner. Uma recusa continua a ser uma recusa: passar pelo servidor não contorna nada.

Alojado na União Europeia

O dispatcher, a base de dados e a consola estão na Alemanha. Os seus tokens são cifrados em repouso e nunca reaparecem em claro numa página.

Sem surpresas

Simples de instalar, e sem custo acrescentado

É uma opção de conceção, não uma promessa comercial: não há nada para alojar nem nada para desbloquear plano a plano.

Um módulo, como os outros

O conector instala-se como qualquer outra extensão da sua loja. Nada para alojar: nenhum contentor para alugar, nenhum servidor para manter, nenhum subdomínio para configurar.

Todos os destinos, em todos os planos

Incluindo o gratuito. Os planos diferem apenas no número de sites e de eventos: nenhum destino está reservado a um patamar, embora seja o hábito.

Começar não custa nada

O plano gratuito cobre um site e 10 000 eventos por mês, sem cartão. Nada quebra se ultrapassar a quota.

Ce qu'on nous demande

Questions fréquentes

O píxel da TikTok continua a ser necessário?

Sim, e é intencional. O píxel e o envio do servidor levam o mesmo identificador de evento, por isso a TikTok junta-os em vez de contar duas vezes. O píxel traz o contexto do navegador, o servidor garante que a compra chega mesmo quando o píxel não pôde executar-se.

As minhas conversões vão ser contadas duas vezes?

Não. A desduplicação assenta no identificador de evento, que fixamos a partir do número da encomenda. Dois envios da mesma encomenda levam o mesmo identificador: a TikTok fica com um.

Que dados pessoais são enviados?

Os identificadores são normalizados e depois cifrados antes de saírem da nossa infraestrutura: a TikTok recebe uma impressão, nunca o endereço. Nada sai sem o consentimento registado pelo seu banner.

O que acontece se a TikTok recusar um evento?

O Inspector da sua consola mostra a recusa com a mensagem exata da TikTok. Um token expirado vê-se no próprio dia, não no balanço mensal.

Ligue este destino em poucos minutos

O plano gratuito inclui todos os destinos. Sem compromisso e sem cartão.