Guia de migração do Search Ads 360

O conector do Search Ads 360 (anteriormente conhecido como Doubleclick Search) depende da nova API Search Ads 360 Reporting. A API Search Ads 360 Reporting antiga não é mais compatível. Por isso, migre os fluxos de trabalho do serviço de transferência de dados do BigQuery para que sejam compatíveis com a nova API Search Ads 360 Reporting. Neste documento, mostramos as diferenças entre o novo Search Ads 360 e a versão antiga, além de informações de mapeamento para você migrar seus recursos para a versão nova.

O que há de novo no Search Ads 360

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

Estrutura da conta

A nova API Search Ads 360 Reporting organiza as contas em uma hierarquia de contas de administrador, de subadministrador e de cliente. Para mais informações, consulte Diferenças da hierarquia de contas e Sobre as contas de administrador.

Espaço de ID

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

Relatórios com base em recursos

O novo modelo de dados da API Search Ads 360 usa um modelo de dados com base em recursos, ao contrário da API antiga, que usa um modelo de dados baseado em relatórios. O novo conector da API Search Ads 360 cria tabelas do BigQuery consultando recursos no Search Ads 360. Para saber mais sobre a estrutura de recursos na nova API Search Ads 360, consulte Estrutura da API Search Ads 360 Reporting.

Migrar configurações de transferência

Não há um método automatizado para converter as configurações de transferência atuais do Search Ads 360 para a nova API Search Ads 360 Reporting. É necessário criar uma nova transferência de dados do Search Ads 360 com a nova API Search Ads 360 Reporting como a fonte de dados.

Revise as informações de mapeamento

Confira as informações de mapeamento a seguir para mapear seus recursos do Search Ads 360 atuais para a nova API Search Ads 360 Reporting.

Mapeamento de relatórios

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

Veja na tabela a seguir as tabelas compatíveis com o serviço de transferência de dados do BigQuery e os recursos consultados para gerar as tabelas.

Relatório antigo de anúncios de pesquisa Novo recurso de anúncios de pesquisa Novo nome da 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
ad 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 recurso p_sa_Asset_customer_id
bidStrategy bidding_strategy p_sa_BidStrategy_customer_id
p_sa_BidStrategyStats_customer_id
campaign campaign 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
conversion conversion 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
p_sa_ProductGroup_customer_id
visit visit p_sa_Visit_customer_id
adGroupTarget webpage_view p_sa_WebpageDeviceStats_customer_id
p_sa_WebpageConversionActionAndDeviceStats_customer_id

Mapeamento de campo

O serviço de transferência de dados do BigQuery é compatível com um subconjunto de campos de relatório do Search Ads 360, conforme listado em Transformação de relatórios do Search Ads 360. O BigQuery não é compatível com . em nomes de colunas, portanto, todos os relatórios transferidos substituem . por _. Por exemplo, o campo ad_group_ad.ad.text_ad.description1 em um recurso do Search Ads 360 é transferido para o BigQuery como ad_group_ad_ad_text_ad_description1.

Mapeamento de ID

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. Para mais informações sobre as tabelas de mapeamento de IDs do novo Search Ads 360, consulte Tabelas de mapeamento de IDs.

Exemplos de consultas migradas

Veja nos exemplos a seguir como pode ficar uma consulta do BigQuery antes e depois do mapeamento para a nova API Search Ads 360 Reporting.

Considere o exemplo de consulta a seguir, que analisa o desempenho da campanha do Search ADs dos últimos 30 dias usando a antiga API Search Ads 360 Reporting.

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 compatibilidade com a nova API Search Ads 360 Reporting, a mesma consulta será convertida no seguinte formato:

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 mais exemplos de consultas compatíveis com o novo Search Ads 360, consulte Exemplos de consultas.

A seguir