Carregue dados do Search Ads 360 para o BigQuery

Pode carregar dados do Search Ads 360 para o BigQuery através do conetor do Serviço de transferência de dados do BigQuery para o Search Ads 360. Com o Serviço de transferência de dados do BigQuery, pode agendar tarefas de transferência recorrentes que adicionam os seus dados mais recentes do Search Ads 360 ao BigQuery.

Vista geral do conetor

O Serviço de transferência de dados do BigQuery para o conetor do Search Ads 360 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 Search Ads 360 suporta a transferência de dados dos relatórios nos relatórios da v0 do Search Ads 360. Para ver informações sobre como os relatórios do Search Ads 360 são transformados em tabelas e vistas do BigQuery, consulte o artigo Transformação de relatórios do Search Ads 360.
Frequência de repetição	O conetor do Search Ads 360 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 Search Ads 360 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 Search Ads 360 tem uma janela 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 acerca da política de retenção de dados do Search Ads 360, consulte o artigo Política de Retenção de Dados de Relatórios.
Número de IDs de cliente por conta de gestor	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 Search Ads 360.

Para ver o guia de transferência do Search Ads 360 que usa a antiga API Google Search Ads 360 Reporting, consulte o artigo Transferências do Search Ads 360 (descontinuado).

Carregamento de dados de transferências do Search Ads 360

Quando transfere dados do Search Ads 360 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 Search Ads 360 é 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 de dados 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 Search Ads 360. 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 Search Ads 360:

• Verifique se concluiu todas as ações necessárias para ativar o Serviço de transferência de dados do BigQuery.
• Crie um conjunto de dados do Serviço de transferência de dados do BigQuery para armazenar os dados de relatórios do Search Ads 360.
• Se pretender configurar notificações de execução de transferências para o Pub/Sub, tem de ter pubsub.topics.setIamPolicy autorizações. As autorizações do Pub/Sub não são necessárias se configurar apenas notificações por email. Para mais informações, consulte as notificações de execução do Serviço de transferência de dados do BigQuery.
• Ative o acesso à API Search Ads 360 Reporting no seu projeto.

Autorizações necessárias

Certifique-se de que o utilizador 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.
  • Ambas as autorizações bigquery.datasets.get e bigquery.datasets.update no conjunto de dados de destino.

  A função de IAM predefinida bigquery.admininclui as autorizações bigquery.transfers.update, bigquery.datasets.update e bigquery.datasets.get. Para mais informações sobre as funções de IAM no Serviço de transferência de dados do BigQuery, consulte o artigo Controlo de acesso.

• Google Cloud:

  • serviceusage.services.use para transferir dados do Search Ads 360 no projeto.

  As funções de IAM predefinidas editor, owner e serviceusage.serviceUsageConsumer incluem autorizações serviceusage.services.use. Para mais informações sobre as funções da IAM na utilização de serviços, consulte a referência de controlo de acesso.

• Search Ads 360:

  • Acesso de leitura ao ID do cliente do Search Ads 360 ou à conta de gestor que é usada na configuração de transferência. Para configurar o acesso de leitura para contas de serviço, pode contactar o apoio técnico do Search Ads 360 para receber assistência.

Crie uma transferência de dados do Search Ads 360

Para criar uma transferência de dados para relatórios do Search Ads 360, precisa do seu ID de cliente do Search Ads 360 ou da conta de gestor. 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 Search Ads 360.

4. 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.

