TikTok Ads

Adicionando o conector

Requisitos

  • Acesso mínimo de Ad account analyst às contas que serão conectadas

Instruções

1) Na plataforma da Kondado, vá para a página de adicionar conectores e selecione o conector do TikTok Ads

2) Clique em “Sign in with TikTok”:

ATENÇÃO: Além de bloqueadores de pop-up, alguns antivirus também podem impedir a exibição do botão “Sign in with TikTok”. Então, caso você já esteja utilizando o navegador chrome e com uma janela anônima e o botão ainda não esteja aparecendo, desative o seu antivirus por alguns instantes e recarregue a página para que o botão apareça. Reative o seu antivirus após terminar o processo

3) Agora você será direcionado para uma página de login do TikTok, onde deverá informar as suas credenciais, após fazer login com a sua conta do TikTok vinculada a sua conta do TikTok Ads, você precisará dar permissão à Kondado

4) Na página de permissões, deixe todas as opções marcadas com “Sim” e clique em “Concluir”

Agora basta salvar o conector

Integrações

Índice

Para utilizar suas integrações da melhor forma, entenda mais sobre detalhamento, métricas, período e janela de atualização

Campaign Report

Campo Tipo

id

text

[en] Advertiser Id

metric_date

timestamp

[en] Timestamp of when the report was genereted

metric_x

float

[en] An example of a metric

metric_y

text

[en] An example of a metric

breakdown_a

float

[en] An example of a breakdown

breakdown_b

date

[en] An example of a breakdown

Esta integração está em modo beta. Nos avise se encontrar algum resultado inesperado

Ad Group Report

Campo Tipo

id

text

[en] Advertiser Id

metric_date

timestamp

[en] Timestamp of when the report was genereted

metric_x

float

[en] An example of a metric

metric_y

text

[en] An example of a metric

breakdown_a

float

[en] An example of a breakdown

breakdown_b

date

[en] An example of a breakdown

Esta integração está em modo beta. Nos avise se encontrar algum resultado inesperado

Ad Report

Campo Tipo

id

text

[en] Advertiser Id

metric_date

timestamp

[en] Timestamp of when the report was genereted

metric_x

float

[en] An example of a metric

metric_y

text

[en] An example of a metric

breakdown_a

float

[en] An example of a breakdown

breakdown_b

date

[en] An example of a breakdown

Esta integração está em modo beta. Nos avise se encontrar algum resultado inesperado

Advertiser Report

Campo Tipo

id

text

[en] Advertiser Id

metric_date

timestamp

[en] Timestamp of when the report was genereted

metric_x

float

[en] An example of a metric

metric_y

text

[en] An example of a metric

breakdown_a

float

[en] An example of a breakdown

breakdown_b

date

[en] An example of a breakdown

Esta integração está em modo beta. Nos avise se encontrar algum resultado inesperado

Reservation Advertiser Report

Campo Tipo

id

text

[en] Advertiser Id

metric_date

timestamp

[en] Timestamp of when the report was genereted

metric_x

float

[en] An example of a metric

metric_y

text

[en] An example of a metric

breakdown_a

float

[en] An example of a breakdown

breakdown_b

date

[en] An example of a breakdown

Disponível em breve

Reservation Campaign Report

Campo Tipo

id

text

[en] Advertiser Id

metric_date

timestamp

[en] Timestamp of when the report was genereted

metric_x

float

[en] An example of a metric

metric_y

text

[en] An example of a metric

breakdown_a

float

[en] An example of a breakdown

breakdown_b

date

[en] An example of a breakdown

Disponível em breve

Reservation Ad Group Report

Campo Tipo

id

text

[en] Advertiser Id

metric_date

timestamp

[en] Timestamp of when the report was genereted

metric_x

float

[en] An example of a metric

metric_y

text

[en] An example of a metric

breakdown_a

float

[en] An example of a breakdown

breakdown_b

date

[en] An example of a breakdown

Disponível em breve

Reservation Ad Report

Campo Tipo

id

text

[en] Advertiser Id

metric_date

timestamp

[en] Timestamp of when the report was genereted

metric_x

float

[en] An example of a metric

metric_y

text

[en] An example of a metric

breakdown_a

float

[en] An example of a breakdown

breakdown_b

date

[en] An example of a breakdown

Disponível em breve

Detalhamento

Todas os detalhamentos de um report segmentam a um grupo de dados em grupos menores, a utilização de detalhamentos diferente do id da entidade a ser lida limita a quantidade de métricas do report

  • campaign_id: Group by Campaign ID
  • adgroup_id: Group by Ad Group ID
  • ad_id: Group by Ad ID
  • advertiser_id: Group by Advertiser ID
  • stat_time_day: Group by day
  • gender: Group by gender
  • age: Group by age
  • country_code: Group by location code.
  • province_id: Group by location ID.
  • dma_id: Group by Designated Market Area (DMA). Only U.S. has DMAs.
  • ac: Group by audience network
  • language: Group by audience language
  • platform: Grouped by operating system
  • interest_category: Group by first_level interest category
  • interest_category_tier2: Group by second_level interest category
  • interest_category_tier3: Group by third_level interest category
  • interest_category_tier4: Group by fourth_level interest category
  • behavior_id: Group by behavior
  • placement: Group by placement
  • device_brand_id: Group by device brand.

Metrics

