Note di rilascio

v23 (28/01/2026)

Nella versione 23 sono stati aggiunti i seguenti aggiornamenti e nuove funzionalità.

Per indicazioni, consulta l'articolo Eseguire l'upgrade all'ultima versione.

Annunci

  • Aggiunta di AD_SHARING_NOT_ALLOWED a AdGroupAdErrorEnum. Questo errore viene restituito quando si tenta di condividere un annuncio tra più gruppi di annunci, cosa che non è più consentita.
  • Sono stati aggiunti nuovi tipi di formati a AdFormatType: TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION.
  • Il supporto di CallAd e CallAdInfo è stato rimosso nella versione 23. Per saperne di più, visita la pagina https://support.google.com/google-ads/answer/6341403.

Asset

Fatturazione

Campagne

Conversioni

  • È stato aggiunto YOUTUBE_FOLLOW_ON_VIEWS a ConversionActionCategory per supportare il monitoraggio degli utenti che guardano un annuncio e in seguito guardano un video dello stesso canale.

Demand Gen

Incentivi

  • È stato aggiunto il supporto per gli incentivi Scegli la tua offerta (CYO), che consente ai partner di recuperare e applicare in modo programmatico gli incentivi Google Ads per i propri clienti:

    • Aggiunta di IncentiveService:
      • Il metodo FetchIncentive consente di recuperare gli incentivi disponibili per un utente in base a paese, lingua e, facoltativamente, all'email dell'utente. In questo modo, possono essere restituite opzioni di incentivo personalizzate "Scegli la tua" (CYO).
      • Il metodo ApplyIncentive consente di applicare un incentivo selezionato dall'utente a un account cliente Google Ads specifico.
    • È stata aggiunta la risorsa di sola lettura AppliedIncentive, interrogabile tramite GoogleAdsService.Search e GoogleAdsService.SearchStream. Fornisce dettagli sugli incentivi riscattati, inclusi stato, avanzamento dell'evasione, importi dei premi e date pertinenti.
    • Sono stati aggiunti nuovi codici di errore in IncentiveErrorEnum per gestire i problemi relativi al recupero o all'applicazione degli incentivi.
    • Aggiunta di INVALID_EMAIL_ADDRESS a AuthenticationErrorEnum.

  • Per facilitare la gestione programmatica più granulare degli errori, nelle release future aggiungeremo codici di errore aggiuntivi a IncentivesService. Ti consigliamo di monitorare gli annunci e le note di rilascio imminenti per questi nuovi codici di errore per assicurarti che le tue applicazioni possano gestire queste nuove modalità di errore.

Pianificazione

Consigli

  • Aggiunta del campo is_new_customer a GenerateRecommendationsRequest. Se impostato su true per i suggerimenti di tipo CAMPAIGN_BUDGET, genera suggerimenti utilizzando un modello per i nuovi clienti. Questa opzione è consigliata solo per i clienti senza campagne.

Report

Shopping

  • ShoppingPerformanceView ora supporta le seguenti metriche segmentate per data di conversione: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date.
  • ShoppingPerformanceView ora supporta le seguenti metriche della concorrenza: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, search_rank_lost_absolute_top_impression_share.
  • Aggiunta di product_image_uri a ShoppingProduct.

Annunci verticali

  • È stato aggiunto vertical_ads_format_setting a AdGroup per le campagne della rete di ricerca che utilizzano i feed viaggi, consentendo di controllare quali formati degli annunci possono essere pubblicati.
  • È stato aggiunto il tipo di criterio vertical_ads_item_group_rule_list a AdGroupCriterion. Aggiunta di vertical_ads_item_group_rule a SharedCriterion. Questi criteri consentono di scegliere come target i gruppi di elementi nelle campagne sulla rete di ricerca con feed viaggi.
  • Ora puoi collegare un feed di dati degli annunci verticali a una campagna sulla rete di ricerca che utilizza AI Max in modo che mostri annunci per la promozione di proprietà e annunci di viaggi con link di prenotazione insieme ai tuoi annunci di testo. A livello di gruppo di annunci, puoi controllare quali formati mostrare con vertical_ads_format_setting e definire un insieme di regole per i gruppi di elementi per scegliere come target un sottoinsieme delle tue entità dal feed di dati degli annunci verticali. Inoltre, ora i report possono essere segmentati sia in base a AdFormatType sia alle dimensioni del feed di dati degli annunci verticali.

Video

v22 (15/10/2025)

Nella versione 22 sono stati aggiunti i seguenti nuovi aggiornamenti e funzionalità.