5. 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.
   • 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.

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

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

   1. Para o ID de cliente, introduza o seu ID de cliente do Search Ads 360.
   2. Opcional: introduza um ID da agência e um ID do anunciante para obter tabelas de mapeamento de IDs.

   3. Opcional: para variáveis personalizadas do Floodlight, introduza quaisquer variáveis personalizadas do Floodlight a incluir na transferência de dados. As variáveis do Floodlight personalizadas têm de pertencer à conta do Search Ads 360 especificada pelo ID do cliente na configuração de transferência. Este parâmetro aceita entradas de string no formato de matriz JSON e pode suportar várias variáveis personalizadas do Floodlight. Em cada artigo da matriz JSON, são necessários os seguintes parâmetros:

      • id: o ID numérico da variável do Floodlight personalizada. Este ID é atribuído quando é criada uma variável personalizada do Floodlight no Search Ads 360. Se tiver especificado um id, não é necessário um name.
      • name: o nome definido pelo utilizador das variáveis personalizadas do Floodlight no Search Ads 360. Se tiver especificado um name, não é necessário um id.
      • cfv_field_name: o nome exato do campo da variável do Floodlight personalizada com base no seu exemplo de utilização. Os valores suportados são conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics e raw_event_conversion_dimensions.
      • destination_table_name: uma lista de tabelas do BigQuery para incluir as variáveis do Floodlight personalizadas. Quando o serviço de transferência de dados do BigQuery obtém dados para estas tabelas, a transferência inclui as variáveis do Floodlight personalizadas na consulta.
      • bigquery_column_name_suffix: o nome intuitivo da coluna definido pelo utilizador. O Serviço de transferência de dados do BigQuery acrescenta o sufixo após o nome do campo padrão para diferenciar as diferentes variáveis personalizadas do Floodlight. Consoante o exemplo de utilização, o Serviço de transferência de dados do BigQuery gera um nome de coluna do BigQuery da seguinte forma:

      	Variáveis personalizadas do Floodlight como métricas e segmentos	Variáveis do Floodlight personalizadas como atributos de eventos não processados no recurso de conversão
      metrics	metrics_conversion_custom_metrics_bigquery_column_name_suffix	metrics_raw_event_conversion_metrics_bigquery_column_name_suffix
      dimension	segments_conversion_custom_dimensions_bigquery_column_name_suffix	segments_raw_event_conversion_dimensions_bigquery_column_name_suffix

      Segue-se um exemplo de uma entrada de variável do Floodlight personalizada que especifica duas variáveis do Floodlight personalizadas:

      [{
      "id": "1234",
      "cfv_field_name": "raw_event_conversion_metrics",
      "destination_table_name": ["Conversion"],
      "bigquery_column_name_suffix": "suffix1"
      },{
      "name": "example name",
      "cfv_field_name": "conversion_custom_metrics",
      "destination_table_name": ["AdGroupConversionActionAndDeviceStats","CampaignConversionActionAndDeviceStats"],
      "bigquery_column_name_suffix": "suffix2"
      }]

   4. Opcional: no campo Colunas personalizadas, introduza quaisquer colunas personalizadas para incluir na transferência de dados. As colunas personalizadas têm de ser propriedade da conta do Search Ads 360 especificada pelo ID do cliente na configuração de transferência. Este campo aceita entradas de strings no formato de matriz JSON e pode suportar várias colunas. Em cada artigo da matriz JSON, os seguintes parâmetros são obrigatórios:

      • id: o ID numérico da coluna personalizada. Este ID é atribuído quando é criada uma coluna personalizada. Se tiver especificado um id, não é necessário um name.
      • name: o nome definido pelo utilizador da coluna personalizada no Search Ads 360. Se tiver especificado um name, não é necessário um id.
      • destination_table_name: uma lista de tabelas do BigQuery para incluir a coluna personalizada. Quando o Serviço de transferência de dados do BigQuery obtém dados para estas tabelas, a transferência inclui o campo da coluna personalizada na consulta.
      • bigquery_column_name: o nome da coluna intuitivo definido pelo utilizador. Este é o nome do campo da coluna personalizada nas tabelas de destino especificadas em destination_table_name. O nome da coluna tem de seguir os requisitos de formato para nomes de colunas do BigQuery e tem de ser exclusivo para outros campos no esquema padrão da tabela ou outras colunas personalizadas.

      Segue-se um exemplo de uma entrada de colunas personalizadas que especifica duas colunas personalizadas:

      [{
        "id": "1234",
        "destination_table_name": ["Conversion"],
        "bigquery_column_name": "column1"
      },{
        "name": "example name",
        "destination_table_name": ["AdGroupStats","CampaignStats"],
        "bigquery_column_name": "column2"
      }]

   5. Opcional: no campo Filtro de tabela, introduza uma lista de tabelas separada por vírgulas para incluir, por exemplo, Campaign, AdGroup. Faça o prefixo desta lista com o caráter - para excluir determinadas tabelas, por exemplo, -Campaign, AdGroup. Por predefinição, todas as tabelas estão incluídas.

   6. Opcional: para Janela de atualização, introduza um valor entre 1 e 30. Se não estiver definida, o período de atualização é de 7 dias por predefinição.

