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, clique em CRIAR + > Conector > e selecione o conector do TikTok Ads
  2. Clique em “Sign in with TikTok”
    1. 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”
  5. 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

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

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

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

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

Taxonomia: Anúncios: Detalhes

Objeto principal

Campo Tipo

ad_id

text

[pt] ID do anúncio

ad_format

text

[pt] Formato do anúncio

advertiser_id

text

[pt] ID do anunciante

ad_name

text

[pt] Nome do anúncio

campaign_id

text

[pt] ID da campanha

    Taxonomia: Campanhas: Detalhes > > campaign_id

campaign_name

text

[pt] Nome da campanha

ad_text

text

[pt] Texto do anúncio

ad_texts

text

[pt] Textos do anúncio

adgroup_id

text

[pt] ID do grupo de anúncios

    Taxonomia: Grupos de anúncios: Detalhes > > adgroup_id

adgroup_name

text

[pt] Nome do grupo de anúncios

aigc_disclosure_type

text

[pt] Tipo de divulgação AIGC

app_name

text

[pt] Nome do aplicativo

avatar_icon_web_uri

text

[pt] URI do ícone de avatar

brand_safety_postbid_partner

text

[pt] Parceiro de brand safety pós-lance

brand_safety_vast_url

text

[pt] URL VAST de brand safety

call_to_action

text

[pt] Chamada para ação

call_to_action_id

text

[pt] ID da chamada para ação

card_id

text

[pt] ID do cartão

carousel_image_labels

text

[pt] Rótulos das imagens do carrossel

click_tracking_url

text

[pt] URL de rastreamento de clique

create_time

timestamp

[pt] Data de criação

creative_authorized

boolean

[pt] Creative autorizado

creative_type

text

[pt] Tipo de creative

deeplink

text

[pt] Deeplink

deeplink_type

text

[pt] Tipo de deeplink

display_name

text

[pt] Nome de exibição

identity_id

text

[pt] ID da identidade

identity_type

text

[pt] Tipo de identidade

image_ids

text

[pt] IDs das imagens

impression_tracking_url

text

[pt] URL de rastreamento de impressão

is_aco

boolean

[pt] É ACO (Automated Creative Optimization)

is_new_structure

boolean

[pt] É nova estrutura

landing_page_url

text

[pt] URL da página de destino

landing_page_urls

text

[pt] URLs de página de destino

modify_time

timestamp

[pt] Data de modificação

music_id

text

[pt] ID da música

operation_status

text

[pt] Status da operação

optimization_event

text

[pt] Evento de otimização

page_id

text

[pt] ID da página

playable_url

text

[pt] URL do playable

profile_image_url

text

[pt] URL da imagem do perfil

secondary_status

text

[pt] Status secundário

tracking_pixel_id

text

[pt] ID do pixel de rastreamento

vast_moat_enabled

boolean

[pt] VAST Moat habilitado

video_id

text

[pt] ID do vídeo

viewability_postbid_partner

text

[pt] Parceiro de viewability pós-lance

viewability_vast_url

text

[pt] URL VAST de viewability

tiktokads_ad_details_utm_params

Campo Tipo

ad_id

text

[pt] ID do anúncio

advertiser_id

text

[pt] ID do anunciante

ad_name

text

[pt] Nome do anúncio

campaign_id

text

[pt] ID da campanha

    Taxonomia: Campanhas: Detalhes > > campaign_id

campaign_name

text

[pt] Nome da campanha

adgroup_id

text

[pt] ID do grupo de anúncios

    Taxonomia: Grupos de anúncios: Detalhes > > adgroup_id

adgroup_name

text

[pt] Nome do grupo de anúncios

utm_params_key

text

[pt] Chave do parâmetro UTM

utm_params_value

text

[pt] Valor do parâmetro UTM

Taxonomia: Campanhas: Detalhes

Campo Tipo

campaign_id

text

[pt] ID da campanha

advertiser_id

text

[pt] ID do anunciante

app_id

text

[pt] ID da app

