Note di rilascio

v22 (15/10/2025)

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

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

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 URL finale, prompt in formato libero, contesto della campagna esistente o ricontestualizzando immagini di prodotti esistenti.
  • Gli errori durante la generazione degli asset vengono restituiti con codici compresi tra AssetGenerationErrorEnum.

Campagne

• Sono stati aggiunti nuovi obiettivi di offerta per le campagne per app per installazioni (ACi) da ottimizzare senza specificare un target, utili per una rapida scalabilità o quando determinare il target giusto è difficile. In AppCampaignBiddingStrategyGoalType:
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: Utilizza con la strategia standard Massimizza le conversioni.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: Utilizza l'offerta standard Massimizza il valore di conversione.
• È stato aggiunto il supporto per il tipo di strategia di offerta quota fissa di impressioni.
• Aggiunta di Campaign.feed_types, che mostra i tipi di feed collegati a una campagna. Per le campagne Performance Max, questo può indicare il verticale dell'attività, ad esempio MERCHANT_CENTER_FEED per la vendita al dettaglio.
• È consentito allegare NEGATIVE_KEYWORDS set condivisi a MULTI_CHANNEL (per le campagne per app) e LOCAL campagne.

Demand Gen

• È stata aggiunta la strategia di offerta basata su CPC target per le campagne Demand Gen. Questa strategia imposta le offerte in modo da massimizzare i clic al costo per clic (CPC) target configurato.
  • Imposta il CPC target a livello di campagna utilizzando Campaign.target_cpc.
  • Esegui l'override a livello di gruppo di annunci utilizzando AdGroup.target_cpc_micros.
• È stato aggiunto un nuovo AssetAutomationType:
  • GENERATE_DESIGN_VERSIONS_FOR_IMAGES: Disponibile per DemandGenMultiAssetAds. Se attivata, questa opzione aggiunge elementi di design e incorpora asset di testo negli asset immagine per creare nuovi asset immagine con proporzioni diverse. I nuovi DemandGenMultiAssetAds sono attivati per impostazione predefinita.
• È stato aggiunto un nuovo AssetAutomationType:
  • GENERATE_VIDEOS_FROM_OTHER_ASSETS: Disponibile per DemandGenMultiAssetAds. Se attivata, genera video utilizzando altri asset come immagini e testo. Questi video possono poi essere utilizzati per creare nuovi DemandGenVideoResponsiveAds. I nuovi DemandGenMultiAssetAds sono attivati per impostazione predefinita.
• Il campo BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros è stato rinominato minimum_budget_amount_micros.

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 limite era di 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 AssetAutomationType valori 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 recuperare automaticamente le immagini dagli URL finali. L'impostazione predefinita è l'impostazione delle estensioni immagine dinamiche a livello di account.
• Rimozione di AssetPerformanceLabel per le campagne Performance Max.
• La funzionalità del Campaign.url_expansion_opt_out rimosso è ora 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.
  • ad_using_product_data: Indica se un annuncio utilizza i dati di prodotto di un feed Google Merchant Center.
  • ad_using_video: Indica se un annuncio utilizza un asset video.

Pianificazione

• In UserListCrmDataSourceType, è stato aggiunto il valore THIRD_PARTY_PARTNER_DATA.
• Sono stati aggiunti nuovi codici di errore relativi ai segmenti di pubblico partner:
  • PARTNER_AUDIENCE_SOURCE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • COMMERCE_PARTNER_NOT_ALLOWED
  • PARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_MANAGER_ACCOUNT_DISALLOWED
  • PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ADVERTISER_TOS_NOT_ACCEPTED
  • ADVERTISER_PARTNER_LINK_MISSING
  • ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPE
  • INVALID_CAMPAIGN_TYPE_FOR_THIRD_PARTY_PARTNER_DATA_LIST
• Aggiunta di is_active_live_stream_creator a YouTubeMetrics. Questo valore viene restituito da ContentCreatorInsightsService.GenerateCreatorInsights e indica se un creator ha pubblicato un live streaming negli ultimi 90 giorni.

