Versione 17.1.0 (7/08/2024)
Le nuove funzionalità e gli aggiornamenti seguenti sono stati aggiunti nella versione v17_1.
Asset
AdGroupAdService.RemoveAutomaticallyCreatedAssets()
ti consente di rimuovere gli asset creati automaticamente specificati 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 restituisce
partial_failure_error
al posto degli URL.
- Il campo
Cronologia delle modifiche
- Nuovo tipo di risorsa di stato della modifica:
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.- Ai report di diagnostica offline vengono aggiunte le seguenti metriche per indicare il numero di conversioni caricate che sono ancora in fase di elaborazione:
Pianificazione
AudienceInsights.GenerateAudienceOverlapInsights()
, che accetta un attributo principale di input e una raccolta di attributi del pubblico, e restituisce le stime della sovrapposizione della potenziale copertura su YouTube tra l'attributo principale e gli attributi del pubblico.
Rapporti
- Supporto per la segmentazione di
per_store_view
basata susegments.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
ecampaign
:Campaign.fixed_cpm
(CPM (costo per mille impressioni) fisso)Campaign.target_cpv
(CPV (costo per visualizzazione) target)
Campaign.video_campaign_settings
, che ti consente di determinare su quali inventari possono essere mostrati 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:
versione 17 (5/06/2024)
Nella versione 17 sono state aggiunte le seguenti funzionalità e modifiche.
Annunci
AdService.getAd
rimosso. Ciò portaAdService
in linea con gli altri servizi del API Google Ads. Consulta Recupero di oggetti per consigliato per recuperare annunci e altri tipi di risorse.- Sono state aggiunte altre convalide per
ImageAdInfo.image_asset
in merito dimensioni e formato. Potrebbero essere visualizzati i seguenti errori se l'immagine è non valido:
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
- Aggiunta
BatchJobError.REQUEST_TOO_LARGE
, che verrà restituito quando il valoreAddBatchJobOperationsRequest
inviato supera i 10484504 byte. - Aggiunto il supporto per l'impostazione
MutateOperation.asset_group_operation
quando utilizziBatchJobService
. Questo consente di utilizzare l'elaborazione batch per creare gestire intere campagne Performance Max. Consulta la nostra nuova guida dedicata.
Campagne
- Discovery rinominata in Demand Gen in tutti i campi, le enumerazioni e gli errori di tutti
risorse nell'API Google Ads, come campagne, annunci e asset. Per
esempio,
AdvertisingChannelType.DISCOVERY
è oraAdvertisingChannelType.DEMAND_GEN
- Aggiunta
Campaign.keyword_match_type
per impostare il tipo di corrispondenza delle parole chiave per tutte le parole chiave di una campagna.
Conversioni
- Per SKAdNetwork
conversioni,
segments.sk_ad_network_conversion_value
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
- Aggiunti ai seguenti campi a
AdGroupCriterion
per mostrare se il criterio del gruppo di annunci viene pubblicato o i motivi per cui non viene pubblicazione:primary_status
primary_status_reasons
- È stato aggiunto il supporto per
metrics.search_impression_share
pergender_view
- È stato aggiunto il supporto per
metrics.phone_calls
perkeyword_view
Servizi locali
- Hai 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 un lead.- Le dimensioni di
AppendLeadConversationRequest.conversations
sono limitate a 1000. - Solo
LocalServicesLead
conlead_type
impostato suLeadType.MESSAGE
può essere specificato inConversation.local_services_lead
- Le dimensioni 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 nuovoLocalServicesLeadService.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
Rapporti
- Ora puoi selezionare solo i campi relativi a un prodotto collegato
durante l'esecuzione di query su
product_link
. Selezione di più elementi campi di diversi prodotti collegati generanoQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
Ad esempio:product_link.advertising_partner.customer
eproduct_link.data_partner.data_partner_id
non può essere selezionato nella stessa query. - Passaggio di
page_size
perGoogleAdsService.Search
in corso... produrrà unRequestError.PAGE_SIZE_NOT_SUPPORTED
.
Shopping
- È stato aggiunto un nuovo report
shopping_product
, che corrisponde alla pagina Prodotti dell'interfaccia utente di Google Ads. Supporta la restituzione Dati relativi allo stato attuale dei prodotti di Google Merchant Center account collegati a un account Google Ads.- Puoi filtrare le metriche
shopping_product
segnala consegments.date
quando utilizziGoogleAdsService.Search
oppureGoogleAdsService.SearchStream
. La segmentazione per data non è consentita e restituisce unShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
.
- Puoi filtrare le metriche
Obiettivi unificati
- Hai aggiunto
UserListCustomerTypeService.MutateUserListCustomerTypes()
per configurare il cliente del segmento di pubblico tipi. CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
rimosso. Per configurare le impostazioni relative al pubblico degli obiettivi del ciclo di vita dei clienti, utilizzaUserListCustomerTypeService.MutateUserListCustomerTypes()
in alternativa.- Collegare o scollegare un elenco di utenti tramite l'impostazione
UserListCustomerType.customer_type_category
aUserListCustomerTypeCategory.PURCHASERS
per includerlo o escluderlo da una definizione di cliente esistente per gli obiettivi del ciclo di vita dei clienti. Visita la pagina segmentare segmenti di pubblico per ulteriori dettagli.
- Collegare o scollegare un elenco di utenti tramite l'impostazione
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
- Hai aggiunto
AdVideoAsset.ad_video_asset_info
per supportare le preferenze dell'inventario per gli asset video durante la creazioneDemandGenVideoResponsiveAdInfo
. - (Solo account inclusi nella lista consentita) Data
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
il 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 correlati a Demand Gen per
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 di Target
Simulazioni di offerte a livello di campagna basate sul ROAS per
Campagne per app che utilizzano
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 SKAdNetwork 4,0 le funzionalità di machine learning.- 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 verrà restituito 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 lo stato del credito e il timestamp quando lo stato del credito rispettivamente.local_services_lead_conversation.message_details.attachment_urls
che restituisce gli URL utilizzabili per scaricare i contenuti allegato.
Video
customer.video_brand_safety_suitability
eBrandSafetySuitability
che supportano il recupero dell'idoneità alla sicurezza del brand per i video presso il cliente livello.- 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
- Migrazione di
advertising_partner
eseguita da DaAccountLink
aProductLink
eProductLinkInvitation
data_partner
egoogle_ads
rimossi daAccountLink
- Aggiunta
Da
IdentityVerificationService
a gestire la verifica dell'inserzionista.StartIdentityVerification()
viene utilizzato per avviare una sessione di verifica utilizzandoverification_program
. Crea una nuova sessione di verifica e restituisce una risposta vuota per un verifica creata correttamente.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
contenente i dettagli relativi alla scadenza entro la quale L'inserzionista deve completare la verificaverification_progress
contenente 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 peraction_url
- Enum:
- Errori:
- Aggiunta
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
Asset
- Modifiche a
asset_group
:- È stato aggiunto il supporto per i segmenti temporali, ad esempio
segments.year
esegments.month
. - Ha reso
campaign
una risorsa attribuita invece di la segmentazione delle risorse.
- È stato aggiunto il supporto per i segmenti temporali, ad esempio
Campagne
- Modifiche alle campagne Demand Gen:
- Aggiunto il supporto per l'impostazione
Da
Campaign.shopping_setting
a di una campagna Demand Gen esistente. - Aggiunta
ShoppingSetting.disable_product_feed
per disattivare il feed dei prodotti facoltativo delle campagne Demand Gen. - Hai aggiunto
Ad.demand_gen_product_ad
e i corrispondentiDemandGenProductAdInfo
, disponibile per Campagne Demand Gen con un valore non nullCampaign.shopping_setting
- Aggiunto il supporto per l'impostazione
Da
- Aggiunti ai seguenti campi a
AdGroup
per mostrare se se il gruppo di annunci viene pubblicato o i motivi per cui non viene pubblicato:primary_status
primary_status_reasons
- Aggiunti ai seguenti campi a
AdGroupAd
per mostrarli se l'annuncio del gruppo di annunci viene pubblicato o i motivi per cui non viene pubblicato:primary_status
primary_status_reasons
- Sono stati aggiunti i seguenti valori a
AdGroupError
:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
Esperimento
- Elemento
Experiment.sync_enabled
aggiunto a specificare se la sincronizzazione deve essere attivata nell'esperimento. Con sincronizzazione attivata, le modifiche apportate campagna originale mentre l'esperimento è in esecuzione, vengono automaticamente copiato nella campagna sperimentale. - Aggiunta
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
- Aggiunta
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
Hotel e Viaggi
- Sono stati aggiunti i seguenti campi a
ListingDimensionInfo
per una sezione Cose da fare per attivare 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 per
travel_activity_performance_view
:
Servizi locali
- Aggiunta
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
eBusinessRegistrationCheckArtifact
per consentire agli inserzionisti di monitorare l'avanzamento della registrazione dell'azienda procedura di verifica. - È 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 tipi di consigli e canali pubblicitari. Ciò è particolarmente utile durante la creazione della campagna. - Aggiunta
RecommendationMetrics.conversions_value
- Le parole chiave consigliate con tipo di corrispondenza delle parole chiave non impostato ora hanno
recommended_match_type
impostato suUNSPECIFIED
anziché suUNKNOWN
. - Sono stati aggiunti i seguenti tipi di consigli:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
che consiglia di attivare l'offerta Massimizza il valore di conversione di strategiaIMPROVE_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 Performance Max campagneREFRESH_CUSTOMER_MATCH_LIST
che consiglia di aggiornare un elenco di clienti che non è stato aggiornato in 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 alla campagna o al cliente livelloIMPROVE_DEMAND_GEN_AD_STRENGTH
che consiglia di migliorare l'efficacia dell'annuncio nelle campagne Demand Gen
Shopping
- Aggiunta
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
eCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
al fine di fornire errori più dettagliati per le campagne Shopping collegate a un Centro per i servizi di shopping comparativo Fitbit.com. - 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
- Elemento
update
aggiunto 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 è stato sospeso a causa di account non autorizzato
attività,
customer.status
ecustomer_client.status
vengono ora restituitiSUSPENDED
In precedenza, venivano restituitiENABLED
- È stato aggiunto il supporto per l'aggiunta e la rimozione di un collegamento tra un account Google Ads e
Un account Merchant Center:
- Aggiunta
ProductLink.merchant_center
eMerchantCenterIdentifier
. - Aggiunta
LinkedProductType.MERCHANT_CENTER
- Aggiunta
- Aggiunta
ProductLinkInvitationService
eProductLinkInvitation
all'assistenza aggiornare un invito al link inviato da altri prodotti, disponibile per hotel Center e Merchant Center Google Cloud. 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
AccountLink.hotel_center
e supporto per l'aggiornamento degli inviti ai collegamenti rimossi 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
ImageAdInfo.media_file
sostituito conImageAdInfo.image_asset
all'assistenza l'aggiunta e la rimozione di immagini utilizzando gli asset. Di conseguenza, abbiamo anche rimossoMediaFileService
, che non è più necessario.- Aggiunta
ListingGroupFilterDimension.webpage
per supportare la creazione di un filtro del gruppo di schede basato su etichette personalizzate e URL sottostringhe.- Inoltre ha sostituito
AssetGroupListingGroupFilter.vertical
conAssetGroupListingGroupFilter.listing_source
eListingGroupFilterListingSource
- Inoltre ha sostituito
asset_group_asset.source
aggiunto al programma l'origine dell'asset del gruppo di asset.- Aggiunta
Da
ad_group_ad_asset_view.source
a mostrano l'origine dell'asset annuncio del gruppo di annunci.
Segmenti di pubblico
- Per Customer Match,
CustomerMatchUserListMetadata.consent
per supportare la fornitura del consenso. A partire dal 6 marzo 2024, se il consenso è mancante per gli utenti 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 l'annuncio personalizzazione tramite Customer Match. Consulta le nostre Guida di Customer Match per ulteriori dettagli. - Per le vendite in negozio, ha aggiunto
UserData.consent
a all'assistenza clienti fornendo il consenso. Consulta le nostre Guida alle vendite in negozio per ulteriori dettagli. Se utilizzi Customer Match con le vendite in negozio, consulta le Domande frequenti per ulteriori informazioni. - Aggiunta
Da
UserList.lookalike_user_list
a per la creazione di un simile di Google Cloud, un segmento di pubblico creato in base al segmento di pubblico di origine esistente fornito. I segmenti simili possono essere utilizzati 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 un targeting avanzato:AssetGroupSignal.audience
- Hai aggiunto
Audience.scope
eAudience.asset_group
per limitare l'utilizzo dei segmenti di pubblico in un gruppo di asset specifico. È necessario impostareAudience.asset_group
se e solo seAudience.scope
èASSET_GROUP
.
- Hai aggiunto
AssetGroupSignal.search_theme
- Aggiunta
CriterionType.SEARCH_THEME
per supportare questo nuovo tipo di criterio. Questo nuovo tipo di criterio può da utilizzare nelle campagne Performance Max per creare unAssetGroupSignal
compilando ilAssetGroupSignal.search_theme
con un criterioSearchThemeInfo
.
- Aggiunta
- Aggiunta
AssetGroupSignalOperation.exempt_policy_violation_keys
per supportare la richiesta di esenzione durante l'aggiunta di indicatori dei gruppi di asset. - È stato aggiunto un nuovo elemento
asset_group_top_combination_view
per registrare 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. - Nel
PerformanceMaxUpgradeStatus
,UPGRADE_ELIGIBLE
rinominato inUPGRADE_ELIGIBLE
.
Per Demand Gen e Scoperta Campagne basate su CPA target, simulazioni di offerte basate su CPA target a livello di campagna (
campaign_simulation.target_cpa_point_list.points
) ora restituisceTargetCpaSimulationPoint.interactions
anzichéTargetCpaSimulationPoint.clicks
È stato aggiunto
BrandSuggestionService
che può suggerire brand in base al prefisso del brand fornito e all'elenco escluso di brand. Questi brand possono essere usati per creareBRAND
criterio, aggiunto a un set condiviso diBRANDS
, e poi collegarli a una campagna creando unCampaignCriterion
conbrand_list
impostata sul set condiviso. I criteri delle campagne possono essere scelti come target nelle campagne sulla rete di ricerca ed esclusi in campagne Performance Max.Aggiunta
Campaign.asset_automation_settings[]
per mostrare lo stato dell'automazione di ogni tipo di asset.Sono stati aggiunti i seguenti valori alla sezione
CampaignPrimaryStatusReason
enum:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversioni
- Hai aggiunto
CallConversion.consent
eClickConversion.consent
all'assistenza fornendo il consenso. Consulta le nostre guida alle conversioni di chiamata e la guida alle conversioni dei clic per ulteriori informazioni i dettagli. - Sono stati aggiunti i seguenti campi relativi a
SKAdNetwork
conversioni, disponibili quando si eseguono query
customer
ocampaign
: metrics.sk_ad_network_conversions
sostituito conmetrics.sk_ad_network_installs
- Aggiunta del supporto per la diagnosi del caricamento delle conversioni offline
- È stato spostato il
offline_conversion_upload_client_summary
da un campo della risorsacustomer
a un report di primo livello. Usa questa per ottenere dettagli utili sullo stato di caricamento delle conversioni, come numero di eventi riusciti, percentuale di successo e percentuale di errori.- Avvertimento: una conversione che viene caricata, ma genera un
ConversionUploadError.CLICK_NOT_FOUND
viene comunque conteggiato come riuscito, ma viene anche contrassegnato comeOfflineConversionAlert
.
- Avvertimento: una conversione che viene caricata, ma genera un
- È stato aggiunto
job_id
come parametro facoltativo per i seguenti tipi di richiesta, così puoi raggruppare logicamente più richieste di caricamento in un'unica domanda offerta di lavoro: - È stato aggiunto
INVALID_JOB_ID
ai seguenti errori: - È stato sostituito
INVALID_CONVERSION_ACTION
conNO_CONVERSION_ACTION_FOUND
eINVALID_CONVERSION_ACTION_TYPE
nei seguenti errori:
- È stato spostato il
- Sono stati aggiunti tre report per supportare Android Privacy Sandbox su più reti
attribuzione senza
reindirizzamenti:
android_privacy_shared_key_google_campaign
che contieneshared_campaign_key
e alcuni campi che consentono di codificare la chiave.android_privacy_shared_key_google_ad_group
che contieneshared_ad_group_key
e alcuni campi che consentono di codificare la chiave.android_privacy_shared_key_google_network_type
che contieneshared_network_type_key
e alcuni campi che consentono di codificare la chiave.
- Aggiunta
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
UnaConversionActionOperation
che tenta di utilizzare una delle attribuzione basata su regole deprecata modelli ora non riesce e restituisce questo errore. In precedenza, l'operazione non riuscivaUNKNOWN
errore.
Hotel e Viaggi
- 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
- È stato aggiunto
LocalServicesSettings
e le relative informazioni al reportcustomer
per restituire un acquisto Fornisce gli stati di licenza granulare e di assicurazione dell'inserzionista. - Sono stati aggiunti i seguenti nuovi report per Locale
Servizi:
local_services_lead
contiene tutti i valori i dettagli relativi a Servizi locali Lead Google Ads comelead_charged
,lead_type
lead_status
.- Enum:
local_services_lead_conversation
contiene i dettagli delle conversazioni telefoniche e del messaggio, comeconversation_channel
,call_duration_millis
ecall_recording_url
.- L'URL di registrazione delle chiamate è autenticato per il cliente target e i relativi account amministratore.
local_services_verification_artifact
restituisce gli elementi di un inserzionista di Servizi locali, come il controllo dei precedenti, licenze aziendali e dati sulle assicurazioni aziendali. Eventuali documenti associati con licenza e assicurazione sono accessibili tramite un URL.
Pianificazione
- Aggiunto il supporto per restituire
Forecast.views
ePlannedProductForecast.views
perReachPlanService.ListPlannableProducts
per i tipi di prodotto applicabili. - Supporto aggiunto per la restituzione
PlannableTargeting.surface_targeting
dellaReachPlanService.ListPlannableProducts
, che descrive le piattaforme disponibili per un prodotto. - È stato aggiunto un nuovo elemento
ReachPlanSurface
enum. - Aggiunto il supporto del targeting Target
frequenza usando
AdvancedProductTargeting.target_frequency_settings
, che restituiscePlannedProductForecast.average_frequency
. - Aggiunta
AudienceInsightsService.GenerateSuggestedTargetingInsights
per restituire segmenti di pubblico suggeriti come target. - 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 suggerimenti: - 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 prima di un evento stagionale che si prevede aumenti per via del traffico.SET_TARGET_CPA
che consiglia di impostare un CPA target per le campagne che non ne hanno uno specificato.SET_TARGET_ROAS
che consiglia di impostare un ROAS target per le campagne che non ne hanno uno specificato.
Rapporti
- Sono state aggiunte le nuove metriche seguenti, su cui è possibile eseguire query
campaign
(disponibile per annunci display, video, discovery e campagne per app) esegments.device
:
Shopping
- È stato rimosso
ShoppingSetting.sales_country
, i cui valori sono ora restituiti comeShoppingSetting.feed_label
- Puoi continuare a utilizzare un account Merchant Center specifico
feed di una campagna utilizzando
il
ShoppingSetting.feed_label
. Deve essere impostato sul valore dell'etichetta del feed o sul paese di due lettere. codice usato in precedenza perShoppingSetting.sales_country
. Per ulteriori dettagli, consulta l'articolo di assistenza per i feed etichette.
- Puoi continuare a utilizzare un account Merchant Center specifico
feed di una campagna utilizzando
il
- È 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
product_bidding_category_constant
sostituito conproduct_category_constant
, che restituisce tutte le localizzazioni disponibili di una categoria in un campo ripetuto.ListingDimensionInfo.product_bidding_category
sostituito conListingDimensionInfo.product_category
ListingGroupFilterDimension.product_bidding_category
sostituito conListingGroupFilterDimension.product_category
- Sono stati sostituiti i seguenti campi utilizzati in
- Rimosso il supporto per l'aggiunta
Campaign.shopping_setting
per eseguire la ricerca campagne. Stai provando a creare una campagna sulla rete di ricerca conCampaign.shopping_setting
o aggiungiCampaign.shopping_setting
a un una campagna sulla rete di ricerca esistente ora si traduceOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Rimosso il supporto per l'aggiunta
CampaignCriterion.listing_scope
alle campagne sulla rete di ricerca. Tentativo di aggiungereCampaignCriterion.listing_scope
a una campagna sulla rete di ricerca esistente ora si traduceOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Aggiunte le seguenti conversioni con carrello
metriche:
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
- Aggiunta
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
per configurare gli obiettivi di acquisizione di clienti a livello di cliente.- Segnala:
customer_lifecycle_goal
- Segnala:
- Aggiunta
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
per configurare gli obiettivi di acquisizione di clienti a livello di campagna.- Segnala:
campaign_lifecycle_goal
- Segnala:
- Aggiunta
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:
- Aggiunta
NetworkSettings.target_google_tv_network
- Aggiunta
AdNetworkType.GOOGLE_TV
- Aggiunta
- Aggiunto il supporto per il targeting di YouTube a livello di campagna:
- Aggiunta
NetworkSettings.target_youtube
- In
AdNetworkType
, unitiYOUTUBE_WATCH
eYOUTUBE_SEARCH
inYOUTUBE
. - Aggiunta
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
- Aggiunta
Note di rilascio archiviate
Per consultare le note di rilascio archiviate, vedi Versioni ritirate.