app_promotion_type

text

[pt] Tipo de promoção da app

bid_align_type

text

[pt] Tipo de alinhamento de lance

budget

float

[pt] Orçamento

budget_mode

text

[pt] Modo de orçamento

budget_optimize_on

boolean

[pt] Otimizar orçamento

campaign_app_profile_page_state

text

[pt] Estado da página de perfil da campanha

campaign_name

text

[pt] Nome da campanha

campaign_product_source

text

[pt] Origem do produto da campanha

campaign_system_origin

text

[pt] Origem do sistema da campanha

campaign_type

text

[pt] Tipo de campanha

catalog_enabled

boolean

[pt] Catálogo habilitado

create_time

timestamp

[pt] Data de criação

deep_bid_type

text

[pt] Tipo de lance profundo

disable_skan_campaign

boolean

[pt] Desabilitar campanha SKAN

is_advanced_dedicated_campaign

boolean

[pt] É campanha avançada dedicada

is_new_structure

boolean

[pt] É nova estrutura

is_search_campaign

boolean

[pt] É campanha de busca

is_smart_performance_campaign

boolean

[pt] É campanha de desempenho inteligente

modify_time

timestamp

[pt] Data de modificação

objective

text

[pt] Objetivo

objective_type

text

[pt] Tipo de objetivo

operation_status

text

[pt] Status de operação

optimization_goal

text

[pt] Objetivo de otimização

postback_window_mode

text

[pt] Modo de janela de postback

rf_campaign_type

text

[pt] Tipo de campanha RF

roas_bid

text

[pt] ROAS de lance

rta_bid_enabled

text

[pt] Lance da RTA habilitado

rta_id

text

[pt] ID da RTA

rta_product_selection_enabled

boolean

[pt] Seleção de produto da RTA habilitada

sales_destination

text

[pt] Destino de vendas

secondary_status

text

[pt] Status secundário

special_industries

text

[pt] Indústrias especiais

virtual_objective_type

text

[pt] Tipo de objetivo virtual

Taxonomia: Grupos de anúncios: Detalhes

Objeto principal

Campo Tipo

adgroup_id

text

[pt] Identificador único do grupo de anúncios.

adgroup_app_profile_page_state

text

[pt] Estado da página de perfil do app para o grupo de anúncios.

adgroup_name

text

[pt] Nome do grupo de anúncios.

advertiser_id

text

[pt] Identificador único do anunciante no TikTok Ads.

age_groups

text

[pt] Faixas etárias alvo da segmentação.

app_download_url

text

[pt] URL do aplicativo para download promovido.

app_id

text

[pt] Identificador do aplicativo promovido.

app_type

text

[pt] Tipo de aplicativo promovido.

audience_ids

text

[pt] IDs de audiências alvo da campanha.

automated_keywords_enabled

boolean

[pt] Indica se a adição automática de palavras-chave está habilitada.

bid_display_mode

text

[pt] Modo de exibição do lance (ex: CPMV).

bid_price

text

[pt] Preço de lance configurado para o grupo de anúncios.

bid_type

text

[pt] Tipo de lance configurado (ex: BID_TYPE_CUSTOM).

billing_event

text

[pt] Evento de cobrança associado (ex: CPM, CPC).

brand_safety_partner

float

[pt] Identificador do parceiro de segurança de marca.

brand_safety_type

text

[pt] Nível de segurança de marca aplicado ao inventário (ex: STANDARD_INVENTORY).

budget

float

[pt] Orçamento alocado para o grupo de anúncios.

budget_mode

text

[pt] Modo de orçamento configurado (ex: BUDGET_MODE_INFINITE).

campaign_id

text

[pt] Identificador único da campanha associada.

    Taxonomia: Campanhas: Detalhes > > campaign_id

campaign_name

text

[pt] Nome da campanha publicitária.

category_exclusion_ids

text

[pt] IDs de categorias de exclusão configuradas.

category_id

text

[pt] Identificador da categoria associada ao grupo de anúncios.

