Guia de migração do Search Ads 360

O conetor do Search Ads 360 (anteriormente conhecido como DoubleClick Search) baseia-se na nova API Google Search Ads 360 Reporting. A antiga API Search Ads 360 Reporting já não é suportada, pelo que deve migrar os seus fluxos de trabalho do Serviço de transferência de dados do BigQuery para serem compatíveis com a nova API Search Ads 360 Reporting. Este documento mostra as alterações do novo Search Ads 360 em relação ao Search Ads 360 antigo e fornece informações de mapeamento para migrar os seus recursos existentes para o novo Search Ads 360.

Quais são as novidades do Search Ads 360

A nova API Search Ads 360 Reporting oferece várias alterações que podem afetar os seus fluxos de trabalho do Serviço de transferência de dados do BigQuery existentes.

Estrutura da conta

A API Google Search Ads 360 Reporting organiza as contas numa hierarquia de contas de gestor, contas de subgestor e contas de cliente. Para mais informações, consulte o artigo Diferenças na hierarquia de contas e o artigo Acerca das contas de gestor.

Espaço de ID

As entidades no novo Search Ads 360 têm um mapeamento de espaço de IDs diferente das versões anteriores do Search Ads 360. Para obter informações acerca do mapeamento entre IDs anteriores e novos, consulte o artigo Mapeamento de IDs.

Relatórios baseados em recursos

O modelo de dados da nova API Search Ads 360 usa um modelo de dados baseado em recursos, ao contrário da API Search Ads 360 antiga, que usa um modelo de dados baseado em relatórios. O conetor da API do novo Search Ads 360 cria tabelas do BigQuery consultando recursos no Search Ads 360. Para mais informações sobre a estrutura dos recursos na API Search Ads 360, consulte o artigo Estrutura da API Google Search Ads 360 Reporting.

Migre configurações de transferência

Não existe um método automático para converter as configurações de transferência do Search Ads 360 existentes para a nova API Google Ads Reporting. Tem de criar uma nova transferência de dados do Search Ads 360 com a nova API Google Search Ads 360 Reporting como origem de dados.

Reveja as informações de mapeamento

Reveja as seguintes informações de mapeamento para mapear os recursos do Search Ads 360 existentes para a API Google Search Ads 360 Reporting.

Mapeamento de relatórios

Os relatórios do novo Search Ads 360 baseiam-se em recursos e têm uma estrutura diferente dos relatórios do Search Ads 360 antigo. Para um mapeamento completo dos relatórios antigos e novos, consulte o artigo Mapeamentos de relatórios para a API Search Ads 360 Reporting.

A tabela seguinte indica as tabelas suportadas pelo Serviço de transferência de dados do BigQuery, juntamente com os recursos consultados para gerar as tabelas.

