Note di rilascio

v24.1 (13/05/2026)

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

Annunci

  • È stato aggiunto il campo classic_display_images a DemandGenMultiAssetAd. Si tratta di immagini personalizzate caricate che vengono pubblicate senza richiedere asset aggiuntivi e non come parte dei formati degli annunci adattabili.

Generale

Esperimenti

  • È stato aggiunto il supporto per i seguenti nuovi tipi di ExperimentTypeEnum:
    • ADOPT_AI_MAX: per esperimenti che testano come AI Max può aiutarti a coinvolgere più clienti con Google AI e le parole chiave a corrispondenza generica.
    • ADOPT_BROAD_MATCH_KEYWORDS: Per gli esperimenti che testano l'impatto delle parole chiave a corrispondenza generica sul numero di ricerche in cui vengono visualizzati i tuoi annunci.
    • OPTIMIZE_ASSETS: Per esperimenti personalizzati per l'ottimizzazione degli asset.
    • PMAX_REPLACEMENT_SHOPPING: Per gli esperimenti che testano il rendimento delle campagne Shopping rispetto a Performance Max.
  • È stato aggiunto il supporto della configurazione per gli esperimenti YOUTUBE_CUSTOM esistenti costituiti da campagne video, utilizzando il nuovo campo video_experiment in Experiment.
  • Sono stati aggiunti i seguenti campi a ExperimentArm per supportare i test degli asset, i gruppi di asset e le impostazioni degli esperimenti Performance Max:

Report

Targeting

  • Aggiunto CANNOT_EXCLUDE_ALL_TARGETS a CriterionErrorEnum. Questo errore viene restituito quando si tenta di escludere tutti i target demografici, il che non è consentito.

Video

  • Pubblica ZEFR come partner di integrazione per la visibilità di terze parti.
  • È stato aggiunto channel_id al campo youtube_video nella risorsa DataLink per esporre l'ID canale YouTube associato al collegamento dei dati.

Versione 24 (22/04/2026)

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

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

Annunci

Ora sono obbligatori i seguenti campi:

Asset

Campagne

Conversioni

  • È stato aggiunto il supporto per i tipi di conversione per la generazione di lead. Questi sono i nuovi ConversionActionType. enum in v24:

    • GOOGLE_ANALYTICS_4_GENERATE_LEAD
    • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
    • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
    • FIREBASE_ANDROID_GENERATE_LEAD
    • FIREBASE_ANDROID_QUALIFY_LEAD
    • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
    • FIREBASE_IOS_GENERATE_LEAD
    • FIREBASE_IOS_QUALIFY_LEAD
    • FIREBASE_IOS_CLOSE_CONVERT_LEAD

  • È stata rimossa la categoria di tipo di cliente dell'elenco utenti LOYALTY_SIGN_UPS.

Generale

Pianificazione

Report

Shopping

  • È stato aggiunto il supporto per le campagne per app nella risorsa ShoppingProduct. Tieni presente che i campi status e issues non sono supportati per le campagne per app.
  • È stato introdotto il filtro dei prodotti basato sui tag che utilizza espressioni logiche per le campagne Shopping.
    • Sono stati aggiunti i tipi di criteri RETAIL_FILTER_BUNDLE e RETAIL_FILTER.
    • Aggiunta di RETAIL_FILTER come nuovo SharedSetType.
    • Ora AdGroupCriterion può utilizzare il campo retail_filter_bundle per collegarsi a un SharedSet di tipo RETAIL_FILTER.
    • Ora SharedCriterion può utilizzare il campo retail_filter per definire singole regole o espressioni di tag all'interno di SharedSet.
    • Aggiunta di RETAIL a ListingGroupFilterListingSource.
    • Aggiunta della dimensione RetailFilter a AssetGroupListingGroupFilter.
    • Sono stati aggiunti nuovi codici di errore in CriterionError e AssetGroupListingGroupFilterError per la convalida.
    • Questa funzionalità è disponibile solo per gli utenti nella lista consentita.

Video

v23.2 (25/03/2026)

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