Asset

  • È stato aggiunto LANDING_PAGE_PREVIEW come nuovo tipo di campo per gli asset immagine.
  • È stata introdotta la AssetGenerationService (beta):
    • Questo servizio consente di generare asset di testo e immagine utilizzando l'AI generativa. Questo servizio è inizialmente disponibile solo per un gruppo limitato di partecipanti alla beta chiusa.
    • GenerateText: genera testo in base a input come URL finale, prompt in formato libero, parole chiave e contesto della campagna esistente.
    • GenerateImages: genera immagini in base a input come l'URL finale, i prompt in formato libero, il contesto della campagna esistente o ricontestualizzando le immagini prodotto esistenti.
    • Gli errori durante la generazione degli asset vengono restituiti con codici compresi tra AssetGenerationErrorEnum.

Campagne

Demand Gen

Generale

  • È stato aggiunto un limite di 10.000 operazioni per richiesta AddBatchJobOperations.
  • Gestione aggiornata del campo page_size in ListBatchJobResultsRequest:
    • Se page_size non è impostato o è 0, ora il valore predefinito è il massimo di 1000 (in precedenza veniva restituito INVALID_PAGE_SIZE).
    • Se page_size supera 1000, l'API ora restituisce un errore INVALID_PAGE_SIZE (in precedenza il valore veniva limitato a 1000 senza preavviso).
  • È stato aggiunto un nuovo codice di errore: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED per indicare quando è stato superato il limite dei tassi di attivazione del profilo pagamenti.

Performance Max

  • Sono stati aggiunti nuovi valori di AssetAutomationType per le campagne Performance Max:
    • GENERATE_IMAGE_ENHANCEMENT: consente la creazione automatica di immagini migliorate, ad esempio il ritaglio automatico. Abilitato per impostazione predefinita.
    • GENERATE_IMAGE_EXTRACTION: consente di reperire automaticamente le immagini dagli URL finali. L'impostazione predefinita è l'estensione immagine dinamica a livello di account.
  • Rimozione di AssetPerformanceLabel per le campagne Performance Max.
  • La funzionalità di Campaign.url_expansion_opt_out rimossa ora viene gestita impostando AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION in AssetAutomationSetting.
  • Sono stati aggiunti nuovi segmenti per le campagne Performance Max. Ciascuno di questi segmenti è disponibile solo per le campagne Performance Max e non restituirà dati se viene selezionato un altro tipo di campagna.

Pianificazione

Report

Obiettivi unificati

  • È stato aggiunto il supporto per gli obiettivi di fidelizzazione dei clienti per ottimizzare il coinvolgimento dei clienti esistenti.

Video

v21 (06/08/2025)

Per indicazioni, consulta l'articolo Eseguire l'upgrade all'ultima versione.

AI Max per le campagne sulla rete di ricerca

  • Ora puoi utilizzare il campo ai_max_setting.enable_ai_max di Campaign per attivare AI Max per campagne sulla rete di ricerca. AI Max per campagne sulla rete di ricerca espande la copertura di una campagna sulla rete di ricerca tramite la corrispondenza dei termini di ricerca e consente di controllare se i controlli di targeting e delle creatività vengono pubblicati quando sono impostati. L'automazione degli asset di testo e i controlli degli elenchi di brand impostati nelle richieste di versioni precedenti verranno comunque rispettati finché AI Max per le campagne sulla rete di ricerca non verrà attivato e disattivato esplicitamente. Campaign.ai_max_setting.bundling_required può essere utilizzato per determinare se AI Max per le campagne sulla rete di ricerca deve essere attivato per rispettare o modificare l'automazione degli asset di testo e i controlli degli elenchi di brand. AdGroup.ai_max_ad_group_setting.disable_search_term_matching può essere utilizzato per disattivare la corrispondenza dei termini di ricerca quando una campagna principale ha attivato AI Max per le campagne sulla rete di ricerca. Consulta il nostro post del blog Aumenta il rendimento con AI Max per campagne sulla rete di ricerca.

  • È stato aggiunto CampaignError.AI_MAX_MUST_BE_ENABLED, che viene generato per le campagne sulla rete di ricerca quando attivi FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION senza attivare AI Max per campagne sulla rete di ricerca nella campagna.

  • È stato aggiunto il supporto per l'applicazione dei controlli del targeting a livello di gruppo di annunci nelle campagne AI Max per campagne sulla rete di ricerca. Ora puoi aggiungere i seguenti criteri ai gruppi di annunci:

    • Elenchi di brand
    • Località
    • Pagine web (regole per gli URL)

  • È stato aggiunto il ai_max_search_term_ad_combination_view per generare report sul rendimento delle combinazioni di termini di ricerca, titoli e pagine di destinazione. Questa visualizzazione mostra quali query di ricerca hanno attivato i tuoi annunci e il rendimento di queste combinazioni specifiche. Una release futura includerà una visualizzazione aggiuntiva che includerà anche i dati di Performance Max. Se vuoi evitare di eseguire la migrazione dell'implementazione per ottenere i dati di Performance Max, valuta la possibilità di attendere questa release.

  • È stato aggiunto AI_MAX come nuovo valore per il segmento search_term_match_type.

