Carregue dados do Google Ads para o BigQuery

Pode carregar dados do Google Ads (anteriormente conhecido como Google AdWords) para o BigQuery através do conetor do Serviço de transferência de dados do BigQuery para o Google Ads. Com o Serviço de transferência de dados do BigQuery, pode agendar tarefas de transferência recorrentes que adicionam os dados mais recentes do Google Ads ao BigQuery.

Para saber mais acerca das alterações recentes às origens de dados, consulte o registo de alterações às origens de dados do Serviço de transferência de dados do BigQuery.

Vista geral do conetor

O Serviço de transferência de dados do BigQuery para o conetor do Google Ads suporta as seguintes opções para a transferência de dados.

Opções de transferência de dados Apoio técnico
Relatórios suportados O conetor do Google Ads suporta a transferência de dados dos relatórios na API Google Ads v20.

Para ver informações sobre como os relatórios do Google Ads são transformados em tabelas e vistas do BigQuery, consulte o artigo Transformação de relatórios do Google Ads.
Frequência de repetição O conetor do Google Ads suporta transferências de dados diárias.

Por predefinição, as transferências de dados são agendadas no momento em que são criadas. Pode configurar a hora da transferência de dados quando configurar a transferência de dados.
Período de atualização Pode agendar as transferências de dados para obter dados do Google Ads de até 30 dias no momento em que a transferência de dados é executada. Pode configurar a duração do período de atualização quando configura a transferência de dados.

Por predefinição, o conetor do Google Ads tem um período de atualização de 7 dias.

Para mais informações, consulte Períodos de atualização.

As capturas instantâneas das tabelas de correspondência são feitas uma vez por dia e armazenadas na partição para a data de execução mais recente. As capturas instantâneas da tabela de correspondência não são atualizadas para preenchimentos nem para dias carregados através da janela de atualização.
Disponibilidade de dados de preenchimento Execute um repreenchimento de dados para obter dados fora da transferência de dados agendada. Pode obter dados até ao limite permitido pela política de retenção de dados na sua origem de dados.

Para obter informações sobre a política de retenção de dados do Google Ads, consulte a Política de retenção de dados do Google Ads.
Número de IDs de cliente por conta de gestor

8000

O Serviço de transferência de dados do BigQuery suporta um máximo de 8000 IDs de clientes para cada conta de gestor do Google Ads (MCC).

Para mapear os relatórios do Google Ads com o que vê na IU do Google Ads, consulte o artigo Mapear relatórios com a IU do Google Ads.

Carregamento de dados de transferências do Google Ads

Quando transfere dados do Google Ads para o BigQuery, os dados são carregados em tabelas do BigQuery particionadas por data. A partição da tabela na qual os dados são carregados corresponde à data da origem de dados. Se agendar várias transferências para a mesma data, o Serviço de transferência de dados do BigQuery substitui a partição dessa data específica pelos dados mais recentes. As várias transferências no mesmo dia ou a execução de preenchimentos não resultam em dados duplicados, e as partições para outras datas não são afetadas.

Atualize as janelas

Um período de atualização é o número de dias que uma transferência de dados obtém dados quando ocorre uma transferência de dados. Por exemplo, se a janela de atualização for de três dias e ocorrer uma transferência diária, o Serviço de transferência de dados do BigQuery obtém todos os dados da tabela de origem dos últimos três dias. Neste exemplo, quando ocorre uma transferência diária, o Serviço de transferência de dados do BigQuery cria uma nova partição da tabela de destino do BigQuery com uma cópia dos dados da tabela de origem do dia atual e, em seguida, aciona automaticamente execuções de preenchimento para atualizar as partições da tabela de destino do BigQuery com os dados da tabela de origem dos últimos dois dias. As execuções de preenchimento automático acionadas automaticamente substituem ou atualizam incrementalmente a tabela de destino do BigQuery, consoante as atualizações incrementais sejam ou não suportadas no conector do Serviço de transferência de dados do BigQuery.

