Autenticação
Para que a Uncover consiga ler dados da sua conta do TikTok Marketing, é necessário fazer "sign in" na plataforma. O usuário fazendo sign in precisa ter, no mínimo, acesso "Analyst" na conta de anúncios cujos dados serão lidos.
Configurações do provider
O provider recebe os seguintes campos de configuração:
Configuração | Significado |
Advertiser ID | ID da conta de advertiser da qual obter dados |
Start date | Data a partir da qual replicar dados |
Tabelas disponíveis
As tabelas "Campaigns reports daily" e "Ads audience reports by province daily" contêm métricas redundantes, e, portanto, nunca devem ser usadas em conjunto parar um mesmo advertiser ID. O fazer resultará em dados duplicados no seu workspace para essa conta do TikTok.
Ads audience reports by province daily
Essa tabela traz dados de desempenho diário de anúncios no TikTok Marketing, agregados por province (no caso do Brasil, estados). A tabela conta com os seguintes campos:
Coluna | Descrição |
ad_name | Nome do anúncio |
ad_text | Texto do anúncio |
adgroup_id | ID do grupo de anúncios |
adgroup_name | Nome do grupo de anúncios |
advertiser_id | Advertiser ID |
campaign_id | ID da campanha |
campaign_name | Nome da campanha |
clicks | Quantidade de clicks |
conversion_rate | Taxa de conversão. É a porcentagem de resultado obtido para cada click no anúncio |
conversion | Número de vezes que o anúncio resultou no evento de otimização eleito |
cost_per_result | Custo médio por resultado |
cpc | Custo médio por click |
cpm | Custo médio por 1000 impressões |
ctr | Percentual de vezes que o anúncio apareceu para um usuário e esse clickou |
impressions | Quantidade de impressões |
placement_type | Placement onde o anúncio foi configurado para ser veiculado. Mais informações na documentação |
promotion_type | Promotion type |
province_id | ID da localização. A completude dessa coluna não é garantida e um percentual de IDs ausentes é esperado. Consulte o significado dos valores retornados na documentação |
result_rate | Percentual de vezes que o resultado configurado foi atingido |
result | Número de vezes que o resultado configurado foi atingido |
spend | Gasto estimado |
stat_time_day | Dia ao qual as métricas se referem |
Para mais informações, acesse a documentação oficial do TikTok.
Campaigns reports daily
Essa tabela traz dados de desempenho diário de campanhas no TikTok Marketing. A tabela conta com os seguintes campos:
Coluna | Descrição |
advertiser_id | Advertiser ID |
stat_time_day | Dia ao qual as métricas se referem |
campaign_id | ID da campanha |
campaign_name | Nome da campanha |
impressions | Quantidade de impressões campanha |
clicks | Quantidade de clicks da campanha |
spend | Gasto estimado com essa campanha. |
cpc | Custo médio por click |
ctr | Percentual de vezes que a campanha apareceu para um usuário e esse clickou |
cpm | Custo médio por 1000 impressões |
cost_per_1000_reached | Custo médio para atingir 1000 usuários únicos |
reach | Número de usuários únicos que viram a campanha pelo menos uma vez |
frequency | Número médio de vezes que cada usuário único viu a campanha. Calculado como impressions dividido por reach |
likes | Número total de likes que a campanha recebeu |
comments | Número total de comentários que a campanha recebeu |
shares | Número total de compartilhamentos que a campanha recebeu |
follows | Número de usuários que seguiram a página no máximo 1 dia após verem a campanha |
video_watched_2s | Número de vezes que um vídeo foi reproduzido por pelo menos 2 segundos, descontados replays |
video_watched_6s | Número de vezes que um vídeo foi reproduzido por pelo menos 6 segundos, descontados replays |
video_views_p25 | Número de vezes que um vídeo foi reproduzido por pelo menos 25% da sua duração, descontados replays |
video_views_p50 | Número de vezes que um vídeo foi reproduzido por pelo menos 50% da sua duração, descontados replays |
video_views_p75 | Número de vezes que um vídeo foi reproduzido por pelo menos 75% da sua duração, descontados replays |
video_views_p100 | Número de vezes que um vídeo foi reproduzido por pelo menos 100% da sua duração, descontados replays |
average_video_play | Tempo médio que um vídeo foi reproduzido, por visualização, contando tempo gasto em replay |
average_video_play_per_user | Tempo médio que um vídeo foi reproduzido por usuário, contando tempo gasto em replay |
video_play_actions | Número de vezes que um vídeo começou a passar, descontados replays |
profile_visits | Número de visitas ao perfil que a campanha gerou |
app_install | Número de vezes que seu aplicativo foi instalado com eventos atribuídos a essa campanha (contagem baseada no momento que cada impressão aconteceu) |
real_time_app_install | Número de vezes que seu aplicativo foi instalado com eventos atribuídos a essa campanha (contagem baseada no momento que a conversão aconteceu) |
real_time_app_install_cost | Custo médio para cada instalação do seu aplicativo com eventos atribuídos a essa campanha |
clicks_on_music_disc | Número de clicks na música para um Spark Ads na campanha |
Para mais informações, acesse a documentação oficial do TikTok.
Limitações
Não é possível extrair resultados de campanhas do tipo "Branded Mission".