Log delle modifiche delle origini dati di BigQuery Data Transfer Service

Questa pagina fornisce dettagli sulle modifiche agli schemi e alle mappature degli schemi delle origini dati di BigQuery Data Transfer Service. Per informazioni sulle modifiche imminenti ai connettori di BigQuery Data Transfer Service, puoi cercare in questa pagina le origini dati, ad esempio Google Ads API o Facebook Ads API, oppure nomi o valori di tabelle specifici.

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 dell'API supportata nel connettore Google Ads.

Le sezioni seguenti descrivono le modifiche apportate durante l'aggiornamento a una nuova versione dell'API Google Ads. Le modifiche sono organizzate in base alla data di rilascio e ogni voce fornisce informazioni sulle modifiche da apportare per continuare a ricevere dati da Google Ads.

Per ulteriori informazioni sul programma di rilascio dell'API Google Ads, consulta la Cronologia.

20 gennaio 2025

Google Ads Transfers prevede di aggiornare la versione dell'API Google Ads dalla v16 alla v18. Dopo l'upgrade dell'API, i valori delle colonne per i dati appena trasferiti nelle tabelle interessate cambieranno. Per saperne di più, consulta Upgrade dell'API Google Ads.

  • Data di inizio prevista: 20 gennaio 2025
  • Data di consegna: in attesa

Tabella: p_ads_Campaign_customer_id

Colonne interessate Valore precedente (v16) Nuovo valore (v18)
campaign_advertising_channel_type DISCOVERY DEMAND_GEN

Tabella: p_ads_Ad_customer_id

Colonne interessate Valore precedente (v16) Nuovo valore (v18)
ad_type

DISCOVERY_MULTI_ASSET_AD

DISCOVERY_CAROUSEL_AD

DISCOVERY_VIDEO_RESPONSIVE_AD

DEMAND_GEN_MULTI_ASSET_AD

DEMAND_GEN_CAROUSEL_AD

DEMAND_GEN_VIDEO_RESPONSIVE_AD

Tabella: Asset

Colonne interessate Valore precedente (v16) Nuovo valore (v18)
asset_type DISCOVERY_CAROUSEL_CARD DEMAND_GEN_CAROUSEL_CARD

Per assicurarti che le query funzionino dopo l'aggiornamento, modificale in modo da selezionare sia i valori vecchi che quelli nuovi. Ad esempio, se nella query SQL è presente la seguente condizione WHERE:

WHERE asset_type='DISCOVERY_CAROUSEL_CARD'

Sostituisci con la seguente istruzione:

WHERE
  asset_type='DISCOVERY_CAROUSEL_CARD'
  OR asset_type='DEMAND_GEN_CAROUSEL_CARD'

24 giugno 2024

Google Ads Transfers prevede di aggiornare la versione dell'API Google Ads dalla versione 14 alla v16. In questo upgrade dell'API, i nomi delle colonne per i dati appena trasferiti nelle tabelle interessate vengono modificati. Inoltre, alcune colonne sono state ritirate. Per saperne di più, consulta Upgrade dell'API Google Ads.

  • Data di inizio target: 17 giugno 2024
  • Data di consegna: 23 giugno 2024
Tabelle interessate Colonne ritirate 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, sono state aggiunte nuove colonne, come segments_product_category_level1 e segments_product_category_level2, allo schema della tabella BigQuery, ma sono state completate con null. Con l'aggiornamento alla versione 16 dell'API Google Ads, queste nuove colonne verranno compilate con nuovi valori. Le colonne ritirate, 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 viene compilata con null. Per assicurarti che le query esistenti continuino a funzionare dopo l'aggiornamento, aggiornale in modo da scegliere 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 ritirate rimarranno nello schema della tabella, ma verranno compilate con null.