Back to Blog
    TikTok
    Rastreamento server‑side
    sGTM
    Events API
    Tutorial
    Privacidade

    Guia completo: TikTok server‑side com sGTM e Tracking Hippo

    17 de agosto de 2025
    10 min read
    Tutorial

    O server‑side do TikTok garante medição precisa e conformidade com RGPD. Ao usar o Events API junto com o Pixel, você recupera dados perdidos por cookies e restrições do iOS.

    Por que importa

    Melhor qualidade de dados

    Recupere conversões perdidas por bloqueadores e limites

    Privacidade

    Transmissão servidor‑servidor atende ao RGPD

    Otimização

    Conversões confiáveis melhoram o algoritmo do TikTok

    Passo 1: Criar contentor Server do GTM

    Crie um contentor de servidor para gerenciar tags sem mexer no código do site.

    Configuração do contentor

    1. Acesse sua conta do GTM
    2. Crie conta/contentor ou adicione um novo
    3. Escolha a plataforma "Server" (não Web)
    4. Dê um nome descritivo (ex.: "Marca‑Server‑Prod")
    5. Copie o "Container Config" para o hosting
    Dica

    Uma base server‑side robusta é essencial; siga nosso guia completo de 7 passos.

    Passo 2: Hospedar no Tracking Hippo

    O Tracking Hippo oferece hosting sGTM compatível com a UE e implantação gerenciada.

    Processo de implantação

    1. Crie sua conta no trackinghippo.io
    2. Novo contentor de servidor e escolha a região da UE
    3. Cole o "Container Config" do Passo 1
    4. Defina subdomínio (ex.: analytics.seudominio.com)
    5. Implante e atualize o DNS com CNAME
    Exemplo de DNS
    CNAME analytics.seudominio.com → seu‑contentor.trackinghippo.eu
    # Substitua pelo seu domínio e endpoint

    Passo 3: Instalar o TikTok Pixel

    O Pixel rastreia ações no site e trabalha junto do Events API para cobertura completa.

    Implementação do Pixel

    1. Ads Manager: acesse sua conta TikTok Business
    2. Criar Pixel: Assets → Events → novo Pixel
    3. Obter ID: copie o ID do Pixel (C9XXXXXXXXXXXXXXXXX)
    4. Instalar no GTM Web: adicione a tag do Pixel
    5. Configurar eventos: ViewContent, AddToCart, Purchase
    Eventos padrão
    • ViewContent — página de produto
    • AddToCart — adicionar ao carrinho
    • InitiateCheckout — início do checkout
    • Purchase — compra
    • Subscribe — newsletter
    • SubmitForm — envio de formulário

    Passo 4: Configurar o TikTok Events API

    O Events API envia dados de conversão do servidor para o TikTok, contornando bloqueadores.

    Configuração

    1. Gere o token de acesso: Assets → Events → Manage
    2. Adicione a tag Events API no GTM Server (Template Gallery)
    3. Configure autenticação (token + Pixel ID)
    4. Mapeie parâmetros de evento (Purchase, ViewContent etc.)
    5. Envie dados do usuário (email, phone, external_id)

    Parâmetros recomendados

    Dados do evento:
    • Nome do evento
    • Horário (timestamp)
    • Valor e moeda
    • IDs e categorias de conteúdo
    Dados do usuário (hash):
    • E‑mail (SHA256)
    • Telefone (SHA256)
    • External ID
    • IP e user‑agent
    Privacidade e segurança

    O Events API hasheia e‑mail/telefone com SHA256 antes do envio, atendendo ao RGPD.

    Passo 5: Deduplicação de eventos

    Evite contagens duplas ao usar Pixel e Events API juntos.

    Por que é importante

    A mesma ação pode ser enviada pelo cliente e servidor. A deduplicação garante relatórios limpos.

    Como fazer

    1. Gere um event_id único por conversão
    2. Inclua event_id nos eventos do Pixel
    3. Envie o mesmo event_id pelo Events API
    4. No GTM Server, encaminhe o event_id
    5. Teste a deduplicação nos relatórios

    Boas práticas para event_id

    Bons exemplos:
    • Número do pedido (order_12345)
    • Timestamp + ID do usuário
    • UUID v4
    • Sequenciais com prefixo
    Requisitos:
    • Único globalmente
    • Consistente entre Pixel e API
    • Alfanumérico até 64 chars
    • Disponível no cliente e servidor
    Resultado

    O TikTok mescla automaticamente duplicatas, mantendo dados de conversão fiéis.

    Passo 6: Testar configurações

    Testar evita perda de dados e garante medição correta desde o início.

    Processo de teste

    1. Ative o modo de teste: no TikTok Events Manager
    2. Gere o código de teste: para identificar eventos
    3. Teste ambos os canais: Pixel e Events API
    4. Verifique parâmetros: valor, moeda, content_ids
    5. Confirme a deduplicação: eventos com event_id igual são mesclados
    6. Monitore 24–48 h: para processamento e exibição

    Sinais de sucesso

    • Eventos no painel Test Events
    • Parâmetros corretos
    • Dados do usuário hasheados
    • Deduplicação ativa
    • Respostas 200

    Problemas comuns

    • Token ausente/incorreto
    • Parâmetros malformados
    • Pixel ID incorreto
    • event_id inconsistente
    • CORS/domínio

    Principais pontos

    Configuração completa Implementação do TikTok server‑side com contentor do GTM hospedado no Tracking Hippo.

    Abordagem híbrida Pixel + Events API maximizam a captura; deduplicação garante relatórios limpos.

    Benefícios de dados Recupere conversões, melhore a otimização e integre com CRM.

    Conformidade Transmissão servidor‑servidor com hashing automático atende ao RGPD.

    Vantagem Tracking Hippo Hosting na UE, implantação automatizada e conformidade integrada sem infraestrutura complexa.

    Quer implementar TikTok server‑side?

    Melhore a performance das campanhas com medição precisa. O Tracking Hippo facilita o sGTM na UE.

    Related Articles