Guia de Configuração e Rastreamento da API de Conversões do TikTok
Saiba como a API de Conversões do TikTok funciona, como configurar a API de Eventos com o Pixel, evitar eventos duplicados, melhorar a correspondência e testar o rastreamento de conversões.

Por
Kinnari Ashar
Tempo de leitura: 15 min

A sua campanha no TikTok pode parecer lucrativa à primeira vista, enquanto algumas das suas conversões mais valiosas nunca chegam a aparecer no relatório. Um cliente pode visualizar um produto, adicioná-lo ao carrinho, concluir a compra ou enviar um formulário de contacto, mas o caminho por trás dessa ação pode permanecer incompleto.
Esses dados em falta afetam mais do que os relatórios. Podem influenciar quais anúncios o TikTok prioriza, para onde aloca o orçamento e com que nível de confiança avalia o desempenho da campanha.
A API de Conversão do TikTok, oficialmente conhecida como Events API, foi concebida para tornar esse panorama mais claro. No entanto, obter dados úteis depende de como a configura, de como a associa ao TikTok Pixel e de como lida com eventos duplicados.
As secções seguintes detalham os pontos que realmente importam, sem transformar o processo num labirinto técnico.
O Que É a API de Conversão do TikTok?
A API de Conversão do TikTok, oficialmente designada por TikTok Events API, é uma ligação servidor para servidor (server-to-server) que envia eventos de marketing e de conversão a partir do seu website, plataforma de e-commerce, aplicação móvel, CRM, servidor ou sistema offline diretamente para o TikTok.
Dependendo do seu negócio e da sua configuração, pode registar ações como:
Visualizações de produtos e pesquisas
Adições ao carrinho e inícios de checkout
Compras e vendas offline
Registos e envios de formulários
Subscrições e contactos qualificados (leads)
O TikTok pode utilizar dados de eventos elegíveis para medir conversões, atribuir resultados a anúncios, otimizar a veiculação, criar audiências e suportar estratégias de retargeting. A qualidade desses resultados depende da precisão, completude, dados de correspondência e estado de consentimento da informação fornecida.
A Events API tem uma finalidade mais restrita em comparação com outros produtos de desenvolvimento do TikTok. A Marketing API gere funções de publicidade, as APIs do TikTok Shop apoiam operações comerciais e a Research API oferece a investigadores autorizados acesso a dados públicos selecionados da plataforma. A Events API foca-se exclusivamente no envio de eventos de marketing.
Como Funciona a API de Conversão do TikTok?
A API de Conversão do TikTok transmite uma ação de cliente registada nos sistemas do seu negócio para o TikTok, onde pode ser correspondida com uma interação elegível de anúncio e utilizada para mensuração.
O processo segue habitualmente esta sequência:
Um cliente vê ou clica no seu anúncio do TikTok e visita o seu website ou loja online.
O cliente conclui uma ação, como visualizar um produto, adicionar um item ao carrinho, submeter um formulário ou fazer um pedido.
O seu website, plataforma de e-commerce, sistema de pagamentos ou CRM regista essa ação.
O seu servidor ou integração gera um evento com detalhes como o nome do evento, carimbo temporal (timestamp), valor do pedido, informações do produto e dados de correspondência disponíveis.
O evento é enviado para a TikTok Events API.
O TikTok utiliza identificadores como dados de clique, dados de contacto, informações do navegador ou outros campos de correspondência válidos para ligar a ação a um utilizador ou a uma interação com o anúncio no TikTok.
Eventos correspondidos podem contribuir para relatórios, atribuição, otimização de campanhas, retargeting e criação de audiências.
Para o acompanhamento web, a mesma ação também pode chegar ao TikTok através do Pixel:
Anúncio do TikTok → Visita ao site → Ação do cliente → Evento do Pixel e evento do servidor → Desduplicação → TikTok Ads Manager
O evento de servidor pode registar um resultado confirmado mesmo quando o pedido do navegador falha devido ao bloqueio do Pixel, à não conclusão do carregamento da página de confirmação, a um checkout efetuado noutro local ou à interrupção da ligação.
No entanto, o envio do evento não garante atribuição no TikTok. O TikTok necessita de dados válidos de correspondência e de atribuição suficientes para associar essa conversão a uma interação com anúncio elegível.
TikTok Pixel vs. API de Conversão do TikTok
O TikTok Pixel e a Events API recolhem dados de conversão por vias distintas. O Pixel monitoriza a atividade no navegador do cliente, enquanto a Events API envia eventos a partir do seu servidor ou de outro sistema conectado.
O TikTok recomenda o uso de ambos para o rastreio de conversões web sempre que possível.
Funcionalidade | TikTok Pixel | API de Conversão do TikTok |
Origem dos dados | Navegador do cliente | Servidor, plataforma, app, CRM ou sistema offline |
Método de rastreio | Baseado no navegador | Servidor para servidor |
Instalação | Código no website, Event Builder ou gestor de tags | Integração de parceiros, Events API Gateway, contentor de servidor ou API direta |
Restrições de navegador | Mais suscetível | Menos dependente da execução do navegador |
Mais indicado para | Visualizações de página e ações no site | Resultados confirmados no website, backend, CRM e offline |
Eventos de CRM e offline | Limitado | Suportado |
Complexidade técnica | Habitualmente mais baixa | Varia de moderada a avançada |
Desduplicação | Não necessária quando utilizado isoladamente | Obrigatória quando o Pixel envia o mesmo evento |
O Pixel adequa-se melhor a comportamentos imediatos no site, enquanto a Events API pode confirmar resultados registados após a interação no navegador, como pagamentos aprovados ou leads qualificadas no CRM.
Quando ambos comunicam a mesma conversão, o TikTok exige a desduplicação para que o Ads Manager a contabilize apenas uma vez.
Que Eventos e Dados Podem Ser Enviados Pela TikTok Events API?
1. Eventos de Conversão Padrão
O TikTok disponibiliza nomes de eventos padrão para as ações mais comuns de e-commerce e geração de contactos. Estes eventos predefinidos servem de suporte a relatórios, otimização de conversões e criação de audiências.
Os eventos habituais incluem:
ViewContent: Um visitante abre uma página de produto ou outra página relevante.
Search: Alguém efetua uma pesquisa por produto, categoria ou termo no seu site.
AddToWishlist: Um comprador guarda um artigo na lista de desejos.
AddToCart: Um produto é adicionado com sucesso ao carrinho.
InitiateCheckout: O cliente inicia o processo de finalização de compra.
AddPaymentInfo: Os detalhes de pagamento são inseridos durante o checkout.
Purchase: Uma compra concluída é registada.
SubmitForm: Um visitante envia com sucesso um formulário de contacto ou proposta.
CompleteRegistration: Um utilizador conclui o registo ou a criação de uma conta.
Subscribe: Um cliente conclui uma subscrição.
StartTrial: Um utilizador inicia um período de teste.
Apenas o nome do evento não é suficiente. É fundamental definir com precisão o momento em que cada evento é acionado.
Por exemplo, o evento Purchase pode referir-se à criação de uma encomenda, à autorização do pagamento, à captura do pagamento ou ao envio do pedido. Escolha um único gatilho e aplique-o uniformemente no seu website, backend e plataformas de relatórios.
Os parâmetros acrescentam contexto ao evento. Dependendo da ação, podem incluir valor, moeda, quantidade, IDs de conteúdo e dados do produto. O TikTok classifica certos parâmetros como obrigatórios e recomenda outros para melhorar a qualidade dos eventos e o desempenho das campanhas.
O envio do mesmo evento em etapas diferentes pode inflacionar as conversões e a receita. Uniformize os gatilhos e os parâmetros antes do lançamento para garantir que o Ads Manager recebe uma versão consistente de cada ação do cliente.
2. Parâmetros de Evento
Uma vez definido o gatilho do evento, os parâmetros descrevem o que sucedeu e facultam ao TikTok as informações necessárias para interpretar o dado corretamente.
Um evento pode incluir:
Nome do evento: A ação que está a ser comunicada, como
AddToCartouPurchase.Hora do evento: O momento exato em que a ação ocorreu.
ID do evento: Um identificador exclusivo para reconhecer o mesmo evento entre o Pixel e a Events API.
URL de origem do evento: A página web onde a ação teve lugar.
Moeda: A divisa utilizada na transação.
Valor da conversão: O valor monetário total atribuído ao evento.
IDs de produto ou de conteúdo: Os identificadores dos produtos envolvidos.
Tipo de conteúdo: A categoria de conteúdo associada ao evento.
Quantidade: O número de unidades envolvidas na ação.
Detalhes do pedido: Informações complementares de compra, como dados dos itens encomendados.
Os identificadores de produtos devem seguir o formato configurado no catálogo do TikTok associado. Verifique se o catálogo armazena IDs de produto, IDs de variante, SKUs ou outro identificador de plataforma antes de mapear os eventos.
A moeda e o valor também exigem formatação consistente. Valores ausentes, estáticos ou incorretamente mapeados podem deixar eventos de compra sem dados de receita válidos, prejudicando os relatórios de retorno sobre o investimento publicitário (ROAS).
3. Informações de Correspondência de Clientes
Após receber um evento, o TikTok necessita de dados suficientes para associar essa ação a um utilizador ou a uma interação com anúncio válida.
Os identificadores de correspondência habituais incluem:
TikTok Click ID: O valor
ttclidassociado a um clique num anúncio do TikTok.Endereço de e-mail em hash: Um endereço de e-mail normalizado e convertido através do algoritmo SHA-256.
Número de telefone em hash: Um número de telefone devidamente formatado e convertido através de SHA-256.
ID externo de cliente em hash: O seu próprio identificador de cliente, formatado segundo as especificações do TikTok.
Endereço IP do cliente: O IP registado aquando da ação no website.
User Agent do navegador: Dados sobre o navegador e o dispositivo do cliente.
Identificador primário do TikTok: O valor do cookie compatível
_ttp, quando disponível.
Um evento pode ser recebido pela Events API e ainda assim apresentar uma correspondência fraca se estes campos estiverem em falta, inválidos ou incorretamente formatados. Uma correspondência eficaz depende de enviar os identificadores recolhidos de forma legal e transparente, e não de enviar apenas um maior volume de dados brutos.
Endereços de e-mail, contactos telefónicos e IDs externos têm de ser normalizados e processados com hash estritamente conforme as diretrizes do TikTok. IDs de clique, endereços IP, user agents e identificadores de cookies possuem regras próprias de formatação.
A sua implementação deve respeitar as opções de consentimento, políticas de privacidade e a legislação de proteção de dados aplicável a cada mercado.
Como Funcionam a Correspondência e a Desduplicação de Eventos no TikTok
Correspondência de Eventos
O TikTok recorre a chaves de correspondência para ligar uma conversão comunicada a um utilizador que tenha interagido previamente com um anúncio. Um parâmetro chave é o TikTok Click ID, ou ttclid, que pode ser adicionado ao URL da página de destino após o clique num anúncio.
O seu website deve preservar esse valor durante toda a navegação e processo de compra. Guardá-lo juntamente com o pedido final ou contacto registado aumenta significativamente as probabilidades de o TikTok associar o resultado à interação original.
O Click ID pode perder-se quando:
Um redirecionamento limpa os parâmetros de URL
O checkout transita para outro domínio
O intermediário de pagamento inicia uma sessão independente
Parâmetros de rastreio são removidos do URL
A sessão inicial expira
Informações de contacto e IDs de cliente externos também melhoram a correspondência, desde que sejam normalizados antes do hash. Utilize igualmente o endereço IP e o user agent reais do utilizador.
Enviar dados fictícios, o IP do servidor ou o user agent do backend fornece ao TikTok informações sobre o seu próprio sistema em vez do comprador.
Desduplicação de Eventos
Quando o Pixel e a Events API comunicam a mesma conversão, o TikTok precisa de identificar que ambos os registos dizem respeito a uma única ação do cliente. A desduplicação impede que compras, contactos ou registos sejam duplicados nas estatísticas.
Ambas as transmissões devem conter o mesmo nome de evento e o mesmo ID exclusivo de evento.
Por exemplo:
Pixel
Purchase:order_84739Servidor
Purchase:order_84739
O TikTok compara estes campos para identificar sobreposições. O valor, a moeda e as informações do produto também devem coincidir para assegurar a consistência dos relatórios.
Um ID de encomenda, ID de transação, identificador de conclusão de checkout ou um UUID estável gerado pelo servidor são opções adequadas, pois cada um representa uma conversão única.
Evite IDs de produtos, IDs de utilizadores, IDs de sessão reutilizados ou identificadores aleatórios criados separadamente pelo navegador e pelo servidor.
Em tentativas de reenvio de pedidos via API, reutilize sempre o ID de evento original. Um novo ID fará com que o reenvio seja processado como uma conversão adicional.
Como Configurar a API de Conversão do TikTok
Passo 1. Escolher um Método de Integração
O primeiro passo consiste em definir a forma como os dados dos eventos serão transferidos dos seus sistemas para o TikTok. A melhor opção depende da plataforma em uso, dos recursos técnicos disponíveis e do grau de controlo pretendido sobre o mapeamento de eventos e a qualidade dos dados.
Cada método aborda um nível de complexidade diferente; por isso, avalie as opções consoante a forma como a sua loja já processa conversões.
Integração via plataforma de e-commerce: Geralmente a via mais simples para lojas Shopify ou WooCommerce compatíveis. A plataforma gere a maior parte da ligação, do mapeamento de eventos e do catálogo.
Parceiro de dados ou rastreio: Ideal se já utiliza uma plataforma de dados de clientes (CDP), CRM, gestor de tags ou serviço de servidor. Certifique-se de quais eventos, identificadores e controlos de privacidade são suportados pelo parceiro.
Integração direta via API: Mais indicada para websites personalizados, checkouts próprios, marketplaces, modelos de subscrição ou lógicas de conversão específicas. Permite maior controlo, mas exige desenvolvimento, testes, monitorização e manutenção.
Google Tag Manager do lado do servidor (Server-Side GTM): Uma solução viável para equipas que já gerem um contentor de servidor e dominam tags, acionadores, variáveis, GA4 e alojamento na nuvem. O TikTok também oferece um fluxo guiado para este método.
Antes de avançar, considere os eventos indispensáveis, a capacidade técnica interna, a estrutura do catálogo, o acesso a registos de eventos, o número de lojas geridas, a política de consentimento e quem será responsável pela manutenção da ligação.
Passo 2. Elaborar um Plano de Rastreio de Eventos
Antes de dar início à configuração técnica, estruture um plano de rastreio que forneça uma definição padronizada para cada ação do utilizador. Desta forma, equipas de desenvolvimento, marketing e analítica operam sob as mesmas diretrizes.
Defina os seguintes elementos para cada evento:
Nome do evento no TikTok
O significado da ação para o negócio
A condição exata de disparo (gatilho)
Origem do disparo: navegador, servidor ou ambos
Campos e parâmetros indispensáveis
Identificadores de correspondência disponíveis
Origem do ID exclusivo do evento
Condições de consentimento aplicáveis
Analise o evento Purchase como referência. Determine se este deve disparar no momento em que a encomenda é gerada ou apenas após a confirmação do pagamento. Na grande maioria das lojas, a confirmação do pagamento oferece um registo mais fidedigno da receita real, excluindo compras pendentes ou recusadas.
Formalize essa regra no plano e aplique-a em todo o checkout, backend, Pixel e Events API. Como o TikTok aceita eventos padrão em ambos os canais, uma definição alinhada evita discrepâncias nos relatórios futuros.
Passo 3. Ligar a Origem de Dados Correta no TikTok
Aceda ao Events Manager na conta de anúncios responsável pelas campanhas.
Vá a Ferramentas, selecione Events Manager, clique em Ligar Origem de Dados e escolha Web. Crie uma nova ligação de dados web ou selecione a ligação já associada ao domínio pretendido.
Antes de concluir, confirme o URL do website, o código do Pixel, a conta de anúncios e as permissões de acesso. Esta verificação é crucial quando são geridas múltiplas lojas ou contas dentro do mesmo Business Center.
Se o Pixel e a Events API registarem ações a partir do mesmo website, garanta que ambos enviam dados para a mesma origem de dados web. Apontar para o destino errado pode direcionar eventos legítimos para outra conta, deixando as campanhas ativas sem a informação necessária.
Passo 4. Gerar e Proteger o Token de Acesso
Caso opte por uma integração direta via Events API, gere o token de acesso necessário para autenticar as chamadas à API. Integrações através de parceiros podem gerir a autenticação através do seu próprio fluxo.
Guarde o token num ambiente de servidor seguro, num gestor de segredos ou em ficheiros de configuração encriptados. O acesso deve ser restrito exclusivamente às equipas e ferramentas encarregues da integração.
Nunca exponha o token em:
Código-fonte do website
Scripts do navegador
Repositórios públicos de código
Capturas de ecrã partilhadas
Ficheiros de log desprotegidos
Um token inserido no código do lado do cliente pode ser facilmente intercetado através das ferramentas de inspeção do navegador. Se uma credencial for exposta, substitua-a de imediato e monitorize o fluxo de eventos em busca de pedidos anómalos.
Documente procedimentos de rotação periódica das credenciais sem interromper a transmissão contínua de eventos.
Passo 5. Capturar e Tratar os Dados do Evento
Com a ligação operacional, prepare o conjunto de dados a encaminhar ao TikTok com cada evento.
Mantenha o valor do parâmetro ttclid desde a página de destino através de eventuais redirecionamentos, etapas de checkout e passos de pagamento. Guarde este identificador associado à encomenda ou contacto sempre que possível.
Recolha estritamente os identificadores autorizados pelo consentimento do utilizador. Normalize os endereços de e-mail e números de telefone antes de aplicar o hash obrigatório, evitando calcular o hash sobre dados formatados incorretamente.
O payload do evento deve conter também o IP original e o user agent reais do visitante, sempre que legalmente permitido. Evite substituí-los pelos dados do seu servidor de alojamento ou sistemas de backend.
Por último, gere um ID de evento consistente e único por ação. Aplique esse mesmo valor em ambas as transmissões (Pixel e servidor), para que o TikTok identifique os dados como uma única conversão.
Passo 6. Enviar Eventos do Pixel e do Servidor
Assim que os dados estiverem formatados, envie os eventos do navegador e do servidor partilhando o mesmo nome de evento do TikTok e o mesmo ID de evento. Esta correspondência permite ao TikTok detetar registos duplicados e contabilizar a ação uma única vez.
Baseie-se nos registos de backend para preencher os valores finais de compra, moeda, ID de encomenda e detalhes de produtos, uma vez que o seu sistema de encomendas ou de pagamentos detém os dados transacionais consolidados.
O evento Purchase só deve ser acionado exatamente no ponto acordado no seu plano de rastreio. Por exemplo, emita-o após a aprovação do pagamento ou confirmação da compra, e não quando o utilizador entra no checkout ou visualiza um ecrã intermédio de pagamento.
Antes de ativar as campanhas, confronte ambas as vias de transmissão e verifique se nomes, IDs, valores e parâmetros coincidem plenamente.
Passo 7. Testar Eventos no TikTok Events Manager
Antes de publicar campanhas, aceda às ferramentas de teste integradas no Events Manager e execute as ações previstas no seu plano de rastreio.
Simule uma visualização de produto, adição ao carrinho, início de checkout e uma transação de teste. Em seguida, valide se:
Os eventos do navegador e do servidor chegam à origem de dados web pretendida
Os nomes dos eventos e os carimbos de data/hora correspondem às ações realizadas
O valor da compra e a moeda refletem o pedido de teste
Os IDs de produtos estão alinhados com a formatação do catálogo ativo
Os identificadores de correspondência são recebidos corretamente
Os eventos coincidentes trazem o mesmo nome de evento e ID de evento
Todas as configurações temporárias de teste são desativadas antes da entrada em produção
Consulte também a secção de Diagnóstico (Diagnostics). Um evento pode ser recebido sem erros aparentes na ligação, mas conter parâmetros em falta, inválidos ou mal formatados.
Terminados os testes, confirme a taxa de desduplicação entre os registos do navegador e do servidor. Os relatórios regulares do Events Manager podem demorar mais a atualizar do que a consola de testes em tempo real; aguarde o tempo de processamento padrão antes de assumir falhas na entrega de eventos.
Problemas Frequentes na API de Conversão do TikTok e Soluções
Um evento processado com sucesso pode, ainda assim, apresentar valores erróneos, correspondência deficiente ou contagens duplicadas. Utilize a tabela abaixo para despistar anomalias antes de alterar toda a sua infraestrutura de integração.
Problema | Causa Provável | O que verificar |
Compras contabilizadas em duplicado | Os eventos do navegador e do servidor utilizam IDs distintos | Confirme se o nome do evento e o ID de evento coincidem em ambas as versões |
Eventos de servidor não são apresentados | Origem de dados, token, conta de anúncios ou ambiente incorretos | Valide a origem de dados associada, o token de acesso, a conta de anúncios e as definições de produção |
TikTok associa poucas conversões | Click ID ou identificadores de clientes ausentes | Reveja que chaves de correspondência estão a ser captadas e enviadas |
Todos os eventos exibem o mesmo IP | Está a ser encaminhado o IP do servidor de alojamento | Envie o IP real do visitante, sempre que permitido por lei |
User Agent em falta | Os dados do navegador não foram preservados | Recolha o user agent do visitante ao longo de toda a sessão |
Receita de compra registada como zero | Valor ou moeda ausentes ou com formatação inválida | Inspecione o formato e conteúdo dos parâmetros de valor e moeda |
Produtos não correspondem ao catálogo | Os IDs de conteúdo usam um formato de identificador diferente | Compare os IDs enviados nos eventos com o formato de produto, variante ou SKU do catálogo |
Encomendas enviadas antes do pagamento | O acionador de Purchase dispara prematuramente | Verifique o estado do pedido ou pagamento que serve de gatilho ao evento |
Reenvios de pedidos criam compras extra | Cada tentativa recebe um novo ID de evento | Reutilize sempre o ID de evento original para qualquer nova tentativa de envio |
Eventos chegam com atraso | Fila de processamento, lotes ou integrações de terceiros causam atrasos | Registe a hora real em que a ação ocorreu e não o momento do processamento posterior |
Um número de compras inferior no TikTok não é necessariamente sinal de falha. A sua loja contabiliza a totalidade dos pedidos de todas as origens, enquanto o Ads Manager expõe apenas as compras atribuídas às campanhas segundo a janela configurada.
Cruze os dados de vendas no backend, eventos do Pixel, eventos do servidor, números desduplicados e compras atribuídas para compreender eventuais discrepâncias.
Tome Decisões Mais Inteligentes nos Seus Testes no TikTok
A API de Conversão do TikTok, oficialmente TikTok Events API, proporciona uma visão nítida do percurso dos utilizadores após interagirem com os seus anúncios. Para iniciativas web, a plataforma aconselha utilizá-la em conjunto com o Pixel, assegurando uma mensuração consistente suportada por eventos do navegador e do servidor.
Relatórios analíticos fidedignos dependem diretamente da qualidade dos eventos submetidos. Os gatilhos de compra devem corresponder a transações reais, os valores de receita precisam de exatidão, os identificadores do catálogo devem coincidir e os eventos simultâneos do Pixel e servidor devem partilhar IDs idênticos.
Estes dados avaliam o sucesso das suas campanhas em curso. O WinningHunter apoia-o na fase prévia ao lançamento. Permite analisar anúncios ativos no TikTok, monitorizar a concorrência, detetar sinais de produtos com potencial, formatos criativos e métricas de lojas para identificar as melhores oportunidades de teste.
Ao conjugar ambas as ferramentas, a pesquisa orienta os seus testes estratégicos, enquanto a precisão dos dados de conversão demonstra quais dessas abordagens geram resultados reais.
Perguntas Frequentes (FAQs)
A API de Conversão do TikTok é o mesmo que a Events API?
Sim. Events API é a designação oficial do produto da TikTok. Profissionais de marketing e plataformas de rastreio usam com frequência os termos TikTok Conversion API, API de Conversão ou TikTok CAPI. Todos se referem à mesma ligação servidor para servidor empregue para enviar eventos de marketing web, mobile, de CRM ou de sistemas offline diretamente para o TikTok.
Ainda necessito do TikTok Pixel se utilizar a Events API?
Sim, o TikTok recomenda associar o Pixel e a Events API na medição de conversões web. O Pixel monitoriza ações no navegador, enquanto a Events API regista os eventos diretamente do servidor ou de plataformas integradas. Sempre que ambos comunicam a mesma ação, devem partilhar o mesmo nome de evento e ID de evento para possibilitar a desduplicação pelo TikTok.
O que significa a desduplicação de eventos no TikTok?
A desduplicação impede que uma conversão seja contabilizada duas vezes quando comunicada simultaneamente pelo Pixel e pela Events API. O TikTok compara o nome e o ID do evento em ambas as entradas. Caso coincidam, a plataforma reconhece tratar-se da mesma compra, formulário, registo ou ação do cliente, agregando-os num único evento.
Que valor devo utilizar como ID de evento no TikTok?
Utilize um identificador único associado à conversão específica, como o número de encomenda, ID de transação, identificador de conclusão de checkout ou um UUID único gerado pelo servidor. Tanto o Pixel como a Events API têm de receber esse mesmo identificador para eventos redundantes. Qualquer nova tentativa de envio via servidor deve manter o ID original.
É possível configurar a TikTok Events API no Shopify?
Sim. Os lojistas da Shopify podem ligar-se ao TikTok utilizando a integração de comércio oficial suportada ou recorrendo a uma aplicação de rastreio compatível. As funcionalidades podem variar consoante o mercado e as definições da loja. Antes de consolidar a instalação, certifique-se de quais eventos, parâmetros de clientes, sinais de consentimento, receitas e identificadores de catálogo a integração efetivamente transfere para o TikTok.
Porque é que o TikTok apresenta menos compras do que a Shopify?
A Shopify consolida encomendas obtidas através de todos os canais de aquisição, enquanto o TikTok lista exclusivamente compras atribuídas aos seus anúncios, consoante o modelo e janela de atribuição ativos. Diferenças adicionais podem ter origem nas janelas temporais de atribuição, chaves de correspondência em falta, opções de consentimento dos utilizadores, falhas no envio de eventos, atrasos de processamento ou deduplicação. Analise os eventos rececionados antes de concluir que existe uma falha na ligação.
A TikTok Events API contorna bloqueadores de anúncios (ad blockers)?
A Events API depende menos de scripts no navegador porque os dados são transmitidos diretamente do servidor ou de sistemas externos. Contudo, não é totalmente imune a bloqueios, controlos de navegador, opções de consentimento ou requisitos de privacidade. É mandatório continuar a recolher e processar os dados dos clientes de forma legítima e em conformidade com as diretrizes do TikTok.
Como posso confirmar se a TikTok Events API está a funcionar?
Aceda ao TikTok Events Manager e avalie o fluxo de eventos de servidor recebidos, os seus parâmetros, dados de correspondência, alertas de diagnóstico e o estado da desduplicação. Execute ações essenciais, como encomendas de teste, e confronte os valores, moedas, IDs de produto e IDs de evento registados com os dados da sua loja e do fornecedor de pagamentos. Tenha em consideração o tempo de propagação antes de assumir que um evento com atraso não foi entregue.











