# Tracking server-side das conversões TikTok

> Envie as conversões para a TikTok Events API a partir do servidor: compra despoletada pela encomenda validada, identificadores cifrados, alojado na UE.

- Página original: https://server-side.datafirefly.com/pt/tiktok-events-api-server-side-tracking.html
- Idioma: pt
- Atualizado em: 2026-09-05
- Editor: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pt/

---

TikTok Events API v1.3

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.

[Criar uma conta](https://admin.datafirefly.com/pricing?lang=pt) Ver o que é enviado

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 (exceto webhooks do Shopify)

**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_view` | `Pageview` |
| `view_content` | `ViewContent` |
| `add_to_cart` | `AddToCart` |
| `initiate_checkout` | `InitiateCheckout` |
| `add_payment_info` | `AddPaymentInfo` |
| `purchase` | `CompletePayment` |
| `lead` | `SubmitForm` |
| `complete_registration` | `CompleteRegistration` |
| `search` | `Search` |
| `add_to_wishlist` | `AddToWishlist` |
| `contact` | `Contact` |
| `subscribe` | `Subscribe` |

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. No Shopify, o pixel da DataFirefly segue o consentimento de marketing registado no Shopify, mas as encomendas chegam por webhooks assinados que não transmitem qualquer sinal de consentimento, pelo que se lhes aplica a sua própria política de consentimento.

### 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. No Shopify, o pixel da DataFirefly segue o consentimento de marketing registado no Shopify, mas as encomendas chegam por webhooks assinados que não transmitem qualquer sinal de consentimento, pelo que se lhes aplica a sua própria política de consentimento.

### 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.

Ir mais longe

## O passo seguinte

Instalar o conector na sua loja, saber o que mede e verificar o que saiu realmente.

### [Módulo PrestaShop](https://server-side.datafirefly.com/pt/prestashop-server-side-tracking.html)

A instalação numa loja PrestaShop, passo a passo.

### [Plugin WooCommerce](https://server-side.datafirefly.com/pt/woocommerce-server-side-tracking.html)

A instalação em WordPress e WooCommerce.

### [Extensão Shopware](https://server-side.datafirefly.com/pt/shopware-server-side-tracking.html)

A instalação em Shopware 6.

### [O que medimos](https://server-side.datafirefly.com/pt/o-que-medimos.html)

Os 28 eventos em claro, e o que vê um site sem loja.

### [Insights: o painel](https://server-side.datafirefly.com/pt/insights.html)

Onde verifica o que saiu e o que o destino fez com isso.

### [Todos os destinos](https://server-side.datafirefly.com/pt/#destinations)

As sete plataformas para onde um mesmo evento pode ir.

## Ligue este destino em poucos minutos

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

[Começar grátis](https://admin.datafirefly.com/pricing?lang=pt) [Vamos conversar](https://server-side.datafirefly.com/pt/contact.html)
