Conector de dados do Google Ads (AdWords)

Seguir
Avatar
Vaibhav Gupta
Updated
Documento
Configurar o Google Ads (AdWords)
Agregação de custos
Configurar o conetor de dados

Detalhes rápidos

Tecnologia do conetor de dados API ( API do Google Ads v10)
Repartição de dados (segmentação)

Na configuração predefinida, os seus dados são repartidos por:

  • País
  • Campanha
  • Subcampanha (grupo de anúncios)
  • Sub rede de anúncios (tipo de rede de anúncios).

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

Mapeamento de dados

Pode obter os seus dados numa de várias configurações de desagregação, cada uma fornecendo um conjunto diferente de dimensões e cada uma com as suas próprias vantagens e limitações.

  • A configuração por defeito é País. Para escolher uma configuração diferente, contacte o suporte da Singular.
  • A configuração Metro (DMA) só é útil para publicidade baseada nos EUA (as informações de DMA só estão disponíveis nos EUA). Se algumas ou todas as suas campanhas operam fora dos EUA, utilize a configuração Cidade.
  • As configurações de Palavra-chave e Editor não incluem dados para campanhas UAC devido a limitações da API do Google Ads.
  • Embora as configurações de Palavra-chave e Editor não incluam o país ou outras dimensões de localização, a Singular pode ser capaz de fornecer o país com base nas definições de países-alvo.
  • As desagregações porIdade ou Género estão disponíveis como desagregações Demográficas separadas (por exemplo, Feminino/Masculino, 20-29, etc.)

Dicas sobre terminologia:

  • O Criativo do Singular corresponde ao Anúncio do Google Ads.
  • A nova dimensão de Ativo da Singular corresponde ao Ativo do Google Ads. Adicionámos este novo nível de granularidade porque, no Google, alguns tipos de anúncios, como os anúncios UAC (aplicação para telemóvel), contêm vários activos.
  • Para obter descrições de todos os campos nos relatórios do Singular, consulte o Glossário de métricas e dimensões do Singular.
  • Para obter mais dicas sobre como executar relatórios de criativos no Google, consulte Como executar relatórios de criativos no Meta e no Google Ads?
País Metro (DMA) Cidade Palavra-chave Palavra-chave+Pontuação de qualidade Editor Shopping Vídeo

Campo em Singular UI Campo em Singular API Campo no Google Country Breakdown
Dimensões
ID da conta adn_account_id cliente.id
Nome da conta adn_account_name nome descritivo do cliente
ID do sítio da aplicação app_site_id campaign.appCampaignSetting.appId
ID do ativo asset_id asset.id
Nome do ativo nome_do_activo asset.name (para activos do tipo Vídeo, utilizamos "asset.youtubeVideoAsset.youtubeVideoTitle")
URL da campanha adn_campaign_url ad.finalUrl
se não estiver disponível, então ad.trackingUrlTemplate
País campo_país geographicView.countryCriterionId
Formato criativo formato_criativo anúncio.tipo
ID do criativo creative_id adGroupAd.ad.id
Nome do criativo nome_criativo adGroupAd.ad.name
URL comunicado do criativo creative_reported_url adGroupAd.ad.finalUrls.0
Data campo_data segmentos.data
URL final final_url campanha.finalUrls OR
critérios do grupo de anúncios.finalUrls OR
adGroup.ad.finalUrls
ID da campanha de rede adn_campaign_id campaign.id
Nome da campanha de rede adn_campaign_name campaign.name
ID criativa da rede adn_creative_id adGroupAd.ad.id
Nome do criativo de rede nome_criativo_da_rede adGroupAd.ad.name
ID da subcampanha da rede adn_sub_campaign_id adGroup.id
Nome da subcampanha de rede nome_da_subcampanha_da_rede adGroup.name
SO sistema operativo campaign.appCampaignSetting.appStore
plataforma plataforma Uma combinação de campaign.appCampaignSetting.appStore e segments.device
Id público site_public_id campaign.appCampaignSetting.appId
Retargeting retenção campaign.advertisingChannelSubType == 'APP_CAMPAIGN_FOR_ENGAGEMENT_'
Sub-rede de anúncios adn_subrede de anúncios segmentos.adNetworkType
Países de destino target_countries_str Ver país
Texto texto_criativo Para criar este campo, utilizamos todos os campos de texto disponíveis no anúncio, que podem diferir consoante o tipo de anúncio. Por exemplo, para o UAC, o campo no Google Ads é asset.textAsset.text. Se existir mais do que um texto (por exemplo, título + descrição), concatenamo-los numa única cadeia de caracteres.
Fuso horário adn_timezone cliente.timeZone
(A Singular recebe dados de hora do Adwords no fuso horário do cliente e converte-os para UTC).
URL de rastreamento tracking_url adGroupAd.ad.trackingUrlTemplate
Desempenho do ativo
 desempenho_do_activo performance_label
