Leitfaden zur Aktualisierung von Google Ads

Der BigQuery Data Transfer Service für Google Ads wird regelmäßig aktualisiert, um neue Spalten zu unterstützen und an Änderungen anzupassen, die durch neue Google Ads API-Versionen eingeführt werden. Der BigQuery Data Transfer Service für Google Ads-Connector verwendet die unterstützte API-Version im Google Ads-Connector. In diesem Dokument werden die Änderungen beschrieben, die sich bei der Aktualisierung auf eine neue Google Ads API-Version ergeben.

Weitere Informationen zum Veröffentlichungszeitplan für die Google Ads API finden Sie unter Zeitplan.

Google Ads API Version 16

Der BigQuery Data Transfer Service für Google Ads-Connector wird aktualisiert, um die Version Google Ads API v16 zu unterstützen, die Google Ads API v14 ersetzt. Dieses Update enthält die folgenden Änderungen:

Betroffene Tabellen	Verworfene Spalten	Neue Spalten
`ShoppingProductStats` `ShoppingProductConversionStats`	`segments_product_bidding_category_level1`	`segments_product_category_level1`
	`segments_product_bidding_category_level2`	`segments_product_category_level2`
	`segments_product_bidding_category_level3`	`segments_product_category_level3`
	`segments_product_bidding_category_level4`	`segments_product_category_level4`
	`segments_product_bidding_category_level5`	`segments_product_category_level5`
`ProductGroupStats`	`ad_group_criterion_listing_group_case_value_product_bidding_category_id`	`ad_group_criterion_listing_group_case_value_product_category_category_id`
	`ad_group_criterion_listing_group_case_value_product_bidding_category_level`	`ad_group_criterion_listing_group_case_value_product_category_level`
	`AssetGroupListingFilter`	`asset_group_listing_group_filter_case_value_product_bidding_category_id`	`asset_group_listing_group_filter_case_value_product_category_category_id`
		`asset_group_listing_group_filter_case_value_product_bidding_category_level`	`asset_group_listing_group_filter_case_value_product_category_level`
		`asset_group_listing_group_filter_vertical`	`asset_group_listing_group_filter_listing_source`

Mit der Google Ads API v14 wurden dem BigQuery-Tabellenschema neue Spalten wie segments_product_category_level1 und segments_product_category_level2 hinzugefügt, aber mit null gefüllt. Nach der Aktualisierung auf die Google Ads API Version 16 werden in diese neuen Spalten neue Werte eingefügt. Verworfene Spalten wie segments_product_bidding_category_level1 und segments_product_bidding_category_level2 werden mit null gefüllt, verbleiben aber weiterhin im Tabellenschema.

Pro Spaltenpaar gilt, dass nur eine Spalte Werte aus der Google Ads API und die andere Spalte null enthält. Damit Ihre bestehenden Abfragen nach der Aktualisierung weiterhin funktionieren, aktualisieren Sie Ihre Abfragen und wählen Sie eine der beiden Spalten aus. Angenommen, Ihre SQL-Abfrage enthält die folgende Anweisung:

segments_product_bidding_category_level1

Ersetzen Sie sie durch die folgende Anweisung, die die richtige Spalte angibt:

IFNULL(segments_product_category_level1, segments_product_bidding_category_level1)

Für Übertragungskonfigurationen, die nach dem 24. Juni 2024 erstellt werden, werden immer die neuen Spalten verwendet. Verworfene Spalten bleiben im Tabellenschema erhalten, werden aber mit null gefüllt.