Migrationsanleitung für Search Ads 360
Der Search Ads 360-Connector (früher Doubleclick Search genannt) basiert auf der neuen Search Ads 360 Reporting API. Die alte Search Ads 360 Reporting API wird nicht mehr unterstützt. Daher sollten Sie Ihre BigQuery Data Transfer Service-Workflows migrieren, damit sie mit der neuen Search Ads 360 Reporting API kompatibel sind. In diesem Dokument werden die Änderungen in der neuen Search Ads 360-Version aus der alten Search Ads 360-Version beschrieben. Außerdem finden Sie hier Zuordnungsinformationen zur Migration Ihrer vorhandenen Ressourcen zur neuen Search Ads 360-Version.
Neu in Search Ads 360
Die neue Search Ads 360 Reporting API bietet mehrere Änderungen, die sich möglicherweise auf Ihre vorhandenen BigQuery Data Transfer Service-Workflows auswirken.
Kontostruktur
Die neue Search Ads 360 Reporting API organisiert Konten in einer Hierarchie von Verwaltungskonten, untergeordneten Verwaltungskonten und Kundenkonten. Weitere Informationen finden Sie unter Unterschiede in der Kontohierarchie und Informationen zu Verwaltungskonten.
ID-Bereich
Entitäten in der neuen Search Ads 360-Version haben eine andere ID-Zuordnung als die früheren Versionen von Search Ads 360. Informationen zur Zuordnung zwischen vorherigen IDs und neuen IDs finden Sie unter ID-Zuordnung.
Ressourcenbasierte Berichterstellung
Das neue Search Ads 360 API-Datenmodell verwendet ein ressourcenbasiertes Datenmodell im Gegensatz zur alten Search Ads 360 API, die ein berichtsbasiertes Datenmodell verwendet. Der neue Search Ads 360 API-Connector erstellt BigQuery-Tabellen durch Abfrage von Ressourcen in Search Ads 360. Weitere Informationen zur Ressourcenstruktur in der neuen Search Ads 360 API finden Sie unter Search Ads 360 Reporting API-Struktur.
Übertragungskonfigurationen migrieren
Es gibt keine automatisierte Methode zum Konvertieren vorhandener Search Ads 360-Übertragungskonfigurationen in die neue Search Ads 360 Reporting API. Sie müssen dann eine neue Search Ads 360-Datenübertragung mit der neuen Search Ads 360 Reporting API als Datenquelle erstellen.
Zuordnungsinformationen prüfen
Sehen Sie sich die folgenden Zuordnungsinformationen an, um Ihre vorhandenen Search Ads 360-Ressourcen der neuen Search Ads 360 Reporting API zuzuordnen.
Berichtszuordnung
Die neuen Search Ads 360-Berichte basieren auf Ressourcen und haben eine andere Struktur als Berichte der alten Search Ads 360-Version. Eine vollständige Zuordnung von alten und neuen Berichten finden Sie unter Berichtszuordnungen für die Search Ads 360 Reporting API.
In der folgenden Tabelle sind die Tabellen aufgeführt, die von BigQuery Data Transfer Service unterstützt werden, sowie die Ressourcen, die zum Generieren der Tabellen abgefragt wurden.
| Alter Bericht zu Suchanzeigen | Neue Ressource für Suchanzeigen | Neuer BigQuery-Tabellenname |
|---|---|---|
| adGroup | ad_group | p_sa_AdGroupStats_customer_id p_sa_AdGroup_customer_id p_sa_AdGroupDeviceStats_customer_id p_sa_AdGroupConversionActionAndDeviceStats_customer_id |
| Anzeige | ad_group_ad | p_sa_AdConversionActionAndDeviceStats_customer_id p_sa_AdDeviceStats_customer_id p_sa_Ad_customer_id |
| – | ad_group_asset | p_sa_AdGroupAssetStats_customer_id p_sa_AdGroupConversionActionAndAssetStats_customer_id |
| – | 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 |
| – | Asset | p_sa_Asset_customer_id |
| bidStrategy | bidding_strategy | p_sa_BidStrategy_customer_id p_sa_BidStrategyStats_customer_id |
| Kampagne | Kampagne | p_sa_CampaignConversionActionAndDeviceStats_customer_id p_sa_Campaign_customer_id p_sa_CampaignDeviceStats_customer_id p_sa_CampaignStats_customer_id |
| – | campaign_asset | p_sa_CampaignAssetStats_customer_id p_sa_CampaignConversionActionAndAssetStats_customer_id |
| – | 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 |
| konto | kunde | p_sa_Account_customer_id p_sa_AccountDeviceStats_customer_id p_sa_AccountConversionActionAndDeviceStats_customer_id p_sa_AccountStats_customer_id |
| – | customer_asset | p_sa_CustomerAssetStats_customer_id p_sa_CustomerConversionActionAndAssetStats_customer_id |
| – | customer_asset_set | p_sa_CustomerAssetSet_customer_id |
| adGroupTarget | gender_view | p_sa_GenderDeviceStats_customer_id p_sa_GenderConversionActionAndDeviceStats_customer_id |
| Suchbegriff | 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 |
Feldzuordnung
BigQuery Data Transfer Service unterstützt einen Teil der Search Ads 360-Berichtsfelder, wie unter Umwandlung von Search Ads 360-Berichten aufgeführt.
BigQuery unterstützt . nicht in Spaltennamen, sodass alle übertragenen Berichte . durch _ ersetzen. Beispielsweise wird das Feld ad_group_ad.ad.text_ad.description1 in einer Search Ads 360-Ressource als ad_group_ad_ad_text_ad_description1 an BigQuery übertragen.
ID-Zuordnung
Entitäten in der neuen Search Ads 360-Version, z. B. Kunden, Kampagnen und Anzeigengruppen, haben einen anderen ID-Bereich als die alte Search Ads 360-Version. Weitere Informationen zu ID-Zuordnungstabellen für die neue Search Ads 360-Version finden Sie unter ID-Zuordnungstabellen.
Beispiele für migrierte Abfragen
In den folgenden Beispielen wird gezeigt, wie eine BigQuery-Abfrage vor und nach der Zuordnung zur neuen Search Ads 360 Reporting API aussehen kann.
Mit der folgenden Beispielabfrage wird die Leistung von Search Ads-Kampagnen der letzten 30 Tage mithilfe der alten Search Ads 360 Reporting API analysiert.
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
Wenn sie mit der neuen Search Ads 360 Reporting API kompatibel ist, wird dieselbe Abfrage so konvertiert:
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
Weitere Beispiele für Abfragen, die mit der neuen Search Ads 360-Version kompatibel sind, finden Sie unter Beispielabfragen.
Nächste Schritte
- Informationen zum Planen und Verwalten wiederkehrender Ladejobs über Search Ads 360 finden Sie unter Search Ads 360-Übertragungen.
- Informationen zum Transformieren Ihrer Search Ads 360-Berichte finden Sie unter Umwandlung von Search Ads 360-Berichten.