Métricas
Custo adn_cost métricas.costMicro
Cliques na rede adn_clicks métricas.cliques
Impressões da rede adn_impressões métricas.impressões
Instalações de rede adn_installs métricas.conversões / métricas.todasConversões
Custo original adn_original_cost métricas.costMicro
Moeda original adn_original_currency código da moeda do cliente
Visualizações de vídeo video_views métricas.videoViews
Visualizações de vídeo concluídas visualizações_de_vídeo_completadas métricas.video_quartil_p100_rate
Visualizações de vídeo - 25% visualizações_vídeo_25pct métricas.video_quartile_p25_rate
Visualizações de vídeo - 50% visualizações_de_vídeo_50pct métricas.video_quartile_p50_rate
Visualizações de vídeo - 75% visualizações_vídeo_75pct métricas.video_quartile_p75_rate

O Singular também suporta a extração de propriedades de campanha para este parceiro - veja mais detalhes aqui.

Instruções especiais de configuração

Autenticação

Consulte as Perguntas frequentes sobre conectores de dados para obter informações gerais sobre a configuração de um conetor de dados.

Quando configura o conetor de dados do AdWords, é-lhe pedido que inicie sessão utilizando uma conta do Google Ads. Recomendamos vivamente que inicie sessão com uma conta do Gestor de anúncios do Google (anteriormente conhecida como conta MCC).

Uma conta Google Manager (MCC) dá-nos acesso a todas as suas contas de publicidade de uma só vez. Depois, pode selecionar da lista as contas que pretende incluir nos seus relatórios Singular. Se não utilizar uma conta Manager (MCC), terá de adicionar um conetor de dados separado para cada conta de publicidade.

Para localizar o seu ID de cliente (tanto para contas de gestor como para contas individuais):

  1. Inicie sessão na sua conta do Google Ads.
  2. Clique no ícone de ajuda no canto superior direito.
  3. Localize o ID do cliente na parte inferior do menu.

Eventos de conversão

Para além das métricas predefinidas na tabela acima, a Singular pode extrair quaisquer métricas de que necessite do Google Ads e apresentar as respectivas estatísticas nos seus relatórios Singular.

Se estiver à procura de informações mais detalhadas ao nível do ativo, considere adicionar 'biddable-app-post-install-conversion' como um evento. Estes dados são obtidos a partir da API do Google Ad. Esta funcionalidade permite-lhe obter dados adicionais sobre eventos de "acções in-app" nas respectivas campanhas. É importante observar que os eventos de conversão não possuem dados de coorte e são associados apenas ao período de coorte 'real'."

Para configurar eventos de conversão no Singular, siga as etapas a seguir:

  1. No Singular, vá para Configurações > Eventos. Se você tiver as guias Eventos personalizados e Eventos de conversão, selecione Eventos de conversão.
  2. Clique em Novo evento.

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

    No dia seguinte, quando o Singular extrair os dados diários da sua conta, também extrairá as estatísticas destas actividades.

  4. Depois de o Singular ter preenchido o(s) novo(s) evento(s) de conversão com alguns dados, quando executar um relatório na página Relatórios, selecione o(s) evento(s) de conversão no menu pendente Eventos.