Quando executa uma transferência de dados pela primeira vez, a transferência de dados obtém todos os dados de origem disponíveis na janela de atualização. Por exemplo, se a janela de atualização for de três dias e executar a transferência de dados pela primeira vez, o Serviço de transferência de dados do BigQuery obtém todos os dados de origem no prazo de três dias.

Para obter dados fora do período de atualização, como dados do histórico, ou para recuperar dados de quaisquer indisponibilidades ou lacunas de transferência, pode iniciar ou agendar uma execução de preenchimento.

Limitações

  • A frequência máxima com que pode configurar uma transferência de dados do Google Ads é uma vez a cada 24 horas. Por predefinição, uma transferência começa no momento em que cria a transferência. No entanto, pode configurar a hora de início da transferência quando criar a transferência.
  • O Serviço de transferência de dados do BigQuery não suporta transferências de dados incrementais durante uma transferência do Google Ads. Quando especifica uma data para uma transferência de dados, todos os dados disponíveis para essa data são transferidos.

Antes de começar

Antes de criar uma transferência de dados do Google Ads, faça o seguinte:

Autorizações necessárias

Certifique-se de que a pessoa que cria a transferência de dados tem as seguintes autorizações necessárias:

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

    • Autorizações bigquery.transfers.update para criar a Transferência de dados
    • Autorizações de bigquery.datasets.get e bigquery.datasets.update no conjunto de dados de destino

    A bigquery.adminfunção de IAM predefinida inclui as autorizações bigquery.transfers.update, bigquery.datasets.update e bigquery.datasets.get. Para mais informações sobre as funções da IAM no Serviço de transferência de dados do BigQuery, consulte a referência de controlo de acesso.

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

    • Para autorizar uma conta de serviço para a transferência de dados do Google Ads, recomendamos que conceda à conta de serviço acesso direto à conta do Google Ads. Para mais informações, consulte o artigo Autorização com acesso direto à conta

Crie uma transferência de dados do Google Ads

Para criar uma transferência de dados para relatórios do Google Ads, precisa do seu ID de cliente do Google Ads ou da sua conta de gestor (MCC). Para obter informações sobre como recuperar o seu ID de cliente do Google Ads, consulte o artigo Encontre o seu ID de cliente.

Para criar uma transferência de dados para relatórios do Google Ads, selecione uma das seguintes opções:

Consola

  1. Aceda à página Transferências de dados na Google Cloud consola.

    Aceda a Transferências de dados

  2. Clique em Criar transferência.

  3. Na secção Tipo de origem, para Origem, escolha Google Ads.

  4. Na secção Detalhes da origem de dados:

    1. Para o ID de cliente, introduza o seu ID de cliente do Google Ads.
    2. Em Tipo de relatório, selecione Padrão ou Personalizado.
      • Se selecionou Padrão, a transferência inclui o conjunto padrão de relatórios e campos, conforme detalhado na transformação de relatórios do Google Ads.
        • Opcional: selecione opções para excluir itens removidos ou desativados e incluir tabelas novas no Google Ads.
        • Opcional: introduza uma lista de tabelas separada por vírgulas para incluir, por exemplo, Campaign, AdGroup. Preceda esta lista com o caráter - para excluir determinadas tabelas, por exemplo, -Campaign, AdGroup. Por predefinição, todas as tabelas são incluídas.
        • Opcional: selecione a opção para incluir tabelas específicas dos relatórios de PMax. Para mais informações sobre o suporte de PMax, consulte o artigo Suporte de PMax.
        • Opcional: para Janela de atualização, introduza um valor entre 1 e 30.
      • Se selecionou Personalizado, introduza uma tabela de saída e uma consulta do Google Ads para cada relatório personalizado que quer incluir nesta transferência.
        • Opcional: clique em Adicionar consulta para adicionar um novo relatório personalizado.
        • Opcional: para Janela de atualização, introduza um valor entre 1 e 30.

  5. Na secção Definições de destino, para Conjunto de dados, selecione o conjunto de dados que criou para armazenar os seus dados.

  6. Na secção Nome da configuração de transferência, em Nome a apresentar, introduza um nome para a transferência de dados, como My Transfer. O nome da transferência pode ser qualquer valor que lhe permita identificar a transferência se precisar de a modificar mais tarde.

  7. Na secção Opções de programação:

    • Para Frequência de repetição, escolha uma opção para a frequência de execução da transferência de dados. Se selecionar Dias, indique uma hora válida em UTC.
      • Horas
      • Dias
      • A pedido
    • Se aplicável, selecione Começar agora ou Começar à hora definida e indique uma data de início e um tempo de execução.

  8. No menu Conta de serviço, selecione uma conta de serviço das contas de serviço associadas ao seu Google Cloud projeto. Pode associar uma conta de serviço à transferência de dados em vez de usar as suas credenciais de utilizador. Para mais informações sobre a utilização de contas de serviço com transferências de dados, consulte o artigo Use contas de serviço.

  9. Opcional: na secção Opções de notificação:

    • Clique no botão para ativar as notificações por email. Quando ativa esta opção, o administrador da transferência recebe uma notificação por email se uma execução de transferência falhar.
    • Clique no botão para ativar as notificações do Pub/Sub. Em Selecionar um tópico do Cloud Pub/Sub, escolha o nome do tópico ou clique em Criar um tópico. Esta opção configura notificações executadas pelo Pub/Sub para a transferência.

  10. Clique em Guardar.