8. No menu Conta de serviço, selecione uma conta de serviço nas contas de serviço associadas ao seu Google Cloud projeto. Pode associar uma conta de serviço à sua transferência 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 service accounts (Use contas de serviço).

   Se iniciou sessão com uma identidade federada, é necessária uma conta de serviço para criar uma transferência. Se iniciou sessão com uma Conta Google, uma conta de serviço para a transferência é opcional. A conta de serviço tem de ter as autorizações necessárias.

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 quando uma execução da transferência falha.
   • 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.
• --service_account_name: especifica uma conta de serviço a usar para a autenticação de transferência do Search Ads 360 em vez da sua conta de utilizador.

bq mk \
--transfer_config \
--project_id=PROJECT_ID \
--target_dataset=DATASET \
--display_name=NAME \
--data_source=DATA_SOURCE \
--service_account_name=SERVICE_ACCOUNT_NAME \
--params='{PARAMETERS,"custom_columns":"[{\"id\": \"CC_ID\",\"destination_table_name\": [\"CC_DESTINATION_TABLE\"],\"bigquery_column_name\": \"CC_COLUMN\"}]","custom_floodlight_variables":"[{\"id\": \"CFV_ID\",\"cfv_field_name\": [\"CFV_FIELD_NAME\"],\"destination_table_name\": [\"CFV_DESTINATION_TABLE\"],\"bigquery_column_name_suffix\": \"CFV_COLUMN_SUFFIX\"}]"}'

Onde:

• PROJECT_ID (Opcional): especifica o projeto a usar. Se a flag não for especificada, é usado o projeto predefinido.
• DATASET: o conjunto de dados de destino para a configuração de transferência.

• NAME: o nome a apresentar da configuração de transferência. O nome da transferência de dados pode ser qualquer valor que lhe permita identificar a transferência se precisar de a modificar mais tarde.

• DATA_SOURCE: a origem de dados: search_ads.

• SERVICE_ACCOUNT_NAME (Opcional): o nome da conta de serviço usado para autenticar a transferência de dados. A conta de serviço deve ser propriedade do mesmo project_id usado para criar a transferência e deve ter todas as autorizações necessárias.

• PARAMETERS: os parâmetros da configuração de transferência criada no formato JSON. Por exemplo: --params='{"param":"param_value"}'. Tem de fornecer o parâmetro customer_id.

  • 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 excluídos (por exemplo, usar -Ad, Campaign, AdGroup exclui todos os três valores).
  • custom_columns: especifica colunas personalizadas para os seus relatórios. Este parâmetro aceita entradas de string no formato de matriz JSON e pode suportar várias colunas. Em cada item da matriz JSON, os seguintes parâmetros são obrigatórios:
    • CC_ID: o ID numérico da coluna personalizada. Este ID é atribuído quando é criada uma coluna personalizada.
    • CC_DESTINATION_TABLE: uma lista de tabelas do BigQuery para incluir a coluna personalizada. Quando o Serviço de transferência de dados do BigQuery obtém dados para estas tabelas, a transferência de dados inclui o campo da coluna personalizada na consulta.
    • CC_COLUMN: o nome da coluna intuitivo definido pelo utilizador. Este é o nome do campo da coluna personalizada nas tabelas de destino especificadas em destination_table_name. O nome da coluna tem de seguir os requisitos de formato para nomes de colunas do BigQuery e tem de ser exclusivo para outros campos no esquema padrão da tabela ou outras colunas personalizadas.
  • custom_floodlight_variables: especifica variáveis do Floodlight personalizadas na sua transferência. Este parâmetro aceita entradas de strings no formato de matriz JSON e pode suportar várias variáveis do Floodlight personalizadas. Em cada item da matriz JSON, os seguintes parâmetros são obrigatórios:
    • CFV_ID: o ID numérico da variável do Floodlight personalizada. Este ID é atribuído quando é criada uma variável personalizada do Floodlight no Search Ads 360.
    • CFV_FIELD_NAME: o nome exato do campo da variável do Floodlight personalizada com base no seu exemplo de utilização. Os valores suportados são conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics e raw_event_conversion_dimensions. Para mais informações, consulte o artigo Métricas do Floodlight personalizadas.
    • CFV_DESTINATION_TABLE: uma lista de tabelas do BigQuery para incluir as variáveis do Floodlight personalizadas. Quando o Serviço de transferência de dados do BigQuery obtém dados para estas tabelas, a transferência de dados inclui as variáveis personalizadas do Floodlight na consulta.
    • CFV_COLUMN_SUFFIX: o nome da coluna intuitivo definido pelo utilizador. O Serviço de transferência de dados do BigQuery anexa o sufixo após o nome do campo padrão para diferenciar as diferentes variáveis personalizadas do Floodlight. Consoante o exemplo de utilização, o Serviço de transferência de dados do BigQuery gera um nome de coluna do BigQuery da seguinte forma:

  	Variáveis personalizadas do Floodlight como métricas e segmentos	Variáveis do Floodlight personalizadas como atributos de eventos não processados no recurso de conversão
  metrics	metrics_conversion_custom_metrics_bigquery_column_name_suffix	metrics_raw_event_conversion_metrics_bigquery_column_name_suffix
  dimension	segments_conversion_custom_dimensions_bigquery_column_name_suffix	segments_raw_event_conversion_dimensions_bigquery_column_name_suffix