Relatório do Search Ads antigo Recurso de anúncios de pesquisa novos Nome da nova tabela do BigQuery
adGroup ad_group p_sa_AdGroupStats_customer_id
p_sa_AdGroup_customer_id
p_sa_AdGroupDeviceStats_customer_id
p_sa_AdGroupConversionActionAndDeviceStats_customer_id
anúncio ad_group_ad p_sa_AdConversionActionAndDeviceStats_customer_id
p_sa_AdDeviceStats_customer_id
p_sa_Ad_customer_id
N/A ad_group_asset p_sa_AdGroupAssetStats_customer_id
p_sa_AdGroupConversionActionAndAssetStats_customer_id
N/A ad_group_asset_set p_sa_AdGroupAssetSet_customer_id
adGroupTarget ad_group_audience_view p_sa_AdGroupAudienceDeviceStats_customer_id
p_sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
adGroupTarget ad_group_criterion p_sa_NegativeAdGroupCriterion_customer_id
p_sa_NegativeAdGroupKeyword_customer_id
p_sa_AdGroupCriterion_customer_id
adGroupTarget age_range_view p_sa_AgeRangeDeviceStats_customer_id
p_sa_AgeRangeConversionActionAndDeviceStats_customer_id
N/A asset p_sa_Asset_customer_id
bidStrategy bidding_strategy p_sa_BidStrategy_customer_id
p_sa_BidStrategyStats_customer_id
campanha campanha p_sa_CampaignConversionActionAndDeviceStats_customer_id
p_sa_Campaign_customer_id
p_sa_CampaignDeviceStats_customer_id
p_sa_CampaignStats_customer_id
N/A campaign_asset p_sa_CampaignAssetStats_customer_id
p_sa_CampaignConversionActionAndAssetStats_customer_id
N/A campaign_asset_set p_sa_CampaignAssetSet_customer_id
campaignTarget campaign_audience_view p_sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
p_sa_CampaignAudienceDeviceStats_customer_id
campaignTarget campaign_criterion p_sa_CampaignCriterion_customer_id
p_sa_NegativeCampaignKeyword_customer_id
p_sa_NegativeCampaignCriterion_customer_id
productLeadAndCrossSell cart_data_sales_view p_sa_CartDataSalesStats_customer_id
conversão conversão p_sa_Conversion_customer_id
floodlightActivity conversion_action p_sa_ConversionAction_customer_id
conta cliente p_sa_Account_customer_id
p_sa_AccountDeviceStats_customer_id
p_sa_AccountConversionActionAndDeviceStats_customer_id
p_sa_AccountStats_customer_id
N/A customer_asset p_sa_CustomerAssetStats_customer_id
p_sa_CustomerConversionActionAndAssetStats_customer_id
N/A customer_asset_set p_sa_CustomerAssetSet_customer_id
adGroupTarget gender_view p_sa_GenderDeviceStats_customer_id
p_sa_GenderConversionActionAndDeviceStats_customer_id
palavra-chave keyword_view p_sa_Keyword_customer_id
p_sa_KeywordDeviceStats_customer_id
p_sa_KeywordStats_customer_id
p_sa_KeywordConversionActionAndDeviceStats_customer_id
adGroupTarget location_view p_sa_LocationDeviceStats_customer_id
p_sa_LocationConversionActionAndDeviceStats_customer_id
productAdvertised shopping_performance_view p_sa_ProductAdvertised_customer_id
p_sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
p_sa_ProductAdvertisedDeviceStats_customer_id
productGroup product_group_view p_sa_ProductGroupStats_customer_id
<0x0Ap_sa_ProductGroup_customer_id
visitar visitar p_sa_Visit_customer_id
adGroupTarget webpage_view p_sa_WebpageDeviceStats_customer_id
p_sa_WebpageConversionActionAndDeviceStats_customer_id

Mapeamento de campos

O Serviço de transferência de dados do BigQuery suporta um subconjunto de campos de relatórios do Search Ads 360, conforme indicado na transformação de relatórios do Search Ads 360. O BigQuery não suporta . nos nomes das colunas, pelo que todos os relatórios transferidos substituem . por _. Por exemplo, o campo ad_group_ad.ad.text_ad.description1 num recurso do Search Ads 360 é transferido para o BigQuery como ad_group_ad_ad_text_ad_description1.

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 antigo Search Ads 360. Para mais informações acerca das tabelas de mapeamento de IDs para o novo Search Ads 360, consulte o artigo Tabelas de mapeamento de IDs.

Exemplos de consultas migradas

Os exemplos seguintes demonstram o aspeto de uma consulta do BigQuery antes e depois de ser mapeada para a nova API Google Ads Reporting.

Considere o seguinte exemplo de consulta que analisa o desempenho da campanha de anúncios de pesquisa dos últimos 30 dias através da API Google Ads Reporting antiga.

SELECT
  c.accountId,
  c.campaign,
  C.status,
  SUM(cs.impr) AS Impressions,
  SUM(cs.clicks) AS Clicks,
  (SUM(cs.cost) / 1000000) AS Cost
FROM
  `previous_dataset.Campaign_advertiser_id` c
LEFT JOIN
  `previous_dataset.CampaignStats_advertiser_id` cs
ON
  (c.campaignId = cs.campaignId
  AND cs._DATA_DATE BETWEEN
  DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
WHERE
  c._DATA_DATE = c._LATEST_DATE
GROUP BY
  1, 2, 3
ORDER BY
  Impressions DESC

Quando mapeada para ser compatível com a API de relatórios do novo Search Ads 360, a mesma consulta é convertida no seguinte:

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

Para ver mais exemplos de consultas compatíveis com o novo Search Ads 360, consulte Consultas de exemplo.

O que se segue?