bq

Introduza o comando bq mk e forneça a flag de criação de transferência — --transfer_config. Os seguintes indicadores também são obrigatórios:

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

As seguintes sinalizações são opcionais:

  • --project_id: especifica o projeto a usar. Se a flag não for especificada, é usado o projeto predefinido.
  • --table_filter: especifica as tabelas a incluir na transferência de dados. Se a flag não for especificada, todas as tabelas são incluídas. Para incluir apenas tabelas específicas, use uma lista de valores separados por vírgulas (por exemplo, Ad, Campaign, AdGroup). Para excluir tabelas específicas, adicione um hífen (-) antes dos valores (por exemplo, -Ad, Campaign, AdGroup).
  • --schedule: especifica a frequência com que a consulta é executada. Se não especificar --schedule, a predefinição é every 24 hours. Para obter informações acerca da sintaxe da programação, consulte o artigo Formatar a programação.
  • --refresh_window_days: especifica o período de atualização de uma configuração de transferência em dias. O valor predefinido é 7.
  • --service_account_name: especifica uma conta de serviço a usar para a autenticação de transferência do Google Ads, em vez da sua conta de utilizador.
bq mk \
--transfer_config \
--project_id=PROJECT_ID \
--target_dataset=DATASET \
--display_name=NAME \
--params='PARAMETERS' \
--data_source=DATA_SOURCE \
--table_filter=TABLES \
--schedule=SCHEDULE
--refresh_window_days=REFRESH_DAYS
--service_account_name=SERVICE_ACCOUNT_NAME

Onde:

  • PROJECT_ID é o ID do seu projeto.
  • DATASET é o conjunto de dados de destino para a configuração da Transferência de dados.
  • NAME é o nome a apresentar da configuração de transferência de dados. O nome da transferência pode ser qualquer valor que lhe permita identificar a transferência se precisar de a modificar mais tarde.
  • PARAMETERS contém os seguintes parâmetros JSON para a configuração de transferência: --params='{"param":"param_value"}'.
    • customer_id: introduza o ID de cliente do Google Ads. Este campo é obrigatório.
    • custom_report_table_names: uma lista de nomes de tabelas para os relatórios personalizados incluídos nesta transferência. Esta lista corresponde às consultas em custom_report_queries. O comprimento desta lista tem de corresponder ao comprimento da lista em custom_report_queries.
    • custom_report_queries: uma lista de consultas da linguagem de consulta do Google Ads (GAQL) para os relatórios personalizados incluídos nesta transferência. Esta lista corresponde aos nomes em custom_report_table_names. O comprimento desta lista tem de corresponder ao comprimento da lista em custom_report_table_names.
    • Opcional: defina o parâmetro exclude_removed_items como true para impedir a transferência de entidades e métricas removidas ou desativadas.
  • DATA_SOURCE é a origem de dados — google_ads.
  • TABLES é a lista de tabelas separadas por vírgulas a incluir ou excluir da transferência de dados.
  • SCHEDULE é a frequência com que quer que a consulta seja executada. Se --schedule não for especificado, o valor predefinido é a cada 24 horas, a partir da hora em que a transferência é criada.
  • REFRESH_DAYS é um número inteiro que especifica o período de atualização de uma configuração de transferência em dias. O valor predefinido é 7.
  • SERVICE_ACCOUNT_NAME é o nome da conta de serviço usado para autenticar a sua transferência. A conta de serviço tem de ser propriedade da mesma project_id usada para criar a transferência e tem de ter todas as autorizações necessárias.