Aviso: não pode configurar notificações através da ferramenta de linha de comandos.

Por exemplo, o comando seguinte cria uma transferência de dados do Search Ads 360 denominada My Transfer com o ID do cliente 6828088731 e o conjunto de dados de destino mydataset. A transferência também especifica uma variável do Floodlight personalizada. A transferência de dados é criada no projeto predefinido:

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--data_source=search_ads \
--params='{"customer_id":"6828088731", "custom_floodlight_variables":"[{\"id\": \"9876\", \"cfv_field_name\": \"raw_event_conversion_metrics\", \"destination_table_name\": [\"Conversion\"],\"bigquery_column_name_suffix\": \"suffix1\" }]"}'

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.

Aviso: quando cria uma transferência de dados do Search Ads 360 através da ferramenta de linha de comandos, a configuração da transferência é feita com os valores predefinidos para Schedule (a cada 24 horas no momento da criação) e Refresh window (0, que configura a janela de atualização predefinida de 7 dias).

API

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

Acione manualmente uma transferência do Search Ads 360

Quando aciona manualmente uma transferência para o Search Ads 360, são tiradas capturas de ecrã das tabelas de correspondência 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 para as seguintes tabelas não são atualizadas:

• Conta
• Anúncio
• AdGroup
• AdGroupCriterion
• Qualquer tabela de mapeamento de IDs
• Recurso
• BidStrategy
• Campanha
• CampaignCriterion
• ConversionAction
• Palavra-chave
• NegativeAdGroupKeyword
• NegativeAdGroupCriterion
• NegativeCampaignKeyword
• NegativeCampaignCriterion
• ProductGroup

Campanhas de Máximo desempenho (MaxD)

O conetor do Search Ads 360 permite-lhe exportar dados de campanhas de desempenho máximo. Tem de selecionar a caixa de verificação Incluir dados de campanhas de PMax quando criar uma transferência de dados, uma vez que os dados de PMax 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 Search Ads 360 filtra os dados de PMax.

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

• CartDataSalesStats
• ProductAdvertised
• ProductAdvertisedDeviceStats
• ProductAdvertisedConversionActionAndDeviceStats

Apoio técnico para contas de gestor do Search Ads 360

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

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

Para os clientes existentes que têm várias transferências de dados do Search Ads 360 específicas do ID de cliente, recomendamos que mudem para uma conta de gestor do Search Ads 360. Pode fazê-lo através dos seguintes passos:

1. Configure uma única transferência de dados do Search Ads 360 ao nível da conta de gestor ou subgestor.
2. Agende um preenchimento.
3. Desative transferências do Search Ads 360 específicas do ID de cliente individual.

Para mais informações sobre as contas de gestor do Search Ads 360, consulte os artigos Acerca das contas de gestor no novo Search Ads 360 e Veja como as contas estão associadas à sua conta de gestor.

