Note di rilascio

versione 17 (5/06/2024)

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

Annunci

• AdService.getAd rimosso. In questo modo AdService è in linea con gli altri servizi dell'API Google Ads. Consulta Recupero di oggetti per il metodo consigliato per recuperare annunci e altri tipi di risorse.
• Sono state aggiunte altre convalide per ImageAdInfo.image_asset relative a dimensioni e formato. Se l'immagine non è valida, potrebbero essere generati i seguenti errori:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Asset

• Nuova enum aggiunta: 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

• Hai aggiunto OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

Job batch

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

Campagne

• Gli annunci discovery sono stati rinominati Demand Gen in tutti i campi, le enumerazioni e gli errori di tutte le risorse nell'API Google Ads, ad esempio campagne, annunci e asset. Ad esempio, AdvertisingChannelType.DISCOVERY è ora AdvertisingChannelType.DEMAND_GEN.
• Opzione Campaign.keyword_match_type aggiunta 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 quando sono pari a zero. Questo le rende coerenti con le altre metriche.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

Criteri

• Sono stati aggiunti ai seguenti campi a AdGroupCriterion per 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 di metrics.search_impression_share per gender_view
• È stato aggiunto il supporto di metrics.phone_calls per keyword_view

Servizi locali

• Aggiunto LocalServicesLeadService.AppendLeadConversation() utilizzato per aggiungere 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 nuovi nuovi campi seguenti 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

Reporting

• Ora puoi selezionare solo i campi relativi a un prodotto collegato quando esegui una query su product_link. Se selezioni più campi di diversi prodotti collegati, verrà visualizzato 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.
• Il passaggio di un page_size a GoogleAdsService.Search comporterà un errore RequestError.PAGE_SIZE_NOT_SUPPORTED.

Shopping

• È stato aggiunto un nuovo report shopping_product, corrispondente alla pagina Prodotti dell'interfaccia utente di Google Ads. Supporta la restituzione dei dati relativi allo stato corrente dei prodotti dagli account Google Merchant Center collegati a un account Google Ads.
  • Puoi filtrare le metriche dal report shopping_product utilizzando segments.date se 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 dei segmenti di pubblico.
• CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings rimosso. Per configurare le impostazioni del pubblico degli obiettivi del ciclo di vita del cliente, utilizza invece UserListCustomerTypeService.MutateUserListCustomerTypes().
  • Allega o scollega un elenco di 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 del cliente. Per ulteriori dettagli, consulta la pagina sulla segmentazione del 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 dell'inventario per gli asset video durante la creazione di DemandGenVideoResponsiveAdInfo.
• (Solo account inclusi nella lista consentita) Impostazione di Campaign.video_brand_safety_suitability modificabile.

Versione 16.1.0 (24/04/2024)

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

Gestione dell'account

• CustomerNegativeCriterion.ip_block che supporta l'aggiunta di un IP come criterio negativo a livello di cliente.
• Nuovo valore enum: ProductLinkError.LINK_EXISTS.
• Nuovo valore enum: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION.

Asset

• Supporto per gli asset relativi a Demand Gen a ad_group_ad_asset_view e asset_field_type_view.
• Nuovo valore enum: AssetFieldType.DISCOVERY_CAROUSEL_CARD.

Segmenti di pubblico

• Nuovo valore enum: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER che limita il numero di elenchi di utenti simili che un cliente può avere a 1000.

Campagne

• Supporto per la restituzione delle simulazioni di offerta per le campagne ROAS target per le campagne per app utilizzando il report campaign_simulation.
• Nuovo valore enum: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN.
• Nuovo valore enum: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY.
• Nuovo valore enum: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS.

Conversioni

• SkAdNetworkConversionValueSchema.postback_mappings, che supporta le funzionalità SKAdNetwork 4.0.
• È stato aggiunto il supporto per gli avvisi per CustomerSkAdNetworkConversionValueSchemaService come MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings. Se il criterio viene impostato su true, eventuali errori non bloccanti relativi a errori delle operazioni verranno restituiti come MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning.
• Nuovi valori enum in CustomerSkAdNetworkConversionValueSchemaError:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

Criteri

• Nuovi campi in BrandInfo:
  • display_name
  • primary_url
  • rejection_reason
  • status
• Nuova enum: BrandRequestRejectionReason.
• Nuovo valore enum: CriterionType.LIFE_EVENT.

Esperimenti

• Nuovo valore enum: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT.

Servizi locali

