Como fazer postback de indicadores por meio da API de eventos

Última atualização: dezembro de 2025

O envio de dados de eventos de volta ao TikTok pode ajudar na geração de leads de maior qualidade e com maior probabilidade de conversão. Consulte Informações sobre o postback de indicadores para otimização da qualidade dos leads para saber mais. Observação: recomendamos que você faça postback de eventos de funil completo e de canal completo para aumentar as taxas de correspondência e de atribuição.

Antes de começar

Você precisará ter acesso de administrador à sua conta do TikTok Ads Manager.


Aceitamos os seguintes idiomas para os eventos de indicadores:

  • العربية

  • 中文（简体）

  • 日本語

  • English

  • Español

  • Français

  • Deutsch

  • Pусский

  • Italiano

  • 한국어

  • Türkçe

  • ภาษาไทย

  • Tiếng Việt

  • Bahasa Indonesia

  • Bahasa Melayu

  • Português (Brasil)

  • Svenska

  • Polski

  • Čeština

Observações:

  • Devido a um problema de exibição de front-end, eventos de indicadores em idiomas que não sejam o inglês podem mostrar pequenas discrepâncias em comparação com o conteúdo original na interface de mapeamento de eventos. No entanto, a correspondência de back-end e os processos de otimização não são afetados.

  • Aceitamos somente indicadores em vários idiomas no postback de indicadores de gestão de relacionamento com o cliente.

Como fazer postback de indicadores por meio da API de eventos

Etapa 1: Crie um conjunto de eventos do CRM

  1. Faça login no TikTok Ads Manager.

  2. Passe o cursor sobre Ferramentas, depois selecione Eventos para acessar o Gerenciador de Eventos.

  3. Clique em Conectar fonte de dados.

  4. Selecione CRM como a fonte de dados.

  5. Crie um nome para o evento de CRM.

  6. Anote a ID do seu conjunto de eventos no canto superior esquerdo da tela. Você precisará dessa ID para concluir o processo de postback.

  7. Depois que o conjunto de eventos for criado com êxito, será exibida a guia de configuração. Clique no botão Conectar.

  8. Escolha Configuração manual como método de configuração e clique em Próximo.

Etapa 2: Gere um token de acesso

  1. Clique em Gerar token de acesso para obter o token de acesso.

  2. Esse é o exemplo de payload que você pode copiar e modificar de acordo com as suas necessidades.

Etapa 3: Envie dados usando a API de eventos

  1. Recupere os conjuntos de eventos do CRM na sua conta de anúncios chamando /crm/list/.

  2. Envie de volta os seus dados de eventos do CRM chamando /event/track/. Defina event_source como crm e event_source_id como uma das IDs de conjunto de eventos do CRM obtidas.

Etapa 4: Mapeie os seus eventos de CRM para os eventos padrão do TikTok

Você pode mapear todos os eventos de CRM, incluindo eventos padrão e personalizados, para 4 estágios de funil definidos no Gerenciador de Eventos do TikTok. Saiba mais sobre o mapeamento de eventos de CRM para começar.


Etapa 5: Valide a configuração do postback

  1. No TikTok Ads Manager, passe o cursor sobre a guia Ferramentas e selecione Eventos.

  2. Clique em Fontes de dados à esquerda.

  3. Clique no conjunto de eventos do CRM que você acabou de criar.

  4. Observe se os dados fluíram para os eventos atribuídos. Pode levar 10 minutos para que os dados sejam sincronizados. Se o número de eventos correspondentes for maior que 0, então os dados de postback começaram a chegar ao TikTok e a configuração foi concluída.