Por exemplo, o comando seguinte cria uma transferência de dados do Google Ads denominada My Transfer usando o ID de cliente 123-123-1234 e o conjunto de dados de destino mydataset. A transferência de dados é criada no projeto predefinido:

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

Na primeira vez que executar o comando, recebe uma mensagem semelhante à seguinte:

[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 comandos.

API

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

Java

Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do BigQuery com bibliotecas cliente. Para mais informações, consulte a API Java BigQuery documentação de referência.

Para se autenticar no BigQuery, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente. 

import com.google.api.gax.rpc.ApiException;
import com.google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest;
import com.google.cloud.bigquery.datatransfer.v1.DataTransferServiceClient;
import com.google.cloud.bigquery.datatransfer.v1.ProjectName;
import com.google.cloud.bigquery.datatransfer.v1.TransferConfig;
import com.google.protobuf.Struct;
import com.google.protobuf.Value;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

// Sample to create ads(formerly AdWords) transfer config
public class CreateAdsTransfer {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    final String projectId = "MY_PROJECT_ID";
    String datasetId = "MY_DATASET_ID";
    // the customer_id only allows digits and hyphen ('-').
    String customerId = "012-345-6789";
    String refreshWindow = "100";
    Map<String, Value> params = new HashMap<>();
    params.put("customer_id", Value.newBuilder().setStringValue(customerId).build());
    params.put("refreshWindow", Value.newBuilder().setStringValue(refreshWindow).build());
    TransferConfig transferConfig =
        TransferConfig.newBuilder()
            .setDestinationDatasetId(datasetId)
            .setDisplayName("Your Ads Transfer Config Name")
            .setDataSourceId("adwords")
            .setParams(Struct.newBuilder().putAllFields(params).build())
            .build();
    createAdsTransfer(projectId, transferConfig);
  }

  public static void createAdsTransfer(String projectId, TransferConfig transferConfig)
      throws IOException {
    try (DataTransferServiceClient client = DataTransferServiceClient.create()) {
      ProjectName parent = ProjectName.of(projectId);
      CreateTransferConfigRequest request =
          CreateTransferConfigRequest.newBuilder()
              .setParent(parent.toString())
              .setTransferConfig(transferConfig)
              .build();
      TransferConfig config = client.createTransferConfig(request);
      System.out.println("Ads transfer created successfully :" + config.getName());
    } catch (ApiException ex) {
      System.out.print("Ads transfer was not created." + ex.toString());
    }
  }
}

Acione manualmente uma transferência do Google Ads

Quando aciona manualmente uma transferência para o Google Ads, são tiradas capturas de ecrã das tabelas de correspondências uma vez por dia e armazenadas na partição para a data de execução mais recente. Quando aciona uma transferência manual, as imagens instantâneas da tabela de correspondências das seguintes tabelas não são atualizadas:

  • Anúncio
  • AdGroup
  • AdGroupAudience
  • AdGroupBidModifier
  • AdGroupAdLabel
  • AdGroupCriterion
  • AdGroupCriterionLabel
  • AdGroupLabel
  • AgeRange
  • Recurso
  • AssetGroup
  • AssetGroupAsset
  • AssetGroupListingGroupFilter
  • AssetGroupSignal
  • Público-alvo
  • BidGoal
  • Orçamento
  • Campanha
  • CampaignAudience
  • CampaignCriterion
  • CampaignLabel
  • Cliente
  • Género
  • Palavra-chave
  • LocationBasedCampaignCriterion
  • ParentalStatus
  • Posicionamento
  • Vídeo