Asset

Campagne

Conversioni

  • È stato aggiunto ENGAGED_VIEW come nuovo valore per il segmento conversion_attribution_event_type.

  • I clienti non avranno più accesso alla modalità debug_enabled in ConversionUploadService. Se impostato su TRUE, questo campo veniva utilizzato in precedenza per distinguere l'errore CLICK_NOT_FOUND da SUCCESS per le importazioni delle conversioni avanzate per i lead.

Demand Gen

Modifiche alla propaganda politica nell'UE

Queste modifiche alla pubblicità politica dell'UE sono state apportate anche alle release v19.2 e v20.1.

  • Aggiunta di Campaign.contains_eu_political_advertising. Questo campo indica se la tua campagna contiene contenuti pubblicitari politici che hanno come target l'Unione Europea. Se questo campo è impostato su CONTAINS_EU_POLITICAL_ADVERTISING, la campagna non verrà più pubblicata nell'UE a partire dal 22 settembre 2025. Le chiamate API per creare una nuova campagna non andranno a buon fine e verrà visualizzato un errore FieldError.REQUIRED se questo campo non è impostato.

    Per le campagne esistenti, devi impostare il campo contains_eu_political_advertising prima di tentare di modificare il targeting per prossimità, località o gruppo di località a livello di campagna o di gruppo di annunci. Le chiamate API per creare o aggiornare questi criteri di campagna o gruppo di annunci per le campagne esistenti non andranno a buon fine e verrà visualizzato un errore CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se la campagna non ha completato l'autodichiarazione.

    Per le versioni v19.x e 20.x, il requisito di impostare questo campo non è ancora obbligatorio, ma lo sarà in futuro. Questa modifica verrà annunciata in anticipo.

  • Le prove e gli esperimenti genereranno un ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se le campagne dell'esperimento non hanno dichiarato autonomamente se includono propaganda politica che ha come target l'Unione Europea.

Performance Max

  • Per le nuove campagne Performance Max, il valore predefinito di Campaign.brand_guidelines_enabled ora è true.

  • È stato aggiunto il report campaign_search_term_view. Questa visualizzazione offre metriche sui termini di ricerca aggregate a livello di campagna. Questa visualizzazione introduce anche il supporto delle campagne Performance Max per i termini di ricerca.

  • È stato aggiunto PERFORMANCE_MAX come nuovo valore per il segmento search_term_match_type.

Pianificazione

Report

Video

v20.1 (06/08/2025)

Queste modifiche alla pubblicità politica dell'UE sono state apportate anche nelle release v19.2 e v21.

Modifiche alla propaganda politica nell'UE

  • Aggiunta di Campaign.contains_eu_political_advertising. Questo campo indica se la tua campagna contiene contenuti pubblicitari politici che hanno come target l'Unione Europea. Se questo campo è impostato su CONTAINS_EU_POLITICAL_ADVERTISING, la campagna non verrà più pubblicata nell'UE a partire dal 22 settembre 2025.

    Per le campagne esistenti, devi impostare il campo contains_eu_political_advertising prima di tentare di modificare il targeting per prossimità, località o gruppo di località a livello di campagna o di gruppo di annunci. Le chiamate API per creare o aggiornare questi criteri di campagna o gruppo di annunci per le campagne esistenti non andranno a buon fine e verrà visualizzato un errore CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se la campagna non ha completato l'autodichiarazione.

    Per le versioni v19.x e 20.x, il requisito di impostare questo campo non è ancora obbligatorio, ma lo sarà in futuro. Questa modifica verrà annunciata in anticipo.

  • Le prove e gli esperimenti genereranno un ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se le campagne dell'esperimento non hanno dichiarato autonomamente se includono propaganda politica che ha come target l'Unione Europea.

v20 (2025-06-04)

Nella versione 20 sono stati aggiunti i seguenti nuovi aggiornamenti e funzionalità.

Per indicazioni, consulta l'articolo Eseguire l'upgrade all'ultima versione.

Asset

Sono state aggiunte diverse nuove metriche e colonne di segmenti per il report asset_group.

Colonne delle metriche

Colonne dei segmenti

Campagne