comment_disabled

boolean

[pt] Indica se os comentários estão desabilitados no anúncio.

contextual_tag_ids

text

[pt] IDs de tags contextuais para segmentação de anúncios.

conversion_bid_price

text

[pt] Preço de lance configurado para conversão.

conversion_window

text

[pt] Janela de conversão usada para atribuição.

create_time

timestamp

[pt] Data e hora de criação do grupo de anúncios.

creative_material_mode

text

[pt] Modo de materiais criativos utilizado (ex: CUSTOM).

dayparting

text

[pt] Configuração de horários (dayparting) para exibição dos anúncios.

deep_bid_type

text

[pt] Tipo de lance configurado para otimização de funil profundo.

deep_cpa_bid

text

[pt] Lance configurado para CPA em funil profundo.

deep_funnel_event_source

text

[pt] Fonte de eventos usada na otimização de funil profundo.

deep_funnel_event_source_id

text

[pt] ID da fonte de eventos para otimização de funil profundo.

deep_funnel_optimization_event

text

[pt] Evento de otimização para funil profundo.

deep_funnel_optimization_status

text

[pt] Status da otimização para funil profundo.

delivery_mode

text

[pt] Modo de entrega do anúncio.

device_model_ids

text

[pt] Lista de identificadores de modelos de dispositivo alvo.

device_price_ranges

text

[pt] Faixas de preço dos dispositivos alvo.

excluded_audience_ids

text

[pt] IDs de audiências excluídas da segmentação.

feed_type

text

[pt] Tipo de feed onde o anúncio será exibido.

frequency

float

[pt] Limite de frequência de exibição dos anúncios.

frequency_schedule

float

[pt] Intervalo de frequência programado (em dias).

gender

text

[pt] Segmentação de gênero (ex: GENDER_UNLIMITED).

household_income

text

[pt] Faixas de renda familiar alvo da segmentação.

interest_category_ids

text

[pt] IDs das categorias de interesse usadas na segmentação.

interest_keyword_ids

text

[pt] IDs de palavras-chave de interesse para segmentação.

inventory_filter_enabled

boolean

[pt] Indica se o filtro de inventário está habilitado.

ios14_quota_type

text

[pt] Tipo de quota relacionado a restrições do iOS 14.

is_hfss

boolean

[pt] Indica se o anúncio se enquadra na categoria HFSS (altos em gordura, sal e açúcar).

is_new_structure

boolean

[pt] Indica se o grupo de anúncios segue a nova estrutura.

is_smart_performance_campaign

boolean

[pt] Indica se é uma campanha de performance inteligente.

isp_ids

text

[pt] IDs de provedores de internet alvo.

keywords

text

[pt] Palavras-chave associadas à segmentação do anúncio.

languages

text

[pt] Idiomas alvo da segmentação de anúncios.

location_ids

text

[pt] Lista de identificadores de localização geográfica alvo.

modify_time

timestamp

[pt] Data e hora da última modificação no grupo de anúncios.

network_types

text

[pt] Tipos de rede onde o anúncio será exibido (ex: TikTok, TikTok Search).

next_day_retention

float

[pt] Taxa de retenção no dia seguinte estimada.

operating_systems

text

[pt] Sistemas operacionais alvo (ex: ANDROID, IOS).

operation_status

text

[pt] Status de operação do grupo de anúncios (ex: ENABLE).

optimization_event

text

[pt] Evento de otimização associado.

optimization_goal

text

[pt] Objetivo de otimização configurado (ex: REACH).

pacing

text

[pt] Modo de ritmo de gasto do orçamento (ex: PACING_MODE_SMOOTH).

pixel_id

text

[pt] Identificador do pixel associado ao grupo de anúncios.

placement_type

text

[pt] Tipo de posicionamento onde o anúncio será exibido.

placements

text

[pt] Locais onde o anúncio será exibido (ex: PLACEMENT_TIKTOK).

promotion_type

text

[pt] Tipo de promoção (ex: WEBSITE_OR_DISPLAY).