• È stato aggiunto un nuovo messaggio PlannableUserListMetadata che contiene UserListCrmDataSourceType in PlannableUserList. Questo messaggio viene restituito da 'ReachPlanService.ListPlannableUserLists' per mostrare se un'origine dati dell'elenco di utenti CRM è FIRST_PARTY o THIRD_PARTY_PARTNER_DATA.

• In ReachPlanService, è stato aggiunto il campo trueview_views, che sostituisce il campo views.

• In TrendInsight è stato aggiunto il supporto per related_videos e related_creators. Sono stati aggiunti anche i metadati delle proprietà dei video e le date di pubblicazione in YouTubeVideoAttributeMetadata.video_properties e YouTubeVideoAttributeMetadata.publish_date.

• AudienceInsightsService.GenerateInsightsFinderReport ora supporta parental_status e income_ranges, nonché combinazioni AND/OR più complesse di argomenti e segmenti di pubblico.

Report

• Sono stati aggiunti due nuovi tipi di clic: CLICK_TO_MESSAGE_THIRD_PARTY_CLICK e CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
• AssetGroupAsset ora può essere segmentato per device, conversion_action, conversion_action_name, e conversion_action_category.
• AdGroupAdAssetView e AdGroupAdAssetCombinationView ora supportano completamente le metriche sul rendimento e sulle conversioni per RESPONSIVE_SEARCH_AD. In precedenza, in queste visualizzazioni venivano restituite solo le impressioni per questo tipo di annuncio.
• Per facilitare l'esplorazione Smart Bidding, le seguenti metriche sono ora segmentabili in base ai campi data (date, month, quarter, week, year):
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
• È stata aggiunta una nuova risorsa: TargetingExpansionView, che riporta le metriche per le espansioni rispetto al targeting manuale, ad esempio l'espansione senza parole chiave per AI Max per campagne sulla rete di ricerca.

• Sono stati aggiunti nuovi segmenti per le campagne PMax. Consulta Aggiornamenti di Performance Max.

  Shopping

• È stato corretto l'ambito delle metriche per campagne e gruppi di annunci nella risorsa ShoppingProduct.

Obiettivi unificati

• È stato aggiunto il supporto per gli obiettivi di fidelizzazione dei clienti per ottimizzare il coinvolgimento dei clienti esistenti.
  • Configura il targeting utilizzando CampaignRetentionGoalSettings.target_option:
    • TARGET_SPECIFIC: Utilizza solo gli utenti degli elenchi di utenti associati alla campagna. (attualmente solo per la lista consentita).
    • TARGET_ALL (Predefinito): ha come target tutti gli utenti per il ricoinvolgimento.

Video

• Sono state rinominate diverse metriche correlate alle visualizzazioni video:
  • average_cpv è diventato trueview_average_cpv
  • video_view_rate è diventato video_trueview_view_rate
  • video_views è diventato video_trueview_views
  • video_view_rate_in_feed è diventato video_trueview_view_rate_in_feed
  • video_view_rate_in_stream è diventato video_trueview_view_rate_in_stream
  • video_view_rate_shorts è diventato video_trueview_view_rate_shorts
• Sono state aggiunte metriche per il tempo di visualizzazione degli annunci video:
  • video_watch_time_duration_millis: Tempo di visualizzazione totale.
  • average_video_watch_time_duration_millis: Tempo di visualizzazione medio per impressione.

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 le 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 della versione precedente verranno comunque rispettati finché AI Max per le campagne sulla rete di ricerca non verrà attivato e disattivato in modo esplicito.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.

• Aggiunta di 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 in AI Max per le 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 include 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

• Sono stati aggiunti i campi terms_and_conditions_text, terms_and_conditions_uri, promotion_barcode_info e promotion_qr_code_info in PromotionAsset. I campi del codice a barre e del codice QR si trovano all'interno di promotion_trigger oneof. Consulta l'articolo del Centro assistenza Informazioni sugli asset di promozione.

• Aggiunta di FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION a AssetAutomationTypeEnum. Con questa impostazione, puoi controllare la generazione automatica di asset di testo e pagine di destinazione dall'URL finale nelle campagne sulla rete di ricerca.