• local_services_lead.credit_details.credit_state e local_services_lead.credit_details.credit_state_last_update_date_time che restituisce rispettivamente lo stato del credito e il timestamp in cui lo stato del credito è stato aggiornato.
• local_services_lead_conversation.message_details.attachment_urls, che restituisce gli URL che possono essere utilizzati per scaricare i contenuti dell'allegato.

Video

• customer.video_brand_safety_suitability e BrandSafetySuitability che supportano il recupero dell'idoneità alla sicurezza del brand video a livello di cliente.
• Nuovo valore enum: VideoCampaignError.MUTATE_REQUIRES_RESERVATION.

versione 16 (21/02/2024)

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

Gestione dell'account

• È stata eseguita la migrazione di advertising_partner da AccountLink a ProductLink e ProductLinkInvitation.
• data_partner e google_ads rimossi da AccountLink.
• È stato aggiunto IdentityVerificationService per gestire la verifica dell'inserzionista.
  • StartIdentityVerification() viene utilizzato per avviare una sessione di verifica utilizzando il verification_program fornito. Viene creata una nuova sessione di verifica e restituisce una risposta vuota per una verifica creata correttamente.
    • Elemento aggiunto IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION.
  • GetIdentityVerification() può essere utilizzato per recuperare le informazioni di verifica, che restituiscono diversi oggetti di IdentityVerification. Ciascun IdentityVerification include:
    • verification_program che è il tipo di programma di verifica dell'identità
    • identity_verification_requirement che contiene i dettagli relativi alla scadenza entro la quale l'inserzionista deve completare la verifica
    • verification_progress che contiene i dettagli relativi alla sessione di verifica, tra cui:
      • program_status rappresenta lo stato attuale di questa sessione di verifica
      • action_url indirizza il cliente a un URL per completare la verifica.
      • invitation_link_expiration_time rappresenta la data di scadenza del action_url
  • Enum:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Errori:
    • IdentityVerificationError
• Elemento aggiunto AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT.

Asset

• Modifiche a asset_group:
  • È stato aggiunto il supporto per i segmenti relativi al tempo, ad esempio segments.year e segments.month.
  • Reso campaign una risorsa attribuita invece di segmentare la risorsa.

Campagne

• Modifiche alle campagne Demand Gen:
  • È stato aggiunto il supporto per impostare Campaign.shopping_setting a una campagna Demand Gen esistente.
  • È stato aggiunto ShoppingSetting.disable_product_feed per disattivare il feed dei prodotti facoltativo delle campagne Demand Gen.
  • È stato aggiunto Ad.demand_gen_product_ad e il corrispondente DemandGenProductAdInfo, disponibile per le campagne Demand Gen con un valore Campaign.shopping_setting diverso da null.
• Sono stati aggiunti ai seguenti campi a AdGroup per mostrare se il gruppo di annunci viene pubblicato o i motivi per cui non viene pubblicato:
  • primary_status
  • primary_status_reasons
• Sono stati aggiunti ai seguenti campi a AdGroupAd per indicare se l'annuncio del gruppo di annunci viene pubblicato o il motivo della mancata pubblicazione:
  • primary_status
  • primary_status_reasons
• Sono stati aggiunti i seguenti valori a AdGroupError:
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

Sperimenta

• È stato aggiunto Experiment.sync_enabled per specificare se la sincronizzazione deve essere attivata nell'esperimento. Con la sincronizzazione attivata, le modifiche apportate alla campagna originale durante l'esecuzione dell'esperimento vengono copiate automaticamente nella campagna di prova.
• Elemento aggiunto ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE.
• Elemento aggiunto CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL.

Hotel e viaggi

• Sono stati aggiunti i seguenti campi a ListingDimensionInfo per un annuncio di Cose da fare al fine di consentire la creazione di gruppi di schede in base allo stato e alla città in cui è disponibile l'attività di viaggio:
  • activity_state
  • activity_city
• È stato aggiunto il supporto dei seguenti segmenti a travel_activity_performance_view:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Servizi locali

• Sono stati aggiunti LocalServicesVerificationArtifact.business_registration_check_verification_artifact e BusinessRegistrationCheckArtifact per consentire agli inserzionisti di monitorare l'avanzamento della procedura di verifica della registrazione dell'attività.
• È stata aggiunta una nuova risorsa local_services_employee per consentire agli inserzionisti di recuperare le informazioni sui dipendenti che hanno aggiunto.

Pianificazione

