Note di rilascio

v21 (6/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 le 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 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 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 specifiche combinazioni. 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

• 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 geografiche, 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 per una nuova campagna solo durante la sua creazione.

• 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 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 propaganda 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 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 della campagna o del 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 contengono pubblicità politica che ha come target l'Unione Europea.

Performance Max

• Per le nuove campagne PMax, 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-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 della campagna o del 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 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 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 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 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 video statico 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 alle 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 della campagna o del 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. 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 dichiarato autonomamente se contengono propaganda 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 per i 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 dei 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 denominato 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 appena aggiunto. 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.