Relatórios personalizados

O conetor do Serviço de transferência de dados do BigQuery para o Google Ads também suporta a utilização de relatórios personalizados através de consultas da linguagem de consultas Google Ads (GAQL) na configuração de transferência do Google Ads. Estes relatórios personalizados carregam dados de todos os recursos disponíveis na versão da API Google Ads suportada pelo Serviço de transferência de dados do BigQuery. Para mais informações sobre a utilização e a validação de uma consulta GAQL, consulte o criador de consultas do Google Ads.

Pode especificar relatórios personalizados quando criar uma transferência do Google Ads.

Limitações dos relatórios personalizados

Os relatórios personalizados com o conetor do Google Ads estão sujeitos às seguintes limitações:

  • O conector do Google Ads não suporta as cláusulas WHERE, ORDER BY, LIMIT e PARAMETERS. A sua consulta GAQL deve estar no formato semelhante ao seguinte: SELECT FIELD_NAME, FIELD_NAME,... FROM RESOURCE_NAME.
  • O conector do Google Ads anexa automaticamente WHERE segments.date = run_date quando existe um segmento de data principal (por exemplo, segments.date, segments.week, segments.month, segments.quarter, segments.year) na consulta. Isto pode fazer com que o validador de consultas do Google Ads retorne um erro, por exemplo, The filtering conditions in the WHERE clause must combine to form a valid, finite date range composed of the core date segments .... Pode ignorar estes erros com segurança.
  • As consultas GAQL sem um campo segments.date funcionam como tabelas de correspondência, que só são atualizadas uma vez por dia e não são suportadas em execuções de preenchimento. Se quiser preencher dados, tem de incluir um campo segments.date na consulta GAQL.
  • O conetor do Google Ads suporta até 100 relatórios personalizados numa única transferência.

Campanhas de Máximo desempenho (MaxD)

O conetor do Google Ads permite-lhe exportar dados de campanhas de PMax. Tem de selecionar a caixa de verificação Incluir tabelas de campanhas de MaxD quando criar uma transferência de dados, uma vez que os dados de MaxD não são exportados por predefinição.

A inclusão de dados de campanhas de Máximo desempenho remove campos ad_group de determinadas tabelas e inclui novas tabelas. Não pode incluir campos ad_group porque a API Google Ads filtra os dados das campanhas de Máximo desempenho.

As tabelas seguintes excluem as colunas relacionadas com ad_group quando a caixa de verificação Incluir tabelas de campanhas de PMax está selecionada:

  • GeoStats
  • GeoConversionStats
  • ShoppingProductConversionStats
  • ShoppingProductStats
  • LocationsUserLocationsStats

As tabelas seguintes são adicionadas quando a caixa de verificação Incluir tabelas de campanhas de Máximo desempenho está selecionada:

  • Recurso
  • AssetGroup
  • AssetGroupAsset
  • AssetGroupListingGroupFilter
  • AssetGroupSignal
  • Público-alvo
  • AssetGroupProductGroupStats
  • CampaignAssetStats

Apoio técnico para contas de gestor do Google Ads

Recomendamos que os clientes existentes que tenham várias transferências do Google Ads específicas do ID de cliente configurem uma única transferência do Google Ads ao nível da conta de gestor (MCC), agendem um preenchimento e desativem as transferências do Google Ads específicas do ID de cliente individuais.