purchased_impression

float

[pt] Quantidade de impressões adquiridas.

purchased_reach

float

[pt] Alcance adquirido no grupo de anúncios.

rf_estimated_cpr

text

[pt] CPR estimado calculado pela ferramenta Reach & Frequency.

rf_estimated_frequency

float

[pt] Frequência estimada da compra Reach & Frequency.

rf_purchased_type

text

[pt] Tipo de compra de alcance e frequência (Reach & Frequency).

saved_audience_id

text

[pt] ID da audiência salva usada na campanha.

schedule_end_time

timestamp

[pt] Data e hora de término programado da campanha.

schedule_infos_is_draft

boolean

[pt] Indica se o cronograma está salvo como rascunho.

schedule_infos_schedule_id

text

[pt] Identificador único do cronograma.

schedule_start_time

timestamp

[pt] Data e hora de início programado da campanha.

schedule_type

text

[pt] Tipo de programação do anúncio (ex: SCHEDULE_START_END).

scheduled_budget

float

[pt] Orçamento programado para o grupo de anúncios.

search_result_enabled

boolean

[pt] Indica se a exibição nos resultados de busca está habilitada.

secondary_optimization_event

text

[pt] Evento secundário configurado para otimização.

secondary_status

text

[pt] Status secundário atual do grupo de anúncios.

share_disabled

boolean

[pt] Indica se o compartilhamento está desabilitado.

skip_learning_phase

boolean

[pt] Indica se a fase de aprendizado será ignorada.

smart_audience_enabled

boolean

[pt] Indica se a segmentação de audiência inteligente está habilitada.

smart_interest_behavior_enabled

boolean

[pt] Indica se comportamento de interesse inteligente está habilitado.

spending_power

text

[pt] Poder de compra segmentado (ex: ALL, HIGH).

statistic_type

text

[pt] Tipo de estatística utilizada no relatório ou segmentação.

tiktok_subplacements

text

[pt] Locais específicos dentro do TikTok onde os anúncios serão exibidos (ex: IN_FEED, SEARCH_FEED).

vbo_window

text

[pt] Janela de otimização baseada em valor (VBO window).

vertical_sensitivity_id

text

[pt] ID de sensibilidade vertical para restrições de conteúdo.

video_download_disabled

boolean

[pt] Indica se o download do vídeo está desabilitado.

tiktokads_adgroup_details_actions

Campo Tipo

adgroup_id

text

[pt] Identificador único do grupo de anúncios.

actions_action_category_ids

text

[pt] IDs das categorias de ação aplicadas.

actions_action_period

float

[pt] Período de tempo considerado para a ação em dias.

actions_action_scene

text

[pt] Cena ou contexto onde a ação ocorreu (ex: VIDEO_RELATED).

actions_video_user_actions

text

[pt] Ações do usuário em vídeo (ex: WATCHED_TO_END, LIKED).

tiktokads_adgroup_details_excluded_custom_actions

Campo Tipo

adgroup_id

text

[pt] Identificador único do grupo de anúncios.

excluded_custom_actions_code

text

[pt] Código da ação personalizada excluída.

excluded_custom_actions_days

float

[pt] Número de dias em que a exclusão da ação personalizada é considerada.

tiktokads_adgroup_details_schedule_infos_schedules

Campo Tipo

adgroup_id

text

[pt] Identificador único do grupo de anúncios.

schedule_infos_schedules_end_time

timestamp

[pt] Horário de término programado para exibição do anúncio.

schedule_infos_schedules_expected_orders

text

[pt] Pedidos esperados durante o período programado.

schedule_infos_schedules_start_time

timestamp

[pt] Horário de início programado para exibição do anúncio.

tiktokads_adgroup_details_included_custom_actions

Campo Tipo

adgroup_id

text

[pt] Identificador único do grupo de anúncios.

included_custom_actions_code

text

[pt] Código da ação personalizada incluída.

included_custom_actions_days

float

[pt] Número de dias em que a ação personalizada é considerada.

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