• È stato aggiunto un nuovo servizio AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset per rimuovere gli asset creati automaticamente da Campaign. Questo servizio supporta solo la rimozione dell'asset di espansione dell'URL finale.

• Aggiunta di DESCRIPTION_PREFIX all'enumerazione ServedAssetFieldType. È stato corretto un problema per cui il served_asset_field_type in ad_group_ad_asset_combination_view era UNKNOWN per gli asset che fungevano da prefisso della descrizione.

Campagne

• È stato aggiunto un nuovo valore enum MISSING_LOCATION_TARGETING a CampaignPrimaryStatusReason. Questo nuovo motivo dello stato verrà restituito solo per le campagne con limitazioni geografiche che non specificano il targeting per località. Per le campagne con limitazioni di località, qualsiasi tentativo di aggiungere il targeting per località al di fuori dell'area consentita genererà l'errore del criterio LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN.

• È stato aggiunto il supporto per i partner di integrazione di terze parti ai livelli VideoCustomer.third_party_integration_partners e Campaign.third_party_integration_partners. Consulta l'articolo del Centro assistenza Monitorare le conversioni da app con analisi di app di terze parti.

• Ora puoi impostare il campo advertising_partner_ids per un Campaign esistente. In precedenza, questo campo poteva essere impostato solo per una nuova campagna durante la creazione. Il campo rimane immutabile dopo l'impostazione.

• Utilizzando un elenco condiviso di tipo TYPE_PLACEMENT_LIST definito a livello di account amministratore, gli inserzionisti possono ora utilizzare i criteri CustomerNegativeCriterion per escludere un elenco di posizionamenti nei singoli account cliente inserzionista.

• Aggiunta di DESCRIPTION_PREFIX all'enumerazione ServedAssetFieldType. È stato corretto un problema per cui il served_asset_field_type in ad_group_ad_asset_combination_view era UNKNOWN per gli asset che fungevano da prefisso della descrizione.

• È stato aggiunto il supporto per il campo target_roas_tolerance_percent_millis nelle strategie di offerta MaximizeConversionValue e TargetRoas. TargetRoas.target_roas_tolerance_percent_millis è disponibile solo per le strategie di portafoglio, che sono disponibili solo per le campagne sulla rete di ricerca.

• È stato modificato un codice di errore ProductGroup. Per le richieste con un errore parziale abilitato, LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION verrà restituito al posto di INVALID_LISTING_GROUP_HIERARCHY.

• È stata aggiunta una nuova risorsa LocationInterestView che riepiloga il rendimento dei criteri di interesse per la località del gruppo di annunci.

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. Questo campo, se impostato su TRUE, veniva utilizzato in precedenza per distinguere l'errore CLICK_NOT_FOUND da SUCCESS per le importazioni delle conversioni avanzate per i lead.

Demand Gen

• È stato aggiunto un codice di errore CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM. In futuro, questo errore verrà restituito quando si tenta di impostare un importo del budget molto basso per una campagna Demand Gen. I dettagli sul budget minimo richiesto sono disponibili nel nuovo campo dei dettagli dell'errore budgetDailyMinimumErrorDetails.

Modifiche alla propaganda politica nell'UE

Queste modifiche alla pubblicità politica dell'UE sono state apportate anche alle versioni 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 genereranno 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à 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 impostare questo campo non è ancora applicato, 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 contengono 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.

• Aggiunta la segnalazione 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

• È stato aggiunto un nuovo metodo ReachPlanService.ListPlannableUserInterests, che consente agli inserzionisti di scoprire gli interessi degli utenti (affinità e mercati in-market) supportati da ReachPlanService.GenerateReachForecast. Il metodo supporta la ricerca di tipi di interessi specifici degli utenti e l'interrogazione per nomi e percorsi.

• Aggiunto AdditionalApplicationInfo a ReachPlanService.ListPlannableUserLists come campo di input facoltativo.

• È stato aggiunto il supporto per AudienceInsightsService.ListAudienceInsightsAttributes per recuperare gli elenchi di utenti proprietari disponibili per l'ID cliente che effettua la richiesta.

