Transferências do Google Ads

Com o serviço de transferência de dados do BigQuery para Google Ads (antes conhecido como Google AdWords), é possível programar e gerenciar automaticamente jobs de carregamento recorrentes dos dados de relatórios do Google Ads.

Relatórios compatíveis

No momento, o serviço de transferência de dados do BigQuery para Google Ads é compatível com as opções de relatórios a seguir:

Para saber como os relatórios do Google Ads são transformados em tabelas e visualizações do serviço de transferência de dados do BigQuery, consulte Transformações de relatórios do Google Ads.

Para associar os relatórios do Google Ads ao que você vê na IU do Google Ads, consulte Como mapear relatórios para a IU do Google Ads.

Opção de relatório Suporte
Versão da API compatível

v201809

Para mais informações sobre a migração da API Google Ads (API AdWords), consulte o Guia de migração (v201809).

Schedule

Diariamente, no horário em que a transferência foi criada pela primeira vez (padrão)

É possível configurar a hora do dia.

Janela de atualização

Últimos 7 dias (padrão)

Configurável para até 30 dias

Snapshots de tabelas de correspondências são produzidos uma vez por dia e armazenados na partição referente à data de execução mais recente. Esses snapshots NÃO são atualizados para preenchimentos ou dias carregados por meio da janela de atualização. Para informações sobre quais tabelas de correspondências não são atualizadas pela janela de atualização, consulte Configurar um preenchimento.

Duração máxima do preenchimento

Sem limite

O Google Ads não tem limites conhecidos de retenção de dados, mas o serviço de transferência de dados do BigQuery tem restrições em relação a quantos dias podem ser solicitados em um único preenchimento. Para mais informações sobre preenchimentos, consulte Configurar um preenchimento.

Número de IDs de cliente por conta do administrador

1.000

O serviço de transferência de dados do BigQuery aceita no máximo 1.000 IDs de cliente por conta de administrador (MCC) do Google Ads.

Antes de começar

Antes de criar uma transferência do Google Ads:

Permissões exigidas

A pessoa que está criando a transferência precisa ter as seguintes permissões:

  • Serviço de transferência de dados do BigQuery:

    • Permissões bigquery.transfers.update para criar a transferência
    • Permissões bigquery.datasets.update no conjunto de dados de destino

    O papel predefinido bigquery.admin do Cloud IAM inclui as permissões bigquery.transfers.update e bigquery.datasets.update. Para mais informações sobre os papéis do Cloud IAM no serviço de transferência de dados do BigQuery, consulte a Referência do controle de acesso.

  • Google Ads: acesso de leitura ao ID de cliente do Google Ads ou à conta de administrador (MCC) usada na configuração de transferência.

Como configurar uma transferência de dados do Google Ads

A configuração de uma transferência de dados do relatório do Google Ads requer um:

  • ID de cliente: seu ID de cliente ou conta de administrador (MCC) do Google Ads, conforme emitido pelo Google Ads. Para mais informações sobre como recuperar seu ID de cliente do Google Ads, consulte Encontrar seu ID de cliente.

Para criar uma transferência de dados para os relatórios do Google Ads:

Console

  1. Acesse o Console do Cloud.

    Acessar o Console do Cloud

  2. Clique em Transferências.

  3. Clique em Criar transferência.

  4. Na página Criar transferência:

    • Na seção Tipo de origem, em Origem, escolha Google Ads.

      Fonte da transferência

    • No campo Nome da configuração de transferência da seção Nome de exibição, insira um nome para a transferência, como My Transfer. Esse nome pode ter qualquer valor que identifique facilmente a transferência, caso seja necessário modificá-la futuramente.

      Nome da transferência

    • Na seção Opções de programação, não altere o valor padrão de Programação (Começar agora). Se preferir, clique em Começar no horário definido.

      • Em Repetições, escolha uma opção para a frequência de execução da transferência.

        • Diário (padrão)
        • Semanal
        • Mensal
        • Personalizada
        • Sob demanda
      • Para Data e hora de início, insira a data e a hora para iniciar a transferência. Se você escolher Iniciar agora, essa opção ficará desativada.

        Programação da transferência

    • Na seção Configurações de destino, em Conjunto de dados de destino, escolha o conjunto criado para armazenar seus dados.

      Transferir conjunto de dados

    • Na seção Detalhes da origem de dados:

      • Em ID de cliente, digite esse dado ou a conta de administrador.
      • Marque Excluir itens removidos/desativados para evitar a transferência de entidades e métricas removidas ou desativadas.

        Detalhes da origem do Google Ads

    • Opcional: na seção Opções de notificação:

      • Clique no botão para ativar as notificações por e-mail. Quando você ativa essa opção, o administrador de transferência recebe uma notificação por e-mail quando uma execução de transferência falha.
      • Em Selecionar um tópico do Pub/Sub, escolha o nome do tópico ou clique em Criar um tópico. Essa opção configura notificações de execução do Pub/Sub para sua transferência.
  5. Clique em Save.