Conversioni

  • Ora puoi aggiornare il campo google_ads_conversion_customer di un cliente esistente per attivare il monitoraggio delle conversioni su più account o per modificare il proprietario del monitoraggio delle conversioni esistente in un altro account amministratore.

  • È stato aggiunto il campo ClickConversion.user_ip_address. Google Ads non supporta la corrispondenza degli indirizzi IP per gli utenti finali nello Spazio economico europeo (SEE), nel Regno Unito (UK) o in Svizzera (CH). Aggiungi una logica per escludere in modo condizionale la condivisione degli indirizzi IP degli utenti di queste regioni. Assicurati di fornire agli utenti informazioni chiare e complete sui dati che raccogli sui tuoi siti, nelle tue app e in altre proprietà e di ottenere il consenso laddove richiesto dalla legge o dalle norme di Google vigenti. Per ulteriori dettagli, consulta la pagina Informazioni sulle importazioni delle conversioni offline.

Demand Gen

Consigli

  • Aggiunto il supporto di ShoppingSetting durante la creazione della campagna quando utilizzi GenerateRecommendationsRequest.
    • È stato aggiunto il campo merchant_center_account_id a GenerateRecommendationsRequest per indicare quando devono essere generati i consigli per la vendita al dettaglio, anziché per le campagne Performance Max standard.

Pianificazione

  • Aggiunta di AudienceInsightsDimension.YOUTUBE_LINEUP in sostituzione di AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP in AudienceInsightsService e ContentCreatorInsightsService. Questa nuova dimensione ti consente di recuperare approfondimenti e metadati per le selezioni YouTube Select (YTS). Gli oggetti sostituiti associati a YOUTUBE_DYNAMIC_LINEUP, ad esempio DynamicLineupAttributeMetadata e AudienceInsightsDynamicLineup, sono stati rimossi per allinearsi alla rimozione più ampia dei posizionamenti dinamici in Google Ads. Questa funzionalità è disponibile solo per gli account inclusi in una lista consentita.
  • Aggiunti AdditionalApplicationInfo e ApplicationInstance in AudienceInsightsService, ContentCreatorInsightsService e ReachPlanService. Questa funzionalità è disponibile solo per gli account inclusi in una lista consentita.
  • Sono stati aggiornati AudienceInsightsService e ContentCreatorInsightsService per fornire approfondimenti più dettagliati. Ora puoi segmentare i dati dei creator di contenuti per dispositivo utilizzando i nuovi AudienceInsightsDimension.DEVICE e AudienceInsightsAttribute.device in entrambi i servizi. Questa funzionalità è disponibile solo per gli account inclusi in una lista consentita.
  • Sono state aggiunte altre metriche aggregate per i video a GenerateCreatorInsightsResponse per un'analisi più completa dei creator di contenuti: engagement_rate, average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video, shorts_views_count, shorts_video_count e is_brand_connect_creator. Questa funzionalità è disponibile solo per gli account inclusi in una lista consentita.
  • Aggiunta di sub_country_locations a GenerateCreatorInsightsRequest per ContentCreatorInsightsService. Ciò consente di specificare le località geografiche a livello di paese per perfezionare le ricerche di approfondimenti per i creator. Il campo sub_country_locations è supportato solo quando utilizzi search_attributes oneof nel campo criteria. Se sub_country_locations vengono forniti con altri tipi di criteri, la richiesta non sarà valida. Ciò consente un targeting geografico e un'analisi più granulari per gli approfondimenti dei creator di contenuti. Questa funzionalità è disponibile solo per gli account inclusi in una lista consentita.
  • È stato aggiunto ReachPlanService.ListPlannableUserLists, che restituisce elenchi di utenti proprietari di prima parte di un cliente, ed è stato aggiunto UserListInfo alle opzioni di targeting dei segmenti di pubblico in GenerateReachForecastRequest. In questo modo puoi recuperare elenchi di utenti pianificabili per un determinato cliente e poi generare previsioni di copertura per le campagne che hanno come target questi segmenti di pubblico specifici. Questi miglioramenti consentono di pianificare la copertura personalizzata incorporando i dati dei segmenti di pubblico proprietari direttamente nelle previsioni. La previsione della copertura è disponibile solo per gli account nella lista consentita.

Video

  • Sono stati aggiunti annunci AdFormatType.PAUSE pubblicati su video organici di YouTube sugli schermi della TV, inclusi nei report. Questi annunci vengono visualizzati direttamente accanto al fotogramma video statico nella schermata di pausa. Non sono inclusi gli annunci video Demand Gen visualizzati nel riquadro degli annunci in basso o in alto rispetto a un video organico in pausa, che vengono riportati in AdFormatType.INFEED.

Note di rilascio archiviate

Consulta la sezione Versioni ritirate per le note di rilascio archiviate.