Per annunci ufficiali sull'API di Google Analytics, iscriviti al gruppo Google Analytics API Notify Group.
15/12/2023 I report sull'accesso ai dati sono ora disponibili per tutte le proprietà Google Analytics.
Alcuni campi della funzionalità Report di accesso ai dati sono ora disponibili per tutte le proprietà Google Analytics, sia per i clienti Standard che per i clienti di Google Analytics 360.
Per ulteriori informazioni, consulta la documentazione relativa allo schema.
15/12/2023 La dimensione accessDateHour
aggiunta allo schema del report Accesso ai dati.
La dimensione accessDateHour
aggiunta allo schema del report Accesso ai dati. Contiene la data e l'ora dell'utente GA che ha eseguito l'accesso ai dati del report GA.
5/10/2023 Le proprietà con i modelli di attribuzione Primo clic, Lineare, Decadimento temporale e In base alla posizione vengono impostati automaticamente sulla DDA (attribuzione basata sui dati) cross-channel.
A partire da metà ottobre 2023, i modelli di attribuzione del primo clic, lineare, decadimento temporale e in base alla posizione non saranno più utilizzabili con il metodo UpdateAttributionSettings per tutte le proprietà.
Se la tua proprietà è attualmente configurata per utilizzare uno di questi modelli, verrà cambiato in attribuzione basata sui dati cross-channel. Avrai comunque la possibilità di utilizzare Ultimo clic cross-channel o Ultimo clic Google Ads preferito.
1/09/2023 Sono stati aggiunti i metodi di configurazione dello schema del valore di conversione di SKAdNetwork.
Metodi di GetSKAdNetworkConversionValueSchema
,
CreateSKAdNetworkConversionValueSchema
,
DeleteSKAdNetworkConversionValueSchema
,
UpdateSKAdNetworkConversionValueSchema
,
ListSKAdNetworkConversionValueSchemas
aggiunti all'API Admin v1alpha.
Questa funzionalità consente di gestire la configurazione dello schema dei valori di conversione di SKAdNetwork per uno stream iOS.
1/09/2023 Aggiunto il metodo UpdateConversionEvent
.
UpdateConversionEvent
aggiunto all'API Admin v1beta.
01/09/2023 Il campo BigQueryLink.enterprise_export_enabled
è stato rinominato in fresh_daily_export_enabled
.
Il campo enterprise_export_enabled
della risorsa BigQueryLink
è stato rinominato in fresh_daily_export_enabled
.
14/07/2023 Interruzione delle modifiche a properties.updateAttributionSettings
, metodi properties.getAttributionSettings
.
A partire dal 24 luglio 2023, verranno apportate modifiche che provocano errori all'API Admin v1 alpha e influiranno sulla funzionalità dei metodi properties.getAttributionSettings e properties.updateAttributionSettings.
I membri dell'enum ReportingAttributionModel
verranno rinominati come segue:
Nome precedente | Nuovo nome |
---|---|
CROSS_CHANNEL_DATA_DRIVEN |
PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN |
CROSS_CHANNEL_LAST_CLICK |
PAID_AND_ORGANIC_CHANNELS_LAST_CLICK |
CROSS_CHANNEL_FIRST_CLICK |
PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK |
CROSS_CHANNEL_LINEAR |
PAID_AND_ORGANIC_CHANNELS_LINEAR |
CROSS_CHANNEL_POSITION_BASED |
PAID_AND_ORGANIC_CHANNELS_POSITION_BASED |
CROSS_CHANNEL_TIME_DECAY |
PAID_AND_ORGANIC_CHANNELS_TIME_DECAY |
ADS_PREFERRED_LAST_CLICK |
GOOGLE_PAID_CHANNELS_LAST_CLICK |
I membri dell'enum AdsWebConversionDataExportScope
verranno rinominati come segue:
Nome precedente | Nuovo nome |
---|---|
CROSS_CHANNEL |
PAID_AND_ORGANIC_CHANNELS |
ADS_PREFERRED |
GOOGLE_PAID_CHANNELS |
10/07/2023 È stato aggiunto il campo ads_web_conversion_data_export_scope
al tipo AttributionSettings
È stato aggiunto il campo ads_web_conversion_data_export_scope
al tipo AttributionSettings
, che può essere modificato utilizzando il metodo UpdateAttributionSettings
.
5/06/2023 Ritiro dei modelli di attribuzione Primo clic, Lineare, Decadimento temporale e In base alla posizione.
A partire da giugno 2023, il metodo UpdateAttributionSettings non può essere utilizzato per configurare le proprietà GA4 con i modelli di attribuzione Primo clic, Lineare, Decadimento temporale e In base alla posizione. A partire da settembre 2023, questi modelli non saranno più disponibili per tutte le proprietà.
Per ulteriori informazioni, consulta l'annuncio del prodotto Google Analytics.
31/05/2023 Sono stati aggiunti i metodi di gestione dei link di AdSense.
Metodi per GetAdSenseLink
,
CreateAdSenseLink
,
DeleteAdSenseLink
,
ListAdSenseLinks
aggiunti all'API Admin v1alpha.
Questa funzionalità consente di gestire i collegamenti da AdSense ad Analytics per una proprietà GA4.
31/05/2023 È stato aggiunto un metodo per cercare una proprietà GA4 collegata.
Il metodo FetchConnectedGa4Property
aggiunto all'API Admin v1alpha
Questa funzionalità consente di ottenere informazioni su una proprietà GA4 collegata alla tua proprietà Universal Analytics durante il processo di migrazione a GA4.
31/05/2023 Aggiunto un metodo per gestire le regole di creazione degli eventi.
I metodi CreateEventCreateRule
,
UpdateEventCreateRule
,
DeleteEventCreateRule
,
ListEventCreateRules
,
GetEventCreateRule
aggiunti all'API Admin v1alpha.
Questa funzionalità consente di gestire le regole di creazione di eventi che possono attivare la creazione di un evento completamente nuovo in base ai criteri corrispondenti di un evento di origine.
31/05/2023 Sono stati aggiunti metodi per gestire i gruppi di canali personalizzati.
Sono stati aggiunti i metodi GetChannelGroup
,
ListChannelGroups
,
CreateChannelGroup
,
UpdateChannelGroup
,
DeleteChannelGroup
all'API Admin v1alpha.
Questa funzionalità consente di gestire i gruppi di canali personalizzati per le sorgenti di traffico del tuo sito web.
Una volta creati, è possibile eseguire query sui gruppi di canali personalizzati utilizzando API di dati di Google Analytics v1.
31/03/2023 Sono stati aggiunti i metodi di gestione delle Impostazioni di misurazione avanzata.
I metodi properties.dataStreams.updateEnhancedMeasurementSettings
, properties.dataStreams.getEnhancedMeasurementSettings
aggiunti all'API Admin v1alpha.
Questa funzionalità consente di gestire le impostazioni della misurazione avanzata per uno stream di dati web di una proprietà GA4.
31/03/2023 Sono stati aggiunti i metodi di gestione dei tag del sito collegati.
I metodi properties.createConnectedSiteTag
, properties.deleteConnectedSiteTag
, properties.listConnectedSiteTags
aggiunti all'API Admin v1alpha.
Questa funzionalità consente di gestire i tag del sito collegati ed è utile per inoltrare il traffico da una proprietà Universal Analytics a una proprietà Google Analytics 4.
31/03/2023 Sono stati aggiunti metodi runAccessReport
a livello di account e proprietà all'API Admin v1beta.
I metodi properties.runAccessReport
e accounts.runAccessReport
aggiunti alla versione v1beta dell'API Admin. I metodi restituiscono un report personalizzato dei record di accesso ai dati.
24/02/2023 Sono stati aggiunti i metodi di gestione dei set di dati espansi.
La risorsa ExpandedDataSet
è stata aggiunta alla versione v1alpha dell'API, insieme alle corrispondenti operazioni properties.expandedDataSets.create
,
properties.expandedDataSets.delete
,
properties.expandedDataSets.patch
,
properties.expandedDataSets.list
e
properties.expandedDataSets.get
. Questa funzionalità può essere utilizzata per gestire i set di dati espansi in Google Analytics 360.
24/02/2023 Le associazioni di accesso sostituiranno i link utente per la gestione delle autorizzazioni utente.
La risorsa AccessBinding
è stata aggiunta alla versione v1alpha dell'API, insieme alle seguenti operazioni:
accounts.accessBindings.create
accounts.accessBindings.delete
accounts.accessBindings.patch
accounts.accessBindings.list
accounts.accessBindings.get
accounts.accessBindings.batchCreate
accounts.accessBindings.batchDelete
accounts.accessBindings.batchUpdate
accounts.accessBindings.batchGet
properties.accessBindings.create
properties.accessBindings.delete
properties.accessBindings.patch
properties.accessBindings.list
properties.accessBindings.get
properties.accessBindings.batchCreate
properties.accessBindings.batchDelete
properties.accessBindings.batchUpdate
properties.accessBindings.batchGet
Questa funzionalità consente di gestire le autorizzazioni degli utenti per una proprietà o un account GA4 e deve essere utilizzata al posto di Link utente.
La funzionalità Link utente verrà rimossa dalla versione alpha dell'API Admin il 1/06/2023
24/02/2023 Ritiro dei metodi di controllo delle autorizzazioni utente.
I seguenti metodi sono deprecati e verranno rimossi dalla versione alpha dell'API Admin il 1/06/23:
24/02/2023 Aggiunti metodi di gestione dei segmenti di pubblico.
La risorsa Audience
è stata aggiunta alla versione v1alpha dell'API, insieme alle corrispondenti operazioni properties.audience.create
,
properties.audience.archive
,
properties.audience.patch
,
properties.audience.list
e
properties.audience.get
.
Questa funzionalità consente di gestire i segmenti di pubblico per una proprietà GA4.
15/02/2023 Sono stati aggiunti i metodi di disattivazione della procedura di configurazione automatica di GA4.
properties.setAutomatedGa4ConfigurationOptOut
,
properties.fetchAutomatedGa4ConfigurationOptOut
operazioni sono state aggiunte alla versione v1alpha dell'API.
Questa funzionalità consente di gestire lo stato di disattivazione per la procedura automatica di configurazione di GA4 per una proprietà UA.
15/02/2023 Sono stati aggiunti i metodi di gestione dei link di BigQuery.
La risorsa BigQueryLink
è stata aggiunta alla versione v1alpha dell'API, insieme alle
operazioni properties.bigQueryLinks.get
,
properties.bigQueryLinks.list
corrispondenti.
Questa funzionalità consente di recuperare informazioni sui collegamenti tra una proprietà GA4 e un progetto BigQuery.
15/02/2023 Sono stati aggiunti i metodi di gestione dei collegamenti di Search Ads 360.
La risorsa SearchAds360Link
è stata aggiunta alla versione v1alpha dell'API, insieme alle corrispondenti operazioni properties.searchAds360Links.create
,
properties.searchAds360Links.delete
,
properties.searchAds360Links.patch
,
properties.searchAds360Links.list
e
properties.searchAds360Links.get
.
Questa funzionalità consente di gestire i collegamenti tra una proprietà GA4 e un'entità Search Ads 360.
15/02/2023 Modifiche che provocano un errore.
LESS_THAN_OR_EQUAL
, valoriGREATER_THAN_OR_EQUAL
rimossi dall'enumNumericFilter.Operation
.Valore
PARTIAL_REGEXP
rimosso dall'enumerazioneStringFilter.MatchType
.
15/02/2023 Modifiche varie.
- Campo
tokensPerProjectPerHour
aggiunto al tipoAccessQuota
. EXPANDED_DATA_SET
,CHANNEL_GROUP
valori aggiunti all'enumerazioneChangeHistoryResourceType
.- Valori
searchAds360Link
,expandedDataSet
,bigqueryLink
aggiunti aChangeHistoryResource
.
11/08/2022 Metodo runAccessReport
aggiunto all'API Admin v1alpha.
Il metodo properties.runAccessReport
aggiunto alla versione v1alpha dell'API Admin. Restituisce un report personalizzato dei record di accesso ai dati. Il report fornisce record di ogni
volta che un utente legge i dati dei report di Google Analytics. I report di accesso ai dati sono disponibili per gli amministratori delle proprietà Google Analytics 360.
11/07/2022 Rilascio della versione v1beta dell'API Admin.
È stata rilasciata la versione 1beta dell'API Google Analytics Admin.
Entrambi i canali Alpha e Beta dell'API continuano a essere supportati per l'API Admin. Il canale beta contiene un sottoinsieme delle funzionalità disponibili in versione alpha che sono considerate stabili e non subiranno cambiamenti significativi in futuro. Una volta raggiunto il limite di maturità, verranno aggiunte nuove funzionalità alla versione beta.
12/10/2021: metodi avanzatiMeasurementSettings rimossi dall'API.
properties.webDataStreams.getEnhancedMeasurementSettings
, i metodiproperties.webDataStreams.updateEnhancedMeasurementSettings
sono stati rimossi dall'API, ma le impostazioni di Misurazione avanzata saranno di nuovo modificabili tramite API a breve.- Il campo
directRoles
della risorsaUserLink
non supporta più il ruolopredefinedRoles/manage-users
. Usa il nuovo ruolopredefinedRoles/admin
, che è equivalente alla combinazione dei precedenti ruolipredefinedRoles/edit
epredefinedRoles/manage-users
. Questa modifica influisce sul comportamento dei metodiaccounts.userLinks
eproperties.userLinks
ed è in linea con le modifiche alla Gestione delle restrizioni relative a dati e accessi introdotte in Google Analytics.
5/06/2021 Funzionalità aggiunte.
All'API vengono aggiunte le seguenti funzionalità:
accounts.searchChangeHistoryEvents
è stato aggiunto all'API. Questo metodo cerca tutte le modifiche apportate a un account o ai relativi account secondari in base all'insieme di filtri specificato. Le cause più comuni sono gli aggiornamenti apportati nell'interfaccia utente di Google Analytics, le modifiche apportate dall'assistenza clienti o le modifiche automatiche del sistema di Google Analytics.- Metodi di gestione dei secret di Measurement Protocol aggiunti in
properties.webDataStreams.measurementProtocolSecrets
:create
Crea un secret di Measurement Protocol.delete
Elimina il secret di Measurement Protocol di destinazione.get
Cerca un singolo secret di Measurement Protocol.list
Restituisci i secret di Measurement Protocol secondari nella proprietà principale specificata.patch
Aggiorna un secret di Measurement Protocol.
- Metodi di gestione degli eventi di conversione aggiunti in
properties.conversionEvents
: - Metodi di gestione delle dimensioni personalizzate aggiunti in
properties.customDimensions
: - Metodi di gestione delle metriche personalizzate aggiunti in
properties.customMetrics
: - Sono stati aggiunti
properties.getGoogleSignalsSettings
,properties.updateGoogleSignalsSettings
metodi che consentono di controllare l'impostazione di Google Signals per una proprietà Google Analytics 4. delete_time
,expire_time
campi di solo output aggiunti al tipoProperty
.
5/06/2021 Modifiche che provocano un errore.
Sono state introdotte le seguenti modifiche che provocano errori:
properties.iosAppDataStreams.create
,properties.androidAppDataStreams.create
metodi sono stati rimossi dall'API. Usa Firebase per creare flussi di applicazioni in una proprietà Google Analytics 4.- Il metodo
properties.delete
ora restituisce i dati della proprietà eliminata come tipoProperty
anziché restituire una risposta vuota. - Ora il campo
time_zone
del tipoProperty
è obbligatorio. - Campo
deleted
rimosso dal tipoProperty
. - Il campo
email_address
del tipoUserLink
ora è immutabile. - Il campo
name
del tipoUserLink
ora è solo di output.
28/01/2021 È stato aggiunto il supporto dell'impaginazione per l'operazione ListFirebaseLinks
.
28/01/2021 Modifiche che provocano un errore.
Modifiche che provocano un errore:
- il campo update_mask
è obbligatorio per tutte le operazioni di aggiornamento.
Campo
country_code
rinominato inregion_code
inAccount
.Campo
url_query_parameter
rinominato inuri_query_parameter
inEnhancedMeasurementSettings
.Campo
parent
rimosso daGoogleAdsLink
.
20/10/2020 È stato aggiunto il supporto per i riepiloghi degli account.
Aggiunto il supporto per il metodo dei riepiloghi degli account.
13/10/2020 Le proprietà App + web rinominate in Google Analytics 4 (GA4).
15/08/2020 L'API Management App + Web viene rinominata API Admin.
L'API App + Web di gestione di Google Analytics è stata rinominata API Google Analytics Admin. Di conseguenza, l'endpoint API è stato modificato in analyticsadmin.googleapis.com. Il codice esistente scritto sulla versione precedente dell'URL dell'endpoint API e delle librerie client deve essere aggiornato di conseguenza.