• score rimosso da AudienceInsightsAttributeMetadata.

Consigli

• Aggiunta RecommendationService.GenerateRecommendations() che restituisce consigli in base alle impostazioni specificate, ad esempio i tipi di consigli e i tipi di canali pubblicitari. Ciò è particolarmente utile durante la creazione della campagna.
• Elemento aggiunto RecommendationMetrics.conversions_value.
• Per le parole chiave consigliate con tipo di corrispondenza delle parole chiave non impostato, l'opzione recommended_match_type è ora impostata su UNSPECIFIED anziché su UNKNOWN.
• Sono stati aggiunti i seguenti tipi di consigli:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN che consiglia di attivare la strategia di offerta Massimizza il valore di conversione
  • IMPROVE_GOOGLE_TAG_COVERAGE che consiglia di implementare il tag Google su più pagine
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN che consiglia di attivare l'espansione dell'URL finale per le campagne Performance Max
  • REFRESH_CUSTOMER_MATCH_LIST che consiglia di aggiornare un elenco di clienti che non è stato aggiornato negli ultimi 90 giorni
  • CUSTOM_AUDIENCE_OPT_IN che consiglia di creare un segmento di pubblico personalizzato
  • LEAD_FORM_ASSET che consiglia di aggiungere asset modulo per i lead a livello di campagna o cliente
  • IMPROVE_DEMAND_GEN_AD_STRENGTH che consiglia di migliorare l'efficacia dell'annuncio nelle campagne Demand Gen

Shopping

• Sono stati aggiunti i valori CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT e CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS per fornire errori più dettagliati per le campagne Shopping collegate a un account Comparison Shopping Service Center.
• Sono stati aggiunti i seguenti valori a AssetGroupListingGroupFilterError:
  • DIMENSION_TYPE_NOT_ALLOWED
  • DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
  • FILTER_EXCLUSION_NOT_ALLOWED
  • LISTING_SOURCE_NOT_ALLOWED
  • MULTIPLE_LISTING_SOURCES
  • MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
  • MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
  • PAGE_FEED_FILTER_HAS_PARENT

Obiettivi del ciclo di vita

• Sono stati aggiunti update a CustomerLifecycleGoalOperation e CampaignLifecycleGoalOperation per rendere questi tipi di operazioni coerenti con altri tipi di operazioni nell'API.

versione 15 (18/10/2023)

Le nuove funzionalità e gli aggiornamenti seguenti sono stati introdotti nella versione 15.

Gestione dell'account

• Se il tuo account viene sospeso a causa di attività non autorizzate, customer.status e customer_client.status vengono restituiti come SUSPENDED. In precedenza, venivano restituiti come ENABLED.
• È stato aggiunto il supporto per aggiungere e rimuovere un collegamento tra un account Google Ads e un account Merchant Center:
  • Aggiunti ProductLink.merchant_center e MerchantCenterIdentifier.
  • Elemento aggiunto LinkedProductType.MERCHANT_CENTER.
• Sono stati aggiunti i valori ProductLinkInvitationService e ProductLinkInvitation per supportare l'aggiornamento di un invito al link inviato da altri prodotti, disponibile per gli account Hotel Center e Merchant Center.
• MerchantCenterLinkService rimosso.
  • Per collegare gli account Google Ads agli account Merchant Center, utilizza ProductLinkInvitationService e ProductLinkService.
• Sono stati rimossi AccountLink.hotel_center e il supporto per l'aggiornamento degli inviti al collegamento dagli account Hotel Center utilizzando AccountLinkService.
  • Per aggiornare un invito al collegamento da un account Hotel Center, utilizza ProductLinkInvitationService.

Asset

• È stato sostituito ImageAdInfo.media_file con ImageAdInfo.image_asset per consentire l'aggiunta e la rimozione di immagini utilizzando gli asset. Di conseguenza, abbiamo rimosso anche MediaFileService, che non è più necessario.
• È stato aggiunto ListingGroupFilterDimension.webpage per supportare la creazione di un filtro del gruppo di schede basato su etichette personalizzate e sottostringhe URL.
  • Inoltre, AssetGroupListingGroupFilter.vertical è stato sostituito con AssetGroupListingGroupFilter.listing_source e ListingGroupFilterListingSource
• È stato aggiunto asset_group_asset.source per mostrare l'origine dell'asset del gruppo di asset.
• È stato aggiunto ad_group_ad_asset_view.source per mostrare l'origine dell'asset annuncio del gruppo di annunci.

