Adicionando o conector
Requisitos
- Acesso mínimo de Ad account analyst às contas que serão conectadas
Instruções
- Na plataforma da Kondado, clique em CRIAR + > Conector > e selecione o conector do TikTok Ads
- 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
- 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
- Na página de permissões, deixe todas as opções marcadas com “Sim” e clique em “Concluir”
- Agora basta salvar o conector
Para utilizar suas integrações da melhor forma, entenda mais sobre detalhamento, métricas, período e janela de atualização
Integrações
Índice
Gráfico de relacionamento
Clique para ampliar
Ad Group Report
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Anunciantes: Anunciantes para a leitura de dados. Deixe em branco para buscar todos os anunciantes do conector
- Janela de atualização: Selecione a quantidade de dias anteriores ao savepoint para a leitura de dados
- Período: Granularidade temporal dos dados
- xxxx: xxxx
- Data inicial de leitura (Savepoint): Data inicial para leitura de dados
- Detalhamento: Selecione as dimensões que farão o detalhamento da leitura de dados
Ad Report
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Anunciantes: Anunciantes para a leitura de dados. Deixe em branco para buscar todos os anunciantes do conector
- Janela de atualização: Selecione a quantidade de dias anteriores ao savepoint para a leitura de dados
- Período: Granularidade temporal dos dados
- xxxx: xxxx
- Data inicial de leitura (Savepoint): Data inicial para leitura de dados
- Detalhamento: Selecione as dimensões que farão o detalhamento da leitura de dados
Advertiser Report
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Anunciantes: Anunciantes para a leitura de dados. Deixe em branco para buscar todos os anunciantes do conector
- Janela de atualização: Selecione a quantidade de dias anteriores ao savepoint para a leitura de dados
- Período: Granularidade temporal dos dados
- xxxx: xxxx
- Data inicial de leitura (Savepoint): Data inicial para leitura de dados
- Detalhamento: Selecione as dimensões que farão o detalhamento da leitura de dados
Campaign Report
Tipo de replicacao: Incremental com janela de atualizacao
Parametros:
- Anunciantes: Anunciantes para a leitura de dados. Deixe em branco para buscar todos os anunciantes do conector
- Janela de atualização: Selecione a quantidade de dias anteriores ao savepoint para a leitura de dados
- Período: Granularidade temporal dos dados
- xxxx: xxxx
- Data inicial de leitura (Savepoint): Data inicial para leitura de dados
- Detalhamento: Selecione as dimensões que farão o detalhamento da leitura de dados
Taxonomia: Anúncios: Detalhes
Tipo de replicacao: Integral
Parametros:
- Anunciantes: Anunciantes para a leitura de dados. Deixe em branco para buscar todos os anunciantes do conector
Relacionamentos:
Objeto principal
Detalhes completos dos anúncios configurados no TikTok Ads.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Ad ID |
|
|
text |
[pt] Ad format |
|
|
text |
[pt] Advertiser ID |
|
|
text |
[pt] Ad name |
|
|
text |
[pt] Campaign ID |
|
|
text |
[pt] Campaign name |
|
|
text |
[pt] Ad text |
|
|
text |
[pt] Ad texts |
|
|
text |
[pt] Ad group ID |
|
|
text |
[pt] Ad group name |
|
|
text |
[pt] AIGC disclosure type |
|
|
text |
[pt] App name |
|
|
text |
[pt] Avatar icon web URI |
|
|
text |
[pt] Brand safety postbid partner |
|
|
text |
[pt] Brand safety VAST URL |
|
|
text |
[pt] Call to action |
|
|
text |
[pt] Call to action ID |
|
|
text |
[pt] Card ID |
|
|
text |
[pt] Carousel image labels |
|
|
text |
[pt] Click tracking URL |
|
|
timestamp |
[pt] Create time |
|
|
boolean |
[pt] Creative authorized |
|
|
text |
[pt] Creative type |
|
|
text |
[pt] Deeplink |
|
|
text |
[pt] Deeplink type |
|
|
text |
[pt] Display name |
|
|
text |
[pt] Identity ID |
|
|
text |
[pt] Identity type |
|
|
text |
[pt] Image IDs |
|
|
text |
[pt] URL da primeira imagem/thumbnail do anúncio. ATENÇÃO: Esta URL expira em 1 hora. Veja tabela tiktokads_ad_details_images para todas as imagens. |
|
|
text |
[pt] Impression tracking URL |
|
|
boolean |
[pt] Is ACO (Automated Creative Optimization) |
|
|
boolean |
[pt] Is new structure |
|
|
text |
[pt] Landing page URL |
|
|
text |
[pt] Landing page URLs |
|
|
timestamp |
[pt] Modify time |
|
|
text |
[pt] Music ID |
|
|
text |
[pt] Operation status |
|
|
text |
[pt] Optimization event |
|
|
text |
[pt] Page ID |
|
|
text |
[pt] Playable URL |
|
|
text |
[pt] Profile image URL |
|
|
text |
[pt] Secondary status |
|
|
text |
[pt] Tracking pixel ID |
|
|
boolean |
[pt] VAST Moat enabled |
|
|
text |
[pt] Video ID |
|
|
text |
[pt] Viewability postbid partner |
|
|
text |
[pt] Viewability VAST URL |
tiktokads_ad_details_utm_params
Parâmetros UTM associados a cada anúncio.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Ad ID |
|
|
text |
[pt] Advertiser ID |
|
|
text |
[pt] Ad name |
|
|
text |
[pt] Campaign ID |
|
|
text |
[pt] Campaign name |
|
|
text |
[pt] Ad group ID |
|
|
text |
[pt] Ad group name |
|
|
text |
[pt] UTM parameter key |
|
|
text |
[pt] UTM parameter value |
tiktokads_ad_details_images
URLs das imagens/thumbnails dos anúncios. ATENÇÃO: URLs expiram em 1 hora após a extração.
Taxonomia: Campanhas: Detalhes
Tipo de replicacao: Integral
Parametros:
- Anunciantes: Anunciantes para a leitura de dados. Deixe em branco para buscar todos os anunciantes do conector
Configurações e atributos das campanhas no TikTok Ads.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Campaign ID |
|
|
text |
[pt] Advertiser ID |
|
|
text |
[pt] App ID |
|
|
text |
[pt] App Promotion Type |
|
|
text |
[pt] Bid Align Type |
|
|
float |
[pt] Budget |
|
|
text |
[pt] Budget Mode |
|
|
boolean |
[pt] Budget Optimize On |
|
|
text |
[pt] Campaign App Profile Page State |
|
|
text |
[pt] Campaign Name |
|
|
text |
[pt] Campaign Product Source |
|
|
text |
[pt] Campaign System Origin |
|
|
text |
[pt] Campaign Type |
|
|
boolean |
[pt] Catalog Enabled |
|
|
timestamp |
[pt] Create Time |
|
|
text |
[pt] Deep Bid Type |
|
|
boolean |
[pt] Disable SKAN Campaign |
|
|
boolean |
[pt] Is Advanced Dedicated Campaign |
|
|
boolean |
[pt] Is New Structure |
|
|
boolean |
[pt] Is Search Campaign |
|
|
boolean |
[pt] Is Smart Performance Campaign |
|
|
timestamp |
[pt] Modify Time |
|
|
text |
[pt] Objective |
|
|
text |
[pt] Objective Type |
|
|
text |
[pt] Operation Status |
|
|
text |
[pt] Optimization Goal |
|
|
text |
[pt] Postback Window Mode |
|
|
text |
[pt] RF Campaign Type |
|
|
text |
[pt] ROAS Bid |
|
|
text |
[pt] RTA Bid Enabled |
|
|
text |
[pt] RTA ID |
|
|
boolean |
[pt] RTA Product Selection Enabled |
|
|
text |
[pt] Sales Destination |
|
|
text |
[pt] Secondary Status |
|
|
text |
[pt] Special Industries |
|
|
text |
[pt] Virtual Objective Type |
Taxonomia: Grupos de anúncios: Detalhes
Tipo de replicacao: Integral
Parametros:
- Anunciantes: Anunciantes para a leitura de dados. Deixe em branco para buscar todos os anunciantes do conector
Relacionamentos:
Objeto principal
Detalhes dos grupos de anúncios (ad groups) do TikTok Ads.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Unique identifier of the ad group. |
|
|
text |
[pt] App profile page state for the ad group. |
|
|
text |
[pt] Ad group name. |
|
|
text |
[pt] Unique identifier of the advertiser in TikTok Ads. |
|
|
text |
[pt] Targeted age groups. |
|
|
text |
[pt] URL of the promoted app for download. |
|
|
text |
[pt] Identifier of the promoted application. |
|
|
text |
[pt] Type of promoted application. |
|
|
text |
[pt] IDs of audiences targeted by the campaign. |
|
|
boolean |
[pt] Indicates whether automatic keyword addition is enabled. |
|
|
text |
[pt] Bid display mode (e.g., CPMV). |
|
|
text |
[pt] Bid price set for the ad group. |
|
|
text |
[pt] Configured bid type (e.g., BID_TYPE_CUSTOM). |
|
|
text |
[pt] Associated billing event (e.g., CPM, CPC). |
|
|
float |
[pt] Identifier of the brand safety partner. |
|
|
text |
[pt] Brand safety level applied to inventory (e.g., STANDARD_INVENTORY). |
|
|
float |
[pt] Budget allocated for the ad group. |
|
|
text |
[pt] Configured budget mode (e.g., BUDGET_MODE_INFINITE). |
|
|
text |
[pt] Unique identifier of the associated campaign. |
|
|
text |
[pt] Advertising campaign name. |
|
|
text |
[pt] IDs of excluded categories. |
|
|
text |
[pt] Identifier of the category associated with the ad group. |
|
|
boolean |
[pt] Indicates if comments are disabled for the ad. |
|
|
text |
[pt] Contextual tag IDs for ad targeting. |
|
|
text |
[pt] Bid price configured for conversion. |
|
|
text |
[pt] Conversion window used for attribution. |
|
|
timestamp |
[pt] Date and time when the ad group was created. |
|
|
text |
[pt] Creative material mode used (e.g., CUSTOM). |
|
|
text |
[pt] Dayparting configuration for ad delivery times. |
|
|
text |
[pt] Bid type configured for deep funnel optimization. |
|
|
text |
[pt] Bid set for deep funnel CPA optimization. |
|
|
text |
[pt] Event source used in deep funnel optimization. |
|
|
text |
[pt] Event source ID for deep funnel optimization. |
|
|
text |
[pt] Deep funnel optimization event. |
|
|
text |
[pt] Status of deep funnel optimization. |
|
|
text |
[pt] Ad delivery mode. |
|
|
text |
[pt] List of targeted device model identifiers. |
|
|
text |
[pt] Price ranges of targeted devices. |
|
|
text |
[pt] IDs of audiences excluded from targeting. |
|
|
text |
[pt] Type of feed where the ad will be displayed. |
|
|
float |
[pt] Ad frequency cap (maximum impressions per user). |
|
|
float |
[pt] Scheduled frequency interval (in days). |
|
|
text |
[pt] Gender targeting (e.g., GENDER_UNLIMITED). |
|
|
text |
[pt] Targeted household income brackets. |
|
|
text |
[pt] IDs of interest categories used for targeting. |
|
|
text |
[pt] Interest keyword IDs for targeting. |
|
|
boolean |
[pt] Indicates whether inventory filtering is enabled. |
|
|
text |
[pt] Quota type related to iOS 14 restrictions. |
|
|
boolean |
[pt] Indicates whether the ad falls into HFSS category (high in fat, salt, sugar). |
|
|
boolean |
[pt] Indicates whether the ad group follows the new structure. |
|
|
boolean |
[pt] Indicates if this is a smart performance campaign. |
|
|
text |
[pt] IDs of targeted internet service providers (ISPs). |
|
|
text |
[pt] Keywords associated with the ad’s targeting. |
|
|
text |
[pt] Languages targeted by the ad group. |
|
|
text |
[pt] List of targeted geographic location identifiers. |
|
|
timestamp |
[pt] Date and time of the last modification to the ad group. |
|
|
text |
[pt] Network types where the ad will appear (e.g., TikTok, TikTok Search). |
|
|
float |
[pt] Estimated next day retention rate. |
|
|
text |
[pt] Targeted operating systems (e.g., ANDROID, IOS). |
|
|
text |
[pt] Operation status of the ad group (e.g., ENABLE). |
|
|
text |
[pt] Associated optimization event. |
|
|
text |
[pt] Optimization goal set (e.g., REACH). |
|
|
text |
[pt] Budget pacing mode (e.g., PACING_MODE_SMOOTH). |
|
|
text |
[pt] Pixel ID associated with the ad group. |
|
|
text |
[pt] Type of placement where the ad will be shown. |
|
|
text |
[pt] Placements where the ad will appear (e.g., PLACEMENT_TIKTOK). |
|
|
text |
[pt] Promotion type (e.g., WEBSITE_OR_DISPLAY). |
|
|
float |
[pt] Number of impressions purchased. |
|
|
float |
[pt] Purchased reach for the ad group. |
|
|
text |
[pt] Estimated CPR (Cost per Result) calculated by the Reach & Frequency tool. |
|
|
float |
[pt] Estimated frequency of the Reach & Frequency purchase. |
|
|
text |
[pt] Reach & Frequency purchase type. |
|
|
text |
[pt] ID of the saved audience used in the campaign. |
|
|
timestamp |
[pt] Scheduled end date and time of the campaign. |
|
|
boolean |
[pt] Indicates if the schedule is saved as draft. |
|
|
text |
[pt] Unique identifier of the schedule. |
|
|
timestamp |
[pt] Scheduled start date and time of the campaign. |
|
|
text |
[pt] Ad scheduling type (e.g., SCHEDULE_START_END). |
|
|
float |
[pt] Scheduled budget for the ad group. |
|
|
boolean |
[pt] Indicates if showing in search results is enabled. |
|
|
text |
[pt] Secondary event configured for optimization. |
|
|
text |
[pt] Current secondary status of the ad group. |
|
|
boolean |
[pt] Indicates whether sharing is disabled. |
|
|
boolean |
[pt] Indicates if learning phase is skipped. |
|
|
boolean |
[pt] Indicates if smart audience targeting is enabled. |
|
|
boolean |
[pt] Indicates if smart interest behavior targeting is enabled. |
|
|
text |
[pt] Targeted spending power segment (e.g., ALL, HIGH). |
|
|
text |
[pt] Type of statistic used in reporting or targeting. |
|
|
text |
[pt] Specific subplacements within TikTok where ads will be shown (e.g., IN_FEED, SEARCH_FEED). |
|
|
text |
[pt] Value-based optimization window (VBO window). |
|
|
text |
[pt] Vertical sensitivity ID for content restrictions. |
|
|
boolean |
[pt] Indicates whether video download is disabled. |
tiktokads_adgroup_details_actions
Ações configuradas para cada grupo de anúncios.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Unique identifier of the ad group. |
|
|
text |
[pt] IDs of the applied action categories. |
|
|
float |
[pt] Time period considered for the action, in days. |
|
|
text |
[pt] Scene or context where the action occurred (e.g., VIDEO_RELATED). |
|
|
text |
[pt] User actions on videos (e.g., WATCHED_TO_END, LIKED). |
tiktokads_adgroup_details_excluded_custom_actions
Ações personalizadas excluídas por grupo de anúncios.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Unique identifier of the ad group. |
|
|
text |
[pt] Code of the excluded custom action. |
|
|
float |
[pt] Number of days the excluded custom action is considered. |
tiktokads_adgroup_details_schedule_infos_schedules
Grades de veiculação (schedules) configuradas para os grupos de anúncios.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Unique identifier of the ad group. |
|
|
timestamp |
[pt] Scheduled end time for ad delivery. |
|
|
text |
[pt] Expected orders during the scheduled period. |
|
|
timestamp |
[pt] Scheduled start time for ad delivery. |
tiktokads_adgroup_details_included_custom_actions
Ações personalizadas incluídas para cada grupo de anúncios.
Notas
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.
Metricas e Atributos
De acordo com as escolhas feitas para os parâmetros de período e detalhamento, seu relatório irá abranger métricas e atributos diferentes.
Atributos
Os atributos são incluídos em seu relatório de acordo com o detalhamento escolhido
- 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
Há 2 tipos de métricas: Básicas e de Audiência
Métricas básicas
Estarão disponíveis nos seguintes casos:
- Relatórios Reservation
- Relatórios que utilizem período Hourly ou Lifetime
- Relatórios que utilizem agregação pelo id da entidade. Por exemplo, um relatório de Ads cujo detalhamento seja ad_id
Métricas gerais
- initiate_checkout_rate: Taxa única de início de checkout (página). A porcentagem de ações de início de checkout da página em relação a todos os cliques atribuídos aos seus anúncios
- cost_per_app_event_add_to_cart: Custo único por adicionar ao carrinho (app). O custo médio por cada ação única de adicionar ao carrinho no app atribuída aos seus anúncios
- sales_lead: Leads únicos gerados (app). O número de ações únicas de geração de leads no app atribuídas aos seus anúncios
- shares: Compartilhamentos pagos. Número de compartilhamentos do seu anúncio durante a impressão do anúncio
- cost_per_web_event_add_to_cart: Custo por adicionar ao carrinho (página). O custo médio por cada ação de adicionar ao carrinho na página atribuída aos seus anúncios
- vta_app_install: Instalação de app VTA. O número de eventos de instalação de app atribuídos a uma impressão de anúncio
- total_add_to_wishlist_value: Valor de adicionar à lista de desejos (app). O valor total das ações de adicionar à lista de desejos no app atribuídas aos seus anúncios
- product_details_page_browse: Visualização da página de detalhes do produto. O número de eventos de visualização de página de detalhes do produto
- web_event_add_to_cart_rate: Taxa única de adicionar ao carrinho (página). A porcentagem de ações de adicionar ao carrinho na página em relação a todos os cliques atribuídos aos seus anúncios
- purchase_rate: Taxa única de compra (app). A porcentagem de ações de compra no app em relação a todas as instalações do app atribuídas aos seus anúncios
- value_per_total_purchase: Valor por compra (app). O valor médio por ação de compra no app atribuída aos seus anúncios
- cost_per_total_app_event_add_to_cart: Custo por adicionar ao carrinho (app). O custo médio por cada ação de adicionar ao carrinho no app atribuída aos seus anúncios
- total_user_registration_value: Valor de conclusão de registro (página). O valor total das ações de conclusão de registro na página atribuídas aos seus anúncios
- cost_per_user_registration: Custo por conclusão de registro (página). O custo médio por cada ação de conclusão de registro na página atribuída aos seus anúncios
- web_event_add_to_cart: Adições ao carrinho (página). O número de ações de adicionar ao carrinho na página atribuídas aos seus anúncios
- user_registration: Registros concluídos (página). O número de ações de conclusão de registro na página atribuídas aos seus anúncios
- total_initiate_checkout_value: Valor de início de checkout (página). O valor total das ações de início de checkout na página atribuídas aos seus anúncios
- real_time_cost_per_conversion: Custo em tempo real por conversão. Valor médio gasto em uma conversão
- app_event_add_to_cart: Adições únicas ao carrinho (app). O número de ações únicas de adicionar ao carrinho no app atribuídas aos seus anúncios
- initiate_checkout: Checkouts iniciados (página). O número de ações de início de checkout na página atribuídas aos seus anúncios
- app_event_add_to_cart_rate: Taxa única de adicionar ao carrinho (app). A porcentagem de ações de adicionar ao carrinho no app em relação a todas as instalações do app atribuídas aos seus anúncios
- registration_rate: Taxa única de registro (app). A porcentagem de ações de registro no app em relação a todas as instalações do app atribuídas aos seus anúncios
- total_purchase: Compras (app). O número de ações de compra no app atribuídas aos seus anúncios
- complete_payment: Pagamentos concluídos (página). O número de ações de conclusão de pagamento na página atribuídas aos seus anúncios
- follows: Seguimentos pagos. Número de seguimentos ao perfil associado durante a impressão do anúncio
- cost_per_total_view_content: Custo por visualização de conteúdo (app). O custo médio por cada ação de visualização de conteúdo no app atribuída aos seus anúncios
- cost_per_add_to_wishlist: Custo único por adicionar à lista de desejos (app). O custo médio por cada ação única de adicionar à lista de desejos no app atribuída aos seus anúncios
- video_watched_6s: Visualizações de vídeo de 6 segundos. Número de vezes que seu vídeo foi reproduzido por pelo menos 6 segundos. Para cada impressão de vídeo, reproduções são contadas separadamente e repetições são excluídas
- cost_per_result: Custo por resultado. Custo médio por cada resultado dos seus anúncios
- total_product_details_page_browse_value: Valor total de visualização da página de detalhes do produto. O valor total retornado dos eventos de visualização da página de detalhes do produto
- likes: Curtidas pagas. Número de vezes que seu anúncio foi curtido durante a impressão do anúncio
- cta_app_install: Instalação de app CTA. O número de eventos de instalação de app atribuídos a um clique no seu anúncio
- total_active_pay_roas: ROAS de compra (app). O retorno sobre o investimento em anúncios (ROAS) das ações de compra no app
- vta_registration: Registro VTA. O número de eventos de registro atribuídos à impressão, com base nas informações recebidas do seu parceiro de medição
- registration: Registros únicos (app). O número de ações únicas de registro no app atribuídas aos seus anúncios
- profile_visits: Visitas pagas ao perfil. Número de visitas ao perfil associado durante a impressão do anúncio
- frequency: Frequência. O número médio de vezes que cada usuário viu seu anúncio em um determinado período
- real_time_conversion_rate_v2: Taxa de conversão em tempo real (CVR). Porcentagem de conversões recebidas de todas as impressões dos seus anúncios
- cta_registration: Registro CTA. O número de eventos de registro no app atribuídos a um clique, com base nas informações recebidas do seu parceiro de medição
- impressions: Impressões. Número de vezes que seus anúncios foram exibidos
- cost_per_cta_purchase: Custo por compra CTA. O custo médio para cada evento de pagamento atribuído a cliques
- cost_per_view_content: Custo único por visualização de conteúdo (app). O custo médio por cada ação única de visualização de conteúdo no app atribuída aos seus anúncios
- comments: Comentários pagos. Número de comentários feitos no seu anúncio durante a impressão do anúncio
- view_content_rate: Taxa única de visualização de conteúdo (app). A porcentagem de ações de visualização de conteúdo no app em relação a todas as instalações do app atribuídas aos seus anúncios
- cost_per_total_checkout: Custo por checkout (app). O custo médio por cada ação de checkout no app atribuída aos seus anúncios
- complete_payment_rate: Taxa única de conclusão de pagamento (página). A porcentagem de ações de conclusão de pagamento na página em relação a todos os cliques atribuídos aos seus anúncios
- value_per_initiate_checkout: Valor por checkout iniciado (página). O valor médio por cada ação de início de checkout na página atribuída aos seus anúncios
- total_sales_lead_value: Valor de geração de leads (app). O valor total das ações de geração de leads no app atribuídas aos seus anúncios
- cost_per_1000_reached: Custo por 1.000 pessoas alcançadas. Custo médio para alcançar 1.000 usuários únicos
- total_add_to_wishlist: Adições à lista de desejos (app). O número de ações de adicionar à lista de desejos no app atribuídas aos seus anúncios
- video_views_p25: Visualizações de vídeo a 25%. Número de vezes que seu vídeo foi reproduzido por pelo menos 25% de sua duração. Para cada impressão, as visualizações são contadas separadamente e repetições são excluídas
- vta_conversion: Conversão VTA. O número de eventos de conversão atribuídos a uma impressão de anúncio
- cost_per_vta_conversion: Custo por conversão VTA. O custo médio para cada evento de conversão atribuído a uma impressão de anúncio
- cost_per_complete_payment: Custo por pagamento concluído (página). O custo médio por cada ação de conclusão de pagamento na página atribuída aos seus anúncios
- ctr: CTR (destino). Porcentagem de impressões que resultaram em um clique no destino em relação a todas as impressões
- cost_per_cta_registration: Custo por registro CTA. O custo médio para cada evento de registro no app atribuídos a cliques
- total_view_content: Visualizações de conteúdo (app). O número de ações de visualização de conteúdo no app atribuídas aos seus anúncios
- real_time_conversion: Conversões em tempo real. Número de vezes que seu anúncio resultou no evento de otimização selecionado
- cta_purchase: Compra CTA. O número de eventos de pagamento no app atribuídos a um clique, com base nas informações recebidas do seu parceiro de medição
- cost_per_product_details_page_browse: Custo de visualização da página de detalhes do produto. O custo médio de cada evento de visualização da página de detalhes do produto
- total_view_content_value: Valor de visualização de conteúdo (app). O valor total das ações de visualização de conteúdo no app atribuídas aos seus anúncios
- total_sales_lead: Leads gerados (app). O número de ações de geração de leads no app atribuídas aos seus anúncios
- value_per_total_view_content: Valor por visualização de conteúdo (app). O valor médio por cada ação de visualização de conteúdo no app atribuída aos seus anúncios
- cost_per_conversion: Custo por conversão. Valor médio gasto em uma conversão
- add_to_wishlist_rate: Taxa única de adicionar à lista de desejos (app). A porcentagem de ações de adicionar à lista de desejos no app em relação a todas as instalações do app atribuídas aos seus anúncios
- conversion_rate: Taxa de conversão (CVR, cliques). Porcentagem de resultados recebidos de todos os cliques no destino dos seus anúncios. Observação: A partir de final de outubro de 2023, a lógica de cálculo dessa métrica será atualizada para ser baseada em impressões – o mesmo que conversion_rate_v2
- real_time_cost_per_result: Custo em tempo real por resultado. Custo médio por cada resultado dos seus anúncios
- video_views_p50: Visualizações de vídeo a 50%. Número de vezes que seu vídeo foi reproduzido por pelo menos 50% de sua duração. Para cada impressão, as visualizações são contadas separadamente e repetições são excluídas
- cost_per_checkout: Custo único por checkout (app). O custo médio por cada ação única de checkout no app atribuída aos seus anúncios
- value_per_web_event_add_to_cart: Valor por adicionar ao carrinho (página). O valor médio por cada ação de adicionar ao carrinho na página atribuída aos seus anúncios
- real_time_result: Resultados em tempo real. Número de vezes que seu anúncio resultou em um resultado pretendido com base no objetivo da campanha e na meta de otimização
- video_views_p100: Visualizações de vídeo a 100%. Número de vezes que seu vídeo foi reproduzido 100% de sua duração. Para cada impressão, as visualizações são contadas separadamente e repetições são excluídas
- total_web_event_add_to_cart_value: Valor de adicionar ao carrinho (página). O valor total das ações de adicionar ao carrinho na página atribuídas aos seus anúncios
- cta_conversion: Conversão CTA. O número de eventos de conversão atribuídos a um clique no seu anúncio
- total_app_event_add_to_cart: Adições ao carrinho (app). O número de ações de adicionar ao carrinho no app atribuídas aos seus anúncios
- checkout: Checkouts únicos (app). O número de ações únicas de checkout no app atribuídas aos seus anúncios
- product_details_page_browse_rate: Taxa de visualização da página de detalhes do produto (%). A porcentagem de eventos de visualização da página de detalhes do produto em relação a todos os eventos de clique
- total_checkout: Checkouts (app). O número de ações de checkout no app atribuídas aos seus anúncios
- value_per_total_app_event_add_to_cart: Valor por adicionar ao carrinho (app). O valor médio por cada ação de adicionar ao carrinho no app atribuída aos seus anúncios
- user_registration_rate: Taxa única de conclusão de registro (página). A porcentagem de ações de conclusão de registro na página em relação a todos os cliques atribuídos aos seus anúncios
- total_app_event_add_to_cart_value: Valor de adicionar ao carrinho (app). O valor total das ações de adicionar ao carrinho no app atribuídas aos seus anúncios
- cost_per_total_add_to_wishlist: Custo por adicionar à lista de desejos (app). O custo médio por cada ação de adicionar à lista de desejos no app atribuída aos seus anúncios
- cost_per_initiate_checkout: Custo por checkout iniciado (página). O custo médio por cada ação de início de checkout na página atribuída aos seus anúncios
- video_watched_2s: Visualizações de vídeo de 2 segundos. Número de vezes que seu vídeo foi reproduzido por pelo menos 2 segundos. Para cada impressão de vídeo, reproduções são contadas separadamente e repetições são excluídas
- total_checkout_value: Valor de checkout (app). O valor total das ações de checkout no app atribuídas aos seus anúncios
- cost_per_vta_purchase: Custo por compra VTA. O custo médio para cada evento de pagamento atribuído à impressão
- result: Resultados. Número de vezes que seu anúncio resultou em um resultado pretendido com base no objetivo da campanha e na meta de otimização
- cost_per_registration: Custo único por registro (app). O custo médio por cada ação única de registro no app atribuída aos seus anúncios
- cpc: CPC (destino). Custo médio de cada clique para um destino especificado
- add_to_wishlist: Adições únicas à lista de desejos (app). O número de ações únicas de adicionar à lista de desejos no app atribuídas aos seus anúncios
- video_play_actions: Visualizações de vídeo. Número de vezes que seu vídeo começou a ser reproduzido. Para cada impressão de vídeo, reproduções são contadas separadamente e repetições são excluídas
- total_purchase_value: Valor de compra (app). O valor total das ações de compra no app atribuídas aos seus anúncios
- video_views_p75: Visualizações de vídeo a 75%. Número de vezes que seu vídeo foi reproduzido por pelo menos 75% de sua duração. Para cada impressão, as visualizações são contadas separadamente e repetições são excluídas
- value_per_user_registration: Valor por conclusão de registro (página). O valor médio por cada ação de conclusão de registro na página atribuída aos seus anúncios
- total_complete_payment_rate: Valor de conclusão de pagamento (página). O valor total das ações de conclusão de pagamento na página atribuídas aos seus anúncios
- value_per_checkout: Valor por checkout (app). O valor médio por cada ação de checkout no app atribuída aos seus anúncios
- conversion: Conversões. Número de vezes que seu anúncio resultou no evento de otimização selecionado
- value_per_product_details_page_browse: Valor por visualização da página de detalhes do produto. O valor médio retornado dos eventos de visualização da página de detalhes do produto
- cost_per_total_purchase: Custo por compra (app). O custo médio por cada ação de compra no app atribuída aos seus anúncios
- value_per_complete_payment: Valor por pagamento concluído (página). O valor médio por cada ação de conclusão de pagamento na página atribuída aos seus anúncios
- cost_per_vta_registration: Custo por registro VTA. O custo médio para cada evento de registro atribuído à impressão
- clicks: Cliques (destino). Número de cliques dos seus anúncios para um destino especificado
- value_per_total_add_to_wishlist: Valor por adicionar à lista de desejos (app). O valor médio por cada ação de adicionar à lista de desejos no app atribuída aos seus anúncios
- reach: Alcance. Número de usuários únicos que visualizaram seus anúncios pelo menos uma vez
- cost_per_purchase: Custo único por compra (app). O custo médio por cada ação única de compra no app atribuída aos seus anúncios
- average_video_play: Tempo médio de reprodução por visualização de vídeo. Tempo médio que seu vídeo foi reproduzido por visualização de vídeo única, incluindo o tempo gasto assistindo novamente o vídeo
- purchase: Compras únicas (app). O número de ações únicas de compra no app atribuídas aos seus anúncios
- cost_per_total_registration: Custo por registro (app). O custo médio por cada ação de registro no app atribuída aos seus anúncios
- checkout_rate: Taxa única de checkout (app). A porcentagem de ações de checkout no app em relação a todas as instalações do app atribuídas aos seus anúncios
- cpm: CPM. Valor médio gasto por 1.000 impressões
- total_registration: Registros (app). O número de ações de registro no app atribuídas aos seus anúncios
- result_rate: Taxa de resultado. Porcentagem de resultados que ocorreram em relação a todas as impressões dos seus anúncios
- view_content: Visualizações únicas de conteúdo (app). O número de ações únicas de visualização de conteúdo no app atribuídas aos seus anúncios
- vta_purchase: Compra VTA. O número de eventos de pagamento no app atribuídos a uma impressão, com base nas informações recebidas do seu parceiro de medição
- real_time_result_rate: Taxa de resultado em tempo real. Porcentagem de resultados que ocorreram em relação a todas as impressões dos seus anúncios
- spend: Custo. Soma do seu gasto total com anúncios
- onsite_purchases_roas: ROAS de compras on-site. O retorno sobre o investimento em anúncios para compras on-site
- onsite_total_purchase: Total de compras on-site. O número total de eventos de compra on-site atribuídos aos seus anúncios
- onsite_cost_per_purchase: Custo por compra on-site. O custo médio por cada evento de compra on-site
- onsite_purchase_rate: Taxa de compra on-site. A porcentagem de impressões que resultaram em uma compra on-site
- onsite_value_per_purchase: Valor por compra on-site. O valor médio de cada evento de compra on-site
- onsite_total_purchase_value: Valor total de compras on-site. O valor monetário total de todas as compras on-site
- onsite_total_checkout_initiation: Total de inícios de checkout on-site. O número total de eventos de início de checkout on-site
- onsite_cost_per_checkout_initiation: Custo por início de checkout on-site. O custo médio por cada evento de início de checkout
- onsite_checkout_initiation_rate: Taxa de início de checkout on-site. A porcentagem de impressões que resultaram em início de checkout
- onsite_value_per_checkout_initiation: Valor por início de checkout on-site. O valor médio de cada evento de início de checkout
- onsite_total_checkout_initiation_value: Valor total de inícios de checkout on-site. O valor monetário total de todos os inícios de checkout
- onsite_total_add_to_cart: Total de adições ao carrinho on-site. O número total de eventos de adição ao carrinho on-site
- onsite_cost_per_add_to_cart: Custo por adição ao carrinho on-site. O custo médio por cada evento de adição ao carrinho
- onsite_add_to_cart_rate: Taxa de adição ao carrinho on-site. A porcentagem de impressões que resultaram em adição ao carrinho
- onsite_value_per_add_to_cart: Valor por adição ao carrinho on-site. O valor médio de cada evento de adição ao carrinho
- onsite_total_add_to_cart_value: Valor total de adições ao carrinho on-site. O valor monetário total de todas as adições ao carrinho
- onsite_total_product_details_page_view: Total de visualizações de página de detalhes do produto on-site
- onsite_cost_per_product_details_page_view: Custo por visualização de página de detalhes do produto on-site
- onsite_product_details_page_view_rate: Taxa de visualização de página de detalhes do produto on-site
- onsite_value_per_product_details_page_view: Valor por visualização de página de detalhes do produto on-site
- onsite_total_product_details_page_view_value: Valor total de visualizações de página de detalhes do produto on-site
- onsite_total_filtered_out_form_submission: Total de envios de formulários filtrados on-site
- shop_total_purchase_by_order_submission: Total de compras por envio de pedido na loja TikTok Shop
- shop_gross_revenue_by_order_submission: Receita bruta por envio de pedido na loja TikTok Shop
- shop_total_items_purchased: Total de itens comprados na loja TikTok Shop
- offline_total_crm_events: Total de eventos CRM offline
- offline_cost_per_crm_event: Custo por evento CRM offline
- offline_crm_event_rate: Taxa de eventos CRM offline
- offline_value_per_crm_event: Valor por evento CRM offline
- offline_crm_event_value: Valor de eventos CRM offline
- offline_preferred_leads: Leads preferenciais offline
- offline_cost_per_preferred_lead: Custo por lead preferencial offline
- offline_preferred_lead_rate: Taxa de leads preferenciais offline
- offline_total_find_location: Total de buscar localização offline
- offline_cost_per_find_location: Custo por buscar localização offline
- offline_find_location_rate: Taxa de buscar localização offline
- offline_value_per_find_location: Valor por buscar localização offline
- offline_total_find_location_value: Valor total de buscar localização offline
- offline_total_schedule: Total de agendamentos offline
- offline_cost_per_schedule: Custo por agendamento offline
- offline_schedule_rate: Taxa de agendamentos offline
- offline_value_per_schedule: Valor por agendamento offline
- offline_total_schedule_value: Valor total de agendamentos offline
- offline_total_customize_product: Total de personalização de produto offline
- offline_cost_per_customize_product: Custo por personalização de produto offline
- offline_customize_product_rate: Taxa de personalização de produto offline
- offline_value_per_customize_product: Valor por personalização de produto offline
- offline_total_customize_product_value: Valor total de personalização de produto offline
- offline_total_custom_events: Total de eventos personalizados offline
- offline_cost_per_custom_event: Custo por evento personalizado offline
- offline_custom_event_rate: Taxa de eventos personalizados offline
- offline_value_per_custom_event: Valor por evento personalizado offline
- offline_total_custom_event_value: Valor total de eventos personalizados offline
- website_total_find_location: Total de buscar localização no website
- website_cost_per_find_location: Custo por buscar localização no website
- website_find_location_rate: Taxa de buscar localização no website
- website_value_per_find_location: Valor por buscar localização no website
- website_total_find_location_value: Valor total de buscar localização no website
- website_total_schedule: Total de agendamentos no website
- website_cost_per_schedule: Custo por agendamento no website
- website_schedule_rate: Taxa de agendamentos no website
- website_value_per_schedule: Valor por agendamento no website
- website_total_schedule_value: Valor total de agendamentos no website
- website_total_customize_product: Total de personalização de produto no website
- website_cost_per_customize_product: Custo por personalização de produto no website
- website_customize_product_rate: Taxa de personalização de produto no website
- website_value_per_customize_product: Valor por personalização de produto no website
- website_total_customize_product_value: Valor total de personalização de produto no website
- day7_retention: Retenção de 7 dias. O número de usuários únicos que retornaram ao app no 7º dia após a instalação
- cost_per_day7_retention: Custo por retenção de 7 dias
- day7_retention_rate: Taxa de retenção de 7 dias
- total_day7_retention: Total de retenção de 7 dias
- cost_per_total_day7_retention: Custo por total de retenção de 7 dias
- value_per_total_day7_retention: Valor por total de retenção de 7 dias
- total_day7_retention_value: Valor total de retenção de 7 dias
- paid_engaged_view: Visualização engajada paga. Visualizações de pelo menos 6 segundos ou até o final, ou com interação
- paid_engagement_engaged_view: Engajamento de visualização engajada paga
- paid_engaged_view_15s: Visualização engajada paga de 15s. Visualizações de pelo menos 15 segundos
- paid_engagement_engaged_view_15s: Engajamento de visualização engajada paga de 15s
Métricas para o detalhamento Placement
- ix_page_duration_avg: Tempo médio que sua Experiência Instantânea foi exibida
- ix_page_viewrate_avg: Porcentagem média de conteúdo da sua Experiência Instantânea que foi visualizada
- average_video_play_per_user: Tempo médio que seu vídeo foi reproduzido por usuário, incluindo qualquer tempo gasto assistindo novamente o vídeo
Métricas inclusas caso Período não seja hourly e não seja um report do tipo Reservation
- skan_total_sales_lead_value: O valor dos eventos de geração de leads no seu app móvel que foram registrados como eventos de app e atribuídos aos seus anúncios. A contagem total é baseada no momento em que os eventos são retornados através da API SKAdNetwork. Pode haver um atraso entre o momento real da conversão e quando a conversão é reportada
- skan_total_sales_lead: O número de leads gerados no seu app móvel que foram registrados como eventos de app e atribuídos aos seus anúncios. A contagem total é baseada no momento em que os eventos são retornados através da API SKAdNetwork. Pode haver um atraso entre o momento real da conversão e quando a conversão é reportada
- skan_sales_lead: O número de leads únicos gerados no seu app móvel que foram registrados como eventos de app e atribuídos aos seus anúncios. A contagem total é baseada no momento em que os eventos são retornados através da API SKAdNetwork. Pode haver um atraso entre o momento real da conversão e quando a conversão é reportada
Métricas de audiência
Estão disponíveis em todos os outros casos que não incluírem as Métricas básicas
- spend: Custo. Soma do seu gasto total com anúncios
- cpc: CPC (destino). Custo médio de cada clique para um destino especificado
- cpm: CPM. Valor médio gasto por 1.000 impressões
- impressions: Impressões. Número de vezes que seus anúncios foram exibidos
- gross_impressions: Impressões brutas (inclui impressões inválidas). O número de vezes que um anúncio foi visto na tela, incluindo impressões inválidas
- clicks: Cliques (destino). Número de cliques dos seus anúncios para um destino especificado
- ctr: CTR (destino). Porcentagem de impressões que resultaram em um clique no destino em relação a todas as impressões
- conversion: Conversões. Número de vezes que seu anúncio resultou no evento de otimização selecionado
- cost_per_conversion: Custo por conversão. Valor médio gasto em uma conversão
- conversion_rate: Taxa de conversão (CVR, cliques). Porcentagem de resultados recebidos de todos os cliques no destino dos seus anúncios. Nota: A partir de final de outubro de 2023, a lógica de cálculo desta métrica será atualizada para ser baseada em impressões (igual à conversion_rate_v2)
- conversion_rate_v2: Taxa de conversão (CVR). Porcentagem de resultados recebidos de todas as impressões dos seus anúncios
- real_time_conversion: Conversões em tempo real. Número de vezes que seu anúncio resultou no evento de otimização selecionado
- real_time_cost_per_conversion: Custo em tempo real por conversão. Valor médio gasto em uma conversão
- real_time_conversion_rate: Taxa de conversão em tempo real (CVR, cliques). Porcentagem de conversões recebidas de todos os cliques no destino dos seus anúncios. Nota: A partir de final de outubro de 2023, a lógica de cálculo desta métrica será atualizada para ser baseada em impressões (igual à real_time_conversion_rate_v2)
- real_time_conversion_rate_v2: Taxa de conversão em tempo real (CVR). Porcentagem de conversões recebidas de todas as impressões dos seus anúncios
- result: Resultados. Número de vezes que seu anúncio resultou em um resultado pretendido com base no objetivo da campanha e na meta de otimização
- cost_per_result: Custo por resultado. Custo médio por cada resultado dos seus anúncios
- result_rate: Taxa de resultado. Porcentagem de resultados que ocorreram em relação a todas as impressões dos seus anúncios
- real_time_result: Resultados em tempo real. Número de vezes que seu anúncio resultou em um resultado pretendido com base no objetivo da campanha e na meta de otimização
- real_time_cost_per_result: Custo em tempo real por resultado. Custo médio por cada resultado dos seus anúncios
- real_time_result_rate: Taxa de resultado em tempo real. Porcentagem de resultados que ocorreram em relação a todas as impressões dos seus anúncios
- currency: Moeda. O código da moeda, ex. USD
- is_aco: Indica se o anúncio é um anúncio automatizado ou um anúncio de Criativo Inteligente. Definido como verdadeiro para um anúncio automatizado ou Criativo Inteligente
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.
Parte deste conteúdo foi gerado ou traduzido com auxílio de inteligência artificial
- Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas

