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 (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 per gli 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, come Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view e così via. Ora gli utenti devono utilizzare asset 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 di specificare 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 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 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à in precedenza 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.
Il valore predefinito di DemandGenCampaignSettings.upgraded_targeting è stato modificato 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, la 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 la segmentazione dei 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 sarà vuoto anziché fornire un URL non valido se la registrazione della chiamata non esiste per la conversazione con il lead di Servizi locali specificato.
È 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 gli errori CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED e CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, che indicano che le campagne Performance Max con le linee guida del brand attivate non hanno le risorse CampaignAsset richieste collegate alla campagna.
- Quando le linee guida del brand sono attivate, alla campagna devono essere collegati almeno un asset con field_type impostato su BUSINESS_NAME e almeno un asset con LOGO 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é 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é CampaignAsset nelle campagne Performance Max con le linee guida per il brand 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 oppure trovare 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 libero utilizzando l'IA generativa.
È stato aggiunto AudienceInsightsService.GenerateTargetingSuggestionMetrics, che restituisce le metriche sulla copertura potenziale per determinate combinazioni di targeting per pubblico.

Consigli

Ora RecommendationService.GenerateRecommendations 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 dal 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. È possibile eseguire query con il report campaign.
- metrics.general_invalid_clicks
- metrics.general_invalid_click_rate
Sono stati aggiunti i seguenti valori a QuotaError:
- EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
- 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 anziché gli URL.

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 la 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 ti 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

Aggiunti ai seguenti campi in AdGroupCriterion per indicare 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 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 utenti impostando UserListCustomerType.customer_type_category su UserListCustomerTypeCategory.PURCHASERS per includerlo o escluderlo da una definizione di cliente esistente rispettivamente per gli obiettivi del ciclo di vita dei clienti. 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.