Annuncio della versione 24 dell'API Google Ads

Mercoledì 22 aprile 2026

Oggi annunciamo il rilascio della versione 24 dell'API Google Ads. Per utilizzare le nuove funzionalità della versione v24, devi eseguire l'upgrade delle librerie client e del codice client. Tutte le librerie client e gli esempi di codice aggiornati sono stati pubblicati.

Partecipa alla presentazione dal vivo di questa release durante il nostro evento "Google Ads API Release Highlights" su Discord, il nostro Ads Developers YouTube Live o il nostro evento LinkedIn Live domani (23 aprile alle 10:00 ET). Anche questo evento verrà registrato e pubblicato su YouTube per chi non potrà partecipare dal vivo. Se hai domande o vuoi discutere di questo post, contattaci nel canale #ads-api su Discord.

Nuove funzionalità

Supporto per le conversioni con dati del carrello: le conversioni con dati del carrello sono un'estensione del monitoraggio delle conversioni sul sito web o nell'app. Utilizzando questa funzionalità, puoi fornire i dettagli dei prodotti venduti per ogni transazione, il che ti consente di accedere a statistiche e report avanzati sulle vendite e sui profitti per il tuo account Google Ads e le tue campagne, ad esempio numero di ordini, volume medio del carrello, entrate e profitto lordo.

La versione 24 dell'API Google Ads aggiunge il supporto per questa funzionalità come segue:

  • È stata aggiunta una nuova risorsa CartDataSalesView che consente di segmentare le metriche di conversione non solo in base al clic sul prodotto, ma anche in base al prodotto venduto, con segmenti come product_sold_brand. In questo modo, gli inserzionisti possono visualizzare le statistiche sui prodotti effettivamente acquistati dai clienti dopo aver fatto clic sugli annunci, anche se l'annuncio riguardava un prodotto diverso.
  • Sono state aggiunte diverse metriche "tutte" non disponibili per le offerte, ovvero metriche che includono anche le conversioni per cui le campagne non vengono ottimizzate attivamente, ad esempio all_cost_of_goods_sold_micros. Le nuove metriche vengono aggiunte a tutte le risorse che supportano le metriche disponibili per l'asta corrispondenti.
  • Aggiunto il segmento conversion_attribution_event_type alla risorsa ShoppingPerformanceView, rendendolo selezionabile con i dati del carrello e altre metriche di conversione. Questo segmento indica se la conversione è attribuita a un clic o a una visualizzazione ed è necessario per riconoscere le statistiche dei dati del carrello generate dalle conversioni view-through.

Funzionalità aggiornate

La versione v24 introduce aggiornamenti alle funzionalità esistenti che richiedono modifiche al codice durante l'upgrade. Qui riportiamo le più importanti; consulta le note di rilascio per l'elenco completo delle modifiche.

Impostazioni di esclusione di contenuti video nelle campagne: abbiamo semplificato la possibilità di configurare le impostazioni di esclusione di contenuti video nelle singole campagne. Questa impostazione è disponibile a livello di cliente e si applica a tutte le campagne. Queste impostazioni di esclusione dei contenuti ti offrono un ulteriore controllo e ti consentono di escludere tipi di contenuti che, pur nel rispetto delle nostre norme, potrebbero non essere adatti al tuo brand o alla tua attività. Per saperne di più sulle impostazioni di esclusione dei contenuti video, visita la pagina https://support.google.com/google-ads/answer/7515513.

Modifiche ad AudienceInsightsService: nell'ambito di un refactoring del codice, abbiamo spostato il campo della richiesta InsightsAudience.topic_audience_combinations nello spazio dei nomi common. Potresti dover aggiornare le istruzioni di importazione in alcuni linguaggi di programmazione.

Modifiche a ReachPlanService: nell'ambito di un refactoring del codice, abbiamo spostato il campo youtube_select_lineups dal servizio ReachPlanService.ListPlannableProducts. Le selezioni sono ora disponibili nel campo youtube_select_lineup_targeting. Le selezioni YouTube Select sono prodotti basati su prenotazione che permettono a clienti idonei di scegliere come target l'1% dei canali più popolari su YouTube con il pubblico più appassionato di un determinato mercato. Scopri di più.

Modifiche a ContentCreatorInsightsService: nell'ambito di un refactoring del codice, abbiamo rimosso il campo is_brand_connect_creator dai servizi ContentCreatorInsightsService.GenerateCreatorInsights e ContentCreatorInsightsService.GenerateTrendingInsights.
Gli utenti devono invece cercare un creator per avere l'opzione CREATOR_PARTNERSHIPS disponibile in partnership_opportunities. YouTube Creator Partnerships in Google Ads è l'area in cui puoi trovare i creator di YouTube con cui collaborare per contenuti sponsorizzati e gestire in modo efficiente le tue partnership con i creator. Scopri di più.

Modifiche a KeywordPlanIdeaService: per offrire un'esperienza più semplificata e affidabile, abbiamo unificato la nostra infrastruttura di previsione. La versione 24 dell'API Google Ads introduce un metodo GenerateKeywordForecastMetrics aggiornato che semplifica il processo di pianificazione concentrandosi sulle metriche che influiscono più direttamente sul rendimento. Nei prossimi giorni pubblicheremo un blog post più dettagliato su questa modifica.

Modifiche alla risorsa campaign_budget: Abbiamo rimosso ilad_sub_network_type segmento per ilcampaign_budget risorsa perché incompatibile con questa visione.

Modifiche alle visualizzazioni degli asset: abbiamo rimosso il segmento click_type dalle visualizzazioni ad_group_asset, campaign_asset e customer_asset. Questa modifica è in linea con una recente modifica del prodotto che ha rimosso questo segmento da Google Ads per evitare una rappresentazione ingannevole dei dati. Puoi utilizzare la segmentazione click_type della risorsa ad_group_ad per ottenere dettagli sul rendimento dell'annuncio e sull'asset con cui è stato pubblicato.

Modifiche all'annuncio adattabile video: VideoResponsiveAdInfo è ora modificabile. Nell'ambito di questa modifica, abbiamo contrassegnato videos, business_name e logo_images come campi obbligatori negli oggetti DemandGenVideoResponsiveAdInfo e VideoResponsiveAdInfo.

Modifiche a ShareablePreviewService: Aggiornato ShareablePreviewService.GenerateShareablePreviews per non utilizzare più errori parziali. Le richieste genereranno un errore se non vanno a buon fine per un ID. Scopri di più.

Le seguenti risorse possono aiutarti a iniziare:

Per richieste di assistenza tecnica, contatta l'indirizzo https://support.google.com/google-ads/contact/google_ads_api

Ritratto dell'autore - , team API Google Ads

Etichette: google-ads-api, release