A utilização de contas de gestor do Google Ads oferece várias vantagens em relação à utilização de IDs de cliente individuais:

  • Já não precisa de gerir várias transferências de dados para criar relatórios sobre vários IDs de clientes.
  • As consultas entre clientes são muito mais simples de escrever porque todos os IDs de clientes estão armazenados na mesma tabela.
  • A utilização de MCCs atenua os problemas de quota de carregamento do Serviço de transferência de dados do BigQuery porque são carregados vários IDs de clientes na mesma tarefa.

Para mais informações sobre as contas de gestor do Google Ads (MCCs), consulte os artigos Trabalhar com contas geridas e Acerca da associação de contas à sua conta de gestor.

Exemplo

A lista seguinte mostra os IDs de cliente associados a contas de gestor do Google Ads específicas:

  • 1234567890: conta de gestor principal
    • 1234 – Conta de subgestor
      • 1111 – ID de cliente
      • 2222: ID de cliente
      • 3333: ID de cliente
      • 4444: ID de cliente
      • 567: conta de subgestor
        • 5555: ID de cliente
        • 6666: ID de cliente
        • 7777: ID de cliente
    • 89 – Conta de subgestor
      • 8888: ID de cliente
      • 9999: ID de cliente
    • 0000: ID de cliente

Cada ID de cliente associado a uma conta de gestor aparece 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.

Transferência da configuração para o ID de cliente 1234567890

Uma configuração de transferência para a conta de gestor principal (ID de cliente 1234567890) geraria execuções de transferência de dados que incluem os seguintes IDs de cliente:

  • 1111 (através da conta de subgestor 1234)
  • 2222 (através da conta de subgestor 1234)
  • 3333 (através da conta de subgestor 1234)
  • 4444 (através da conta de subgestor 1234)
  • 5555 (através da conta de subgestor 567 e da conta de subgestor 1234)
  • 6666 (através da conta de subgestor 567 e da conta de subgestor 1234)
  • 7777 (através da conta de subgestor 567 e da conta de subgestor 1234)
  • 8888 (através da conta de subgestor 89)
  • 9999 (através da conta de subgestor 89)
  • 0000 (ID de cliente individual)

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

Uma configuração de transferência para a conta de subgestor 123 (ID de cliente 1234) geraria execuções de transferência de dados que incluem os seguintes IDs de cliente:

  • 1111
  • 2222
  • 3333
  • 4444
  • 5555 (através da conta de subgestor 567)
  • 6666 (através da conta de subgestor 567)
  • 7777 (através da conta de subgestor 567)

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

Uma configuração de transferência para a conta de subgestor 567 (ID de cliente 567) geraria execuções de transferência de dados que incluem os seguintes IDs de cliente:

  • 5555
  • 6666
  • 7777

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

Uma configuração de transferência para a conta de subgestor 89 (ID de cliente 89) geraria execuções de transferência de dados que incluem os seguintes IDs de cliente:

  • 8888
  • 9999

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

Uma configuração de transferência para o ID de cliente 0000 geraria execuções de transferência de dados que incluiriam apenas o ID de cliente individual:

  • 0000

Migre dados do Google Ads para MCCs

Para migrar os seus dados existentes do Google Ads no Serviço de transferência de dados do BigQuery para a estrutura de MCC, pode configurar um preenchimento para adicionar os seus dados existentes às tabelas criadas pela configuração de transferência associada à conta de gestor. Tenha em atenção que, quando agenda um preenchimento, as tabelas de correspondência não são atualizadas.

Resolva problemas de configuração da transferência do Google Ads

Se tiver problemas com a configuração da transferência de dados, consulte a secção Problemas de transferência do Google Ads em Resolução de problemas de configurações de transferência.

Consultar os seus dados

Quando os dados são transferidos para o Serviço de transferência de dados do BigQuery, são gravados em tabelas particionadas por tempo de ingestão. Para mais informações, consulte o artigo Introdução às tabelas particionadas.

Se consultar as tabelas diretamente em vez de usar as vistas geradas automaticamente, tem de usar a pseudocoluna _PARTITIONTIME na consulta. Para mais informações, consulte o artigo Consultar tabelas particionadas.