Segmenti di pubblico

• Per Customer Match, è stato aggiunto CustomerMatchUserListMetadata.consent per supportare l'invio del consenso. A partire dal 6 marzo 2024, se manca il consenso per gli utenti del SEE, il valore del consenso viene determinato come non fornito. I dati degli utenti nel SEE senza consenso non verranno elaborati e non potranno essere utilizzati per la personalizzazione degli annunci tramite Customer Match. Per ulteriori dettagli, consulta la guida di Customer Match.
• Per le vendite in negozio, è stato aggiunto UserData.consent per supportare l'invio del consenso. Per ulteriori dettagli, consulta la nostra guida sulle vendite in negozio. Se utilizzi Customer Match con le vendite in negozio, consulta le Domande frequenti per ulteriori informazioni.
• È stato aggiunto UserList.lookalike_user_list per supportare la creazione di un segmento simile, un segmento di pubblico creato in base al segmento di pubblico di origine esistente fornito. I segmenti simili possono essere utilizzati solo in una campagna Demand Gen.

Campagne

• Aggiornamenti alle campagne Performance Max:

  • AssetGroupSignal ora supporta due tipi di indicatori che possono essere associati a un gruppo di asset per il targeting avanzato:
    • AssetGroupSignal.audience
      • Sono stati aggiunti Audience.scope e Audience.asset_group per limitare l'utilizzo del pubblico a un gruppo di asset specifico. Audience.asset_group deve essere impostato se e solo se Audience.scope è ASSET_GROUP.
    • AssetGroupSignal.search_theme
      • È stato aggiunto CriterionType.SEARCH_THEME per supportare questo nuovo tipo di criterio. Questo nuovo tipo di criterio può essere utilizzato solo nelle campagne Performance Max per creare un AssetGroupSignal mediante la compilazione di AssetGroupSignal.search_theme con un criterio SearchThemeInfo.
  • È stato aggiunto AssetGroupSignalOperation.exempt_policy_violation_keys per supportare la richiesta di esenzione durante l'aggiunta di indicatori dei gruppi di asset.
  • È stato aggiunto un nuovo asset_group_top_combination_view per segnalare gli asset con il rendimento migliore a livello di gruppo di asset.
  • Ora è possibile eseguire query su asset_group con i campi delle metriche per supportare il recupero del rendimento di una campagna Performance Max.
  • In PerformanceMaxUpgradeStatus, UPGRADE_ELIGIBLE è stato rinominato UPGRADE_ELIGIBLE.

• Per le campagne Demand Gen e discovery CPA target, le simulazioni di offerte basate su CPA target a livello di campagna (campaign_simulation.target_cpa_point_list.points) restituiscono ora TargetCpaSimulationPoint.interactions anziché TargetCpaSimulationPoint.clicks.

• È stato aggiunto l'elemento BrandSuggestionService che può suggerire i brand in base al prefisso del brand fornito e all'elenco di brand esclusi. Questi brand possono essere utilizzati per creare un criterio BRAND, aggiungerlo a un set condiviso di BRANDS e poi associarlo a una campagna creando un elemento CampaignCriterion con brand_list impostato sul set condiviso. I criteri delle campagne possono essere scelti come target nelle campagne sulla rete di ricerca ed esclusi rispettivamente nelle campagne Performance Max.

  • Campi:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Enum:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• Aggiunto Campaign.asset_automation_settings[] per mostrare lo stato dell'automazione di ogni tipo di asset.

• Sono stati aggiunti i seguenti valori all'enum CampaignPrimaryStatusReason:

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

Conversioni