• È stato aggiunto il supporto degli elenchi di utenti proprietari a AudienceInsightsService.GenerateAudienceCompositionInsights per recuperare approfondimenti per i segmenti di pubblico che hanno come target un elenco di utenti. Qualsiasi richiesta che ha come target un elenco utenti restituirà solo l'indice del pubblico ed è disponibile solo per i seguenti AudienceInsightsDimension: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST.

• È stato aggiornato il tipo di input del pubblico a InsightsAudience per AudienceInsightsService.GenerateTargetingSuggestionMetrics. Il nuovo input del segmento di pubblico consente una combinazione AND-of-OR degli interessi degli utenti, supportando le metriche di potenziale copertura per definizioni di segmenti di pubblico più personalizzate.

• Aggiunta della quota di pubblico a TrendInsightMetrics per ottenere la quota di un pubblico per una tendenza.

• Sono state aggiunte nuove categorie correlate a KnowledgeGraphAttributeMetadata in modo che gli utenti possano filtrare gli attributi del Knowledge Graph per categoria.

Report

• Ora sono disponibili una serie di nuove metriche per AssetGroupAsset, ChannelAggregateAssetView, e CampaignAggregateAssetView. Inoltre, per ChannelAggregateAssetView e CampaignAggregateAssetView, impressions, che in precedenza era azzerato per le campagne Performance Max, ora verrà riportato il suo valore effettivo.

• È stata resa selezionabile la risorsa AssetSet con ChangeStatus in modo che gli utenti possano ottenere maggiori informazioni sulla risorsa di tipo AssetSet o CampaignAssetSet in una sola query.

• È stata resa selezionabile la risorsa CampaignAssetSet con ChangeStatus, in modo che gli utenti possano ottenere maggiori informazioni sulla risorsa di tipo AssetSet o CampaignAssetSet in una sola query.

• È stato aggiunto un nuovo segmento search_term_targeting_status che può essere selezionato nella visualizzazione dei termini di ricerca della campagna.

• Aggiunta di un nuovo final_url_expansion_asset_view.

• È stato aggiunto il supporto per le metriche value_adjustment e all_value_adjustment nel report AssetGroup.

• Metrica AssetGroupAsset segmentabile per ad_network_type.

• È stato aggiunto un nuovo segmento landing_page_source che può essere utilizzato con la risorsa landing_page_view.

• È stato aggiunto un nuovo segmento search_term_match_source che può essere selezionato nelle visualizzazioni dei termini di ricerca e dei termini di ricerca delle campagne.

• È stato aggiunto un nuovo segmento match_type che può essere selezionato dalla visualizzazione delle parole chiave.

• È stato aggiunto il supporto per le metriche per i cluster di intent di query unici con:

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

• È stato aggiunto un nuovo tipo di clic VEHICLE_ASSETS nella segmentazione click_view per monitorare e segnalare i clic correlati ai formati degli annunci specifici per gli asset dei veicoli.

Esplorazione Smart Bidding per le strategie di offerta basate sul ROAS target nella rete di ricerca

• Ora puoi attivare l'esplorazione Smart Bidding nelle campagne sulla rete di ricerca impostando il campo target_roas_tolerance_percent_millis nelle strategie di offerta MaximizeConversionValue e TargetRoas su qualsiasi valore divisibile per 1000 compreso tra 10.000 (10%) e 30.000 (30%) inclusi. Le strategie di offerta MaximizeConversionValue dovranno anche impostare il campo target_roas. TargetRoas.target_roas_tolerance_percent_millis è disponibile solo per le strategie di portafoglio. Consulta il nostro post del blog sull'esplorazione dell'offerta intelligente e l'articolo del Centro assistenza.

• Ora è supportata la generazione di report sulla diversità aggregata per le seguenti metriche per i cluster di intent di query unici. Nell'interfaccia utente di Google Ads è disponibile una visualizzazione segmentata per ora.

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

Video