Perguntas frequentes e resolução de problemas

Como é que encontro o ID da minha conta de gestor (ID MCC)?

Para localizar o seu ID de cliente (para contas de gestor e individuais):

  1. Inicie sessão na sua conta do Google Ads.
  2. Clique no ícone de ajuda no canto superior direito.
  3. Localize o ID do cliente na parte inferior do menu.

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

Porque é que não consigo autenticar a minha conta do Gestor de Anúncios do Google?

Na sua conta do Google Ads Manager, aceda a Definições > Definições de rede. Certifique-se de que activou o acesso à API. Em seguida, tente autenticar novamente a sua conta do Google Ads Manager no Singular.

google_auth.png

Porque é que, por vezes, continuo a ver os dados do país no relatório, mesmo que esteja a utilizar uma desagregação diferente?

Quando utiliza uma desagregação que não fornece informações sobre o país, a Singular tenta fornecer a granularidade do país de qualquer forma, analisando as definições de segmentação da campanha no Google e/ou os dados do rastreador (se os tivermos):

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

O Google Ads rastreia diferentes tipos do que ele chama de "ações de conversão" - incluindo downloads de aplicativos, inscrições de usuários, compras e muito mais. Por predefinição, uma vez que a maioria dos nossos clientes está interessada em instalações de aplicações, extraímos conversões do tipo download e mostramos as respectivas métricas no campo Instalações de rede nos nossos relatórios.

Observação: Instalações de rede é uma métrica no Singular que reflete o número de instalações relatadas pela rede de anúncios - não deve ser confundida com Instalações, que geralmente é baseada em dados do rastreador de atribuição. Para o Adwords, Instalações de rede é o número de conversões "first_open" relatadas pelo Adwords.

Quando cria uma consulta de relatório, pode selecionar Instalações de rede na secção Métricasde origem . Consulte O que são métricas de origem? para obter mais informações.

O Singular extrai criativos do AdWords?

Sim, o Singular extrai métricas de criativos, bem como os próprios criativos (imagens, textos, vídeos, etc.). Isto é verdade quer utilize a versão antiga da integração do AdWords ou a nova. No entanto, apenas a nova integração mostra os anúncios para campanhas UAC.

O que é um "criativo" no contexto do AdWords? Qual é a diferença entre um "criativo" e um "ativo"?

O Criativo da Singular corresponde ao Anúncio do Google Ads.

A nova dimensão de Ativo da Singular corresponde ao Ativo do Google Ads. Adicionámos este novo nível de granularidade porque, no Google, alguns tipos de anúncios, como os anúncios UAC (aplicação para telemóvel), contêm vários activos. As instalações relatadas para o ativo são extraídas da métrica "biddable_app_install_conversions", que é diferente de outras granularidades que usam"metrics.conversions"

Que tipos de anúncios do Google são suportados pela Singular?

A Singular suporta os seguintes tipos de anúncios do Google:

Tipo de anúncio Ativo(s) de anúncio incluído(s)
Texto Imagem Vídeo
Gmail
Hotel
Local
Texto
Texto expandido
Pesquisa dinâmica expandida
Produto de compras
Compras inteligentes
Apenas chamada
Carregamento HTML5
HTML5 dinâmico
Pesquisa responsiva
Pesquisa responsiva herdada
Instalação de aplicações herdadas
Ecrã responsivo
Vídeo
BUMPER DE VÍDEO
VÍDEO NÃO SALTÁVEL NO FLUXO
VÍDEO OUTSTREAM
DESCOBERTA DE VÍDEO TRUEVIEW
VÍDEO TRUEVIEW IN STREAM
VÍDEO RESPONSIVO
Aplicação (UAC)
Envolvimento na aplicação (UAC - anúncios com ligação direta)
PRÉ-REGISTO DA APLICAÇÃO

