Conector de dados do Google Ads (AdWords)

Seguir
Avatar
Vaibhav Gupta
Updated
Configuração do Google Ads (AdWords)
Agregação de custos
Configurar o conector de dados

 

Detalhes rápidos

Tecnologia do conetor de dados API (Google Ads API v19)
Detalhamento de dados (segmentação)

Na configuração padrão, seus dados são detalhados por:

  • País
  • Campanha
  • Subcampanha (Ad Group)
  • Sub-rede de anúncios (Ad Network Type).

Para escolher uma configuração diferente, consulte Mapeamento de dados abaixo.
Qual o intervalo de tempo em que extraímos dados Todos os dias, a Singular extrai dados dos últimos 7 dias. Uma vez por semana, às segundas-feiras, a Singular extrai dados dos últimos 30 dias.
Fuso horário Definido pelo cliente nas configurações do Google, para cada conta
Os dados estão disponíveis no nível criativo (anúncio)? Sim
O Singular mostra seus ativos criativos? Sim (exceto os vídeos do YouTube, dos quais a Singular mostra apenas miniaturas)
Limitações conhecidas
  • A granularidade por país não está disponível para criativos.
  • Nos relatórios de criativos, a métrica Installs com granularidade de ativo é mapeada a partir de biddable_app_install_conversions"; o que difere de outras granularidades, que usam "metrics.conversions"

Mapeamento de dados

Você pode obter seus dados em uma de várias configurações de detalhamento, cada uma fornecendo um conjunto diferente de dimensões e com suas próprias vantagens e limitações.

  • A configuração padrão é Country. Para escolher outra, entre em contato com o suporte da Singular.
  • A configuração Metro (DMA) só é útil para publicidade voltada aos Estados Unidos (as informações de DMA só estão disponíveis lá). Se algumas ou todas as suas campanhas operarem fora dos Estados Unidos, use a configuração City.
  • As configurações Keyword e Publisher não incluem dados de campanhas UAC devido a limitações da API do Google Ads.
  • Embora as configurações Keyword e Publisher não incluam país nem outras dimensões de localização, a Singular pode conseguir fornecer o país com base nas configurações de países segmentados.
  • Idade ou Gênero estão disponíveis como detalhamentos demográficos separados (por exemplo, mulher/homem, 20-29, etc.).   

Dicas sobre terminologia:

Country Metro (DMA) City Keyword Keyword+Quality Score Publisher Shopping Video

