Transferências do Search Ads 360

Com o serviço de transferência de dados do BigQuery para 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

Programação

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

Você pode configurar a hora do dia.

Janela de atualização

Últimos 7 dias (padrão)

Configurável para até 30 dias

Snapshots de tabelas de correspondê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 não resultam em dados duplicados, e as partições de outras datas não são afetadas.

Limitações

  • A frequência máxima para configurar uma transferência 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 do Search Ads 360:

Permissões necessárias

Verifique se o usuário que cria a transferência 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.
    • 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 do BigQuery no console do Google Cloud.

Acesse a página do BigQuery

  1. Clique em Transferências de dados.

  2. Clique em Criar transferência.

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

  4. No campo Nome de exibição da seção Transferir nome da configuração, insira um nome para a transferência, 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: 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.

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

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

  9. Opcional: insira um ID da agência e um ID do anunciante (ambos precisam ser especificados) para recuperar as tabelas de mapeamento de IDs.

  10. Opcional: 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.

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

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

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

  14. Clique em Save.

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.
  • --table_filter: especifica as tabelas a serem incluídas na transferência. Se a sinalização não for especificada, todas as tabelas serão incluídas. Para incluir apenas tabelas específicas, use uma lista de valores separados por vírgula (por exemplo, Ad, Campaign, AdGroup). Para excluir tabelas específicas, prefixe os valores com um hífen (-) (por exemplo, -Ad, Campaign, AdGroup).
  • --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 \
--params='parameters' \
--data_source=data_source \
--service_account_name=service_account_name

Em que:

  • project_id: o ID do projeto.
  • dataset: o conjunto de dados de destino na configuração da transferência.
  • name: o nome de exibição da configuração de transferência. O nome da transferência pode ser qualquer valor que permita identificá-la facilmente, caso precise modificá-la mais tarde.
  • 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.
  • data_source: a fonte de dados — search_ads.
  • service_account_name é o nome da conta de serviço usado para autenticar a transferência. 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.

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

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

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
  • Campaign
  • 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 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 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 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 da conta de administrador raiz (ID de cliente 1234567890) gera execuções de transferência que incluem os seguintes IDs de cliente:

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

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

Uma configuração de transferência da conta de subadministrador 123 (ID de cliente 1234) 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 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 da conta de subadministrador 89 (ID de cliente 89) gera execuções de transferência que incluem os seguintes IDs de cliente:

  • 8888
  • 9999

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

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

  • 0000

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