IU clássica

  1. Acesse a IU clássica da Web do BigQuery.

    Acessar a IU clássica da Web do BigQuery

  2. Clique em Transfers.

  3. Clique em Adicionar transferência.

  4. Na página Nova transferência:

    • Em Origem, escolha Google Ads (antigo AdWords).
    • Em Display Name, insira um nome para a transferência, como My Transfer. Ele pode ter qualquer valor que identifique facilmente a transferência, caso seja necessário modificá-la no futuro;
    • Em Atualizar janela, insira o número de dias a serem incluídos na transferência de dados. Se você inserir 1, não haverá preenchimento diário. Inserir 0 configura a janela de atualização padrão de sete dias. O valor máximo é 30. Para mais informações, consulte Como determinar a atualidade dos dados.
    • Em Programação, mantenha o valor padrão, que é de 24 horas a partir do horário de criação da transferência, ou clique em Editar para alterá-lo.

      Programação do Google Ads

    • Em Conjunto de dados de destino, escolha o conjunto que você criou para armazenar seus dados do Google Ads.

    • Em ID de cliente, digite esse dado ou a conta de administrador.

    • Marque Excluir itens removidos/desativados para evitar a transferência de entidades e métricas removidas ou desativadas.

      Transferência do Google Ads

    • (Opcional) Expanda a seção Avançado e configure as notificações de execução da transferência.

      • Em Tópico do Pub/Sub, insira o nome do seu tópico. Por exemplo: projects/myproject/topics/mytopic.
      • Marque Enviar notificações por e-mail para permitir notificações por e-mail sobre falhas na execução da transferência.
      • Não marque Desativada ao configurar uma transferência. Consulte Como trabalhar com transferências para desativar as transferências atuais.

        Tópico do Pub/Sub

  5. Clique em Add.

  6. Quando solicitado, clique em Permitir para autorizar o serviço de transferência de dados do BigQuery a acessar e gerenciar os dados nele próprio e gerenciar os dados de relatórios do Google Ads. É necessário permitir pop-ups do endereço bigquery.cloud.google.com para ver a janela de permissões.

    Permitir transferência

CLI

Insira o comando bq mk e forneça a sinalização de criação da transferência --transfer_config. As sinalizações abaixo também são obrigatórias:

  • --data_source
  • --target_dataset
  • --display_name
  • --params

Também é possível fornecer a sinalização --project_id para especificar um determinado projeto. Se --project_id não for especificado, o projeto padrão será usado.

    bq mk \
    --transfer_config \
    --project_id=project_id \
    --target_dataset=dataset \
    --display_name=name \
    --params='parameters' \
    --data_source=data_source
    

Em que:

  • project_id é o ID do projeto;
  • dataset é o conjunto de dados de destino na configuração da transferência;
  • name é o nome de exibição da configuração da transferência. Ele pode ter qualquer valor que identifique facilmente a transferência, caso seja necessário modificá-la no futuro;
  • parameters contém os parâmetros para a configuração da transferência criada no formato JSON. Por exemplo, --params='{"param":"param_value"}'. No Google Ads, você precisa fornecer o parâmetro customer_id. Se quiser, defina o parâmetro exclude_removed_items como true para evitar a transferência de entidades e métricas removidas ou desativadas.
  • data_source é a fonte de dados: adwords.

Por exemplo, com o comando a seguir, você cria uma transferência do Google Ads chamada My Transfer usando o ID de cliente 123-123-1234 e o conjunto de dados de destino mydataset. A transferência é criada no projeto padrão:

bq mk \
    --transfer_config \
    --target_dataset=mydataset \
    --display_name='My Transfer' \
    --params='{"customer_id":"123-123-1234","exclude_removed_items":"true"}' \
    --data_source=adwords
    

Ao executar o comando pela primeira vez, você receberá uma mensagem como esta:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Siga as instruções na mensagem e cole o código de autenticação na linha de comando.

API

Use o método projects.locations.transferConfigs.create e forneça uma instância do recurso TransferConfig.

Suporte para contas de administrador do Google Ads

