Vuoi condividere il tuo feedback sull'API Google Ads? Registrati per ricevere un invito a partecipare alla ricerca sugli utenti.

Questa pagina è stata tradotta dall'API Cloud Translation.

Note di rilascio

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 su lacune nel gruppo di asset.
- Contiene un sottocampo 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 un 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 è stato inviato un feedback a un lead.
È stata aggiunta una nuova colonna delle metriche biddable_cohort_app_post_install_conversions per le campagne per app.

Demand Gen

Per supportare Demand Gen sono stati introdotti metodi aggiuntivi nei servizi di pianificazione.
È stato aggiunto il supporto per i controlli dei canali a livello di gruppo di annunci per le campagne Demand Gen. 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 corrente:
- Annuncio in-stream di YouTube
- In-feed di YouTube
- YouTube Shorts
- Scopri
- 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 dell'annuncio multi asset Demand Gen.

Cronologia delle modifiche

È stato aggiunto il supporto di 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.
Ora puoi specificare il tipo di cliente associato alla conversione durante il caricamento delle 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 frequenza target previsione della copertura mensile.
È stato aggiunto un nuovo metodo ReachPlanService.GenerateConversionRates, che consente agli inserzionisti di richiedere i tassi di conversione suggeriti per i prodotti pianificabili supportati.
Previsione Demand Gen in ReachPlanService.GenerateReachForecast:
- Ora gli sviluppatori possono richiedere previsioni sulla copertura per le campagne Demand Gen. Gli sviluppatori possono utilizzare il nuovo DEMAND_GEN_MAX_CONVERSIONScodice prodotto pianificabile per generare previsioni sulla copertura di Demand Gen.
- È stato aggiunto un nuovo campo conversion_rate che consente agli sviluppatori che richiedono le previsioni di copertura di 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 di Demand Gen. Non è supportato per altri prodotti pianificabili.
- È stato 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 pianificabileDEMAND_GEN_MAX_CONVERSIONS.

Consigli

Il nuovo campo ad_strength è disponibile per ImprovePerformanceMaxAdStrengthRecommendation e 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 valore è disponibile tramite un nuovo campo pmax_campaign_settings a livello di campagna e funziona solo per le campagne Performance Max per la vendita al dettaglio. Se provi a 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 in sola lettura per gli annunci audio. Per scoprire di più su questa funzionalità, consulta il Centro assistenza Google Ads. Queste modifiche mostrano:
- Un nuovo AdvertisingChannelSubType denominato YOUTUBE_AUDIO.
- Un nuovo AdGroupType denominato YOUTUBE_AUDIO.
- Una nuova enumerazione dei formati degli annunci denominata YOUTUBE_AUDIO_AD e i relativi campi YouTubeAudioAdInfo.
Sono stati aggiunti nuovi segmenti e nuove metriche alle metriche sulla copertura delle query con aggiustamento demografico. Nell'ambito di queste modifiche,
- Sono state introdotte due nuove colonne di 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 è selezionato insieme a un campo della metrica di copertura (coviewed_impressions, primary_impressions, unique_users o average_impression_frequency_per_user), deve essere selezionato anche l'altro segmento per recuperare statistiche valide per queste colonne.
- Questa funzionalità è attualmente disponibile solo per i clienti inclusi nella lista consentita.

v19 (26/02/2025)

Le seguenti funzionalità e modifiche sono state aggiunte nella versione 19.

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 il supporto degli asset immagine verticali con proporzioni 9:16 negli annunci Demand Gen.DemandGenMultiAssetAdInfo.tall_portrait_marketing_images

Asset

(Solo per gli account inseriti nella lista consentita) È stato aggiunto il supporto per gli asset messaggio tramite Asset.business_message_asset, BusinessMessageAsset e i seguenti enum ed errori.
- Enum:
- Errori:
  - AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
  - ResourceLimitType