Asset

  • È stata aggiunta la risorsa VideoEnhancement con informazioni sugli annunci video specifiche per il miglioramento, ad esempio se sono generati da Google o forniti dall'inserzionista. Per saperne di più, consulta la sezione Informazioni sui miglioramenti video.
  • È stata aggiunta la risorsa di sola lettura AppTopCombinationView per fornire approfondimenti sulle combinazioni di asset con il rendimento migliore nelle campagne per app.
  • È stato aggiunto il supporto per recuperare CustomerAsset con field_type BUSINESS_LOGO.

Campagne

Generale

  • Sono stati aggiunti due nuovi codici di errore a CustomerClientLinkError: MAX_CUSTOMER_LIMIT_REACHED e ACCOUNT_CREATION_POLICY_VIOLATION.
  • Ora viene generato un errore quando si tenta di utilizzare la categoria di tipo di cliente LOYALTY_SIGN_UPS elenco utenti ritirata.

Pianificazione

Report

  • È stata aggiunta la metrica biddable_indirect_install_first_in_app_conversion_micros alle risorse Campaign, Customer e AdGroup.

Video

  • Estensione di ShareablePreviewService per supportare le anteprime di YouTube Live impostando preview_type su YOUTUBE_LIVE_PREVIEW. Aggiunta di UNSUPPORTED_AD_TYPE e TOO_MANY_RESOURCES_IN_REQUEST a ShareablePreviewError. Questa funzionalità è supportata solo per alcuni tipi di annunci.

v23.1 (25/02/2026)

Nella versione 23.1 sono state aggiunte le seguenti nuove funzionalità e aggiornamenti.

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

Gestione account

  • È stato aggiunto advertising_partner_properties.allowed_domain alle risorse ProductLinkInvitation e ProductLink. Il partner pubblicitario potrà fare pubblicità solo su questo dominio.
  • È stato aggiunto il campo contains_eu_political_advertising alla risorsa Customer. Questo campo recupera lo stato della dichiarazione a livello di account che indica se contiene pubblicità politica rivolta all'UE e restituisce un EuPoliticalAdvertisingStatusEnum.

Campagne

  • È stato aggiunto il supporto per le linee guida per il testo, che possono essere utilizzate con le campagne Performance Max e sulla rete di ricerca per controllare in modo programmatico gli asset di testo creati con l'AI.
  • Sono stati aggiunti CampaignPrimaryStatusReason.CAMPAIGN_NOT_BOOKED, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRING, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRED e CampaignPrimaryStatusReason.BOOKING_CANCELLED per fornire i motivi principali dello stato delle campagne con la strategia di offerta FIXED_CPM.
  • Aggiunti Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure e Campaign.VideoCampaignSettings.booking_details(di sola lettura).
  • È stato aggiunto Campaign.missing_eu_political_advertising_declaration per supportare l'interrogazione e il filtro delle campagne per le quali mancano dichiarazioni relative alla presenza o meno di pubblicità politica rivolta all'UE.

Conversioni

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

Generale

  • È stato aggiunto CANNOT_TARGET_ONLY_UNDETERMINED a CriterionErrorEnum. Questo errore viene restituito quando si tenta di scegliere come target solo la categoria non determinata nelle dimensioni demografiche.

Incentivi

  • Sono stati aggiunti due nuovi codici di errore a IncentiveErrorEnum: MAX_INCENTIVES_REDEEMED e ACCOUNT_TOO_OLD. Questi errori possono essere restituiti per le richieste effettuate a partire dall'11 marzo 2026.

Pianificazione

Report

  • Sono state aggiunte nuove metriche che indicano il numero di utenti che hanno visto il tuo annuncio almeno due, tre, quattro, cinque o dieci volte: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus e unique_users_ten_plus.
  • Aggiunta di VERTICAL_ADS_DATA_FEED a SearchTermMatchSourceEnum per supportare i feed di dati degli annunci verticali, ad esempio il targeting delle entità degli annunci per i viaggi.

YouTubeVideoUpload

  • È stato aggiunto il servizio YouTubeVideoUpload per supportare il caricamento e la gestione dei video su YouTube e la risorsa YouTubeVideoUpload per supportare il recupero dello stato di caricamento e dei metadati. Questa funzionalità è supportata solo per REST e la libreria client Python.

v23 (28/01/2026)

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