• Sono stati aggiunti CallConversion.consent e ClickConversion.consent per supportare l'invio del consenso. Per ulteriori dettagli, consulta la guida alle conversioni di chiamata e la guida alle conversioni di clic.
• Sono stati aggiunti i seguenti campi relativi alle conversioni SKAdNetwork, disponibili quando si eseguono query con customer o campaign:
  • Segmenti:
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • Metriche:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• È stato sostituito metrics.sk_ad_network_conversions con metrics.sk_ad_network_installs.
• È stato aggiunto il supporto per la diagnosi del caricamento delle conversioni offline
  • offline_conversion_upload_client_summary è stato spostato da un campo della risorsa customer a un report di primo livello. Utilizza questo report per ottenere dettagli utili sullo stato del caricamento delle conversioni, come il numero di eventi riusciti, la percentuale di successo e la percentuale di errori.
    • Avvertimento: una conversione caricata, ma che genera un errore ConversionUploadError.CLICK_NOT_FOUND, viene comunque conteggiata come riuscita, ma viene contrassegnata come OfflineConversionAlert.
  • job_id è stato aggiunto come parametro facoltativo per i seguenti tipi di richieste in modo da poter raggruppare logicamente più richieste di caricamento in un singolo job concettuale:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • È stato aggiunto INVALID_JOB_ID ai seguenti errori:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • INVALID_CONVERSION_ACTION sostituito con NO_CONVERSION_ACTION_FOUND e INVALID_CONVERSION_ACTION_TYPE nei seguenti errori:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• Sono stati aggiunti tre report per supportare l'attribuzione su più reti di Android Privacy Sandbox senza reindirizzamenti:
  • android_privacy_shared_key_google_campaign che contiene shared_campaign_key e alcuni campi per la codifica della chiave.
  • android_privacy_shared_key_google_ad_group che contiene shared_ad_group_key e alcuni campi per la codifica della chiave.
  • android_privacy_shared_key_google_network_type che contiene shared_network_type_key e alcuni campi per la codifica della chiave.
• Elemento aggiunto ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Un ConversionActionOperation che tenta di utilizzare uno dei modelli di attribuzione basata su regole ritirati ora non funziona e restituisce questo errore. In precedenza, l'operazione non riusciva con un errore UNKNOWN.

Hotel e viaggi

• È stato aggiunto il supporto per i seguenti campi in travel_activity_group_view e travel_activity_performance_view:
  • Segmenti:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • Metriche:
    • metrics.search_absolute_top_impression_share
    • metrics.search_budget_lost_absolute_top_impression_share
    • metrics.search_budget_lost_impression_share
    • metrics.search_budget_lost_top_impression_share
    • metrics.search_impression_share
    • metrics.search_rank_lost_absolute_top_impression_share
    • metrics.search_rank_lost_impression_share
    • metrics.search_rank_lost_top_impression_share
    • metrics.search_top_impression_share

Annunci di Servizi locali

• Sono stati aggiunti LocalServicesSettings e i relativi campi al report customer per restituire gli stati granulari dell'assicurazione e della licenza di un inserzionista di Servizi locali.
• Sono stati aggiunti i seguenti nuovi report per Servizi locali:
  • local_services_lead contiene tutti i dettagli relativi ai lead di annunci di Servizi locali, come lead_charged, lead_type e lead_status.
    • Enum:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation contiene dettagli di messaggi e conversazioni telefoniche, ad esempio conversation_channel, call_duration_millis e call_recording_url.
    • L'URL di registrazione delle chiamate viene autenticato in base all'account cliente target e ai relativi account amministratore.
  • local_services_verification_artifact restituisce gli elementi di un inserzionista di Servizi locali, come il controllo dei precedenti, le licenze commerciali e i dati sulle assicurazioni aziendali. È possibile accedere a tutti i documenti associati alla licenza e all'assicurazione tramite un URL.
    • Enum:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

Pianificazione

• È stato aggiunto il supporto per restituire Forecast.views e PlannedProductForecast.views per ReachPlanService.ListPlannableProducts per i tipi di prodotto applicabili.
• È stato aggiunto il supporto per restituire PlannableTargeting.surface_targeting per ReachPlanService.ListPlannableProducts, che descrive le piattaforme disponibili per un prodotto.
• È stata aggiunta una nuova enum ReachPlanSurface.
• È stato aggiunto il supporto del targeting della frequenza target utilizzando AdvancedProductTargeting.target_frequency_settings, che restituisce PlannedProductForecast.average_frequency.
• Aggiunto AudienceInsightsService.GenerateSuggestedTargetingInsights per restituire i segmenti di pubblico selezionabili come target suggeriti.
• Sono stati aggiunti i seguenti valori a ReachPlanError:
  • NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
  • NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

Consigli

• Aggiunta RecommendationSubscriptionService che gestisce le sottoscrizioni ai consigli:
  • Risorsa: RecommendationSubscription
  • Campo: MutateOperation.recommendation_subscription_operation
  • Enum: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • Errori:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• Sono stati aggiunti i seguenti tipi di consigli:
  • FORECASTING_SET_TARGET_CPA, che consiglia di impostare un CPA target per le campagne che non ne hanno uno specificato, prima di un evento stagionale che si prevede generi un aumento del traffico.
  • SET_TARGET_CPA, che consiglia di impostare un CPA target per le campagne per le quali non è stato specificato uno.
  • SET_TARGET_ROAS, che consiglia di impostare un ROAS target per le campagne per le quali non è stato specificato uno.

