Guida all'aggiornamento di Google Ads

BigQuery Data Transfer Service per Google Ads viene aggiornato periodicamente per supportare nuove colonne e adattarsi alle modifiche introdotte dalle nuove versioni dell'API Google Ads. Il connettore BigQuery Data Transfer Service per Google Ads utilizza la versione API supportata nel connettore Google Ads. Questo documento descrive le modifiche apportate durante l'aggiornamento a una nuova versione dell'API Google Ads.

Per ulteriori informazioni sulla pianificazione delle release dell'API Google Ads, consulta la sezione Tempistiche.

Il connettore BigQuery Data Transfer Service per Google Ads è in fase di aggiornamento per supportare il rilascio della versione 16 dell'API Google Ads, che sostituisce la versione 14 dell'API Google Ads. Questo aggiornamento include le seguenti modifiche:

Tabelle interessate Colonne deprecate Nuove colonne
  • 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

Con la versione 14 dell'API Google Ads, nuove colonne, ad esempio segments_product_category_level1 e segments_product_category_level2, sono state aggiunte allo schema della tabella BigQuery, ma sono state compilate con null. Con l'aggiornamento alla versione 16 dell'API Google Ads, queste nuove colonne verranno compilate con nuovi valori. Le colonne deprecate, come segments_product_bidding_category_level1 e segments_product_bidding_category_level2, verranno compilate con null, ma rimarranno nello schema della tabella.

Per ogni coppia di colonne, solo una colonna viene compilata con i valori dell'API Google Ads, mentre l'altra con i valori null. Per assicurarti che le query esistenti continuino a funzionare dopo l'aggiornamento, aggiornale scegliendo una delle due colonne. Ad esempio, se nella query SQL è presente la seguente istruzione:

segments_product_bidding_category_level1

Sostituisci con la seguente istruzione che specifica la colonna corretta:

IFNULL(segments_product_category_level1, segments_product_bidding_category_level1)

Le configurazioni di trasferimento create dopo il 24 giugno 2024 utilizzeranno sempre le nuove colonne. Le colonne deprecate rimarranno nello schema della tabella, ma verranno compilate con null.