Transferências do Search Ads 360

Com o serviço de transferência de dados do BigQuery para o conector do Search Ads 360, é possível programar e gerenciar automaticamente jobs de carregamento recorrentes relacionados a dados de relatórios do Search Ads 360.

Relatórios compatíveis

O serviço de transferência de dados do BigQuery para Search Ads 360 é compatível com a API Reporting v0 do Search Ads 360:

Para saber como os relatórios do Search Ads 360 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 Search Ads 360.

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

v0
Repetir frequência

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

Você pode configurar a hora do dia.
Atualizar janela

Últimos 7 dias (padrão)

Configurável para até 30 dias

Snapshots de tabelas de correspondência 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 quanto a preenchimentos ou dias carregados por meio da janela de atualização.
Duração máxima do preenchimento

Sem limite
Número de IDs de cliente por conta de administrador

2.000

O serviço de transferência de dados do BigQuery aceita até 2.000 IDs de cliente para cada conta de administrador do Search Ads 360.

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

Ingestão de dados das transferências do Search Ads 360

Quando você transfere dados do Search Ads 360 para o BigQuery, eles são carregados em tabelas do BigQuery particionadas por data. A partição da tabela em que os dados são carregados corresponde à data da fonte de dados. Se você programar várias transferências para a mesma data, o serviço de transferência de dados do BigQuery substituirá a partição dessa data específica pelos dados mais recentes. Várias transferências no mesmo dia ou preenchimentos não resultam em dados duplicados, e as partições de outras datas não são afetadas.

Atualizar janelas

Uma janela de atualização é o número de dias que uma transferência de dados recupera dados quando ocorre uma transferência de dados. Por exemplo, se a janela de atualização for de três dias e uma transferência diária ocorrer, o serviço de transferência de dados do BigQuery vai extrair todos os dados da tabela de origem dos últimos três dias. Nesse exemplo, quando uma transferência diária ocorre, o serviço de transferência de dados do BigQuery cria uma nova partição de tabela de destino do BigQuery com uma cópia dos dados da tabela de origem do dia atual e, em seguida, aciona automaticamente as execuções de preenchimento para atualizar as partições de 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 vão substituir ou atualizar de forma incremental a tabela de destino do BigQuery, dependendo de se as atualizações incrementais são aceitas ou não pelo conector do serviço de transferência de dados do BigQuery.

Quando você executa uma transferência de dados pela primeira vez, ela recupera 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 você executar a transferência de dados pela primeira vez, o serviço de transferência de dados do BigQuery vai recuperar todos os dados de origem em três dias.

As janelas de atualização são mapeadas para o campo da APITransferConfig.data_refresh_window_days.

Para recuperar dados fora da janela de atualização, como dados históricos, ou para recuperar dados de interrupções ou lacunas de transferência, inicie ou programe uma execução de preenchimento.

Limitações

  • A frequência máxima para configurar uma transferência de dados do Search Ads 360 é de uma vez a cada 24 horas. Por padrão, uma transferência começa no momento em que você cria a transferência. No entanto, é possível configurar o horário de início da transferência ao criar sua transferência.
  • O serviço de transferência de dados do BigQuery não é compatível com transferências incrementais durante uma transferência do Search Ads 360. Ao especificar 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:

Permissões necessárias

Verifique se o usuário que está criando a transferência de dados tem as seguintes permissões necessárias:

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

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

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

  • Google Cloud:

    • Permissões serviceusage.services.use para fazer o download de dados do Search Ads 360 no projeto.

    Os papéis do IAM predefinidos editor, owner e serviceusage.serviceUsageConsumer incluem as permissões serviceusage.services.use. Para mais informações sobre papéis do IAM no Service Usage, consulte Referência de controle de acesso.

  • Search Ads 360:

    • Acesso de leitura ao ID de cliente do Search Ads 360 ou à conta de administrador usada na configuração de transferência.

Criar uma transferência de dados do Search Ads 360

Para criar uma transferência de dados para os relatórios do Search Ads 360, você precisa do ID de cliente da ferramenta ou da conta de administrador. Selecione uma das seguintes opções:

Console

  1. Acesse a página "Transferências de dados" no console do Google Cloud.

    Acesse Transferências de dados

  2. Clique em Criar transferência.

  3. Na seção Tipo de origem, em Origem, escolha Search Ads 360.

  4. No campo Nome de exibição da seção Transferir nome da configuração, insira um nome para a transferência de dados, como My Transfer. O nome da transferência pode ser qualquer valor que permita identificá-la, caso você precise modificá-la mais tarde.

  5. Na seção Opções de programação, faça o seguinte:

    • Em Frequência de repetição, escolha uma opção para a frequência de execução da transferência de dados: Se você selecionar Dias, forneça um horário válido em UTC.
      • Horas
      • Dias
      • Sob demanda
    • Se aplicável, selecione Começar agora ou Começar no horário definido e forneça uma data de início e um horário de execução.

  6. Na seção Configurações de destino, em Conjunto de dados, selecione o conjunto de dados que você criou para armazenar seus dados.

    1. Na seção Detalhes da fonte de dados:

    2. Em ID de cliente, insira o ID do Search Ads 360:

    3. Opcional: insira um ID da agência e um ID do anunciante para recuperar as tabelas de mapeamento de IDs.

    4. Opcional: no campo Variáveis personalizadas do Floodlight, insira as variáveis personalizadas do Floodlight para incluir na transferência de dados. As variáveis personalizadas do Floodlight precisam ser de propriedade da conta do Search Ads 360 especificada pelo ID de cliente na configuração de transferência. Esse parâmetro usa entradas de string no formato de matriz JSON e é compatível com diversas variáveis personalizadas do Floodlight. Em cada item da matriz JSON, os seguintes parâmetros são obrigatórios:

      • id: o ID numérico da variável personalizada do Floodlight. Esse ID é atribuído quando uma variável personalizada do Floodlight é criada no Search Ads 360. Se você especificou um id, um name não é obrigatório.
      • name: o nome definido pelo usuário das variáveis personalizadas do Floodlight no Search Ads 360. Se você especificou um name, um id não é necessário.
      • cfv_field_name: o nome exato do campo da variável personalizada do Floodlight com base no seu caso de uso. Os valores compatíveis são conversion_custom_metrics, conversion_custom_dimensionsraw_event_conversion_metrics e raw_event_conversion_dimensions.
      • destination_table_name: uma lista de tabelas do BigQuery em que as variáveis personalizadas do Floodlight serão incluídas. Quando o serviço de transferência de dados do BigQuery recupera dados dessas tabelas, a transferência inclui as variáveis personalizadas do Floodlight na consulta.

      • bigquery_column_name_suffix: o nome da coluna amigável definido pelo usuário. O serviço de transferência de dados do BigQuery anexa o sufixo após o nome do campo padrão para diferenciar variáveis personalizadas do Floodlight. Dependendo do caso de uso, o serviço de transferência de dados do BigQuery gera um nome de coluna do BigQuery da seguinte maneira:

        Variáveis personalizadas do Floodlight como métricas e segmentos Variáveis personalizadas do Floodlight como atributos brutos de evento 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

      Veja a seguir um exemplo de entrada de variável personalizada do Floodlight que especifica duas variáveis personalizadas do Floodlight:

      [{
  "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"
}]

    5. Opcional: no campo Colunas personalizadas, insira qualquer coluna personalizada a ser incluída na transferência de dados. As colunas personalizadas precisam ser de propriedade da conta do Search Ads 360 especificada pelo ID de cliente na configuração de transferência. Esse campo recebe entradas de string no formato de matriz JSON e pode aceitar várias colunas. Em cada item da matriz JSON, os seguintes parâmetros são obrigatórios:

      • id: o ID numérico da coluna personalizada. Esse ID é atribuído quando uma coluna personalizada é criada. Se você especificou um id, um name não é obrigatório.
      • name: o nome definido pelo usuário da coluna personalizada no Search Ads 360. Se você especificou um name, um id não é necessário.
      • destination_table_name: uma lista de tabelas do BigQuery em que a coluna personalizada será incluída. Quando o serviço de transferência de dados do BigQuery recupera os dados dessas tabelas, a transferência inclui o campo de coluna personalizada na consulta.
      • bigquery_column_name: o nome da coluna amigável definido pelo usuário. Esse é o nome do campo da coluna personalizada nas tabelas de destino especificadas em destination_table_name. O nome da coluna precisa seguir os requisitos de formato de nomes de coluna do BigQuery e ser exclusivo para outros campos no esquema padrão da tabela ou outros colunas personalizadas.

      Veja a seguir um exemplo de 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"
  }]

    6. Opcional: no campo Filtro de tabela, insira uma lista de tabelas separadas por vírgulas para incluir, por exemplo, Campaign, AdGroup. Adicione o caractere - como prefixo para excluir determinadas tabelas, por exemplo, -Campaign, AdGroup. Todas as tabelas são incluídas por padrão.

    7. Opcional: em Período de atualização, insira um valor entre 1 e 30. Se não for definido, a janela de atualização será definida como sete dias por padrão.

  7. No menu Conta de serviço, selecione uma conta de serviço nas contas de serviço associadas ao seu projeto do Google Cloud. É possível associar uma conta de serviço à transferência em vez de usar suas credenciais de usuário. Para mais informações sobre o uso de contas de serviço com transferências de dados, consulte Usar contas de serviço.

  8. 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 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 seu tópico ou clique em Criar um tópico. Essa opção configura notificações de execução do Pub/Sub da sua transferência.

  9. Clique em Salvar.

