versione 17 (5/06/2024)
Nella versione 17 sono state aggiunte le seguenti funzionalità e modifiche.
Annunci
AdService.getAd
rimosso. In questo modoAdService
è 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:
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:
Segmenti di pubblico
Job batch
- È stato aggiunto
BatchJobError.REQUEST_TOO_LARGE
, che verrà generato quando il valore del campoAddBatchJobOperationsRequest
inviato supera i 10484504 byte. - Aggiunto il supporto per l'impostazione di
MutateOperation.asset_group_operation
quando si utilizzaBatchJobService
. 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
è oraAdvertisingChannelType.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 insegments.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.
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
pergender_view
- È stato aggiunto il supporto di
metrics.phone_calls
perkeyword_view
Servizi locali
- Aggiunto
LocalServicesLeadService.AppendLeadConversation()
utilizzato per aggiungere un nuovoLocalServicesLeadConversation
aLocalServicesLead
, 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
conlead_type
impostato suLeadType.MESSAGE
può essere specificato inConversation.local_services_lead
.
- La dimensione di
- 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 metodoLocalServicesLeadService.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à visualizzatoQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
. Ad esempio,product_link.advertising_partner.customer
eproduct_link.data_partner.data_partner_id
non possono essere selezionati nella stessa query. - Il passaggio di un
page_size
aGoogleAdsService.Search
comporterà un erroreRequestError.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
utilizzandosegments.date
se utilizziGoogleAdsService.Search
oGoogleAdsService.SearchStream
. La segmentazione per data non è consentita e restituirà un erroreShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
.
- Puoi filtrare le metriche dal report
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 inveceUserListCustomerTypeService.MutateUserListCustomerTypes()
.- Allega o scollega un elenco di utenti impostando
UserListCustomerType.customer_type_category
suUserListCustomerTypeCategory.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.
- Allega o scollega un elenco di utenti impostando
Video
- Sono stati aggiunti i seguenti valori a
ContentLabelType
. Puoi escludere questiContentLabelTypes
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 diDemandGenVideoResponsiveAdInfo
. - (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
easset_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
comeMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
. Se il criterio viene impostato sutrue
, eventuali errori non bloccanti relativi a errori delle operazioni verranno restituiti comeMutateCustomerSkAdNetworkConversionValueSchemaResponse.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
elocal_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
eBrandSafetySuitability
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
daAccountLink
aProductLink
eProductLinkInvitation
. data_partner
egoogle_ads
rimossi daAccountLink
.- È stato aggiunto
IdentityVerificationService
per gestire la verifica dell'inserzionista.StartIdentityVerification()
viene utilizzato per avviare una sessione di verifica utilizzando ilverification_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
.
- Elemento aggiunto
GetIdentityVerification()
può essere utilizzato per recuperare le informazioni di verifica, che restituiscono diversi oggetti diIdentityVerification
. CiascunIdentityVerification
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 verificaverification_progress
che contiene i dettagli relativi alla sessione di verifica, tra cui:program_status
rappresenta lo stato attuale di questa sessione di verificaaction_url
indirizza il cliente a un URL per completare la verifica.invitation_link_expiration_time
rappresenta la data di scadenza delaction_url
- Enum:
- Errori:
- 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
esegments.month
. - Reso
campaign
una risorsa attribuita invece di segmentare la risorsa.
- È stato aggiunto il supporto per i segmenti relativi al tempo, ad esempio
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 corrispondenteDemandGenProductAdInfo
, disponibile per le campagne Demand Gen con un valoreCampaign.shopping_setting
diverso da null.
- È stato aggiunto il supporto per impostare
- 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: - È stato aggiunto il supporto dei seguenti segmenti a
travel_activity_performance_view
:
Servizi locali
- Sono stati aggiunti
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
eBusinessRegistrationCheckArtifact
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 daAudienceInsightsAttributeMetadata
.
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 suUNSPECIFIED
anziché suUNKNOWN
. - 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 conversioneIMPROVE_GOOGLE_TAG_COVERAGE
che consiglia di implementare il tag Google su più paginePERFORMANCE_MAX_FINAL_URL_OPT_IN
che consiglia di attivare l'espansione dell'URL finale per le campagne Performance MaxREFRESH_CUSTOMER_MATCH_LIST
che consiglia di aggiornare un elenco di clienti che non è stato aggiornato negli ultimi 90 giorniCUSTOM_AUDIENCE_OPT_IN
che consiglia di creare un segmento di pubblico personalizzatoLEAD_FORM_ASSET
che consiglia di aggiungere asset modulo per i lead a livello di campagna o clienteIMPROVE_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
eCampaignError.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
aCustomerLifecycleGoalOperation
eCampaignLifecycleGoalOperation
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
ecustomer_client.status
vengono restituiti comeSUSPENDED
. In precedenza, venivano restituiti comeENABLED
. - È stato aggiunto il supporto per aggiungere e rimuovere un collegamento tra un account Google Ads e
un account Merchant Center:
- Aggiunti
ProductLink.merchant_center
eMerchantCenterIdentifier
. - Elemento aggiunto
LinkedProductType.MERCHANT_CENTER
.
- Aggiunti
- Sono stati aggiunti i valori
ProductLinkInvitationService
eProductLinkInvitation
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
eProductLinkService
.
- Per collegare gli account Google Ads agli account Merchant Center, utilizza
- Sono stati rimossi
AccountLink.hotel_center
e il supporto per l'aggiornamento degli inviti al collegamento dagli account Hotel Center utilizzandoAccountLinkService
.- Per aggiornare un invito al collegamento da un account Hotel Center, utilizza
ProductLinkInvitationService
.
- Per aggiornare un invito al collegamento da un account Hotel Center, utilizza
Asset
- È stato sostituito
ImageAdInfo.media_file
conImageAdInfo.image_asset
per consentire l'aggiunta e la rimozione di immagini utilizzando gli asset. Di conseguenza, abbiamo rimosso ancheMediaFileService
, 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 conAssetGroupListingGroupFilter.listing_source
eListingGroupFilterListingSource
- Inoltre,
- È 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
eAudience.asset_group
per limitare l'utilizzo del pubblico a un gruppo di asset specifico.Audience.asset_group
deve essere impostato se e solo seAudience.scope
èASSET_GROUP
.
- Sono stati aggiunti
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 unAssetGroupSignal
mediante la compilazione diAssetGroupSignal.search_theme
con un criterioSearchThemeInfo
.
- È stato aggiunto
- È 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 rinominatoUPGRADE_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 oraTargetCpaSimulationPoint.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 criterioBRAND
, aggiungerlo a un set condiviso diBRANDS
e poi associarlo a una campagna creando un elementoCampaignCriterion
conbrand_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.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
eClickConversion.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
ocampaign
: - È stato sostituito
metrics.sk_ad_network_conversions
conmetrics.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 risorsacustomer
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 comeOfflineConversionAlert
.
- Avvertimento: una conversione caricata, ma che genera un errore
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:- È stato aggiunto
INVALID_JOB_ID
ai seguenti errori: INVALID_CONVERSION_ACTION
sostituito conNO_CONVERSION_ACTION_FOUND
eINVALID_CONVERSION_ACTION_TYPE
nei seguenti errori:
- 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 contieneshared_campaign_key
e alcuni campi per la codifica della chiave.android_privacy_shared_key_google_ad_group
che contieneshared_ad_group_key
e alcuni campi per la codifica della chiave.android_privacy_shared_key_google_network_type
che contieneshared_network_type_key
e alcuni campi per la codifica della chiave.
- Elemento aggiunto
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
. UnConversionActionOperation
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 erroreUNKNOWN
.
Hotel e viaggi
- È stato aggiunto il supporto per i seguenti campi in
travel_activity_group_view
etravel_activity_performance_view
:- Segmenti:
- 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 reportcustomer
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, comelead_charged
,lead_type
elead_status
.- Enum:
local_services_lead_conversation
contiene dettagli di messaggi e conversazioni telefoniche, ad esempioconversation_channel
,call_duration_millis
ecall_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.
Pianificazione
- È stato aggiunto il supporto per restituire
Forecast.views
ePlannedProductForecast.views
perReachPlanService.ListPlannableProducts
per i tipi di prodotto applicabili. - È stato aggiunto il supporto per restituire
PlannableTargeting.surface_targeting
perReachPlanService.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 restituiscePlannedProductForecast.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: - 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) esegments.device
:
Shopping
- È stato rimosso
ShoppingSetting.sales_country
, i cui valori sono ora restituiti comeShoppingSetting.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 perShoppingSetting.sales_country
. Per ulteriori dettagli, consulta l'articolo dell'assistenza sulle etichette dei feed.
- Puoi continuare a utilizzare un feed di Merchant Center specifico per una campagna utilizzando il campo
- È 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
consegments.product_category_level1
segments.product_bidding_category_level2
consegments.product_category_level2
segments.product_bidding_category_level3
consegments.product_category_level3
segments.product_bidding_category_level4
consegments.product_category_level4
segments.product_bidding_category_level5
consegments.product_category_level5
- È stato sostituito
product_bidding_category_constant
conproduct_category_constant
, che restituisce tutte le localizzazioni disponibili di una categoria in un campo ripetuto. - È stato sostituito
ListingDimensionInfo.product_bidding_category
conListingDimensionInfo.product_category
. - È stato sostituito
ListingGroupFilterDimension.product_bidding_category
conListingGroupFilterDimension.product_category
.
- Sono stati sostituiti i seguenti campi utilizzati in
- È 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 conCampaign.shopping_setting
o ad aggiungereCampaign.shopping_setting
a una campagna sulla rete di ricerca esistente, ora si ottieneOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - È stato rimosso il supporto per l'aggiunta di
CampaignCriterion.listing_scope
alle campagne sulla rete di ricerca. Se provi ad aggiungereCampaignCriterion.listing_scope
a una campagna sulla rete di ricerca esistente ora si ottieneOPERATION_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:
Obiettivi unificati
- È stato aggiunto
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
per configurare gli obiettivi di acquisizione di clienti a livello di cliente.- Segnala:
customer_lifecycle_goal
- Segnala:
- È stato aggiunto
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
per configurare gli obiettivi di acquisizione dei clienti a livello di campagna.- Segnala:
campaign_lifecycle_goal
- Segnala:
- 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
.
- Elemento aggiunto
- Aggiunto il supporto per il targeting di YouTube a livello di campagna:
- Elemento aggiunto
NetworkSettings.target_youtube
- In
AdNetworkType
, sono stati unitiYOUTUBE_WATCH
eYOUTUBE_SEARCH
inYOUTUBE
. - Elemento aggiunto
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
.
- Elemento aggiunto
Note di rilascio archiviate
Per consultare le note di rilascio archiviate, vedi Versioni ritirate.