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
Ad Report
Advertiser Report
Campaign Report
Taxonomia: Anúncios: Detalhes
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] ID do anúncio |
|
text |
[pt] Formato do anúncio |
|
text |
[pt] ID do anunciante |
|
text |
[pt] Nome do anúncio |
|
text |
[pt] ID da campanha |
|
text |
[pt] Nome da campanha |
|
text |
[pt] Texto do anúncio |
|
text |
[pt] Textos do anúncio |
|
text |
[pt] ID do grupo de anúncios |
|
text |
[pt] Nome do grupo de anúncios |
|
text |
[pt] Tipo de divulgação AIGC |
|
text |
[pt] Nome do aplicativo |
|
text |
[pt] URI do ícone de avatar |
|
text |
[pt] Parceiro de brand safety pós-lance |
|
text |
[pt] URL VAST de brand safety |
|
text |
[pt] Chamada para ação |
|
text |
[pt] ID da chamada para ação |
|
text |
[pt] ID do cartão |
|
text |
[pt] Rótulos das imagens do carrossel |
|
text |
[pt] URL de rastreamento de clique |
|
timestamp |
[pt] Data de criação |
|
boolean |
[pt] Creative autorizado |
|
text |
[pt] Tipo de creative |
|
text |
[pt] Deeplink |
|
text |
[pt] Tipo de deeplink |
|
text |
[pt] Nome de exibição |
|
text |
[pt] ID da identidade |
|
text |
[pt] Tipo de identidade |
|
text |
[pt] IDs das imagens |
|
text |
[pt] URL de rastreamento de impressão |
|
boolean |
[pt] É ACO (Automated Creative Optimization) |
|
boolean |
[pt] É nova estrutura |
|
text |
[pt] URL da página de destino |
|
text |
[pt] URLs de página de destino |
|
timestamp |
[pt] Data de modificação |
|
text |
[pt] ID da música |
|
text |
[pt] Status da operação |
|
text |
[pt] Evento de otimização |
|
text |
[pt] ID da página |
|
text |
[pt] URL do playable |
|
text |
[pt] URL da imagem do perfil |
|
text |
[pt] Status secundário |
|
text |
[pt] ID do pixel de rastreamento |
|
boolean |
[pt] VAST Moat habilitado |
|
text |
[pt] ID do vídeo |
|
text |
[pt] Parceiro de viewability pós-lance |
|
text |
[pt] URL VAST de viewability |
tiktokads_ad_details_utm_params
Campo | Tipo | |
---|---|---|
text |
[pt] ID do anúncio |
|
text |
[pt] ID do anunciante |
|
text |
[pt] Nome do anúncio |
|
text |
[pt] ID da campanha |
|
text |
[pt] Nome da campanha |
|
text |
[pt] ID do grupo de anúncios |
|
text |
[pt] Nome do grupo de anúncios |
|
text |
[pt] Chave do parâmetro UTM |
|
text |
[pt] Valor do parâmetro UTM |
Taxonomia: Campanhas: Detalhes
Campo | Tipo | |
---|---|---|
text |
[pt] ID da campanha |
|
text |
[pt] ID do anunciante |
|
text |
[pt] ID da app |
|
text |
[pt] Tipo de promoção da app |
|
text |
[pt] Tipo de alinhamento de lance |
|
float |
[pt] Orçamento |
|
text |
[pt] Modo de orçamento |
|
boolean |
[pt] Otimizar orçamento |
|
text |
[pt] Estado da página de perfil da campanha |
|
text |
[pt] Nome da campanha |
|
text |
[pt] Origem do produto da campanha |
|
text |
[pt] Origem do sistema da campanha |
|
text |
[pt] Tipo de campanha |
|
boolean |
[pt] Catálogo habilitado |
|
timestamp |
[pt] Data de criação |
|
text |
[pt] Tipo de lance profundo |
|
boolean |
[pt] Desabilitar campanha SKAN |
|
boolean |
[pt] É campanha avançada dedicada |
|
boolean |
[pt] É nova estrutura |
|
boolean |
[pt] É campanha de busca |
|
boolean |
[pt] É campanha de desempenho inteligente |
|
timestamp |
[pt] Data de modificação |
|
text |
[pt] Objetivo |
|
text |
[pt] Tipo de objetivo |
|
text |
[pt] Status de operação |
|
text |
[pt] Objetivo de otimização |
|
text |
[pt] Modo de janela de postback |
|
text |
[pt] Tipo de campanha RF |
|
text |
[pt] ROAS de lance |
|
text |
[pt] Lance da RTA habilitado |
|
text |
[pt] ID da RTA |
|
boolean |
[pt] Seleção de produto da RTA habilitada |
|
text |
[pt] Destino de vendas |
|
text |
[pt] Status secundário |
|
text |
[pt] Indústrias especiais |
|
text |
[pt] Tipo de objetivo virtual |
Taxonomia: Grupos de anúncios: Detalhes
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do grupo de anúncios. |
|
text |
[pt] Estado da página de perfil do app para o grupo de anúncios. |
|
text |
[pt] Nome do grupo de anúncios. |
|
text |
[pt] Identificador único do anunciante no TikTok Ads. |
|
text |
[pt] Faixas etárias alvo da segmentação. |
|
text |
[pt] URL do aplicativo para download promovido. |
|
text |
[pt] Identificador do aplicativo promovido. |
|
text |
[pt] Tipo de aplicativo promovido. |
|
text |
[pt] IDs de audiências alvo da campanha. |
|
boolean |
[pt] Indica se a adição automática de palavras-chave está habilitada. |
|
text |
[pt] Modo de exibição do lance (ex: CPMV). |
|
text |
[pt] Preço de lance configurado para o grupo de anúncios. |
|
text |
[pt] Tipo de lance configurado (ex: BID_TYPE_CUSTOM). |
|
text |
[pt] Evento de cobrança associado (ex: CPM, CPC). |
|
float |
[pt] Identificador do parceiro de segurança de marca. |
|
text |
[pt] Nível de segurança de marca aplicado ao inventário (ex: STANDARD_INVENTORY). |
|
float |
[pt] Orçamento alocado para o grupo de anúncios. |
|
text |
[pt] Modo de orçamento configurado (ex: BUDGET_MODE_INFINITE). |
|
text |
[pt] Identificador único da campanha associada. |
|
text |
[pt] Nome da campanha publicitária. |
|
text |
[pt] IDs de categorias de exclusão configuradas. |
|
text |
[pt] Identificador da categoria associada ao grupo de anúncios. |
|
boolean |
[pt] Indica se os comentários estão desabilitados no anúncio. |
|
text |
[pt] IDs de tags contextuais para segmentação de anúncios. |
|
text |
[pt] Preço de lance configurado para conversão. |
|
text |
[pt] Janela de conversão usada para atribuição. |
|
timestamp |
[pt] Data e hora de criação do grupo de anúncios. |
|
text |
[pt] Modo de materiais criativos utilizado (ex: CUSTOM). |
|
text |
[pt] Configuração de horários (dayparting) para exibição dos anúncios. |
|
text |
[pt] Tipo de lance configurado para otimização de funil profundo. |
|
text |
[pt] Lance configurado para CPA em funil profundo. |
|
text |
[pt] Fonte de eventos usada na otimização de funil profundo. |
|
text |
[pt] ID da fonte de eventos para otimização de funil profundo. |
|
text |
[pt] Evento de otimização para funil profundo. |
|
text |
[pt] Status da otimização para funil profundo. |
|
text |
[pt] Modo de entrega do anúncio. |
|
text |
[pt] Lista de identificadores de modelos de dispositivo alvo. |
|
text |
[pt] Faixas de preço dos dispositivos alvo. |
|
text |
[pt] IDs de audiências excluídas da segmentação. |
|
text |
[pt] Tipo de feed onde o anúncio será exibido. |
|
float |
[pt] Limite de frequência de exibição dos anúncios. |
|
float |
[pt] Intervalo de frequência programado (em dias). |
|
text |
[pt] Segmentação de gênero (ex: GENDER_UNLIMITED). |
|
text |
[pt] Faixas de renda familiar alvo da segmentação. |
|
text |
[pt] IDs das categorias de interesse usadas na segmentação. |
|
text |
[pt] IDs de palavras-chave de interesse para segmentação. |
|
boolean |
[pt] Indica se o filtro de inventário está habilitado. |
|
text |
[pt] Tipo de quota relacionado a restrições do iOS 14. |
|
boolean |
[pt] Indica se o anúncio se enquadra na categoria HFSS (altos em gordura, sal e açúcar). |
|
boolean |
[pt] Indica se o grupo de anúncios segue a nova estrutura. |
|
boolean |
[pt] Indica se é uma campanha de performance inteligente. |
|
text |
[pt] IDs de provedores de internet alvo. |
|
text |
[pt] Palavras-chave associadas à segmentação do anúncio. |
|
text |
[pt] Idiomas alvo da segmentação de anúncios. |
|
text |
[pt] Lista de identificadores de localização geográfica alvo. |
|
timestamp |
[pt] Data e hora da última modificação no grupo de anúncios. |
|
text |
[pt] Tipos de rede onde o anúncio será exibido (ex: TikTok, TikTok Search). |
|
float |
[pt] Taxa de retenção no dia seguinte estimada. |
|
text |
[pt] Sistemas operacionais alvo (ex: ANDROID, IOS). |
|
text |
[pt] Status de operação do grupo de anúncios (ex: ENABLE). |
|
text |
[pt] Evento de otimização associado. |
|
text |
[pt] Objetivo de otimização configurado (ex: REACH). |
|
text |
[pt] Modo de ritmo de gasto do orçamento (ex: PACING_MODE_SMOOTH). |
|
text |
[pt] Identificador do pixel associado ao grupo de anúncios. |
|
text |
[pt] Tipo de posicionamento onde o anúncio será exibido. |
|
text |
[pt] Locais onde o anúncio será exibido (ex: PLACEMENT_TIKTOK). |
|
text |
[pt] Tipo de promoção (ex: WEBSITE_OR_DISPLAY). |
|
float |
[pt] Quantidade de impressões adquiridas. |
|
float |
[pt] Alcance adquirido no grupo de anúncios. |
|
text |
[pt] CPR estimado calculado pela ferramenta Reach & Frequency. |
|
float |
[pt] Frequência estimada da compra Reach & Frequency. |
|
text |
[pt] Tipo de compra de alcance e frequência (Reach & Frequency). |
|
text |
[pt] ID da audiência salva usada na campanha. |
|
timestamp |
[pt] Data e hora de término programado da campanha. |
|
boolean |
[pt] Indica se o cronograma está salvo como rascunho. |
|
text |
[pt] Identificador único do cronograma. |
|
timestamp |
[pt] Data e hora de início programado da campanha. |
|
text |
[pt] Tipo de programação do anúncio (ex: SCHEDULE_START_END). |
|
float |
[pt] Orçamento programado para o grupo de anúncios. |
|
boolean |
[pt] Indica se a exibição nos resultados de busca está habilitada. |
|
text |
[pt] Evento secundário configurado para otimização. |
|
text |
[pt] Status secundário atual do grupo de anúncios. |
|
boolean |
[pt] Indica se o compartilhamento está desabilitado. |
|
boolean |
[pt] Indica se a fase de aprendizado será ignorada. |
|
boolean |
[pt] Indica se a segmentação de audiência inteligente está habilitada. |
|
boolean |
[pt] Indica se comportamento de interesse inteligente está habilitado. |
|
text |
[pt] Poder de compra segmentado (ex: ALL, HIGH). |
|
text |
[pt] Tipo de estatística utilizada no relatório ou segmentação. |
|
text |
[pt] Locais específicos dentro do TikTok onde os anúncios serão exibidos (ex: IN_FEED, SEARCH_FEED). |
|
text |
[pt] Janela de otimização baseada em valor (VBO window). |
|
text |
[pt] ID de sensibilidade vertical para restrições de conteúdo. |
|
boolean |
[pt] Indica se o download do vídeo está desabilitado. |
tiktokads_adgroup_details_actions
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do grupo de anúncios. |
|
text |
[pt] IDs das categorias de ação aplicadas. |
|
float |
[pt] Período de tempo considerado para a ação em dias. |
|
text |
[pt] Cena ou contexto onde a ação ocorreu (ex: VIDEO_RELATED). |
|
text |
[pt] Ações do usuário em vídeo (ex: WATCHED_TO_END, LIKED). |
tiktokads_adgroup_details_excluded_custom_actions
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do grupo de anúncios. |
|
text |
[pt] Código da ação personalizada excluída. |
|
float |
[pt] Número de dias em que a exclusão da ação personalizada é considerada. |
tiktokads_adgroup_details_schedule_infos_schedules
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do grupo de anúncios. |
|
timestamp |
[pt] Horário de término programado para exibição do anúncio. |
|
text |
[pt] Pedidos esperados durante o período programado. |
|
timestamp |
[pt] Horário de início programado para exibição do anúncio. |
tiktokads_adgroup_details_included_custom_actions
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
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