• Aggiunta di YouTubeVideoListAsset. È stato aggiunto anche Asset#youtube_video_list_asset, che può essere utilizzato per creare un collegamento tra un campaign e un tipo YouTubeVideoListAsset. Consulta l'articolo del Centro assistenza Utilizzare i video correlati.

• Sono stati aggiunti nuovi campi di metadati a YouTubeChannelInsights e YouTubeVideoAttributeMetadata.

• Sono stati esposti nuovi tipi di clic: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK e PRODUCT_ASSETS.

• È stato aggiunto il campo allow_non_skippable_in_stream a VideoAdInventoryControl per consentire la pubblicazione degli annunci video adattabili come annunci in-stream non ignorabili. Questa opzione è disponibile per le campagne che supportano la combinazione del formato non ignorabile con altri formati.

• Sono stati aggiunti i campi Campaign.VideoCampaignSettings.video_ad_sequence e AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting (di sola lettura). Consulta l'articolo del Centro assistenza Informazioni sulla sequenza di annunci video.

• Sono stati aggiunti nuovi campi di metadati a YouTubeChannelInsights e YouTubeVideoAttributeMetadata.

• Sono stati aggiunti il tipo di criterio VIDEO_LINEUP e il campo video_lineup a CampaignCriterion e AdGroupCriterion. Questa funzionalità è disponibile solo per gli account inclusi nella lista consentita. Per informazioni dettagliate, contatta il tuo rappresentante per lo sviluppo aziendale di Google.

• È stato aggiunto un report sull'idoneità dei contenuti sia a livello di dettaglio che di gruppo. Consulta l'articolo del Centro assistenza Informazioni sul report "Idoneità dei contenuti".

v20.1 (06/08/2025)

Queste modifiche alla pubblicità politica dell'UE sono state apportate anche alle 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à 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 impostare questo campo non è ancora applicato, 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 autodichiarato se contengono pubblicità 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

• new_customer_lifetime_value
• all_new_customer_lifetime_value
• 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

Colonne dei segmenti

• ad_network_type
• conversion_action
• conversion_action_name
• conversion_action_category
• external_conversion_source
• conversion_attribution_event_type
• conversion_adjustment
• conversion_lag_bucket
• conversion_or_adjustment_lag_bucket
• new_versus_returning_customers
• device
• slot

Campagne

• È stato aggiunto il supporto per l'aggiunta e l'aggiornamento delle parole chiave escluse a livello di campagna per le campagne Performance Max.

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 l'account principale di monitoraggio delle conversioni esistente con un account amministratore diverso.

• È 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 raccolti sui tuoi siti, nelle tue app e in altre proprietà e di ottenere il consenso ove richiesto dalla legge o dalle norme di Google vigenti. Per ulteriori dettagli, consulta la pagina Informazioni sulle importazioni delle conversioni offline.

Demand Gen

• Sono stati aggiunti nuovi valori al segmento ad_network_type che consentono di segmentare le campagne Demand Gen per canale:
  • MAPS
  • GMAIL
  • DISCOVER
• Sono state aggiunte metriche per le conversioni confrontabili con altre piattaforme:
  • platform_comparable_conversions_from_interactions_rate
  • platform_comparable_conversions
  • platform_comparable_conversions_value
  • platform_comparable_conversions_value_per_cost
  • platform_comparable_conversions_by_conversion_date
  • platform_comparable_conversions_value_by_conversion_date
  • platform_comparable_conversions_from_interactions_value_per_interaction
  • cost_per_platform_comparable_conversion
  • value_per_platform_comparable_conversion
  • value_per_platform_comparable_conversions_by_conversion_date
  • cost_converted_currency_per_platform_comparable_conversion

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, come DynamicLineupAttributeMetadata e AudienceInsightsDynamicLineup, sono stati rimossi per allinearsi alla rimozione più ampia dei lineup dinamici in Google Ads. Questa funzionalità è disponibile solo per gli account inclusi in una lista consentita.
• Aggiunta di 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 filtri AudienceInsightsDimension.DEVICE e AudienceInsightsAttribute.device in entrambi i servizi. Questa funzionalità è disponibile solo per gli account inclusi in una lista consentita.
• Sono state aggiunte metriche video aggregate aggiuntive 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 secondarie per perfezionare le ricerche degli 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 un cliente, ed è stato aggiunto UserListInfo alle opzioni di targeting per segmento di pubblico in GenerateReachForecastRequest. In questo modo puoi recuperare gli 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 proprietari sul pubblico direttamente nelle previsioni. La previsione della copertura è disponibile solo per gli account inclusi nella lista consentita.