bq

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

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

As sinalizações a seguir são opcionais:

  • --project_id: especifica qual projeto usar. Se a sinalização não for especificada, o projeto padrão será usado.
  • --service_account_name: especifica uma conta de serviço a ser usada para a autenticação de transferência do Search Ads 360 em vez da sua conta de usuário.
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\"}]"}'

Em que:

  • PROJECT_ID (opcional): especifica qual projeto usar. Se a sinalização não for especificada, o projeto padrão será usado.
  • DATASET: o conjunto de dados de destino na configuração da transferência.

  • NAME: o nome de exibição da configuração de transferência. O nome da transferência de dados pode ser qualquer valor que permita identificá-la, caso você precise modificá-la depois.

  • DATA_SOURCE: a fonte 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 precisa pertencer ao mesmo project_id usado para criar a transferência e ter todas as permissões necessárias.

  • PARAMETERS é o parâmetro da configuração de transferência criada no formato JSON. Por exemplo, --params='{"param":"param_value"}'. É necessário fornecer o parâmetro customer_id.

    • table_filter: especifica as tabelas a serem incluídas na transferência de dados. Se a sinalização não for especificada, todas as tabelas serão incluídas. Para incluir apenas tabelas específicas, use uma lista separada de valores separados por vírgulas (por exemplo, Ad, Campaign, AdGroup). Para excluir tabelas específicas, prefixe os valores excluídos com um hífen (-). Por exemplo, o uso de -Ad, Campaign, AdGroup exclui os três valores.
    • custom_columns: especifica colunas personalizadas para seus relatórios. Esse parâmetro recebe entradas de string no formato de matriz JSON e pode aceitar várias colunas. Em cada item da matriz JSON, os seguintes parâmetros são necessários:
      • CC_ID: o ID numérico da coluna personalizada. Esse ID é atribuído quando uma coluna personalizada é criada.
      • CC_DESTINATION_TABLE: uma lista de tabelas do BigQuery em que a coluna personalizada será incluída. Quando o serviço de transferência de dados do BigQuery recupera os dados dessas tabelas, a transferência inclui o campo de coluna personalizada na consulta.
      • CC_COLUMN: o nome da coluna amigável definido pelo usuário. Esse é o nome do campo da coluna personalizada nas tabelas de destino especificadas em destination_table_name. O nome da coluna precisa seguir os requisitos de formato dos nomes das colunas do BigQuery e ser exclusivo para outros campos no esquema padrão da tabela ou outras colunas personalizadas.
    • custom_floodlight_variables: especifica variáveis personalizadas do Floodlight na transferência. Esse parâmetro usa entradas de string no formato de matriz JSON e é compatível com diversas variáveis personalizadas do Floodlight. Em cada item da matriz JSON, os seguintes parâmetros são necessários:
      • CFV_ID: o ID numérico da variável personalizada do Floodlight. Esse ID é atribuído quando uma variável personalizada do Floodlight é criada no Search Ads 360.
      • CFV_FIELD_NAME: o nome exato do campo da variável personalizada do Floodlight com base no seu caso de uso. Os valores compatíveis são conversion_custom_metrics, conversion_custom_dimensionsraw_event_conversion_metrics e raw_event_conversion_dimensions. Para mais informações, consulte Métricas personalizadas do Floodlight.
      • CFV_DESTINATION_TABLE: uma lista de tabelas do BigQuery em que as variáveis personalizadas do Floodlight serão incluídas. Quando o serviço de transferência de dados do BigQuery recupera os dados dessas tabelas, a transferência inclui as variáveis personalizadas do Floodlight na consulta.
      • CFV_COLUMN_SUFFIX: o nome da coluna amigável definido pelo usuário. O serviço de transferência de dados do BigQuery anexa o sufixo após o nome do campo padrão para diferenciar as variáveis personalizadas do Floodlight. Dependendo do caso de uso, o serviço de transferência de dados do BigQuery gera um nome de coluna do BigQuery da seguinte maneira:
    Variáveis personalizadas do Floodlight como métricas e segmentos Variáveis personalizadas do Floodlight como atributos brutos de evento 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

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

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\" }]"}'

Ao executar o comando pela primeira vez, você recebe 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.

Acionar manualmente uma transferência do Search Ads 360