Recomendamos aos clientes existentes que tenham várias transferências do Google Ads específicas ao ID do cliente para configurar uma única transferência do Google Ads no nível da conta de administrador (MCC), programar um preenchimento e desativar transferências do Google Ads específicas ao ID do cliente individual.

O uso de contas de administrador do Google Ads oferece várias vantagens em relação ao uso de IDs de cliente individuais:

  • Não é mais necessário gerenciar várias transferências para gerar relatórios com base em vários IDs de cliente.
  • As consultas entre clientes são muito mais simples de escrever porque todos os IDs de cliente são armazenados na mesma tabela.
  • O uso de MCCs reduz os problemas de cota de carregamento do serviço de transferência de dados do BigQuery porque vários IDs de cliente são carregados no mesmo job.

Para mais informações sobre contas de administrador (MCCs) do Google Ads, consulte Como trabalhar com contas gerenciadas e Como vincular contas à do administrador.

Exemplo

Veja na lista a seguir os IDs de cliente vinculados a determinadas contas de administrador do Google Ads:

  • 1234567890: conta de administrador raiz
    • 1234: conta de subadministrador
      • 1111: ID de cliente
      • 2222 - ID de cliente
      • 3333 - ID de cliente
      • 4444: ID de cliente
      • 567: conta de subadministrador
        • 5555: ID de cliente
        • 6666 - ID de cliente
        • 7777: ID de cliente
    • 89: conta de subadministrador
      • 8888: ID de cliente
      • 9999 - ID de cliente
    • 0000: ID de cliente

Todo ID de cliente vinculado a uma conta de administrador é exibido em cada relatório. Para mais informações sobre a estrutura de relatórios do Google Ads no serviço de transferência de dados do BigQuery, consulte Transformação de relatórios do Google Ads.

Configuração de transferência do ID de cliente 1234567890

Uma configuração de transferência da conta de administrador raiz (ID de cliente 1234567890) gera execuções de transferência que incluem os seguintes IDs de cliente:

  • 1111 (por meio da conta de subadministrador 1234)
  • 2222 (por meio da conta de subadministrador 1234)
  • 3333 (por meio da conta de subadministrador 1234)
  • 4444 (por meio da conta de subadministrador 1234)
  • 5555 (por meio da conta de subadministrador 567 e da conta de subadministrador 1234)
  • 6666 (por meio da conta de subadministrador 567 e da conta de subadministrador 1234)
  • 7777 (por meio da conta de subadministrador 567 e da conta de subadministrador 1234)
  • 8888 (por meio da conta de subadministrador 89)
  • 9999 (por meio da conta de subadministrador 89)
  • 0000 (ID de cliente individual)

Configuração de transferência do ID de cliente 1234

Uma configuração de transferência da conta de subadministrador 123 (ID de cliente 1234) gera execuções de transferência que incluem os seguintes IDs de cliente:

  • 1111
  • 2222
  • 3333
  • 4444
  • 5555 (por meio da conta de subadministrador 567)
  • 6666 (por meio da conta de subadministrador 567)
  • 7777 (por meio da conta de subadministrador 567)

Configuração de transferência do ID de cliente 567

Uma configuração de transferência da conta de subadministrador 567 (ID de cliente 567) gera execuções de transferência que incluem os seguintes IDs de cliente:

  • 5555
  • 6666
  • 7777

Configuração de transferência do ID de cliente 89

Uma configuração de transferência da conta de subadministrador 89 (ID de cliente 89) gera execuções de transferência que incluem os seguintes IDs de cliente:

  • 8888
  • 9999

Configuração de transferência do ID de cliente 0000

Uma configuração de transferência do ID de cliente 0000 gera execuções de transferência que incluem apenas o ID de cliente individual:

  • 0000

Como migrar dados do Google Ads para MCCs

Para migrar os dados atuais do Google Ads no serviço de transferência de dados do BigQuery para a estrutura da MCC, configure um preenchimento para adicioná-los às tabelas criadas pela configuração de transferência vinculada à conta de administrador. Quando você programa um preenchimento, as tabelas de correspondências não são atualizadas.

Como solucionar problemas na configuração da transferência do Google Ads

Se você tiver problemas ao configurar a transferência, consulte Problemas de transferência do Google Ads em Solução de problemas de configuração de transferência do serviço de transferência de dados do BigQuery.

Como consultar dados

Quando os dados são movidos para o serviço de transferência de dados do BigQuery, eles são gravados em tabelas particionadas por tempo de processamento. Para mais informações, consulte Introdução às tabelas particionadas.