Todo Report possui diversas métricas que são definidas automaticamente, para que seu relatório possua o máximo das métricas disponíveis selecione o detalhamento referente ao objeto a ser lido (advertiser_id, campaign_id, adgroup_id, ad_id)


Métricas de atributo

  • campaign_id: Group by Campaign ID
  • adgroup_id: Group by Ad Group ID
  • ad_id: Group by Ad ID
  • advertiser_id: Group by Aadvertiser ID
  • stat_time_day: Group by day
  • stat_time_hour: Group by hour
  • gender: Group by gender
  • age: Group by age
  • country_code: Group by location code.
  • province_id: Group by location ID.
  • dma_id: Group by Designated Market Area (DMA). Only U.S. has DMAs.
  • ac: Group by audience network
  • language: Group by audience language
  • platform: Grouped by operating system
  • interest_category: Group by first_level interest category
  • interest_category_tier2: Group by second_level interest category
  • interest_category_tier3: Group by third_level interest category
  • interest_category_tier4: Group by fourth_level interest category
  • behavior_id: Group by behavior
  • placement: Group by placement.
  • device_brand_id: Group by device brand. When this dimension is used, lifetime cannot be true .

Métricas básicas

  • spend: Total Cost
  • cash_spend: Cost Charged by Cash
  • cpc: CPC (Destination)
  • cpm: CPM
  • impressions: Impressions
  • gross_impressions: Gross Impressions (Includes Invalid Impressions)
  • clicks: Clicks (Destination)
  • ctr: CTR (Destination)
  • reach: Reach
  • cost_per_1000_reached: Cost per 1,000 people reached
  • conversion: Conversions
  • cost_per_conversion: CPA
  • conversion_rate_v2: CVR (Impressions)
  • real_time_conversion: Real-time Conversions
  • real_time_cost_per_conversion: Real-time CPA
  • real_time_conversion_rate: Real-time CVR (Clicks)
  • real_time_conversion_rate_v2: Real-time CVR (Impressions)
  • result: Result
  • cost_per_result: Cost Per Result
  • result_rate: Result Rate (%)
  • real_time_result: Real-time Result
  • real_time_cost_per_result: Real-time Cost Per Result
  • real_time_result_rate: Real-time Result Rate (%)
  • secondary_goal_result: Secondary Goal Result
  • cost_per_secondary_goal_result: Cost per Secondary Goal Result
  • secondary_goal_result_rate: Secondary Goal Result Rate (%)
  • frequency: Frequency
  • currency: currency

Métricas de Video play

  • video_play_actions: Video Views
  • video_watched_2s: 2-Second Video Views
  • video_watched_6s: 6-Second Video Views
  • average_video_play: Video Average Watch Time Per Video View
  • average_video_play_per_user: Video Average Watch Time Per Person
  • video_views_p25: Video Views at 25%
  • video_views_p50: Video Views at 50%
  • video_views_p75: Video Views at 75%
  • video_views_p100: Video Views at 100%

Métricas de engajamento

  • engagements: Clicks (All)
  • profile_visits: Paid Profile Visit
  • likes: Paid Likes
  • comments: Paid Comments
  • shares: Paid Shares
  • follows: Paid Followers
  • clicks_on_music_disc: Music Clicks
  • ix_page_duration_avg: Instant Experience Average View Time
  • ix_page_viewrate_avg: Instant Experience Average View Percentage

Período

O período define a granularidade da coluna metric_date. Ele é útil para melhor mensuração de algumas métricas do tipo “count distinct” que podem ser diferentes em uma somatória mensal (com granularidade mensal) versus somatória dos dias do mês (com granularidade diária), por exemplo unique_clicks – se um mesmo usuário clicou no seu anúncio todos os dias de um mês, ele será contado como um clique por dia em uma granularidade diária, mas se for somado, ele será considerado 30 cliques para um mês. O correto, neste caso, seria considerar apenas 1 clique do usuário no mês, utilizando o período mensal na integração.

Os períodos disponíveis são:

  • hourly: separa seus dados por hora. O campo metric_date é apresentado com o dia e é criado um novo campo coluna metric_datehour. Este campo diminui as métricas possíveis do relatório
  • daily: por dia. O campo metric_date é apresentado com o dia. As métricas disponíveis irão variar conforme o detalhamento
  • weekly: por semana. O campo metric_date é apresentado como a segunda-feira da semana em questão e os resultados referem-se aos dados de segunda à domingo. As métricas disponíveis irão variar conforme o detalhamento
  • monthly: por mês. O campo metric_date é apresentado como primeiro dia do mês e os dados referem-se ao período entre o primeiro e o último dia do mês. As métricas disponíveis irão variar conforme o detalhamento
  • lifetime: todos os dados disponíveis, não há o campo metric_date (quantidade de métricas e detalhamentos reduzidos)

Janela de atualização

Este parâmetro indica quandos dias anteriores ao savepoint os dados continuarão sendo atualizados. Isso quer dizer que, com uma integração que tenha janela de 7 dias, a cada execução, serão lidos 7 dias de resultados. Essa janela é útil caso, em algumas situações, os dados do “passado” ainda podem ser alterados. Como é o caso de uma conversão por um usuário que foi impactado por um anúncio mas só converteu de fato 3 dias depois – ele é atribuído como uma conversão de 3 dias atrás, alterado o passado.