È 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 è attivata per impostazione predefinita per gli annunci video adattabili Demand Gen.
(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.
- È stato aggiunto CustomerLifecycleGoal.owner_customer per mostrare il nome della risorsa del cliente proprietario dell'obiettivo del ciclo di vita del cliente.
ConversionActionType.SALESFORCE obsoleto.

Feed

Sono state rimosse tutte le entità correlate al feed, ad esempio Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view e così via. Ora gli utenti devono utilizzare assets per raggiungere lo stesso scopo. Consulta Note sulla migrazione per l'elenco di tutte le entità rimosse.

Hotel e viaggi

Sono stati impostati min_days e max_days di ValueRuleItineraryAdvanceBookingWindow un campo optional per consentire la specifica di 0 come valore. Questo supporta il targeting per le ricerche di viaggi che si verificano oggi.

Performance Max

(Solo per gli account inclusi nella lista consentita) Linee guida per il brand
- Campaign.brand_guidelines_enabled Il valore è modificabile solo quando viene creata una campagna Performance Max.
- Questa opzione è 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 del 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
- 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 il supporto per 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 di tendenza su YouTube per determinate definizioni di pubblico.
È stato aggiunto GenerateCreatorInsightsRequest.country_locations[] per specificare i paesi in cui cercare i criteri specificati
È stato aggiunto GenerateCreatorInsightsRequest.search_brand per specificare un brand per la ricerca dei creator
Sono stati aggiunti nuovi campi a YouTubeChannelInsights per fornire informazioni aggiuntive sul canale per le richieste di 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

In seguito al rilascio di DataLinkService.CreateDataLink, abbiamo aggiunto i seguenti metodi per consentire la mutazione 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 di VIDEO_OUTSTREAM dai seguenti enum:

v18 (16/10/2024)

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

Gestione dell'account

(Solo per gli account inseriti nella lista consentita) È stato aggiunto DataLinkService.CreateDataLink, che consente di collegare un account Google Ads ai video dei creator ospitati sul canale YouTube del creator. Il collegamento dei video consente all'account Google Ads di pubblicare annunci in partnership utilizzando i video dei creator.

Gruppi di annunci

È stato aggiunto AdGroup.exclude_demographic_expansion, che consente di escludere l'espansione dei dati demografici quando optimized_targeting_enabled è true, una funzionalità precedentemente supportata solo per Demand Gen.

Annunci

È stato aggiunto AdGroupAd.ad_group_ad_asset_automation_settings, che consente di attivare o disattivare la generazione automatica di asset per gli annunci.
Sono stati aggiunti i seguenti valori a AssetAutomationType:
- GENERATE_VERTICAL_YOUTUBE_VIDEOS
- GENERATE_SHORTER_YOUTUBE_VIDEOS
È stato aggiunto AdNetworkType.GOOGLE_OWNED_CHANNELS, che viene utilizzato dagli annunci pubblicati sui canali di proprietà di Google, come YouTube, Gmail e il feed di Discover.

Asset

AssetType.DISCOVERY_CAROUSEL_CARD è stato rinominato in AssetType.DEMAND_GEN_CAROUSEL_CARD.

Campagne

È stato aggiunto metrics.store_visits_last_click_model_attributed_conversions, che restituisce il numero di visite in negozio attribuite dal modello Ultimo clic di una campagna.
Sono state aggiunte le seguenti metriche relative alle visualizzazioni di video per una campagna:
È stato aggiunto metrics.results_conversions_purchase, che restituisce gli acquisti di conversione per i risultati degli obiettivi unificati di una campagna.
È stato modificato il valore predefinito di DemandGenCampaignSettings.upgraded_targeting da false a true.

Criterio

È stato aggiunto content_criterion_view, che restituisce le metriche sul rendimento dei contenuti scelti come target, come parole chiave, posizionamenti e argomenti, per le campagne display, Demand Gen e video.

Hotel e viaggi

Supporto dei feed viaggi negli annunci della rete di ricerca
- È stato aggiunto ClickType.TRAVEL_ASSETS per consentire la segmentazione delle metriche dei feed viaggi negli annunci della rete di ricerca.
- È stato aggiunto AssetSetType.TRAVEL_FEED che può essere utilizzato per attivare e disattivare l'utilizzo del feed viaggi negli annunci della rete di ricerca.
(Solo per gli account inclusi nella lista consentita) È stato aggiunto l'itinerario di viaggio come nuova regola per il valore di conversione con i seguenti nuovi campi e valori:
- ConversionValueRule.itinerary_condition con ValueRuleItineraryCondition, che consente di specificare una finestra per prenotazione anticipata, una durata dell'itinerario e i giorni della settimana di inizio del viaggio
- ConversionValueRulePrimaryDimensionEnum.ITINERARY
- ValueRuleSetDimension.ITINERARY
Sono stati aggiunti i seguenti segmenti per i report campaign e ad_group per consentire di segmentare i dati sul rendimento in base a destinazioni specifiche (città, paesi e regioni) per le campagne per hotel e sulla rete di ricerca:

Servizi locali

PhoneCallDetails.call_recording_url non sarà presente, anziché fornire un URL non valido, se la registrazione della chiamata non esiste per la conversazione con il lead di Servizi locali in questione.
È stato aggiunto CategoryBid.target_cpa_bid_micro che consente di impostare il CPA target per una categoria tramite Campaign.local_services_campaign_settings.

Performance Max

Supporto per le linee guida per il brand
- È stato aggiunto Campaign.brand_guidelines_enabled, che indica se le linee guida per il branding sono attivate per una determinata campagna Performance Max. Se questa opzione è attivata, gli asset con field_type impostato su BUSINESS_NAME, LOGO, LANDSCAPE_LOGO devono essere collegati come risorse CampaignAsset anziché come risorse AssetGroupAsset.
- Sono stati aggiunti errori CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED e CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED che indicano che le campagne Performance Max con linee guida del brand attivate non dispongono delle risorse CampaignAsset obbligatorie collegate alla campagna.
- Quando le linee guida del brand sono attivate, almeno un asset con field_type impostato su BUSINESS_NAME e almeno un asset con LOGO devono essere collegati alla campagna come risorse CampaignAsset. Le campagne Performance Max per le vendite online con un feed dei prodotti devono soddisfare questo requisito solo se sono presenti asset collegati ai gruppi di asset della campagna.
- Sono stati aggiunti i seguenti valori a AssetLinkError:
  - BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, che viene generato quando si tenta di collegare gli asset del brand alle campagne come risorse CampaignAsset anziché come risorse AssetGroupAsset nelle campagne Performance Max con le linee guida del brand non attivate.
  - Errore BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL che viene generato quando si tenta di collegare gli asset del brand alle campagne come risorse AssetGroupAsset anziché come risorse CampaignAsset nelle campagne Performance Max con le linee guida per il branding attivate.
È stato aggiunto performance_max_placement_view, che restituisce le impressioni dei posizionamenti in cui sono stati pubblicati gli annunci Performance Max.
AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION aggiunto

Pianificazione

(Solo per gli account inclusi nella lista consentita) È stato aggiunto un nuovo servizio con il metodo ContentCreatorInsightsService.GenerateCreatorInsights, che consente agli utenti di esplorare approfondimenti sui migliori creator di YouTube. In questo modo, i clienti possono cercare i creator in base a una combinazione di targeting per pubblico e targeting per contenuti o a approfondimenti sui creator in base a un elenco di ID canale YouTube.
Aggiornamenti a AudienceInsightsService.GenerateSuggestedTargetingInsights:
- audience, baseline_audience e data_month sono stati spostati in audience_definition.
- È stato aggiunto audience_description per generare suggerimenti di targeting da una descrizione di testo in formato libero utilizzando l'IA generativa.
È stato aggiunto AudienceInsightsService.GenerateTargetingSuggestionMetrics, che restituisce le metriche sulla copertura potenziale per determinate combinazioni di targeting per pubblico.

Consigli

RecommendationService.GenerateRecommendations ora può essere utilizzato per generare consigli sui suggerimenti di budget ottimizzati durante la creazione della campagna, includendo il tipo di consiglio CAMPAIGN_BUDGET in GenerateRecommendationsRequest.recommendation_types[]. Questo approccio è valido per le campagne Performance Max e sulla rete di ricerca.

Rapporti

I campi summary_row_setting e return_total_results_count di SearchGoogleAdsRequest sono stati sostituiti con il campo search_settings il cui tipo è SearchSettings con i seguenti campi:
- omit_results
- return_summary_row
- return_total_results_count
Sono state aggiunte le seguenti nuove metriche relative ai clic non validi generici, ad esempio quelli generati da bot o crawler e quelli con pattern irregolari. Possono essere sottoposti a query con il report campaign.
- metrics.general_invalid_clicks
- metrics.general_invalid_click_rate
Sono stati aggiunti i seguenti valori a QuotaError:
- EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

v17.1.0 (07/08/2024)

Nella versione 17_1 sono state aggiunte le seguenti nuove funzionalità e gli aggiornamenti riportati di seguito.

Asset

AdGroupAdService.RemoveAutomaticallyCreatedAssets() ti consente di rimuovere asset creati automaticamente specifici collegati agli annunci adattabili della rete di ricerca.

Segmenti di pubblico

Nuovi valori enum in UserListCustomerTypeCategory:
- LOYALTY_TIER_1_MEMBERS
- LOYALTY_TIER_2_MEMBERS
- LOYALTY_TIER_3_MEMBERS
- LOYALTY_TIER_4_MEMBERS
- LOYALTY_TIER_5_MEMBERS
- LOYALTY_TIER_6_MEMBERS
- LOYALTY_TIER_7_MEMBERS

Campagne

ShareablePreviewService.GenerateShareablePreviews() genera gli URL shareable_preview_url nella risposta per le anteprime degli annunci condivisibili per i gruppi di asset attivati e in pausa.
- Il campo expiration_date_time indica la data di scadenza degli URL nella risposta.
- Se si verifica un errore, il metodo restituirà partial_failure_error instead of the URLs.

Cronologia delle modifiche

Nuovo tipo di risorsa per la modifica dello stato: ASSET_GROUP.

Conversioni

Nuovo campo del segmento per la versione SKAdNetwork: segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary, che mostra i dati di diagnostica del caricamento delle conversioni a livello di azione di conversione.
Le seguenti metriche vengono aggiunte ai report di diagnostica offline per indicare il numero di conversioni caricate che sono ancora in fase di elaborazione:
- offline_conversion_upload_client_summary
  - pending_event_count
  - pending_rate
- offline_conversion_upload_conversion_action_summary:
  - pending_count

Pianificazione

AudienceInsights.GenerateAudienceOverlapInsights(), che accetta un attributo principale di input e una raccolta di attributi del segmento di pubblico e restituisce le stime della sovrapposizione della potenziale copertura di YouTube tra l'attributo principale e gli attributi del segmento di pubblico.

Rapporti

Supporto per la segmentazione di per_store_view in base a segments.date

Video

Supporto per il recupero delle informazioni relative alle seguenti strategie di offerta standard per le campagne video che utilizzano i report, ad esempio ad_group, campaign:
- Campaign.fixed_cpm (CPM fisso (costo per mille impressioni))
- Campaign.target_cpv (CPV target (costo per visualizzazione))
Campaign.video_campaign_settings che ti consente di determinare su quali inventari possono essere pubblicati gli annunci video utilizzando i seguenti campi del report:
segments.ad_format_type che consente di segmentare i seguenti report in base al tipo di formato dell'annuncio video:

v17 (05/06/2024)

Le seguenti funzionalità e modifiche sono state aggiunte nella versione 17.

Annunci

AdService.getAd rimosso. In questo modo, AdService viene allineato agli altri servizi nell' API Google Ads. Consulta la sezione Recupero degli oggetti per conoscere il metodo consigliato per recuperare gli annunci e altri tipi di risorse.
Sono state aggiunte altre convalide per ImageAdInfo.image_asset relative alle dimensioni e al formato. Se l'immagine non è valida, potrebbero verificarsi i seguenti errori:
- ImageError.UNEXPECTED_SIZE
- ImageError.FORMAT_NOT_ALLOWED

Asset

È stato aggiunto un nuovo enum: ClickType.AD_IMAGE
Sono stati aggiunti i seguenti nuovi report con nuove metriche per le campagne Performance Max e sulla rete di ricerca:
- campaign_aggregate_asset_view
- channel_aggregate_asset_view

Segmenti di pubblico

OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED aggiunto

Job batch

È stato aggiunto BatchJobError.REQUEST_TOO_LARGE, che verrà generato quando il valore AddBatchJobOperationsRequest inviato è maggiore di 10484504 byte.
È stato aggiunto il supporto per l'impostazione MutateOperation.asset_group_operation quando si utilizza BatchJobService. In questo modo puoi utilizzare l'elaborazione collettiva per creare e gestire intere campagne Performance Max. Consulta la nostra nuova guida dedicata.

Campagne

Il nome Discovery è stato rinominato in Demand Gen in tutti i campi, gli enum e gli errori di tutte le risorse dell'API Google Ads, ad esempio campagne, annunci e asset. Ad esempio, AdvertisingChannelType.DISCOVERY ora è AdvertisingChannelType.DEMAND_GEN.
È stato aggiunto Campaign.keyword_match_type per consentirti di impostare il tipo di corrispondenza delle parole chiave per tutte le parole chiave di una campagna.

Conversioni

Per le conversioni SKAdNetwork,
- segments.sk_ad_network_conversion_value è stato rinominato in segments.sk_ad_network_fine_conversion_value.
- segments.sk_ad_network_redistributed_fine_conversion_value aggiunto.
Le seguenti metriche vengono ora restituite con la risposta anche se sono pari a zero. In questo modo, sono coerenti con le altre metriche.

Criteri

Aggiunto ai seguenti campi per AdGroupCriterion mostrare se il criterio del gruppo di annunci viene pubblicato o i motivi per cui non viene pubblicato:
- primary_status
- primary_status_reasons
È stato aggiunto il supporto per metrics.search_impression_share per gender_view
È stato aggiunto il supporto per metrics.phone_calls per keyword_view

Servizi locali

È stato aggiunto LocalServicesLeadService.AppendLeadConversation() per accodare un nuovo LocalServicesLeadConversation a LocalServicesLead, che invia i messaggi agli utenti tramite canali appropriati come gli SMS, a seconda di come è stato creato il lead.
- La dimensione di AppendLeadConversationRequest.conversations è limitata a 1000.
- Solo LocalServicesLead con lead_type impostato su LeadType.MESSAGE può essere specificato in Conversation.local_services_lead.
Sono stati aggiunti nuovi valori enum a ConversationType:
- WHATSAPP per rappresentare una conversazione introdotta tramite WhatsApp.
- ADS_API per rappresentare una conversazione introdotta utilizzando il nuovo metodo LocalServicesLeadService.AppendLeadConversation().
Sono stati aggiunti i seguenti nuovi campi a local_services_verification_artifact:
- local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
- local_services_verification_artifact.license_verification_artifact.expiration_date_time

Rapporti

Ora puoi selezionare solo i campi relativi a un prodotto collegato quando esegui query su product_link. La selezione di più campi di diversi prodotti collegati comporterà l'errore QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Ad esempio, product_link.advertising_partner.customer e product_link.data_partner.data_partner_id non possono essere selezionati nella stessa query.
Se passi un valore page_size a GoogleAdsService.Search, verrà generato un errore RequestError.PAGE_SIZE_NOT_SUPPORTED.

Shopping

È stato aggiunto un nuovo report shopping_product, che corrisponde alla pagina Prodotti dell'interfaccia utente di Google Ads. Supporta il ritorno di dati relativi allo stato attuale dei prodotti dagli account Google Merchant Center collegati a un account Google Ads.
- Puoi filtrare le metriche del report shopping_product utilizzando segments.date quando utilizzi GoogleAdsService.Search o GoogleAdsService.SearchStream. La segmentazione per data non è consentita e restituirà un errore ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

Obiettivi unificati

È stato aggiunto UserListCustomerTypeService.MutateUserListCustomerTypes() per configurare i tipi di clienti del segmento di pubblico.
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings rimosso. Per configurare le impostazioni dei segmenti di pubblico degli obiettivi del ciclo di vita del cliente, utilizza invece UserListCustomerTypeService.MutateUserListCustomerTypes().
- Collega o scollega un elenco di utenti impostando UserListCustomerType.customer_type_category su UserListCustomerTypeCategory.PURCHASERS per includerlo o escluderlo da una definizione di cliente esistente per gli obiettivi del ciclo di vita del cliente, rispettivamente. Per ulteriori dettagli, consulta la sezione Segmentare i segmenti di pubblico.

Video

Sono stati aggiunti i seguenti valori a ContentLabelType. Puoi escludere questi ContentLabelTypes a livello di cliente:
- BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
- BRAND_SUITABILITY_GAMES_FIGHTING
- BRAND_SUITABILITY_GAMES_MATURE
- BRAND_SUITABILITY_HEALTH_SENSITIVE
- BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
- BRAND_SUITABILITY_NEWS_RECENT
- BRAND_SUITABILITY_NEWS_SENSITIVE
- BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
- BRAND_SUITABILITY_POLITICS
- BRAND_SUITABILITY_RELIGION
È stato aggiunto AdVideoAsset.ad_video_asset_info per supportare le preferenze di inventario per gli asset video durante la creazione di DemandGenVideoResponsiveAdInfo.
(Solo account inclusi nella lista consentita) È stato impostato come modificabile il valore Campaign.video_brand_safety_suitability.

Note di rilascio archiviate

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