Use a pseudocoluna _PARTITIONTIME para consultar direto as tabelas, em vez de usar visualizações geradas automaticamente. Para mais informações, veja Como consultar tabelas particionadas.

Use as consultas de amostra do Google Ads a seguir para analisar os dados transferidos. Também é possível usar as consultas em uma ferramenta de visualização, como o Google Data Studio. Essas consultas são fornecidas para ajudar você a começar a consultar seus dados do Google Ads com o serviço de transferência de dados do BigQuery. Para outras perguntas sobre o que é possível fazer com esses relatórios, entre em contato com o representante técnico do Google Ads.

Em todas as consultas a seguir, substitua dataset pelo nome do conjunto de dados. Substitua customer_id por seu ID de cliente do Google Ads.

Use a pseudocoluna _PARTITIONTIME para consultar direto as tabelas, em vez de usar visualizações geradas automaticamente. Para mais informações, veja Como consultar tabelas particionadas.

Desempenho da campanha

A consulta de amostra a seguir analisa o desempenho da campanha do Google Ads nos últimos 30 dias.

Console

    SELECT
      c.ExternalCustomerId,
      c.CampaignName,
      c.CampaignStatus,
      SUM(cs.Impressions) AS Impressions,
      SUM(cs.Interactions) AS Interactions,
      (SUM(cs.Cost) / 1000000) AS Cost
    FROM
      `dataset.Campaign_customer_id` c
    LEFT JOIN
      `dataset.CampaignBasicStats_customer_id` cs
    ON
      (c.CampaignId = cs.CampaignId
       AND cs._DATA_DATE BETWEEN
       DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
    WHERE
      c._DATA_DATE = c._LATEST_DATE
    GROUP BY
      1, 2, 3
    ORDER BY
      Impressions DESC
    

CLI

    bq query --use_legacy_sql=false '
    SELECT
      c.ExternalCustomerId,
      c.CampaignName,
      c.CampaignStatus,
      SUM(cs.Impressions) AS Impressions,
      SUM(cs.Interactions) AS Interactions,
      (SUM(cs.Cost) / 1000000) AS Cost
    FROM
      `dataset.Campaign_customer_id` c
    LEFT JOIN
      `dataset.CampaignBasicStats_customer_id` cs
    ON
      (c.CampaignId = cs.CampaignId
       AND cs._DATA_DATE BETWEEN
       DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
    WHERE
      c._DATA_DATE = c._LATEST_DATE
    GROUP BY
      1, 2, 3
    ORDER BY
      Impressions DESC'
    

Contagem de palavras-chave

A consulta de amostra a seguir analisa palavras-chave por status de campanha, grupo de anúncios e palavra-chave. Nesta consulta, a função KeywordMatchType é usada. Com os tipos de correspondência de palavra-chave, você controla quais pesquisas podem acionar o anúncio. Para mais informações sobre as opções de correspondência de palavra-chave, consulte Sobre opções de correspondência de palavra-chave.

Console

    SELECT
      c.CampaignStatus AS CampaignStatus,
      a.AdGroupStatus AS AdGroupStatus,
      k.Status AS KeywordStatus,
      k.KeywordMatchType AS KeywordMatchType,
      COUNT(*) AS count
    FROM
      `dataset.Keyword_customer_id` k
      JOIN
      `dataset.Campaign_customer_id` c
    ON
      (k.CampaignId = c.CampaignId AND k._DATA_DATE = c._DATA_DATE)
    JOIN
      `dataset.AdGroup_customer_id` a
    ON
      (k.AdGroupId = a.AdGroupId AND k._DATA_DATE = a._DATA_DATE)
    WHERE
      k._DATA_DATE = k._LATEST_DATE
    GROUP BY
      1, 2, 3, 4
    

CLI

    bq query --use_legacy_sql=false '
    SELECT
      c.CampaignStatus AS CampaignStatus,
      a.AdGroupStatus AS AdGroupStatus,
      k.Status AS KeywordStatus,
      k.KeywordMatchType AS KeywordMatchType,
      COUNT(*) AS count
    FROM
      `dataset.Keyword_customer_id` k
    JOIN
      `dataset.Campaign_customer_id` c
    ON
      (k.CampaignId = c.CampaignId AND k._DATA_DATE = c._DATA_DATE)
    JOIN
      `dataset.AdGroup_customer_id` a
    ON
      (k.AdGroupId = a.AdGroupId AND k._DATA_DATE = a._DATA_DATE)
    WHERE
      k._DATA_DATE = k._LATEST_DATE
    GROUP BY
      1, 2, 3, 4'