Conectando o TikTok Ads

Puxar seus dados do TikTok Ads para o Google Sheets leva apenas alguns cliques. Como a Metric Might se conecta diretamente à Marketing API do TikTok, você pode extrair instantaneamente o investimento (Spend), Visualizações de Vídeo (Video Views) e dados de Conversão (Conversion data) de todas as contas de anúncios dos seus clientes.

1. Pré-requisitos (Permissões Necessárias)

Antes de poder puxar os dados, você deve ter as permissões corretas dentro da sua conta do TikTok For Business.

  • Você deve ter pelo menos acesso de Operador (Operator) ou Analista (Analyst) à(s) conta(s) de anúncios (Ad Accounts) do TikTok que deseja consultar.
  • Se você gerencia vários clientes, certifique-se de que o seu login do TikTok For Business tenha recebido acesso às respectivas contas de anúncios ou ao TikTok Business Center principal antes de se autenticar na Metric Might.

2. Como Conectar

Você pode conectar a sua conta do TikTok Ads sem sair do construtor de queries.

  1. Abra o Web App da Metric Might e navegue até a página Queries.
  2. Na seção Data source, clique no menu suspenso e selecione Add Data Source.
  3. Escolha TikTok Ads.
  4. Um pop-up seguro pedirá que você faça login no TikTok For Business. Revise as permissões e clique em Confirm.
⚠️ Pop-up bloqueado? Se nada aparecer quando você clicar para conectar, seu navegador pode estar bloqueando o pop-up de autenticação. Libere pop-ups para app.metricmight.com e tente novamente.
💡 Dica para Agências: Quando você autentica a sua conta do TikTok, a Metric Might detecta e libera automaticamente o acesso a todas as contas de anúncios às quais o seu login está vinculado — incluindo aquelas gerenciadas via Business Center. Você não precisa autenticar cada cliente individualmente.

3. Métricas e Dimensões Disponíveis

A Metric Might busca dinamicamente as métricas e dimensões mais atualizadas direto da API do TikTok, para que você sempre tenha acesso aos campos mais recentes de vídeo e conversão.

Ao construir a sua query, clique nos menus suspensos de Metrics ou Dimensions para abrir a sobreposição de pesquisa. Você pode procurar por campos padrão como Spend, Impressions e Clicks, bem como métricas de engajamento altamente específicas do TikTok, como 2-Second Video Views, 6-Second Video Views e Video Views at 100%.

A matriz de compatibilidade em tempo real da Metric Might desativará automaticamente quaisquer campos que não possam ser consultados junto com a sua seleção atual.

4. Expiração de Token

Os tokens de acesso do TikTok geralmente expiram a cada 180 dias, ou imediatamente se você alterar sua senha do TikTok For Business ou modificar suas configurações de segurança.

Você pode ver a data de expiração da sua conexão com o TikTok a qualquer momento na página Connections — ela é exibida diretamente no card da fonte de dados (data source). Isso permite que você se reautentique proativamente antes que um refresh agendado quebre.

Se uma query do TikTok parar de funcionar inesperadamente com um erro de autenticação, vá até a página Connections, clique no menu de três pontos (⋮) ao lado da fonte de dados do TikTok Ads e selecione Sign In Again.

5. Peculiaridades e Pegadinhas Específicas do TikTok

Cada API de plataforma de anúncios tem comportamentos únicos. Se os seus dados do TikTok parecerem um pouco diferentes do que você espera, quase sempre será devido a um dos seguintes motivos.

Fusos Horários (Timezones)

Quando uma Conta de Anúncios (Ad Account) do TikTok é criada, o fuso horário é fixado e não pode ser alterado. A Metric Might usa automaticamente o fuso horário nativo de cada conta de anúncios ao calcular intervalos de datas relativos como “Ontem” (Yesterday) ou “Últimos 7 dias” (Last 7 Days), de modo que seus dados sempre se alinharão corretamente com os relatórios nativos da própria conta sem necessidade de configuração manual.

Atrasos na Sincronização de Conversões (Delayed Conversion Syncs)

O rastreamento via pixel e server-to-server (Events API) do TikTok pode sofrer delays de processamento. Enquanto o Spend, Impressions e Clicks geralmente ficam disponíveis entre 15 e 30 minutos, as conversões (Conversions) e o Custo por Ação (Cost per Action (CPA)) podem levar várias horas para se consolidarem totalmente. Sempre aguarde algumas horas antes de tratar os dados de conversão de hoje como finais.

Métricas de Engajamento de Vídeo Vitalícias (Lifetime)

Algumas métricas de engajamento de vídeo na API do TikTok — como certas taxas de visualização (view-through rates) — são calculadas em uma base vitalícia (lifetime) em vez de serem quebradas por dia. Se você adicionar uma dessas métricas ao lado de uma dimensão de Data (Date) e notar que os números parecem idênticos em todas as linhas, este é o motivo. Essas métricas são melhor consultadas no nível da campanha ou da conta de anúncios sem o breakdown de data diário.

O que vem a seguir?

Esta página foi útil?