Guide de migration Search Ads 360

Le connecteur Search Ads 360 (anciennement Doubleclick Search) repose sur la nouvelle API Search Ads 360 Reporting. L'ancienne API de création de rapports Search Ads 360 n'est plus acceptée. Vous devez donc migrer vos workflows du service de transfert de données BigQuery pour qu'ils soient compatibles avec la nouvelle API Search Ads 360 Reporting. Ce document présente les modifications apportées à la nouvelle interface Search Ads 360 par rapport à l'ancienne, et fournit des informations de mappage pour migrer vos ressources existantes vers la nouvelle interface Search Ads 360.

Nouveautés de Search Ads 360

La nouvelle API Search Ads 360 Reporting propose plusieurs modifications susceptibles d'affecter vos workflows existants du service de transfert de données BigQuery.

Structure du compte

La nouvelle API Search Ads 360 Reporting organise les comptes dans une hiérarchie de comptes administrateur, de comptes administrateur secondaire et de comptes client. Pour en savoir plus, consultez les sections Différences au niveau de la hiérarchie des comptes et À propos des comptes administrateur.

Espace d'ID

Les entités de la nouvelle interface Search Ads 360 adoptent un mappage d'espace d'ID différent de celui des versions précédentes de Search Ads 360. Pour en savoir plus sur le mappage entre les anciens ID et les nouveaux, consultez la section Mappage d'ID.

Création de rapports basés sur les ressources

Le modèle de données de la nouvelle API Search Ads 360 utilise un modèle de données basé sur des ressources, contrairement à l'ancienne API Search Ads 360 qui utilisait un modèle de données basé sur des rapports. Le connecteur de la nouvelle API Search Ads 360 crée des tables BigQuery en interrogeant des ressources dans Search Ads 360. Pour en savoir plus sur la structure des ressources dans la nouvelle API Search Ads 360, consultez la page Structure de l'API Search Ads 360 Reporting.

Migrer des configurations de transfert

Il n'existe aucune méthode automatisée pour convertir les configurations de transfert Search Ads 360 existantes vers la nouvelle API Search Ads 360 Reporting. Vous devez créer un transfert de données vers la nouvelle interface Search Ads 360, avec la nouvelle API Search Ads 360 Reporting comme source de données.

Examiner les informations de mappage

Consultez les informations de mappage suivantes pour mapper vos ressources Search Ads 360 existantes sur la nouvelle API Search Ads 360 Reporting.

Mappage de rapport

Les rapports de la nouvelle interface Search Ads 360 sont basés sur des ressources et présentent une structure différente de celle des rapports de l'ancienne interface Search Ads 360. Pour en savoir plus sur le mappage des anciens et des nouveaux rapports, consultez la section Mappages de rapports pour l'API Search Ads 360 Reporting.

Le tableau suivant liste les tables compatibles avecle service de transfert de données BigQuery, ainsi que les ressources interrogées pour générer les tables.

Ancien rapport Search Ads Nouvelle ressource Search Ads Nom de la nouvelle table BigQuery
adGroup ad_group p_sa_AdGroupStats_customer_id
p_sa_AdGroup_customer_id
p_sa_AdGroupDeviceStats_customer_id
p_sa_AdGroupConversionActionAndDeviceStats_customer_id
annonce 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 composant 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
compte grand public 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
mot clé 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

Mappage de champ

Le service de transfert de données BigQuery accepte un sous-ensemble de champs de rapport Search Ads 360, comme indiqué dans la section Transformation des rapports Search Ads 360. Comme BigQuery n'accepte pas le caractère . dans les noms de colonnes, ce caractère . est remplacé par _ dans tous les rapports transférés. Par exemple, le champ ad_group_ad.ad.text_ad.description1 d'une ressource Search Ads 360 va être transféré vers BigQuery sous cette forme : ad_group_ad_ad_text_ad_description1.

Mappage d'ID

Les entités de la nouvelle interface Search Ads 360, telles que les clients, les campagnes et les groupes d'annonces, disposent d'un espace d'ID différent de celui de l'ancienne interface Search Ads 360. Pour en savoir plus sur les tables de mappage d'ID pour la nouvelle interface Search Ads 360, consultez la section Tables de mappage d'ID.

Exemples de requêtes migrées

Les exemples suivants montrent à quoi peut ressembler une requête BigQuery, avant et après son mappage avec la nouvelle API Search Ads 360 Reporting.

Prenons l'exemple suivant, qui analyse les performances des campagnes Search Ads au cours des 30 derniers jours avec l'ancienne API de création de rapports Search Ads 360.

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

Lors du mappage de la requête, de sorte que celle-ci soit compatible avec la nouvelle API Search Ads 360 Reporting, elle va être convertie comme suit :

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

Pour plus d'exemples de requêtes compatibles avec la nouvelle interface Search Ads 360, consultez la section Exemples de requêtes.

Étapes suivantes