Nota: o nome do Google para o tipo de anúncio ("App Engagement", "Responsive Search", etc.) não aparece nos seus relatórios Singular. A dimensão Tipo de criativo que vê nos seus relatórios não está relacionada - mostra se o criativo é uma imagem, texto ou vídeo.

Estou a obter a discriminação por país. Porque é que vejo linhas sem informações sobre o país?

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

Quando o Singular extrai dados da API do Google Ads, ele executa as seguintes etapas:

  1. Extrai os dados da discriminação selecionada do ponto de extremidade correspondente da API do Google Ads, neste caso - o ponto de extremidade location_view, que fornece informações sobre o país.
  2. Extrai dados para as mesmas campanhas do ponto de extremidade de campanha 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 permite que façamos o download de vídeos do YouTube. Portanto, para criativos de vídeo, incluímos a miniatura do vídeo + um link para o vídeo no YouTube.

Qual é a diferença entre visualizações de vídeo e visualizações de vídeo - 25%, 50%, 75%? As visualizações de vídeo podem ser superiores ou inferiores às visualizações de vídeo - concluídas?

A métrica de visualizações de vídeo é uma contagem de quantas visualizações de vídeo foram iniciadas. Conta todas as impressões do seu vídeo, quer o vídeo tenha sido visto na íntegra, quer tenha sido visto apenas durante um segundo.

As métricas de visualizações de vídeo - 25%, 50% e 75% calculam quantas dessas impressões foram de pessoas que viram o seu vídeo até à marca de 25%, 50% ou 75%, respetivamente. Da mesma forma, a métrica de visualizações de vídeo concluídas calcula apenas as impressões em que o vídeo foi visualizado na totalidade. Para calcular esses valores, usamos a fórmula sugerida pelo Google: impressões * video_view_rate.

Dependendo das suas necessidades, poderá querer utilizar uma das métricas de percentagem em vez da métrica de visualizações de vídeo. Consulte a secção "Vídeo reproduzido até" na documentação do Google.

Nota: existe uma discrepância inerente entre as visualizações nos vídeos do YouTube e as visualizações apresentadas na conta do Google Ads. As visualizações do YouTube e as visualizações da conta do Google Ads são calculadas utilizando métricas diferentes.

  • O YouTube conta uma visualização como alguém que está a ver o vídeo durante, pelo menos, 30 segundos ou até ao fim do vídeo, consoante o que ocorrer primeiro.
  • O Google Ads conta uma visualização como uma impressão de anúncio que é contabilizada quando o anúncio é apresentado no YouTube ou num site parceiro.
  • Consequentemente, poderá haver uma diferença entre as visualizações comunicadas na análise do YouTube e as visualizações apresentadas na conta do Google Ads.
  • Além disso, as análises do YouTube são actualizadas em tempo real, enquanto os dados do Google Ads podem demorar até 48 horas a serem actualizados.

Além disso, os anúncios do YouTube e as métricas de visualizações funcionam de forma diferente dos anúncios online tradicionais. Ao apresentar um anúncio do YouTube, só será cobrada uma taxa quando alguém vir o anúncio durante 30 segundos ou interagir com ele de alguma forma, como clicar numa sobreposição de chamada para ação ou num banner complementar. Por conseguinte, é importante concentrar-se nas métricas de envolvimento, como a taxa de visualização e as acções ganhas, e não apenas nas visualizações, para avaliar a eficácia dos anúncios do YouTube.

Porque é que não consigo ver os Pacotes multimédia nos meus relatórios de criativos?

Um Pacote multimédia é outro tipo de criativo, juntamente com "Imagem", "Texto" e "Vídeo". Se algum dos seus criativos de anúncios for um pacote multimédia, poderá ver as métricas desses criativos, mas não o criativo em si, porque a API do Google Ads não fornece o criativo.

Por que a dimensão Nome do criativo nem sempre está disponível?

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