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 |
| Non disponible | ad_group_asset | p_sa_AdGroupAssetStats_customer_id p_sa_AdGroupConversionActionAndAssetStats_customer_id |
| Non disponible | 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 |
| Non disponible | 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 |
| Non disponible | campaign_asset | p_sa_CampaignAssetStats_customer_id p_sa_CampaignConversionActionAndAssetStats_customer_id |
| Non disponible | 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 |
| Non disponible | customer_asset | p_sa_CustomerAssetStats_customer_id p_sa_CustomerConversionActionAndAssetStats_customer_id |
| Non disponible | 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
- Consultez la page Transferts Search Ads 360 pour apprendre à planifier et à gérer des jobs de chargement récurrents à partir de Search Ads 360.
- Consultez la page Transformation des rapports Search Ads 360 pour savoir comment transformer vos rapports Search Ads 360.