Nota: o Serviço de transferência de dados do BigQuery extrai relatórios para todos os IDs de clientes indicados, mas pode não ver IDs de clientes nos seus relatórios se não comunicar atividade para o dia pedido.

Exemplo

A lista seguinte mostra os IDs de cliente associados a determinadas contas de gestor do Search Ads 360:

• 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 Search Ads 360 no Serviço de transferência de dados do BigQuery, consulte o artigo Transformação de relatórios do Search Ads 360.

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

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

• 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) gera 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) gera 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) gera execuções de transferência de dados que incluem os seguintes IDs de clientes:

• 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 gera execuções de transferência de dados que incluem apenas o ID de cliente individual:

• 0000

Consultar os seus dados

Quando os dados são transferidos para o Serviço de transferência de dados do BigQuery, são escritos 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.

Exemplos de consultas do Search Ads 360

Pode usar as seguintes consultas de exemplo do Search Ads 360 para analisar os dados transferidos. Também pode ver as consultas numa ferramenta de visualização, como o Looker Studio.

As consultas seguintes são exemplos para começar a consultar os seus dados do Search Ads 360 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 Search Ads 360.

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.

Desempenho da campanha

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

SELECT
  c.customer_id,
  c.campaign_name,
  c.campaign_status,
  SUM(cs.metrics_clicks) AS Clicks,
  (SUM(cs.metrics_cost_micros) / 1000000) AS Cost,
  SUM(cs.metrics_impressions) AS Impressions
FROM
  `DATASET.sa_Campaign_CUSTOMER_ID` c