Video

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

v19.2 (06/08/2025)

Queste modifiche alla pubblicità politica dell'UE sono state apportate anche nelle release v20.1 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à 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 impostare questo campo non è ancora applicato, ma lo sarà in futuro. Attendi l'annuncio di questa modifica.

• Le prove e gli esperimenti genereranno un ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se le campagne dell'esperimento non hanno autodichiarato se contengono pubblicità politica che ha come target l'Unione Europea.

v19.1 (16/04/2025)

Nella versione 19.1 sono state aggiunte le seguenti funzionalità e modifiche.

Asset

• È stato aggiunto un campo asset_coverage per AssetGroup che restituisce informazioni sulle lacune nel gruppo di asset.
  • Contiene un campo secondario ad_strength_action_items che restituisce un elenco di azioni che un inserzionista può intraprendere per migliorare l'efficacia dell'annuncio di un gruppo di asset.

Campagne

• Ora puoi valutare o fornire feedback per i lead nelle Campagne di Servizi locali. Nell'ambito di questa modifica, la versione 19.1
  • È stato aggiunto un nuovo servizio denominato LocalServicesLeadService. Puoi utilizzare il metodo ProvideLeadFeedback per caricare la valutazione e il feedback per i lead.
  • È stato aggiunto un nuovo campo denominato lead_feedback_submitted a LocalServicesLead per determinare se il feedback è stato inviato a un lead.
• È stata aggiunta una nuova colonna delle metriche biddable_cohort_app_post_install_conversions per le campagne per app.

Demand Gen

• Nei servizi di pianificazione sono stati introdotti metodi aggiuntivi per supportare Demand Gen.

• È stato aggiunto il supporto per i controlli dei canali per le campagne Demand Gen a livello di gruppo di annunci. Puoi selezionare un raggruppamento generale predefinito di canali o un sottoinsieme di canali utilizzando il campo demand_gen_ad_group_settings. I seguenti canali sono supportati nella release attuale:

  • Annuncio in-stream di YouTube
  • In-feed di YouTube
  • YouTube Shorts
  • Feed personalizzato
  • Gmail
  • Display

• È stato esposto un nuovo tipo di asset per TALL_PORTRAIT_MARKETING_IMAGE. Questo tipo di asset si riferisce al campo tall_portrait_marketing_images del formato annuncio multiasset Demand Gen.

Cronologia delle modifiche

• È stato aggiunto il supporto per altri tre tipi di risorse in ChangeStatusResourceType:
  • CAMPAIGN_BUDGET
  • ASSET_SET
  • CAMPAIGN_ASSET_SET
• Puoi recuperare questi tre tipi più granulari dal report change_status.

Conversioni

• Ora puoi impostare il campo google_ads_conversion_customer durante la creazione di un nuovo cliente utilizzando l'API Google Ads. In precedenza, questo era un campo di sola lettura.

  NOTA:questa funzionalità è disponibile solo per una lista consentita chiusa. Per utilizzarlo, contatta il tuo account manager.

• Ora puoi specificare il tipo di cliente associato alla conversione quando carichi le conversioni offline.

• È stato introdotto un nuovo campo session_attributes per ClickConversion.

Annunci di Servizi locali

• È stata aggiunta una nuova RPC ProvideLeadFeedback a LocalServicesLeadService per fornire feedback sulla qualità di LocalServicesLead.
• È stato aggiunto un nuovo campo lead_feedback_submitted alla risorsa LocalServicesLead che conferma se è stato fornito un feedback per una risorsa specifica.

Servizi di pianificazione