Consultas de exemplo do Google Ads

Pode usar as seguintes consultas de exemplo do Google Ads para analisar os seus dados transferidos. Também pode usar as consultas numa ferramenta de visualização, como o Looker Studio. Estas consultas são fornecidas para ajudar a começar a consultar os seus dados do Google Ads com o Serviço de transferência de dados do BigQuery. Se tiver mais dúvidas sobre o que pode fazer com estes relatórios, contacte o seu representante técnico do Google Ads.

Em cada uma das seguintes consultas, substitua dataset pelo nome do conjunto de dados. Substitua customer_id pelo seu ID de cliente do Google Ads.

Se consultar as tabelas diretamente em vez de usar as vistas geradas automaticamente, tem de usar a pseudocoluna _PARTITIONTIME na sua consulta. Para mais informações, consulte o artigo Consultar tabelas particionadas.

Desempenho da campanha

A consulta de exemplo seguinte analisa o desempenho da campanha do Google Ads nos últimos 30 dias.

Consola 

SELECT
  c.customer_id,
  c.campaign_name,
  c.campaign_status,
  SUM(cs.metrics_impressions) AS Impressions,
  SUM(cs.metrics_interactions) AS Interactions,
  (SUM(cs.metrics_cost_micros) / 1000000) AS Cost
FROM
  `DATASET.ads_Campaign_CUSTOMER_ID` c
LEFT JOIN
  `DATASET.ads_CampaignBasicStats_CUSTOMER_ID` cs
ON
  (c.campaign_id = cs.campaign_id
  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

bq 

  bq query --use_legacy_sql=false '
  SELECT
    c.customer_id,
    c.campaign_name,
    c.campaign_status,
    SUM(cs.metrics_impressions) AS Impressions,
    SUM(cs.metrics_interactions) AS Interactions,
    (SUM(cs.metrics_cost_micros) / 1000000) AS Cost
  FROM
    `DATASET.ads_Campaign_CUSTOMER_ID` c
  LEFT JOIN
    `DATASET.ads_CampaignBasicStats_CUSTOMER_ID` cs
  ON
    (c.campaign_id = cs.campaign_id
    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 exemplo seguinte analisa as palavras-chave por campanha, grupo de anúncios e estado da palavra-chave. Esta consulta usa a função KeywordMatchType. Os tipos de correspondência de palavras-chave ajudam a controlar as pesquisas que podem acionar o seu anúncio. Para mais informações sobre as opções de correspondência de palavras-chave, consulte o artigo Acerca das opções de correspondência de palavras-chave.

Consola 

  SELECT
    c.campaign_status AS CampaignStatus,
    a.ad_group_status AS AdGroupStatus,
    k.ad_group_criterion_status AS KeywordStatus,
    k.ad_group_criterion_keyword_match_type AS KeywordMatchType,
    COUNT(*) AS count
  FROM
    `DATASET.ads_Keyword_CUSTOMER_ID` k
    JOIN
    `DATASET.ads_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.ads_AdGroup_CUSTOMER_ID` a
  ON
    (k.ad_group_id = a.ad_group_id AND k._DATA_DATE = a._DATA_DATE)
  WHERE
    k._DATA_DATE = k._LATEST_DATE
  GROUP BY
    1, 2, 3, 4

bq 

  bq query --use_legacy_sql=false '
  SELECT
    c.campaign_status AS CampaignStatus,
    a.ad_group_status AS AdGroupStatus,
    k.ad_group_criterion_status AS KeywordStatus,
    k.ad_group_criterion_keyword_match_type AS KeywordMatchType,
    COUNT(*) AS count
  FROM
    `DATASET.ads_Keyword_CUSTOMER_ID` k
  JOIN
    `DATASET.ads_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.ads_AdGroup_CUSTOMER_ID` a
  ON
    (k.ad_group_id = a.ad_group_id AND k._DATA_DATE = a._DATA_DATE)
  WHERE
    k._DATA_DATE = k._LATEST_DATE
  GROUP BY
    1, 2, 3, 4'