LEFT JOIN
  `DATASET.sa_CampaignStats_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

Substitua o seguinte:

• DATASET: o nome do conjunto de dados
• CUSTOMER_ID: o ID do cliente do Search Ads 360

Contagem de palavras-chave

A consulta de exemplo seguinte analisa as palavras-chave por campanha, grupo de anúncios e estado da palavra-chave.

  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.sa_Keyword_CUSTOMER_ID` k
    JOIN
    `DATASET.sa_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.sa_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

Substitua o seguinte:

• DATASET: o nome do conjunto de dados
• CUSTOMER_ID: o ID do cliente do Search Ads 360

Tabelas de mapeamento de IDs

As entidades no novo Search Ads 360, como clientes, campanhas e grupos de anúncios, têm um espaço de IDs diferente do Search Ads 360 antigo. Para os utilizadores da transferência do Search Ads 360 existentes que queiram combinar dados do antigo Search Ads 360 com a API Search Ads 360, podem usar o Serviço de transferência de dados do BigQuery para transferir tabelas de mapeamento de IDs se fornecerem um ID da agência e um ID do anunciante válidos na configuração da transferência.

As entidades suportadas contêm duas colunas, legacy_id e new_id, que especificam o mapeamento de IDs para entidades nas versões antiga e nova do Search Ads 360, respetivamente. Para as entidades AD, CAMPAIGN_CRITERION e CRITERION, também é fornecido um new_secondary_id, uma vez que estas entidades não têm IDs exclusivos a nível global no novo Search Ads 360. Segue-se uma lista de tabelas de mapeamento de IDs.

• IdMapping_AD
• IdMapping_AD_GROUP
• IdMapping_CAMPAIGN
• IdMapping_CAMPAIGN_CRITERION
• IdMapping_CAMPAIGN_GROUP
• IdMapping_CAMPAIGN_GROUP_PERFORMANCE_TARGET
• IdMapping_CRITERION
• IdMapping_CUSTOMER
• IdMapping_FEED_ITEM
• IdMapping_FEED_TABLE

Nota: tal como acontece com as tabelas de correspondência, os instantâneos das tabelas de mapeamento de IDs são tirados uma vez por dia e armazenados na partição para a data de execução mais recente. As tabelas de mapeamento de IDs de instantâneos não são atualizadas para preenchimentos novamente nem para dias carregados através da janela de atualização.

Consultas de exemplo

A consulta seguinte usa tabelas de mapeamento de IDs para agregar métricas por campanha em tabelas de transferências de dados do Search Ads 360 anterior e novo no novo espaço de IDs.

SELECT CustomerID, CampaignID, Sum(Clicks), Sum(Cost) FROM
(SELECT
  cs.customer_id AS CustomerID,
  cs.campaign_id AS CampaignID,
  cs.metrics_clicks AS Clicks,
  cs.metrics_cost_micros / 1000000 AS Cost
FROM
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
WHERE cs._DATA_DATE = 'NEW_DATA_DATE'
UNION ALL
SELECT
  customer_id_mapping.new_id AS CustomerID,
  campaign_id_mapping.new_id AS CampaignID,
  cs.clicks AS Clicks,
  cs.cost AS Cost
FROM
  `DATASET.CampaignStats_ADVERTISER_ID` cs
LEFT JOIN
  `DATASET.IdMapping_CUSTOMER_ADVERTISER_ID` customer_id_mapping
ON cs.accountId = customer_id_mapping.legacy_id
LEFT JOIN
  `DATASET.IdMapping_CAMPAIGN_ADVERTISER_ID` campaign_id_mapping
ON cs.campaignId = campaign_id_mapping.legacy_id
WHERE cs._DATA_DATE = 'OLD_DATA_DATE')
GROUP BY
1, 2
ORDER BY
1, 2

Substitua o seguinte:

• DATASET: o nome do conjunto de dados
• CUSTOMER_ID: o ID do cliente do Search Ads 360
• ADVERTISER_ID: o ID do anunciante do Search Ads 360
• NEW_DATA_DATE: a data dos dados da tabela do novo Search Ads 360
• OLD_DATA_DATE: a data dos dados da tabela do Search Ads 360 anterior

A seguinte consulta usa tabelas de mapeamento de IDs para agregar métricas por campanha em tabelas de transferências de dados do Search Ads 360 anterior e novo no espaço de IDs antigo.

SELECT CustomerID, CampaignID, Sum(Clicks), Sum(Cost) FROM
(SELECT
  customer_id_mapping.legacy_id AS CustomerID,
  campaign_id_mapping.legacy_id AS CampaignID,
  cs.metrics_clicks AS Clicks,
  cs.metrics_cost_micros / 1000000 AS Cost
FROM
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
LEFT JOIN
  `DATASET.IdMapping_CUSTOMER_ADVERTISER_ID` customer_id_mapping
ON cs.customer_id = customer_id_mapping.new_id
LEFT JOIN
  `DATASET.IdMapping_CAMPAIGN_ADVERTISER_ID` campaign_id_mapping
ON cs.campaign_id = campaign_id_mapping.new_id
WHERE cs._DATA_DATE = 'NEW_DATA_DATE'
UNION ALL
SELECT
  CAST(accountId AS INT) AS CustomerID,
  CAST(campaignId AS INT) AS CampaignID,
  cs.clicks AS Clicks,
  cs.cost AS Cost
FROM
  `DATASET.CampaignStats_ADVERTISER_ID` cs
WHERE cs._DATA_DATE = 'OLD_DATA_DATE')
GROUP BY
1, 2
ORDER BY
1, 2

Substitua o seguinte:

• DATASET: o nome do conjunto de dados
• CUSTOMER_ID: o ID do cliente do Search Ads 360
• ADVERTISER_ID: o ID do anunciante do Search Ads 360
• NEW_DATA_DATE: a data dos dados da tabela do novo Search Ads 360
• OLD_DATA_DATE: a data dos dados da tabela do Search Ads 360 anterior

Potenciais problemas de quota

A API Search Ads 360 Reporting atribui uma quota para o número de pedidos que o projeto Google pode enviar. Se estiver a usar um projeto para o Serviço de transferência de dados do BigQuery e outros serviços, todos os serviços partilham a mesma quota e podem potencialmente atingir o limite da quota em qualquer serviço.

Para evitar este potencial problema sem afetar os fluxos de trabalho existentes, considere estas opções:

• Use o parâmetro table_filter para carregar apenas as tabelas necessárias.

• Configure um projeto separado para o Serviço de transferência de dados do BigQuery. Uma junção de tabelas entre projetos pode ter o seguinte aspeto:

    #standardSQL
    select count(a.item1)
    from (select item1, item2 from project-A.data_set_a.table_name_a) a
    inner join
    (select item3, item4 from project-B.data_set_b.table_name_b) b
    on a.item1 = b.item3

• Contacte o apoio técnico do Search Ads 360 e peça uma quota adicional.