• È stato aggiunto il supporto per le previsioni mensili della frequenza target in ReachPlanService.GenerateReachForecast.
  • Gli sviluppatori possono impostare TargetFrequencyTimeUnit.MONTHLY in TargetFrequencySettings quando utilizzano il codice prodotto pianificabile TARGET_FREQUENCY per generare una previsione della copertura mensile della frequenza target.
• È stato aggiunto un nuovo metodo ReachPlanService.GenerateConversionRates, che consente agli inserzionisti di richiedere tassi di conversione suggeriti per i prodotti pianificabili supportati.
• Previsione Demand Gen in ReachPlanService.GenerateReachForecast:
  • Gli sviluppatori ora possono richiedere previsioni della copertura per le campagne Demand Gen. Gli sviluppatori possono utilizzare il nuovo codice prodotto pianificabile DEMAND_GEN_MAX_CONVERSIONS per generare previsioni della copertura Demand Gen.
  • È stato aggiunto un nuovo campo conversion_rate che consente agli sviluppatori che richiedono previsioni della copertura Demand Gen di fornire un tasso di conversione. I tassi di conversione suggeriti possono essere recuperati utilizzando il nuovo metodo ReachPlanService.GenerateConversionRates. Questo campo è obbligatorio per le richieste di previsione Demand Gen. Non è supportato per altri prodotti pianificabili.
  • Aggiunto un nuovo campo conversions alle previsioni restituite. Questo campo contiene il numero di conversioni in un determinato punto della curva di copertura. Le conversioni sono supportate solo per il prodotto pianificabile DEMAND_GEN_MAX_CONVERSIONS.

Consigli

• Il nuovo campo ad_strength è disponibile per ImprovePerformanceMaxAdStrengthRecommendation, che restituisce il punteggio di efficacia dell'annuncio corrente del gruppo di asset associato al consiglio.

  Shopping

• Ora puoi ignorare le esclusioni dei brand per gli annunci Shopping nelle campagne Performance Max. Questo viene esposto tramite un nuovo campo pmax_campaign_settings a livello di campagna e funziona solo per le campagne PMax per la vendita al dettaglio. Se tenti di impostare questo campo per un tipo di campagna incompatibile, verrà generato un nuovo errore CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED.

Video

• È stato aggiunto il supporto di sola lettura per gli annunci audio. Consulta il Centro assistenza Google Ads per scoprire di più su questa funzionalità. Questa modifica espone:
  • È stato creato un nuovo AdvertisingChannelSubType denominato YOUTUBE_AUDIO.
  • Un nuovo AdGroupType chiamato YOUTUBE_AUDIO.
  • Una nuova enumerazione del formato dell'annuncio denominata YOUTUBE_AUDIO_AD e i relativi campi YouTubeAudioAdInfo.
• Sono state aggiunte nuove metriche e segmenti alle metriche sulla copertura delle query con aggiustamento demografico. Nel quadro di questi cambiamenti,
  • Sono state introdotte due nuove colonne delle metriche denominate coviewed_impressions e primary_impressions.
  • Sono stati introdotti due nuovi segmenti denominati adjusted_age_range e adjusted_gender.
  • Se uno dei due nuovi segmenti viene selezionato insieme a un campo della metrica di copertura (coviewed_impressions, primary_impressions, unique_users o average_impression_frequency_per_user), anche l'altro segmento deve essere selezionato per recuperare statistiche valide per queste colonne.
  • Questa funzionalità è attualmente disponibile solo per i clienti autorizzati.

v19 (26/02/2025)

Nella versione 19 sono state aggiunte le seguenti funzionalità e modifiche.

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

Gestione dell'account

• Sono stati aggiunti i seguenti valori a CustomerError per tenere conto delle modifiche imminenti:
  • CREATION_DENIED_FOR_POLICY_VIOLATION
  • CREATION_DENIED_INELIGIBLE_MCC

Annunci

• È stato aggiunto DemandGenMultiAssetAdInfo.tall_portrait_marketing_images per supportare gli asset immagine verticali con proporzioni 9:16 negli annunci Demand Gen.

Asset