Field in Singular UI Field in Singular API Field in Google Country Breakdown
Dimensions
Account ID adn_account_id customer.id
Account Name adn_account_name customer.descriptiveName
App Site ID app_site_id campaign.appCampaignSetting.appId
Asset ID asset_id asset.id
Asset Name asset_name asset.name (for assets of type Video we use “asset.youtubeVideoAsset.youtubeVideoTitle”)
Campaign URL adn_campaign_url ad.finalUrl
if not available, then ad.trackingUrlTemplate
Country country_field geographicView.countryCriterionId
Creative Format creative_format ad.type
Creative ID creative_id adGroupAd.ad.id
Creative Name creative_name adGroupAd.ad.name
Creative Reported URL creative_reported_url adGroupAd.ad.finalUrls.0
Date date_field segments.date
Final URL final_url campaign.finalUrls OR
adGroupCriterion.finalUrls OR
adGroup.ad.finalUrls
Network Campaign ID adn_campaign_id campaign.id
Network Campaign Name adn_campaign_name campaign.name
Network Creative ID adn_creative_id adGroupAd.ad.id
Network Creative Name adn_creative_name adGroupAd.ad.name
Network Sub Campaign ID adn_sub_campaign_id adGroup.id
Network Sub Campaign Name adn_sub_campaign_name adGroup.name
OS os campaign.appCampaignSetting.appStore
Platform platform A combination of campaign.appCampaignSetting.appStore and segments.device
Public Id site_public_id campaign.appCampaignSetting.appId
Retargeting retention campaign.advertisingChannelSubType == ‘APP_CAMPAIGN_FOR_ENGAGEMENT_’
Sub Ad Network adn_subadnetwork segments.adNetworkType
Target Countries target_countries_str See country
Text creative_text To create this field, we take any available text fields in the ad, which may differ based on the ad type. E.g., for UAC, the field in Google Ads is asset.textAsset.text. If there is more than one text (e.g. headline + description), we concatenate them into one string. 
Timezone adn_timezone customer.timeZone
(Singular receives time data from Adwords in the client's timezone and converts it to UTC.)
Tracking URL tracking_url adGroupAd.ad.trackingUrlTemplate
Asset Performance
 asset_performance performance_label
Metrics
Cost adn_cost metrics.costMicro
Network Clicks adn_clicks metrics.clicks
Network Impressions adn_impressions metrics.impressions
Network Installs adn_installs metrics.conversions / metrics.allConversions
Original Cost adn_original_cost metrics.costMicro
Original Currency adn_original_currency customer.currencyCode
Video Views video_views metrics.videoViews
Completed Video Views completed_video_views metrics.video_quartile_p100_rate
Video Views - 25% video_views_25pct metrics.video_quartile_p25_rate
Video Views - 50% video_views_50pct metrics.video_quartile_p50_rate
Video Views - 75% video_views_75pct metrics.video_quartile_p75_rate

A Singular também oferece suporte à extração de propriedades de campanha para este parceiro: veja mais detalhes aqui.

Instruções especiais de configuração

Autenticação

Consulte as FAQ de conectores de dados para informações gerais sobre como configurar um conector de dados.

Ao configurar o conector de dados do AdWords, é solicitado que você faça login com uma conta do Google Ads. Recomendamos fortemente fazer login com uma conta de administrador do Google Ads (antes conhecida como conta MCC).

Uma conta de administrador do Google (MCC) nos dá acesso a todas as suas contas de anúncios de uma vez. Depois você pode escolher na lista quais contas quer incluir nos seus relatórios da Singular. Se você não usar uma conta de administrador (MCC), terá de adicionar um conector de dados separado para cada conta de anúncios.

Para localizar seu ID de cliente (tanto em contas de administrador quanto individuais):

  1. Faça login na sua conta do Google Ads.
  2. Clique no ícone de ajuda no canto superior direito.
  3. Encontre Customer ID no final do menu.

Eventos de conversão

Além das métricas padrão da tabela acima, a Singular pode extrair quaisquer métricas de que você precise do Google Ads e exibir suas estatísticas nos seus relatórios da Singular.

Se você busca insights mais detalhados no nível do ativo, considere adicionar 'biddable-app-post-install-conversion' como evento. Esses dados são extraídos da API do Google Ads. Esse recurso permite incorporar dados adicionais sobre eventos de 'ações in-app' nas respectivas campanhas. É importante observar que os eventos de conversão não têm dados de coorte e são associados apenas ao período de coorte 'real'.

Para configurar eventos de conversão na Singular, siga estas etapas:

  1. Na Singular, acesse Settings > Events. Se você tiver as abas Custom Events e Conversion Events, selecione Conversion Events.
  2. Clique em New Event.

  3. No menu suspenso AdWords você verá uma lista das métricas disponíveis no AdWords. Você pode mapear cada atividade para um evento separado da Singular ou combinar várias métricas em um único evento.

    No dia seguinte, quando a Singular extrair os dados diários da sua conta, ela também extrairá as estatísticas dessas atividades.

  4. Depois que a Singular preencher os novos eventos de conversão com alguns dados, ao executar um relatório na página Reports, escolha os eventos de conversão no menu suspenso Events.

FAQ e solução de problemas

Como encontro meu ID da conta de administrador (ID de MCC)?

Para localizar seu ID de cliente (tanto em contas de administrador quanto individuais):

  1. Faça login na sua conta do Google Ads.
  2. Clique no ícone de ajuda no canto superior direito.
  3. Encontre Customer ID no final do menu.

Para mais informações, consulte Sobre as contas de administrador do Google Ads na documentação do Google.

Por que não consigo autenticar minha conta de administrador do Google Ads?

Na sua conta de administrador do Google Ads, acesse Settings > Network Settings. Verifique se você ativou o API access. Depois tente autenticar novamente sua conta de administrador do Google Ads na Singular.

google_auth.png

Por que às vezes ainda vejo dados de país no relatório, mesmo usando um detalhamento diferente?

Quando você usa um detalhamento que não fornece informações de país, a Singular tenta oferecer granularidade por país mesmo assim, consultando, para a campanha as configurações de segmentação no Google e/ou os dados do tracker (se os tivermos):

  1. Se a campanha for segmentada para um único país, mostraremos esse país no relatório.
  2. Se houver vários países segmentados e também tivermos dados do tracker para a mesma campanha, estimaremos o custo por país com base na proporção de instalações por país nos dados do tracker. Consulte Como a métrica de custo é calculada por país?
Como a Singular extrai as Network Installs das campanhas do AdWords?

O Google Ads faz tracking de diferentes tipos do que chama de “ações de conversão”: downloads de apps, cadastros de usuários, compras e mais. Por padrão, como a maioria dos nossos clientes se interessa por instalações de apps, extraímos as conversões do tipo download e mostramos suas métricas no campo Network Installs dos nossos relatórios.

Observação: Network Installs é uma métrica da Singular que reflete o número de instalações reportadas pela rede de anúncios, e não deve ser confundida com Installs, que normalmente se baseia nos dados do tracker de atribuição. No caso do AdWords, Network Installs é o número de conversões "first_open" reportadas pelo AdWords.

Ao montar uma consulta de relatório, você pode selecionar Network Installs na seção Source Metrics . Consulte O que são Source Metrics? para mais informações.

A Singular extrai os criativos do AdWords?

Sim, a Singular extrai tanto as métricas de criativos quanto os próprios criativos (imagens, textos, vídeos, etc.). Isso vale tanto para a versão antiga da integração do AdWords quanto para a nova. No entanto, apenas a nova integração mostra os criativos de campanhas UAC.

O que é um "creative" no contexto do AdWords? Qual é a diferença entre “creative” e “asset”?

O Creative da Singular corresponde ao Addo Google Ads.

A nova dimensão Asset da Singular corresponde ao Assetdo Google Ads. Adicionamos esse novo nível de granularidade porque no Google alguns tipos de anúncio, como os de UAC (app móvel), contêm vários assets. As instalações reportadas para um ativo são extraídas da métrica "biddable_app_install_conversions", o que difere de outras granularidades, que usam "metrics.conversions"

Quais tipos de anúncio do Google a Singular oferece suporte?

A Singular oferece suporte aos seguintes tipos de anúncio do Google:

Tipo de anúncio Ativos de anúncio incluídos
Texto Imagem Vídeo
Gmail Incluído    
Hotel Incluído    
Local Incluído    
Text Incluído    
Expanded Text Incluído    
Expanded Dynamic Search Incluído    
Shopping Product Incluído    
Shopping Smart Incluído    
Call Only Incluído    
HTML5 Upload Incluído    
Dynamic HTML5 Incluído    
Responsive Search Incluído    
Legacy Responsive Search Incluído    
Legacy App Install Incluído    
Responsive Display   Incluído  
Video     Incluído
VIDEO BUMPER     Incluído
VIDEO NON SKIPPABLE IN STREAM     Incluído
VIDEO OUTSTREAM     Incluído
VIDEO TRUEVIEW DISCOVERY     Incluído
VIDEO TRUEVIEW IN STREAM     Incluído
VIDEO RESPONSIVE     Incluído
App (UAC) Incluído Incluído Incluído
App Engagement (UAC - deep linked ads) Incluído Incluído Incluído
APP PRE REGISTRATION Incluído Incluído Incluído

Observação: O nome que o Google usa para o tipo de anúncio (“App Engagement”, “Responsive Search”, etc.) não aparece nos seus relatórios da Singular. A dimensão Creative Type que você vê nos seus relatórios não tem relação: ela indica se o criativo é uma imagem, um texto ou um vídeo.

Estou extraindo o detalhamento por país. Por que vejo linhas sem informações de país?

Isso pode acontecer quando há discrepâncias entre os dados que o Google fornece em endpoints diferentes para as mesmas campanhas.

Quando a Singular extrai dados da API do Google Ads, ela executa as seguintes etapas:

  1. Extrai os dados do detalhamento selecionado do endpoint correspondente da API do Google Ads, neste caso o endpoint location_view, que fornece as informações de país.
  2. Extrai os dados das mesmas campanhas do endpoint campaign do Google para obter as métricas completas.
  3. Compara as métricas de cada campanha e, se necessário, adiciona uma linha para alinhar os dados. Veja a ilustração abaixo para um exemplo. Observe que os dados no nível da campanha são considerados a fonte da verdade.

Screen_Shot_2019-12-01_at_19.29.13.png

Por que não consigo ver vídeos nos meus relatórios de criativos?

A política de privacidade do Google não nos permite baixar vídeos do YouTube. Por isso, para criativos de vídeo, incluímos a miniatura do vídeo mais um link para o vídeo no YouTube.

Qual é a diferença entre video views e video views - 25%, 50%, 75%? O video views pode ser maior ou menor que video views - completed?

A métrica video views é uma contagem de quantas reproduções de vídeo foram iniciadas. Ela conta todas as impressões do seu vídeo, tenha ele sido assistido por completo ou visto por apenas um segundo.

As métricas video views - 25%, 50%, and 75% calculam quantas dessas impressões corresponderam a pessoas que assistiram ao seu vídeo até 25%, 50% ou 75%, respectivamente. De forma semelhante, a métrica completed video views apenas calcula as impressões em que o vídeo foi assistido por completo. Para calcular esses valores, usamos a fórmula sugerida pelo Google: impressions * video_view_rate.

Dependendo das suas necessidades, talvez prefira usar uma das métricas de porcentagem em vez da métrica de reproduções de vídeo. Consulte a seção "Video played to" na documentação do Google.

Observação: Existe uma discrepância inerente entre as visualizações dos vídeos no YouTube e as exibidas na conta do Google Ads. As visualizações do YouTube e as da conta do Google Ads são calculadas com métricas diferentes.

  • O YouTube conta uma visualização quando alguém assiste ao vídeo por pelo menos 30 segundos ou até o fim do vídeo, o que ocorrer primeiro.
  • O Google Ads conta uma visualização como uma impressão do anúncio, contabilizada quando o anúncio é exibido no YouTube ou em um site parceiro.
  • Como resultado, pode haver diferença entre as visualizações reportadas no YouTube Analytics e as exibidas na conta do Google Ads.
  • Além disso, o YouTube Analytics é atualizado em tempo real, enquanto os dados do Google Ads podem levar até 48 horas para atualizar.

Ademais, os anúncios do YouTube e as métricas de visualização funcionam de forma diferente dos anúncios online tradicionais. Ao veicular um anúncio no YouTube, só há cobrança quando alguém assiste ao anúncio por 30 segundos ou interage com ele de alguma forma, como clicando em uma sobreposição de call-to-action ou em um banner complementar. Por isso, é importante focar em métricas de engajamento, como a taxa de visualização (view-through rate) e as ações conquistadas (earned actions), em vez de apenas visualizações, para avaliar a eficácia dos anúncios do YouTube.

Por que não consigo ver Media Bundles nos meus relatórios de criativos?

Um Media Bundle é outro tipo de criativo, junto com "Image", "Text" e "Video". Se algum dos seus criativos de anúncio for um media bundle, você poderá ver as métricas desses criativos, mas não o criativo em si, porque a API do Google Ads não o fornece.

Por que a dimensão Creative Name nem sempre está disponível?

Para criativos de UAC, o Google não fornece um nome, apenas um ID.