Voltar ao blog
    TikTok
    Server-Side Tracking
    sGTM
    Events API
    Tutorial
    Privacidade

    Guia completo do TikTok server-side tracking com sGTM e Tracking Hippo

    17 de agosto de 2025
    10 min de leitura
    Tutorial

    O TikTok server-side tracking garante medição precisa de conversões e conformidade com o GDPR para suas campanhas de anúncios. Ao implementar o TikTok Events API junto com o tradicional TikTok Pixel, você captura dados mais confiáveis e reduz perdas causadas por restrições a cookies third-party e limitações de tracking no iOS.

    Por que o TikTok server-side tracking é importante

    Mais qualidade dos dados

    Recupere dados de conversão perdidos por ad blockers e restrições de navegador

    Conformidade de privacidade

    Atenda aos requisitos do GDPR com transmissão de dados servidor-a-servidor

    Otimização de campanha

    Tracking de conversões aprimorado melhora a performance do algoritmo do TikTok

    Passo 1: criar o container Server do Google Tag Manager

    O primeiro passo é criar um container de servidor para gerenciar suas tags server-side. Com um container de servidor, você coloca tags no seu site sem alterar código, gerenciando tudo a partir de um único local central.

    Configuração do container de servidor

    1. Acesse o Google Tag Manager: vá até sua conta GTM em tagmanager.google.com
    2. Criar novo container: clique em "Create Account" ou adicione um novo container a uma conta existente
    3. Selecione Server Container: escolha "Server" como plataforma de destino (não Web)
    4. Configure as opções: dê um nome descritivo ao container (ex.: "SuaMarca-Server-Production")
    5. Obtenha o Container Config: copie a string de configuração do container de servidor para o setup de hosting
    Dica de especialista

    Uma base sólida de server-side tracking é essencial para o sucesso. Considere seguir nosso guia completo de 7 passos para configurar a infraestrutura de server-side tracking.

    Passo 2: hospedar seu container no Tracking Hippo

    O Tracking Hippo oferece hosting sGTM em conformidade com a UE, com deploy automatizado e infraestrutura gerenciada. Isso elimina a complexidade da configuração de servidor e garante a conformidade com o GDPR.

    Processo de deploy no Tracking Hippo

    1. Crie a conta Tracking Hippo: cadastre-se em trackinghippo.io e acesse seu dashboard
    2. Novo container de servidor: clique em "Create New Container" e selecione sua região da UE preferida
    3. Insira o Container Config: cole a configuração do container GTM de servidor do Passo 1
    4. Configure o domínio personalizado: defina seu subdomínio de tracking (ex.: analytics.seudominio.com)
    5. Faça o deploy e configure o DNS: faça o deploy do container e atualize seu DNS com os registros CNAME fornecidos
    Exemplo de configuração de DNS
    CNAME analytics.seudominio.com → seu-container.trackinghippo.eu
    # Substitua pelo seu domínio e endpoint Tracking Hippo reais

    Passo 3: instalar o TikTok Pixel

    O TikTok Pixel é essencial para rastrear ações dos visitantes no seu site, como visualizar produtos ou concluir compras. Esse método tradicional de tracking funciona em conjunto com o server-side tracking para uma coleta de dados completa.

    Implementação do TikTok Pixel

    1. Acesse o TikTok Ads Manager: vá até sua conta TikTok Business e acesse o Ads Manager
    2. Crie o TikTok Pixel: vá em Assets → Events e crie um novo TikTok Pixel para seu site
    3. Obtenha o código do Pixel: copie o seu TikTok Pixel ID único (formato: C9XXXXXXXXXXXXXXXXX)
    4. Instale no GTM: adicione a tag do TikTok Pixel ao seu container web (não ao container de servidor)
    5. Configure os eventos: configure eventos padrão como ViewContent, AddToCart e Purchase
    Eventos padrão do TikTok
    • ViewContent — visualizações de página de produto
    • AddToCart — adicionar ao carrinho
    • InitiateCheckout — início do checkout
    • Purchase — transações concluídas
    • Subscribe — inscrições em newsletter
    • SubmitForm — envios de formulário

    Passo 4: configurar o TikTok Events API

    O TikTok Events API envia dados de conversão diretamente do seu servidor para o TikTok, oferecendo um tracking mais confiável do que implementações apenas com pixel. Essa abordagem servidor-a-servidor contorna restrições de navegador e ad blockers.

    Processo de configuração do Events API

    1. Conecte seu container web: no seu container web do GTM, defina o parâmetro server_container_url da sua tag do Google com seu domínio de rastreamento personalizado (ex.: https://analytics.seudominio.com) — o client GA4 do seu container de servidor receberá esses eventos e poderá acionar sua tag da TikTok Events API
    2. Obtenha o token de acesso: no TikTok Ads Manager, vá em Assets → Events → Manage e gere um token de acesso do Events API
    3. Instale a tag do Events API: no seu container GTM de servidor, adicione o template de tag do TikTok Events API a partir da Community Template Gallery
    4. Configure a autenticação: adicione seu token de acesso e o TikTok Pixel ID na configuração da tag
    5. Configure os parâmetros de evento: mapeie os eventos do seu site para os eventos padrão do TikTok (Purchase, ViewContent, etc.)
    6. Configure os dados do usuário: configure parâmetros de informações do cliente como email, phone e external_id para melhor matching

    Parâmetros de dados recomendados

    Dados do evento:
    • Nome do evento (Purchase, ViewContent)
    • Horário do evento (timestamp do servidor)
    • Valor e moeda
    • Content IDs e categorias
    Dados do usuário (com hash):
    • Endereço de e-mail (SHA256)
    • Número de telefone (SHA256)
    • External ID (ID do cliente)
    • Endereço IP e user agent
    Privacidade e segurança

    O Events API faz hash automático dos dados pessoais (email, telefone) usando SHA256 antes da transmissão. Isso garante a conformidade com o GDPR mantendo a utilidade dos dados para matching de audiência.

    Passo 5: garantir a deduplicação de eventos

    A deduplicação de eventos evita que a mesma conversão seja contada duas vezes ao usar TikTok Pixel e Events API simultaneamente. Isso garante relatórios limpos e precisos e evita métricas de conversão infladas.

    Por que a deduplicação é importante

    Ao rodar TikTok Pixel e Events API ao mesmo tempo (setup recomendado), a mesma ação do usuário pode ser rastreada duas vezes — uma pelo pixel e outra pelo servidor. Isso leva à contagem duplicada de conversões e a dados distorcidos de performance de campanha.

    Implementando a deduplicação de eventos

    1. Gere um Event ID: crie um identificador único para cada evento de conversão (ex.: ID do pedido, ID baseado em timestamp)
    2. Adicione ao código do Pixel: inclua o parâmetro event_id nos eventos do TikTok Pixel no client-side
    3. Inclua no Events API: envie o mesmo event_id nas suas chamadas server-side do Events API
    4. Configure no GTM: configure seu container de servidor para repassar o event_id vindo das requisições do cliente
    5. Teste a deduplicação: verifique se eventos idênticos com event_id correspondentes estão sendo deduplicados nos relatórios do TikTok

    Boas práticas para Event ID

    Bons Event IDs:
    • Números de pedido (ex.: "order_12345")
    • Combinações de timestamp + user ID
    • UUID v4 gerado no client-side
    • Números sequenciais com prefixos
    Requisitos:
    • Único entre todos os eventos
    • Consistente entre pixel e API
    • Alfanumérico, no máximo 64 caracteres
    • Disponível tanto no cliente quanto no servidor
    Resultado da deduplicação

    Com a deduplicação correta, o TikTok identifica e mescla automaticamente eventos duplicados, mostrando dados de conversão limpos e precisos que refletem a verdadeira performance da campanha.

    Passo 6: testar suas configurações

    O teste é fundamental para garantir que sua implementação de TikTok server-side tracking funcione corretamente. Testes adequados evitam perda de dados e garantem uma medição de campanha precisa desde o primeiro dia.

    Processo de teste

    1. Ative o modo de teste: no TikTok Events Manager, vá até seu pixel e ative o modo "Test Events"
    2. Gere o código de teste: crie um código de evento de teste para identificar seus eventos de teste no dashboard
    3. Teste ambos os canais: dispare eventos para verificar se TikTok Pixel e Events API estão funcionando corretamente
    4. Verifique os dados de evento: confira se todos os parâmetros de evento (value, currency, content_ids) estão sendo enviados corretamente
    5. Confirme a deduplicação: garanta que eventos duplicados estão sendo mesclados corretamente nos relatórios do TikTok
    6. Monitore por 24-48 horas: dê tempo para que os dados sejam processados e apareçam no TikTok Ads Manager

    Sinais de sucesso

    • Eventos aparecem no dashboard Test Events
    • Parâmetros de evento estão formatados corretamente
    • Dados de usuário com hash adequado
    • Eventos duplicados são deduplicados
    • Códigos de resposta do servidor são 200

    Problemas comuns

    • Token de acesso ausente ou incorreto
    • Parâmetros de evento mal formados
    • Configuração incorreta do Pixel ID
    • Inconsistência de event_id entre canais
    • Restrições de CORS ou de domínio

    Principais pontos

    Configuração completa Este guia cobre a implementação do TikTok server-side tracking usando containers de servidor do Google Tag Manager hospedados no Tracking Hippo, oferecendo mais precisão de conversão e conformidade com o GDPR.

    Implementação dupla Rodar TikTok Pixel e Events API simultaneamente maximiza a captura de dados, enquanto a deduplicação de eventos garante relatórios limpos e métricas de conversão precisas.

    Benefícios para os dados O server-side tracking recupera dados de conversão perdidos por ad blockers, melhora a otimização de campanhas com mais qualidade de dados e permite integração com CRM e outras fontes de dados.

    Conformidade de privacidade A transmissão servidor-a-servidor com hash automático garante a conformidade com o GDPR mantendo a utilidade dos dados para segmentação de audiência e otimização de campanha.

    Vantagem do Tracking Hippo Infraestrutura hospedada na UE com deploy automatizado, escalonamento gerenciado e conformidade com GDPR integrada torna o server-side tracking acessível, sem gestão complexa de infraestrutura.

    Pronto para implementar o TikTok server-side tracking?

    Comece a melhorar a performance das suas campanhas no TikTok com um server-side tracking preciso. O Tracking Hippo facilita o deploy e a gestão da sua infraestrutura sGTM na UE.

    Artigos relacionados