• (Solo per gli account inclusi nella lista consentita) È stato aggiunto il supporto per gli asset di messaggistica tramite Asset.business_message_asset, BusinessMessageAsset e i seguenti enum ed errori.
  • Enum:
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • Errori:
    • AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
    • ResourceLimitType
      • BUSINESS_MESSAGE_ASSET_LINKS_PER_CUSTOMER
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_CAMPAIGN
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_AD_GROUP
• È stato aggiunto AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW per supportare la generazione automatica di un'anteprima della pagina di destinazione.
• AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS è ora attivato per impostazione predefinita per gli annunci video Demand Gen responsivi.
• (Solo per gli account inclusi nella lista consentita; la lista consentita è attualmente chiusa) Aggiunti Asset.app_deep_link_asset e AppDeepLinkAsset.

Conversioni

• Obiettivi di conversione
  • LifecycleGoalValueSettings.high_lifetime_value non è più in versione beta ed è ora modificabile.
  • Aggiunto CustomerLifecycleGoal.owner_customer per mostrare il nome risorsa del cliente proprietario dell'obiettivo del ciclo di vita del cliente.
• ConversionActionType.SALESFORCE deprecato.

Feed

• Sono state rimosse tutte le entità correlate ai feed, come Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view e così via. Gli utenti ora devono utilizzare assets per raggiungere lo stesso scopo.

Hotel e viaggi

• Sono stati resi min_days e max_days di ValueRuleItineraryAdvanceBookingWindow un campo optional per consentire di specificare 0 come valore. Ciò supporta il targeting per le ricerche di viaggi che vengono effettuate oggi.

Performance Max

• (Solo per gli account inclusi nella lista consentita) Linee guida per il brand
  • Reso Campaign.brand_guidelines_enabled modificabile solo durante la creazione di una campagna Performance Max.
  • Questa impostazione è incompatibile con Performance Max per gli obiettivi di viaggio.
  • Per attivare le linee guida per il brand per le campagne Performance Max esistenti, utilizza un CampaignService.EnablePMaxBrandGuidelines aggiunto di recente. La disattivazione delle linee guida per il brand non è supportata.
  • Sono stati aggiunti Campaign.brand_guidelines e BrandGuidelines per consentire l'impostazione dei colori e della famiglia di caratteri del brand.
  • Nuovi valori di errore:
    • BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
    • BrandGuidelinesMigrationError
    • BRAND_GUIDELINES_ALREADY_ENABLED
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
    • BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
    • CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
    • AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
    • TOO_MANY_ENABLE_OPERATIONS
  • CampaignError
  • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
  • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
  • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
  • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
  • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
  • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
  • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
• È stato aggiunto AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS per supportare la generazione automatica di asset video migliorati per le campagne Performance Max.

Pianificazione

• (Solo per gli account inclusi nella lista consentita) È stato aggiunto ContentCreatorInsightsService.GenerateTrendingInsights che consente agli utenti di visualizzare gli argomenti dei contenuti di tendenza su YouTube per determinate definizioni di pubblico.
• Aggiunta GenerateCreatorInsightsRequest.country_locations[] per specificare i paesi in cui cercare i criteri indicati
• È stato aggiunto GenerateCreatorInsightsRequest.search_brand per specificare un brand per la ricerca di creator
• Sono stati aggiunti nuovi campi a YouTubeChannelInsights per fornire informazioni aggiuntive sui canali per le richieste search_channels:
  • channel_url
  • channel_description
  • top_videos
• Sono stati aggiunti nuovi campi dei metadati a AudienceInsightsAttributeMetadata:
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

Video

• Dopo il rilascio di DataLinkService.CreateDataLink, abbiamo aggiunto i seguenti metodi per consentire la modifica dei link ai dati creati in precedenza:
  • RemoveDataLink per rimuovere i collegamenti dei dati in un account Google Ads
  • UpdateDataLink per accettare, rifiutare e revocare i collegamenti dei dati in un account Google Ads
• È stato rimosso il supporto per VIDEO_OUTSTREAM dai seguenti enum:
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

Note di rilascio archiviate

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