Quando você aciona manualmente uma transferência do Search Ads 360, os snapshots das tabelas de correspondência são criados uma vez por dia e armazenados na partição da última data de execução. Quando você aciona uma transferência manual, os snapshots da tabela de correspondências para as tabelas a seguir não são atualizados:

  • Conta
  • Anúncio
  • AdGroup
  • AdGroupCriterion
  • Qualquer tabela de mapeamento de IDs
  • Recurso
  • BidStrategy
  • Campanha
  • CampaignCriterion
  • ConversionAction
  • Palavra-chave
  • NegativeAdGroupKeyword
  • NegativeAdGroupCriterion
  • NegativeCampaignKeyword
  • NegativeCampaignCritrion
  • Grupo do produto

Suporte para contas de administrador do Search Ads 360

O uso de contas de administrador do Search Ads 360 oferece vários benefícios em comparação com o uso de IDs de cliente individuais:

  • Você não precisa gerenciar várias transferências de dados para gerar relatórios sobre vários IDs de cliente.
  • As consultas entre clientes são mais simples de escrever porque todos os IDs de cliente são armazenados na mesma tabela.
  • O uso de contas de administrador 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.

No caso dos clientes atuais que têm várias transferências de dados do Search Ads 360 com um ID de cliente específico, recomendamos mudar para uma conta de administrador do Search Ads 360. Para isso, siga estas etapas:

  1. Configure uma única transferência de dados do Search Ads 360 no nível da conta de administrador ou subadministrador.
  2. Programar um preenchimento.
  3. Desative as transferências do Search Ads 360 específicas do ID de cliente individual.

Para mais informações sobre as contas de administrador do Search Ads 360, consulte Sobre as contas de administrador no novo Search Ads 360 e Ver como as contas são vinculadas à sua conta de administrador.

Exemplo

A lista a seguir mostra os IDs de cliente vinculados a determinadas contas de administrador do Search Ads 360:

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

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

Uma configuração de transferência de dados 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 de dados da conta de subadministrador 123 (ID de cliente 1234) gerar 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 de dados da conta de subadministrador 567 (ID de cliente 567) gerar 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 de dados 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 de dados do ID de cliente 0000 gera execuções de transferência que incluem apenas o ID de cliente individual:

  • 0000

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 a tabelas particionadas.

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

Consultas de amostra do Search Ads 360

Use as consultas de amostra do Search Ads 360 a seguir para analisar os dados transferidos. Também é possível ver as consultas em uma ferramenta de visualização, como o Looker Studio.

As consultas a seguir são exemplos para começar a consultar seus dados do Search Ads 360 com o serviço de transferência de dados do BigQuery. Se tiver outras dúvidas sobre o que é possível fazer com esses relatórios, entre em contato com o representante técnico do Search Ads 360.

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

Desempenho da campanha

O exemplo de consulta a seguir 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:

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

Contagem de palavras-chave

Na consulta de amostra a seguir, analisamos as palavras-chave por campanha, grupo de anúncios e status 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:

  • DATASET: o nome do conjunto de dados
  • CUSTOMER_ID: o ID de 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 ID diferente do antigo. No caso de usuários para transferência do Search Ads 360 que querem combinar dados do antigo Search Ads 360 com a nova API, use o serviço de transferência de dados do BigQuery para transferir tabelas de mapeamento de IDs caso você forneça um ID da agência e do anunciante válidos na configuração da transferência.

As entidades compatíveis 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, respectivamente. Um new_secondary_id também é fornecido para as entidades AD, CAMPAIGN_CRITÉRIO e CRITÉRIO, porque essas entidades não têm códigos exclusivos globalmente no novo Search Ads 360. Esta é 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

Exemplo de consultas

A consulta a seguir usa tabelas de mapeamento de IDs para agregar métricas por campanha em tabelas de transferências de dados anteriores e novas do Search Ads 360 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:

  • DATASET: o nome do conjunto de dados
  • CUSTOMER_ID: o ID de 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 anterior do Search Ads 360.

A consulta a seguir usa tabelas de mapeamento de IDs para agregar métricas por campanha em tabelas de transferências de dados anteriores e novas do Search Ads 360 no espaço dos IDs antigos.

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:

  • DATASET: o nome do conjunto de dados
  • CUSTOMER_ID: o ID de 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 anterior do Search Ads 360.

Possíveis problemas de cota

A API de relatórios do Search Ads 360 atribui uma cota diária para o número de solicitações que o projeto do Google pode enviar. Se você usa um projeto para o serviço de transferência de dados do BigQuery e outros, todos eles compartilham a mesma cota e podem atingir o limite em qualquer serviço.

Para evitar esse possível problema sem afetar os fluxos de trabalho atuais, considere estas opções:

  • Configure um projeto separado para o serviço de transferência de dados do BigQuery. Uma mesclagem de tabela entre projetos pode ter a seguinte aparência: 

      #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

  • Entre em contato com o suporte do Search Ads 360 e solicite mais cota.