Reporting

• Sono state aggiunte le seguenti nuove metriche, su cui è possibile eseguire query con campaign (disponibile per le campagne display, video, discovery e per app) e segments.device:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

Shopping

• È stato rimosso ShoppingSetting.sales_country, i cui valori sono ora restituiti come ShoppingSetting.feed_label.
  • Puoi continuare a utilizzare un feed di Merchant Center specifico per una campagna utilizzando il campo ShoppingSetting.feed_label. Deve essere impostato sul valore dell'etichetta del feed o sul codice paese di due lettere utilizzato in precedenza per ShoppingSetting.sales_country. Per ulteriori dettagli, consulta l'articolo dell'assistenza sulle etichette dei feed.
• È stata rimossa la dipendenza delle categorie di prodotto da un codice paese nei report. L'insieme di ID categoria supportati non è cambiato.
  • Sono stati sostituiti i seguenti campi utilizzati in shopping_performance_view:
    • segments.product_bidding_category_level1 con segments.product_category_level1
    • segments.product_bidding_category_level2 con segments.product_category_level2
    • segments.product_bidding_category_level3 con segments.product_category_level3
    • segments.product_bidding_category_level4 con segments.product_category_level4
    • segments.product_bidding_category_level5 con segments.product_category_level5
  • È stato sostituito product_bidding_category_constant con product_category_constant, che restituisce tutte le localizzazioni disponibili di una categoria in un campo ripetuto.
  • È stato sostituito ListingDimensionInfo.product_bidding_category con ListingDimensionInfo.product_category.
  • È stato sostituito ListingGroupFilterDimension.product_bidding_category con ListingGroupFilterDimension.product_category.
• È stato rimosso il supporto per l'aggiunta di Campaign.shopping_setting alle campagne sulla rete di ricerca. Se provi a creare una campagna sulla rete di ricerca con Campaign.shopping_setting o ad aggiungere Campaign.shopping_setting a una campagna sulla rete di ricerca esistente, ora si ottiene OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• È stato rimosso il supporto per l'aggiunta di CampaignCriterion.listing_scope alle campagne sulla rete di ricerca. Se provi ad aggiungere CampaignCriterion.listing_scope a una campagna sulla rete di ricerca esistente ora si ottiene OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• Sono state aggiunte le seguenti metriche sulle conversioni con dati del carrello:
  • metrics.orders
  • metrics.average_order_value_micros
  • metrics.average_cart_size
  • metrics.cost_of_goods_sold_micros
  • metrics.gross_profit_micros
  • metrics.gross_profit_margin
  • metrics.revenue_micros
  • metrics.units_sold
  • metrics.cross_sell_cost_of_goods_sold_micros
  • metrics.cross_sell_gross_profit_micros
  • metrics.cross_sell_revenue_micros
  • metrics.cross_sell_units_sold
  • metrics.lead_cost_of_goods_sold_micros
  • metrics.lead_gross_profit_micros
  • metrics.lead_revenue_micros
  • metrics.lead_units_sold
  • Tutte queste metriche sono selezionabili nei seguenti report:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

Obiettivi unificati

• È stato aggiunto CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals per configurare gli obiettivi di acquisizione di clienti a livello di cliente.
  • Segnala: customer_lifecycle_goal
• È stato aggiunto CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals per configurare gli obiettivi di acquisizione dei clienti a livello di campagna.
  • Segnala: campaign_lifecycle_goal
• Elemento aggiunto CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN.
• Sono stati aggiunti i seguenti valori a ConversionGoalCampaignConfigError:
  • EMPTY_CONVERSION_GOALS
  • STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
  • PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES

Video

• Aggiunto il supporto per il targeting di Google TV a livello di campagna:
  • Elemento aggiunto NetworkSettings.target_google_tv_network
  • Elemento aggiunto AdNetworkType.GOOGLE_TV.
• Aggiunto il supporto per il targeting di YouTube a livello di campagna:
  • Elemento aggiunto NetworkSettings.target_youtube
  • In AdNetworkType, sono stati uniti YOUTUBE_WATCH e YOUTUBE_SEARCH in YOUTUBE.
  • Elemento aggiunto CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE.

Note di rilascio archiviate

Per consultare le note di rilascio archiviate, vedi Versioni ritirate.