Annunci

  • È stato aggiunto AD_SHARING_NOT_ALLOWED a AdGroupAdErrorEnum. Questo errore viene restituito quando si tenta di condividere un annuncio tra più gruppi di annunci, cosa non più consentita.
  • Sono stati aggiunti nuovi tipi di formati a AdFormatType: TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION.
  • È stato rimosso il supporto per CallAd e CallAdInfo nella versione 23. Per saperne di più, consulta la sezione Informazioni sugli annunci di chiamata.

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 tu".
      • 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 versioni 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

  • È stato aggiunto il campo is_new_customer a GenerateRecommendationsRequest. Se impostato su true per i consigli di tipo CAMPAIGN_BUDGET, genera consigli utilizzando un modello per i nuovi clienti. Questa impostazione è consigliata solo per i clienti senza campagne.

Report

  • Metriche e segmentazione

    • AdGroupAdAssetView ora supporta le metriche relative a impressioni, rendimento e conversioni per RESPONSIVE_DISPLAY_AD.
    • È stato aggiunto il segmento ad_sub_network_type per una suddivisione più granulare del rendimento all'interno di una rete pubblicitaria. Inizialmente, questo segmento è disponibile per le campagne Demand Gen su YouTube (in-stream, annuncio in-feed, Shorts). Questo segmento deve essere selezionato insieme a ad_network_type.
    • È stata attivata la suddivisione del tipo di rete pubblicitaria per le campagne Performance Max.
    • UserLocationView e GeographicView ora supportano le 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,
      • cross_device_conversions_by_conversion_date,
      • cross_device_conversions_value_by_conversion_date.

  • Nuovi segmenti per gli annunci verticali

  • Nuove visualizzazioni:

    • È stato aggiunto PerStoreView per eseguire query sui dettagli della posizione del negozio.
    • È stato aggiunto MatchedLocationInterestView per le campagne AI Max, che fornisce metriche sul rendimento suddivise per località geografiche in cui gli utenti hanno mostrato interesse.

  • Performance Max:

    • È stata attivata la suddivisione del tipo di rete pubblicitaria per le campagne Performance Max.

  • Rimozioni:

    • Sono state rimosse le metriche delle etichette di rendimento delle risorse aggregate. L'enumerazione dell'etichetta di rendimento non viene più restituita per la rete di ricerca e display.

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. È stato aggiunto vertical_ads_item_group_rule a SharedCriterion. Questi criteri consentono di scegliere come target i gruppi di articoli nelle campagne sulla rete di ricerca con feed di 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.1 (25/02/2026)

Nella versione 22.1 è stata aggiunta la seguente nuova funzionalità.

Gestione account

  • È stato aggiunto il campo contains_eu_political_advertising alla risorsa Customer. Questo campo recupera lo stato della dichiarazione a livello di account che indica se contiene pubblicità politica rivolta all'UE e restituisce un EuPoliticalAdvertisingStatusEnum.

Campagne

  • È stato aggiunto Campaign.missing_eu_political_advertising_declaration per supportare l'interrogazione e il filtro delle campagne per le quali mancano dichiarazioni relative alla presenza o meno di pubblicità politica rivolta all'UE.

v22 (2025-10-15)

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

Asset

  • È stato aggiunto LANDING_PAGE_PREVIEW come nuovo tipo di campo dell'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 in modo invisibile a 1000).
  • È 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 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.1 (25/02/2026)

Nella versione 21.1 è stata aggiunta la seguente nuova funzionalità.

Gestione account

  • È stato aggiunto il campo contains_eu_political_advertising alla risorsa Customer. Questo campo recupera lo stato della dichiarazione a livello di account che indica se contiene pubblicità politica rivolta all'UE e restituisce un EuPoliticalAdvertisingStatusEnum.

Campagne

  • È stato aggiunto Campaign.missing_eu_political_advertising_declaration per supportare l'interrogazione e il filtro delle campagne per le quali mancano dichiarazioni relative alla presenza o meno di pubblicità politica rivolta all'UE.

v21 (2025-08-06)

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 del 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 la 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 pubblicità politica nell'UE

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

  • È stato aggiunto Campaign.contains_eu_political_advertising. Questo campo indica se la tua campagna contiene contenuti pubblicitari politici destinati all'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 con 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 gruppo di annunci. Le chiamate API per creare o aggiornare questi criteri della campagna o del gruppo di annunci per le campagne esistenti non andranno a buon fine e verrà restituito 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 impostazione di 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 pubblicità 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

Note di rilascio archiviate

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