Per gli annunci ufficiali sull'API Google Analytics, iscriviti al gruppo di notifica dell'API Google Analytics.
28/06/2024 È stata aggiunta la quota "errori client per progetto per proprietà"
Ora è previsto un limite di 10.000 errori del server API consentiti per progetto, per proprietà, in un periodo di 15 minuti. Sono incluse tutte le richieste che generano una
risposta con qualsiasi codice diverso da 500
o 200
. Esempi di errori che rientrano in questa quota: utilizzo di combinazioni di dimensioni e metriche incompatibili, tutti gli errori di autenticazione.
Se questo limite viene superato, ulteriori chiamate API alla proprietà verranno bloccate temporaneamente per il progetto Google Cloud associato fino al termine del periodo di 15 minuti.
14/05/2024 È stata aggiunta la funzionalità di confronto
Utilizzando i confronti, puoi valutare i sottoinsiemi dei tuoi dati uno accanto all'altro.
I metodi di reporting principali dell'API di dati v1beta vengono aggiornati per supportare il campo comparisons
che, se incluso, specifica la configurazione dei confronti richiesti.
In una richiesta, puoi specificare un confronto di base specificando l'espressione dimensionFilter
con una richiesta oppure utilizzare un confronto salvato specificando il nome della risorsa del confronto nel campo comparison
.
Il metodo getMetadata viene aggiornato per elencare tutti i confronti salvati disponibili per una proprietà nel campo della risposta comparisons
.
Se in una richiesta viene specificato almeno un confronto, la risposta conterrà la colonna comparison
che identifica ciascun confronto.
Al momento, i confronti salvati possono essere creati solo utilizzando l'UI di Google Analytics.
8/05/2024 Sono state aggiunte attività di report, una funzionalità di generazione di report asincrona, alla versione 1alpha dell'API di dati.
Utilizzando le attività dei report, puoi avviare una richiesta asincrona a lunga esecuzione per generare un report personalizzato dei dati sugli eventi di Google Analytics.
I seguenti metodi di manipolazione delle attività dei report sono stati aggiunti all'API Data v1alpha:
- properties.reportTasks.create
- properties.reportTasks.get
- properties.reportTasks.list
- properties.reportTasks.query
6/05/2024 Nuove dimensioni per gli eventi chiave
Le dimensioni e le metriche per gli eventi chiave sono ora disponibili.
Modifica le richieste di report che usano la dimensione isConversionEvent
per
usare la dimensione isKeyEvent
.
Modifica tutte le richieste di report che utilizzano una Metrica deprecata nella tabella seguente per utilizzare invece la Metrica degli eventi chiave.
Metrica deprecata | Metrica degli eventi chiave |
---|---|
advertiserAdCostPerConversion |
advertiserAdCostPerKeyEvent |
conversions |
keyEvents |
firstTimePurchaserConversionRate |
firstTimePurchaserRate |
purchaserConversionRate |
purchaserRate |
sessionConversionRate |
sessionKeyEventRate |
userConversionRate |
userKeyEventRate |
Apporta modifiche simili a qualsiasi utilizzo delle metriche degli eventi chiave per un evento chiave nelle richieste di report.
La risposta per il metodo properties/getMetadata
riflette l'introduzione delle dimensioni e delle metriche degli eventi chiave negli oggetti DimensionMetadata
e MetricMetadata
, come indicato di seguito:
apiName
,uiName
edescription
contengono il nome, il nome dell'interfaccia utente e la descrizione dell'API dell'evento chiave.- Il campo ripetuto
deprecatedApiNames
contiene una voce con il nome deprecato dell'API Conversion.
25/03/2024 Sono state aggiunte le dimensioni specifiche per gruppo di canali principale, sorgente di traffico manuale e integrazione.
Le dimensioni specifiche del gruppo di canali principale, della sorgente di traffico manuale e dell'integrazione di CM360, DV360 e SA360 sono state aggiunte allo schema dell'API di dati.
Dimensioni relative ai segmenti di pubblico:
audienceId
ID pubblico. L'identificatore numerico di un segmento di pubblico.
Dimensioni del gruppo di canali principale:
firstUserPrimaryChannelGroup
Gruppo di canali principale del primo utenteprimaryChannelGroup
Gruppo di canali principalesessionPrimaryChannelGroup
Gruppo di canali principale della sessione
Dimensioni Sorgente di traffico manuale:
manualCampaignId
ID campagna manualemanualCampaignName
Nome campagna manualemanualCreativeFormat
Formato della creatività manualemanualMarketingTactic
Tattica di marketing manualemanualMedium
Mezzo manualemanualSource
Sorgente manualemanualSourceMedium
Sorgente / Mezzo manualemanualSourcePlatform
Piattaforma di origine manualefirstUserManualCampaignId
ID campagna manuale della prima interazione dell'utentefirstUserManualCampaignName
Nome della campagna manuale della prima interazione dell'utentefirstUserManualCreativeFormat
Formato della creatività manuale della prima interazione dell'utentefirstUserManualMarketingTactic
Tattica di marketing manuale del primo utentefirstUserManualMedium
Mezzo manuale della prima interazione dell'utentefirstUserManualSource
Sorgente manuale della prima interazione dell'utentefirstUserManualSourceMedium
Sorgente / Mezzo manuale della prima interazione dell'utentefirstUserManualSourcePlatform
Piattaforma di origine manuale della prima interazione dell'utentesessionManualCampaignId
ID campagna manuale della sessionesessionManualCampaignName
Nome della campagna manuale della sessionesessionManualCreativeFormat
Formato della creatività manuale della sessionesessionManualMarketingTactic
Tattica di marketing manuale della sessioneMezzo manuale della sessione
sessionManualMedium
sessionManualSource
Sorgente manuale della sessionesessionManualSourceMedium
Sorgente / Mezzo manuale della sessionePiattaforma di origine manuale della sessione
sessionManualSourcePlatform
Dimensioni dell'integrazione di Campaign Manager 360 (CM360):
cm360AccountId
ID account CM360cm360AccountName
nome account CM360cm360AdvertiserId
ID inserzionista CM360cm360AdvertiserName
Nome inserzionista CM360cm360CampaignId
ID campagna CM360cm360CampaignName
nome campagna CM360cm360CreativeFormat
formato della creatività CM360cm360CreativeId
ID creatività CM360cm360CreativeName
Nome creatività CM360cm360CreativeType
tipo di creatività CM360cm360CreativeTypeId
ID tipo di creatività CM360cm360CreativeVersion
versione della creatività CM360cm360Medium
Mezzo CM360cm360PlacementCostStructure
struttura dei costi dei posizionamenti CM360cm360PlacementId
ID posizionamento CM360cm360PlacementName
nome posizionamento CM360cm360RenderingId
ID rendering CM360cm360SiteId
ID sito CM360cm360SiteName
Nome sito CM360cm360Source
origine CM360cm360SourceMedium
sorgente / mezzo CM360firstUserCm360AccountId
ID account CM360 del primo utentefirstUserCm360AccountName
Nome account CM360 della prima interazione dell'utentefirstUserCm360AdvertiserId
ID inserzionista CM360 primo utentefirstUserCm360AdvertiserName
Nome inserzionista CM360 della prima interazione dell'utentefirstUserCm360CampaignId
ID campagna CM360 del primo utentefirstUserCm360CampaignName
Nome campagna CM360 del primo utentefirstUserCm360CreativeFormat
Formato della creatività CM360 della prima interazione dell'utentefirstUserCm360CreativeId
ID creatività CM360 primo utentefirstUserCm360CreativeName
Nome creatività CM360 primo utentefirstUserCm360CreativeType
Tipo di creatività CM360 primo utentefirstUserCm360CreativeTypeId
ID tipo di creatività CM360 primo utentefirstUserCm360CreativeVersion
Versione creatività CM360 della prima interazione dell'utentefirstUserCm360Medium
Mezzo CM360 della prima interazione dell'utentefirstUserCm360PlacementCostStructure
Struttura dei costi dei posizionamenti CM360 della prima interazione dell'utentefirstUserCm360PlacementId
ID posizionamento CM360 del primo utentefirstUserCm360PlacementName
Nome posizionamento CM360 del primo utentefirstUserCm360RenderingId
ID rendering CM360 del primo utentefirstUserCm360SiteId
ID sito CM360 del primo utentefirstUserCm360SiteName
Nome sito CM360 della prima interazione dell'utentefirstUserCm360Source
Sorgente CM360 del primo utentefirstUserCm360SourceMedium
Sorgente / mezzo CM360 primo utentesessionCm360AccountId
ID account CM360 della sessionesessionCm360AccountName
Nome account CM360 della sessionesessionCm360AdvertiserId
ID inserzionista CM360 della sessionesessionCm360AdvertiserName
Nome inserzionista CM360 della sessionesessionCm360CampaignId
ID campagna CM360 della sessionesessionCm360CampaignName
Nome campagna CM360 della sessionesessionCm360CreativeFormat
Formato della creatività CM360 della sessionesessionCm360CreativeId
ID creatività CM360 sessionesessionCm360CreativeName
Nome creatività CM360 della sessionesessionCm360CreativeType
Tipo di creatività CM360 della sessionesessionCm360CreativeTypeId
ID tipo di creatività CM360 sessionesessionCm360CreativeVersion
Versione creatività CM360 della sessionesessionCm360Medium
Mezzo CM360 della sessionesessionCm360PlacementCostStructure
Struttura dei costi dei posizionamenti CM360 della sessionesessionCm360PlacementId
ID posizionamento CM360 della sessionesessionCm360PlacementName
Nome posizionamento CM360 della sessionesessionCm360RenderingId
ID rendering CM360 della sessionesessionCm360SiteId
ID sito CM360 della sessionesessionCm360SiteName
Nome sito CM360 della sessionesessionCm360Source
sorgente CM360 della sessionesessionCm360SourceMedium
Sorgente / mezzo CM360 della sessione
Dimensioni dell'integrazione di Google Display & Video 360 (DV360):
dv360AdvertiserId
ID inserzionista DV360dv360AdvertiserName
Nome inserzionista DV360dv360CampaignId
ID campagna DV360dv360CampaignName
nome campagna DV360dv360CreativeFormat
Formato della creatività DV360dv360CreativeId
ID creatività DV360dv360CreativeName
Nome creatività DV360dv360ExchangeId
ID piattaforma di scambio DV360dv360ExchangeName
Nome piattaforma di scambio DV360dv360InsertionOrderId
ID ordine di inserzione DV360dv360InsertionOrderName
Nome ordine di inserzione DV360dv360LineItemId
ID elemento pubblicitario DV360dv360LineItemName
nome elemento pubblicitario DV360dv360Medium
Mezzo DV360dv360PartnerId
ID partner DV360dv360PartnerName
Nome partner DV360dv360Source
sorgente DV360dv360SourceMedium
Sorgente / mezzo DV360firstUserDv360AdvertiserId
ID inserzionista della prima interazione dell'utente DV360firstUserDv360AdvertiserName
Nome inserzionista della prima interazione dell'utente DV360firstUserDv360CampaignId
ID campagna del primo utente DV360firstUserDv360CampaignName
Nome campagna della prima interazione dell'utente DV360firstUserDv360CreativeFormat
Formato della creatività della prima interazione dell'utente DV360firstUserDv360CreativeId
ID creatività della prima interazione dell'utente DV360firstUserDv360CreativeName
Nome creatività della prima interazione dell'utente DV360firstUserDv360ExchangeId
ID piattaforma di scambio della prima interazione dell'utente DV360firstUserDv360ExchangeName
Nome piattaforma di scambio della prima interazione dell'utente DV360firstUserDv360InsertionOrderId
ID ordine di inserzione del primo utente DV360firstUserDv360InsertionOrderName
Nome ordine di inserzione della prima interazione dell'utente DV360firstUserDv360LineItemId
ID elemento della prima interazione dell'utente DV360firstUserDv360LinteItemName
Nome elemento della prima interazione dell'utente DV360firstUserDv360Medium
Mezzo della prima interazione dell'utente DV360firstUserDv360PartnerId
ID partner DV360 del primo utentefirstUserDv360PartnerName
Nome partner DV360 del primo utentefirstUserDv360Source
Sorgente del primo utente DV360firstUserDv360SourceMedium
Sorgente / mezzo del primo utente DV360sessionDv360AdvertiserId
ID inserzionista della sessione DV360sessionDv360AdvertiserName
Nome inserzionista della sessione DV360sessionDv360CampaignId
ID campagna della sessione DV360sessionDv360CampaignName
Nome campagna della sessione DV360sessionDv360CreativeFormat
Formato della creatività della sessione DV360sessionDv360CreativeId
ID creatività della sessione DV360sessionDv360CreativeName
Nome creatività della sessione DV360sessionDv360ExchangeId
ID piattaforma di scambio della sessione DV360sessionDv360ExchangeName
Nome piattaforma di scambio della sessione DV360sessionDv360InsertionOrderId
ID ordine di inserzione della sessione DV360sessionDv360InsertionOrderName
Nome ordine di inserzione della sessione DV360sessionDv360LineItemId
ID elemento della sessione DV360sessionDv360LineItemName
Nome elemento della sessione DV360sessionDv360Medium
Mezzo della sessione DV360sessionDv360PartnerId
ID partner DV360 della sessionesessionDv360PartnerName
Nome partner DV360 della sessionesessionDv360Source
Sorgente della sessione DV360sessionDv360SourceMedium
Sorgente / mezzo della sessione DV360
Dimensioni dell'integrazione di Google Search Ads 360 (SA360):
firstUserSa360AdGroupId
ID gruppo di annunci SA360 del primo utentefirstUserSa360AdGroupName
Nome gruppo di annunci SA360 del primo utentefirstUserSa360CampaignId
ID campagna SA360 del primo utentefirstUserSa360CampaignName
campagna SA360 del primo utentefirstUserSa360CreativeFormat
Formato della creatività SA360 del primo utentefirstUserSa360EngineAccountId
ID account motore SA360 del primo utentefirstUserSa360EngineAccountName
Nome account motore SA360 del primo utentefirstUserSa360EngineAccountType
Tipo di account motore SA360 del primo utentefirstUserSa360KeywordText
Testo della parola chiave SA360 del primo utentefirstUserSa360ManagerAccountId
ID account amministratore SA360 del primo utentefirstUserSa360ManagerAccountName
Nome dell'account amministratore SA360 del primo utentefirstUserSa360Medium
Mezzo SA360 del primo utentefirstUserSa360Query
Query SA360 del primo utentefirstUserSa360Source
Sorgente SA360 del primo utentefirstUserSa360SourceMedium
Sorgente / mezzo SA360 del primo utentesa360AdGroupId
ID gruppo di annunci SA360sa360CampaignId
ID campagna SA360sa360AdGroupName
Nome gruppo di annunci SA360sa360CampaignName
campagna SA360sa360CreativeFormat
formato della creatività SA360sa360EngineAccountId
ID account motore SA360sa360EngineAccountName
Nome account motore SA360sa360EngineAccountType
tipo di account motore SA360sa360KeywordText
Testo della parola chiave SA360sa360ManagerAccountId
ID account amministratore SA360sa360ManagerAccountName
Nome dell'account amministratore SA360sa360Medium
Mezzo SA360sa360Query
query SA360sa360Source
origine SA360sa360SourceMedium
Sorgente / mezzo SA360sessionSa360AdGroupId
ID gruppo di annunci SA360 della sessionesessionSa360CampaignId
ID campagna SA360 della sessionesessionSa360ManagerAccountId
ID account amministratore SA360 della sessionesessionSa360ManagerAccountName
Nome dell'account amministratore SA360 della sessionesessionSa360SourceMedium
Sorgente / mezzo SA360 della sessione
6/03/2024 Supporto per i segmenti di pubblico non attivi nelle esportazioni dei segmenti di pubblico.
La funzionalità Esportazione dei segmenti di pubblico supporta meglio l'esportazione dei segmenti di pubblico di utenti non attivi. Gli utenti accedono a questi segmenti di pubblico senza un evento idoneo; ad esempio, possono inserire il segmento di pubblico non visitando il tuo sito web per sette giorni. Esempi di segmenti di pubblico non attivi includono "Acquirenti inattivi negli ultimi 7 giorni", "Utenti non attivi negli ultimi 7 giorni" e "Utenti senza notifiche ricevute negli ultimi 7 giorni". Per scoprire di più su questi segmenti di pubblico suggeriti, consulta Segmenti di pubblico suggeriti.
28/02/2024 Le esportazioni dei segmenti di pubblico restituiscono l'ID utente specificato nel tagging.
Le esportazioni dei segmenti di pubblico ora restituiscono l'ID utente specificato nel tagging anche se i dati forniti dall'utente sono attivati per la tua proprietà. Se la raccolta dei dati forniti dagli utenti è attiva, questi dati insieme allo User-ID possono essere inviati a Google Analytics nel tagging per migliorare la misurazione. Per scoprire di più, consulta Raccolta dei dati forniti dall'utente.
30/01/2024 Supporto delle notifiche webhook per gli elenchi dei segmenti di pubblico e gli elenchi dei segmenti di pubblico ricorrenti nell'API di dati v1 alpha.
I campi AudienceList.webhookNotification
e RecurringAudienceList.webhookNotification
possono essere specificati durante la creazione di un elenco del segmento di pubblico (utilizzando properties.audienceLists.create)
o un elenco del segmento di pubblico ricorrente (utilizzando properties.recurringAudienceLists.create).
Questa funzionalità ti consente di ricevere in modo asincrono notifiche webhook quando diventa disponibile un elenco del segmento di pubblico.
18/01/2024 Compatibilità migliorata per le dimensioni che includono la stringa di query o il componente minuti.
Le dimensioni che includono la stringa di query ora sono compatibili con la maggior parte dei campi.
Dimensioni come pagePathPlusQueryString
, unifiedPageScreen
, pageLocation
e fullPageUrl
sono ora compatibili con molti campi aggiuntivi, tra cui
sessionSource
, browser
, city
e landingPage
.
Le dimensioni che includono il componente minuti sono ora compatibili con la maggior parte dei campi. Dimensioni come minute
, nthMinute
e dateHourMinute
ora sono compatibili con un insieme simile di campi aggiuntivi.
Per informazioni complete sulla compatibilità, consulta Esplorazione dimensioni e metriche di GA4.
13/12/2023 Parametri personalizzati basati sugli articoli
Ora le dimensioni personalizzate basate sugli articoli possono essere incluse nelle query dell'API Analytics Data utilizzando la seguente sintassi:
Nome API generico | Descrizione |
---|---|
customItem:parameter_name | Dimensione personalizzata basata sugli articoli per parameter_name |
Per ulteriori informazioni, consulta la pagina Dimensioni e metriche delle API.
05/12/2023 gli elenchi dei segmenti di pubblico sono disponibili nella versione beta dell'API di dati v1 come esportazioni dei segmenti di pubblico
La funzionalità elenchi dei segmenti di pubblico è stata rinominata Esportazioni dei segmenti di pubblico e aggiunta alla versione beta dell'API Data API v1.
Sono stati aggiunti i seguenti metodi alla versione beta dell'API di dati v1:
28/11/2023 È stato aggiunto samplingMetadatas
alla risposta al report
Elemento samplingMetadatas
aggiunto a
ResponseMetaData
. Questa raccolta conterrà un elemento SampleMetadata
per ogni intervallo di date nella richiesta per cui i risultati sono stati campionati. Google Analytics
applica il campionamento solo quando prevede che i limiti di cardinalità
riducano la qualità dei dati.
28/11/2023 È stata aggiunta la funzionalità di esportazione ricorrente dell'elenco del segmento di pubblico alla versione alpha dell'API di dati v1
Aggiunti i metodi properties.recurringAudienceLists.create
,
properties.recurringAudienceLists.create
,
properties.recurringAudienceLists.list
alla versione alpha dell'API di dati v1.
Questa funzionalità ti consente di creare elenchi dei segmenti di pubblico ogni giorno man mano che cambiano le iscrizioni ai segmenti di pubblico. Gli elenchi dei segmenti di pubblico ricorrenti assicurano di lavorare con i risultati più recenti sull'appartenenza al pubblico.
08/11/2023 È stata aggiunta l'esportazione degli elenchi dei segmenti di pubblico nella funzionalità di Fogli alla versione alpha dell'API di dati v1
È stato aggiunto il metodo properties.audienceLists.exportSheet
alla versione alpha dell'API di dati v1, che consente di esportare un elenco del segmento di pubblico in Fogli Google.
13/10/2023 È stato aggiunto il supporto per i segmenti di pubblico con durata inclusione di 1 giorno
I segmenti di pubblico con durata inclusione di un giorno sono ora supportati dalla funzionalità di esportazione degli elenchi dei segmenti di pubblico.
12/09/2023 Regole di ordinamento predefinite di AudienceList
Per impostazione predefinita, i report creati utilizzando la funzionalità di esportazione degli elenchi dei segmenti di pubblico seguono le stesse regole di ordinamento degli altri metodi di generazione dei report dell'API di dati: l'ordinamento sarà decrescente per la prima colonna, poi per la seconda colonna e così via.
Prima di questa modifica, potresti aver ricevuto il seguente report:
deviceId | isAdsPersonalizationAllowed |
---|---|
ABC | true |
DAC | false |
ABC | false |
AAA | true |
Dopo questa modifica, riceverai il seguente report:
deviceId | isAdsPersonalizationAllowed |
---|---|
AAA | true |
ABC | false |
ABC | true |
DAC | false |
15/08/2023 È stata aggiunta la dimensione isLimitedAdTracking
allo schema di esportazione dell'elenco del segmento di pubblico
isLimitedAdTracking
L'impostazione della limitazione del monitoraggio degli annunci sul dispositivo. I valori possibili sono:true
,false
e(not set)
.Per scoprire di più, consulta la sezione Dimensioni degli elenchi dei segmenti di pubblico.
15/08/2023 Aggiunta la dimensione currencyCode
, metrica itemDiscountAmount
currencyCode
Il codice della valuta locale (in base allo standard ISO 4217) dell'evento di e-commerce. Ad esempio, "USD" o "GBP".itemDiscountAmount
Il valore monetario degli sconti sugli articoli negli eventi di e-commerce. Questa metrica viene compilata nel tagging tramite il parametro articolo "discount".
Per saperne di più, consulta Schema dei report dell'API di dati.
10/08/2023 È stata aggiunta la dimensione isAdsPersonalizationAllowed
allo schema di esportazione dell'elenco del segmento di pubblico
isAdsPersonalizationAllowed
La personalizzazione degli annunci è consentita. Se un utente è idoneo alla personalizzazione degli annunci,isAdsPersonalizationAllowed
restituiscetrue
. Se un utente non è idoneo alla personalizzazione degli annunci,isAdsPersonalizationAllowed
restituiscefalse
.Per scoprire di più, consulta la sezione Dimensioni degli elenchi dei segmenti di pubblico.
10/07/2023 Elenchi dei segmenti di pubblico
Supporto degli elenchi dei segmenti di pubblico aggiunto alla versione 1 dell'API di dati. Gli elenchi dei segmenti di pubblico includono un'istantanea degli utenti nel segmento di pubblico al momento della creazione dell'elenco.
I seguenti metodi sono stati aggiunti all'API di dati v1 alpha:
19/05/2023 Gruppi di canali personalizzati
Supporto dei gruppi di canali personalizzati aggiunto all'API di dati.
11/05/2023 Modifiche alla quota di token.
Il sistema di quote dell'API di dati è stato aggiornato per consentire addebiti più precisi.
Il numero di token addebitati per ogni richiesta è stato aggiornato in linea con la modifica della quota e ribilanciato in modo da consentire un numero maggiore di query semplici nei report, addebitando al contempo un numero significativamente maggiore di token di quota per report di date di grandi dimensioni.
Dopo questa modifica, mentre l'addebito per alcune richieste rimarrà invariato, si verificherà un aumento notevole degli addebiti per le query più complicate. Ad esempio, le richieste per più di 6 mesi di dati possono addebitare 1000 o più token di quota.
Proprietà standard
Nome quota | Limite precedente | Nuovo limite |
---|---|---|
Token principali per proprietà al giorno | 25.000 | 200.000 |
Token principali per proprietà all'ora | 5000 | 40.000 |
Token principali per progetto per proprietà all'ora | 1.750 | 14.000 |
Token in tempo reale per proprietà al giorno | 25.000 | 200.000 |
Token in tempo reale per proprietà all’ora | 5000 | 40.000 |
Token in tempo reale per progetto per proprietà all'ora | 1.750 | 14.000 |
Token canalizzazione per proprietà al giorno | 25.000 | 200.000 |
Token canalizzazione per proprietà all'ora | 5000 | 40.000 |
Token canalizzazione per progetto per proprietà all'ora | 1.750 | 14.000 |
Proprietà Analytics 360
Nome quota | Limite precedente | Nuovo limite |
---|---|---|
Token principali per proprietà al giorno | 250.000 | 2.000.000 |
Token principali per proprietà all'ora | 50.000 | 400.000 |
Token principali per progetto per proprietà all'ora | 17.500 | 140.000 |
Token in tempo reale per proprietà al giorno | 250.000 | 2.000.000 |
Token in tempo reale per proprietà all’ora | 50.000 | 400.000 |
Token in tempo reale per progetto per proprietà all'ora | 17.500 | 140.000 |
Token canalizzazione per proprietà al giorno | 250.000 | 2.000.000 |
Token canalizzazione per proprietà all'ora | 50.000 | 400.000 |
Token canalizzazione per progetto per proprietà all'ora | 17.500 | 140.000 |
2/03/2023 Aggiunta le dimensioni di data.
dayOfWeekName
Nome del giorno della settimana. Il giorno della settimana in inglese. Questa dimensione ha valoriSunday
,Monday
e così via.isoWeek
settimana ISO dell'anno. Numero della settimana ISO, dove ogni settimana inizia il lunedì. Per maggiori dettagli, consulta la pagina https://en.wikipedia.org/wiki/ISO_week_date. I valori di esempio includono01
,02
e53
.isoYear
anno ISO. L'anno ISO dell'evento. Per maggiori dettagli, consulta la pagina https://en.wikipedia.org/wiki/ISO_week_date. I valori di esempio includono2022
e2023
.isoYearIsoWeek
settimana ISO dell'anno ISO. I valori combinati diisoWeek
eisoYear
. I valori di esempio includono201652
e201701
.yearMonth
anno/mese. I valori combinati diyear
emonth
. I valori di esempio includono202212
o202301
.yearWeek
anno alla settimana. I valori combinati diyear
eweek
. I valori di esempio includono202253
o202301
.
27/02/2023 Sono state aggiunte le dimensioni e-commerce.
itemListPosition
posizione dell'elenco di articoli. La posizione di un articolo (ad es. un prodotto che vendi) in un elenco. Questa dimensione viene compilata nel tagging tramite il parametro "index" nell'array di articoli.itemLocationID
ID posizione articolo. La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID luogo Google corrispondente all'articolo associato. Puoi anche utilizzare un ID località personalizzato. Questo campo viene compilato per la codifica dal parametro "location_id" nell'array di articoli.itemPromotionCreativeSlot
area creatività per promozione articolo. Il nome dell'area creatività promozionale associata all'articolo. Questa dimensione può essere specificata nel tagging tramite il parametrocreative_slot
a livello di evento o di articolo. Se il parametro viene specificato sia a livello di evento che di articolo, viene utilizzato il parametro a livello di articolo.
21/02/2023 È stata aggiunta la dimensione "Pagina di destinazione + stringa di query".
landingPagePlusQueryString
Pagina di destinazione + stringa di query. Il percorso pagina e la stringa di query associati alla prima visualizzazione di pagina di una sessione.
Questo campo sostituisce la dimensione landingPage
che è deprecata e verrà aggiornata in modo da non restituire una stringa di query il 14 maggio 2023.
28/01/2023 Sono state aggiunte le metriche "Visualizzazioni per utente", "Utenti che hanno fatto scorrere la pagina".
screenPageViewsPerUser
visualizzazioni per utente. Il numero di schermate di app o pagine web visualizzate dagli utenti per utente attivo. Le visualizzazioni ripetute di una stessa pagina o schermata vengono conteggiate.(screen_view + page_view events) / active users
.scrolledUsers
utenti che hanno eseguito lo scorrimento. Il numero di utenti unici che hanno fatto scorrere la pagina verso il basso di almeno il 90%.
23/01/2023 Sono state aggiunte le dimensioni "Continente", "ID continente".
continent
continente. Il continente in cui ha avuto origine l'attività utente. Ad esempio,Americas
oAsia
ID continente
continentId
. L'ID geografico del continente in cui ha avuto origine l'attività utente, recuperato dal suo indirizzo IP.
23/01/2023 È stata aggiunta la dimensione "ID filtro dati di test".
testDataFilterId
ID filtro dati di test. L'identificatore numerico di un filtro dati in stato di test. Puoi utilizzare i filtri dei dati per includere o escludere i dati degli eventi dai report in base ai valori dei parametri evento. Per saperne di più, consulta la pagina https://support.google.com/analytics/answer/10108813.
18/10/2022 Sono state aggiunte le metriche relative agli annunci.
advertiserAdClicks
clic sugli annunci. Numero totale di volte in cui gli utenti hanno fatto clic su un annuncio per raggiungere la proprietà.advertiserAdCost
Costo degli annunci. L'importo totale che hai pagato per i tuoi annunci.advertiserAdCostPerClick
Costo per clic degli annunci. Il costo per clic degli annunci è il costo dell'annuncio diviso per i clic sull'annuncio ed è spesso abbreviato in CPC.- Costo per conversione:
advertiserAdCostPerConversion
. Il costo per conversione è il costo dell'annuncio diviso per le conversioni. advertiserAdImpressions
impressioni degli annunci. Il numero totale di impressioni.returnOnAdSpend
Ritorno sulla spesa pubblicitaria. Il ritorno sulla spesa pubblicitaria (ROAS) indica le entrate totali divise per il costo dell'annuncio dell'inserzionista.
17/10/2022 Sono state aggiunte metriche basate sugli articoli.
itemsAddedToCart
articoli aggiunti al carrello. Il numero di unità aggiunte al carrello per un singolo articolo.itemsCheckedOut
articoli pagati. Il numero di unità acquistate per un singolo articolo.itemsClickedInList
articoli selezionati tramite clic nell'elenco. Il numero di unità selezionate nell'elenco per un singolo articolo.itemsClickedInPromotion
articoli selezionati tramite clic nella promozione. Il numero di unità selezionate nella promozione di un singolo articolo.itemsViewed
elementi visualizzati. Il numero di unità visualizzate per un singolo articolo.itemsViewedInList
articoli visualizzati nell'elenco. Il numero di unità visualizzate nell'elenco per un singolo articolo.itemsViewedInPromotion
articoli visualizzati nella promozione. Il numero di unità visualizzate nella promozione di un singolo articolo.
13/09/2022 Annuncio sulle modifiche alla compatibilità dello schema.
Il 1° dicembre 2022 verranno apportate le seguenti modifiche che provocano un errore:
Le dimensioni basate sugli articoli come
itemName
stanno diventando incompatibili con le metriche basate sugli eventi comeeventCount
. Le dimensioni basate sugli articoli saranno comunque compatibili con le metriche basate sugli articoli comeitemRevenue
, con le metriche basate sugli utenti (activeUsers
) e con le metriche basate sulle sessioni comesessions
.Le dimensioni di attribuzione come
source
stanno diventando incompatibili con alcune metriche basate sugli eventi comeeventCount
. Le dimensioni di attribuzione saranno comunque compatibili con metriche attribuibili comeconversions
, metriche basate sugli utenti comeactiveUsers
e metriche basate sulle sessioni comesessions
.Le dimensioni che includono la stringa di query, come
pagePathPlusQueryString
, saranno compatibili solo con un insieme limitato di dimensioni e metriche.
Per ulteriori informazioni, leggi la spiegazione dettagliata delle modifiche alla compatibilità.
01/09/2022 Modifiche alle quote.
Le quote
Requests per day
,Requests Per Minute
,Requests Per Minute Per User
vengono rimosse dall'API di dati.Tokens Per Project Per Property Per Hour
quota è stata aggiunta all'API.Ogni richiesta utilizza la quota sia per
Tokens Per Property Per Hour
sia perTokens Per Project Per Property Per Hour
.Consulta la documentazione sulle quote per informazioni dettagliate sulle nuove quote.
03/08/2022 Sono state aggiunte le dimensioni SA360 con ambito a livello di sessione.
sessionSa360AdGroupName
Nome del gruppo di annunci SA360 della sessione. Il nome del gruppo di annunci di Search Ads 360 che ha generato questa sessione.sessionSa360CampaignName
campagna SA360 della sessione. Il nome della campagna in Search Ads 360 che ha generato questa sessione.sessionSa360CreativeFormat
Formato della creatività SA360 della sessione. Il tipo di creatività in Search Ads 360 che ha generato questa sessione. Ad esempio, "Annuncio adattabile della rete di ricerca" o "Annuncio di testo espanso".sessionSa360EngineAccountId
ID account motore SA360 della sessione. L'ID dell'account motore in SA360 che ha generato questa sessione.sessionSa360EngineAccountName
Nome account motore SA360 della sessione. Il nome dell'account motore in SA360 che ha generato questa sessione.sessionSa360EngineAccountType
Tipo di account motore SA360 della sessione. Il tipo di account motore in Search Ads 360 che ha generato questa sessione. Ad esempio, "google ads", "bing" o "baidu".sessionSa360Keyword
Testo della parola chiave SA360 della sessione. La parola chiave del motore di ricerca di Search Ads 360 che ha generato questa sessione.sessionSa360Medium
Mezzo SA360 della sessione. La parola chiave del motore di ricerca di Search Ads 360 che ha generato questa sessione. Ad esempio, "cpc".sessionSa360Query
Query SA360 della sessione. La query di ricerca di Search Ads 360 che ha generato questa sessione.sessionSa360Source
Sorgente SA360 della sessione. La sorgente del traffico da Search Ads 360 che ha portato a questa sessione. Ad esempio, "example.com" o "google".Le dimensioni
sessionCampaignId
,sessionCampaignName
ora supportano le campagne Search Ads 360.
11/07/2022 Aggiunte metriche del tasso di conversione.
Tasso di conversione
sessionConversionRate
: la percentuale di sessioni in cui è stato attivato un evento di conversione.userConversionRate
La percentuale di utenti che hanno attivato un evento di conversione.
Metriche del tasso di conversione per una conversione
sessionConversionRate:event_name
: la percentuale di sessioni in cui è stato attivato un evento di conversione specifico.userConversionRate:event_name
La percentuale di utenti che hanno attivato un evento di conversione specifico.
05/05/2022 È stata aggiunta la funzionalità di generazione di report Canalizzazione al canale alpha.
Metodo
runFunnelReport
aggiunto alla versione v1alpha dell'API, che restituisce un report sulla canalizzazione personalizzato dei dati sugli eventi di Google Analytics.Questo metodo viene introdotto in fase di stabilità alpha con l'intento di raccogliere feedback sulla sintassi e sulle funzionalità prima di accedere alla versione beta. Compila il feedback sui report sulla canalizzazione dell'API di dati di Google Analytics per inviare il tuo feedback su questa API.
16/02/2022 Sono state aggiunte nuove dimensioni.
Termine e contenuti manuali
firstUserManualAdContent
Contenuto dell'annuncio manuale della prima interazione dell'utente. Il contenuto dell'annuncio che ha acquisito per la prima volta l'utente. Completato dal parametroutm_content
.firstUserManualTerm
Termine manuale della prima interazione dell'utente. Il termine che ha acquisito per la prima volta l'utente. Completato dal parametroutm_term
.manualAdContent
Contenuto dell'annuncio manuale. Il contenuto dell'annuncio attribuito all'evento di conversione. Completato dal parametroutm_content
.manualTerm
Termine manuale. Il termine attribuito all'evento di conversione. Completato dal parametroutm_term
.sessionManualAdContent
Contenuto dell'annuncio manuale della sessione. Il contenuto dell'annuncio che ha generato una sessione. Completato dal parametroutm_content
.sessionManualTerm
Termine manuale della sessione. Il termine che ha generato una sessione. Completato dal parametroutm_term
.
Analisi degli arresti anomali
crashAffectedUsers
utenti interessati da arresti anomali. Il numero di utenti che hanno registrato un arresto anomalo in questa riga del report.crashFreeUsersRate
Percentuale di utenti senza arresti anomali.
App/web
averageSessionDuration
La durata media (in secondi) delle sessioni degli utenti.newVsReturning
Utenti nuovi / di ritorno.screenPageViewsPerSession
visualizzazioni per sessione.landingPage
Pagina di destinazione. Il percorso pagina e la stringa di query associati alla prima visualizzazione di pagina di una sessione.platformDeviceCategory
La piattaforma e il tipo di dispositivo su cui è stato eseguito il tuo sito web o la tua app mobile.
App mobile
averagePurchaseRevenuePerUser
Entrate medie generate dagli acquisti per utente.firstTimePurchaserConversionRate
La percentuale di utenti attivi che hanno effettuato il primo acquisto.firstTimePurchasersPerNewUser
Il numero medio di nuovi acquirenti per nuovo utente.dauPerMau
DAU / MAU. La percentuale mobile di utenti attivi in 30 giorni che sono anche utenti attivi in 1 giorno.dauPerWau
DAU / WAU. La percentuale mobile di utenti attivi in 7 giorni che sono anche utenti attivi in 1 giorno.wauPerMau
WAU / MAU. La percentuale mobile di utenti attivi in 30 giorni che sono anche utenti attivi in 7 giorni.purchaserConversionRate
La percentuale di utenti attivi che hanno effettuato una o più transazioni di acquisto.transactionsPerPurchaser
transazioni per acquirente.
campagna google ads
firstUserGoogleAdsCampaignType
Il tipo di campagna Google Ads che ha acquisito per la prima volta l'utente.googleAdsCampaignType
Il tipo di campagna Google Ads attribuito all'evento di conversione.sessionGoogleAdsCampaignType
Il tipo di campagna Google Ads che ha generato questa sessione.
7/09/2021 Sono state aggiunte nuove dimensioni Data/ora.
dateHourMinute
I valori combinati di data, ora e minuti nel formato AAAAMMGGHHMM.minute
: il minuto di due cifre dell'ora in cui l'evento è stato registrato.nthMinute
Il numero di minuti dall'inizio dell'intervallo di date.
7/09/2021 Sono state aggiunte nuove dimensioni compilate dai parametri evento.
achievementId
L'ID dell'obiettivo in un gioco per un evento.character
Il personaggio del giocatore in un gioco per un evento.fileExtension
L'estensione del file scaricato.fileName
: il percorso pagina del file scaricato.groupId
L'ID gruppo di giocatori in un gioco per un evento.linkClasses
L'attributo classe HTML di un link in uscita.linkDomain
Il dominio di destinazione del link in uscita.linkId
Attributo ID HTML per un link in uscita o il download di un file.linkText
Il testo del link per il download del file.linkUrl
L'URL completo per un link in uscita o il download di un file.method
Il metodo con cui è stato attivato un evento.outbound
Restituisce "true" se il link che rimanda a un sito non fa parte del dominio della proprietà.pageLocation
Protocollo, nome host, percorso pagina e stringa di query per le pagine web visitate.pageReferrer
L'URL di riferimento completo, inclusi nome host e percorso.percentScrolled
La percentuale di pagina che l'utente ha fatto scorrere (ad esempio "90").searchTerm
Il termine cercato dall'utente.videoProvider
L'origine del video (ad es. "youtube").videoTitle
Il titolo del video.videoUrl
L'URL del video.visible
Restituisce "true" se il contenuto è visibile.unifiedPagePathScreen
Il percorso pagina (web) o la classe della schermata (app) in cui è stato registrato l'evento.
07/09/2021 Modifiche allo schema dell'API.
Modifiche alle dimensioni esistenti:
unifiedPageScreen
Per gli eventi generati dal web, questa dimensione ora restituisce il percorso pagina e la stringa di query in cui l'evento è stato registrato.
Annuncio delle modifiche imminenti:
firstUserTrafficOrigin
L'origine del traffico che ha acquisito per la prima volta l'utente. Non fare affidamento sul fatto che questo campo restituisca "Manuale" per il traffico che utilizza UTM; questo campo verrà aggiornato da "Manuale" a "(not set)" per un imminente lancio di funzionalità.sessionTrafficOrigin
L'origine del traffico della campagna della sessione. Non fare affidamento sul fatto che questo campo restituisca "Manuale" per il traffico che utilizza UTM; questo campo verrà aggiornato da "Manuale" a "(not set)" per un imminente lancio di funzionalità.trafficOrigin
L'origine del traffico della campagna dell'evento di conversione. Non fare affidamento sul fatto che questo campo restituisca "Manuale" per il traffico che utilizza UTM; questo campo verrà aggiornato da "Manuale" a "(not set)" per un imminente lancio di funzionalità.
07/09/2021 checkCompatibility
metodo aggiunto all'API.
Il metodo checkCompatibility
elenca le dimensioni e le metriche che possono essere aggiunte a una richiesta di report e mantengono la compatibilità.
21/07/2021 Modifiche ai report in tempo reale.
Ora è possibile specificare gli intervalli minuti di dati sugli eventi da leggere utilizzando il parametro minuteRanges
del metodo runRealtimeReport
.
21/07/2021 Nuove dimensioni di raggruppamento dei canali.
Nuove dimensioni di raggruppamento dei canali aggiunte allo schema dei report dell'API di dati:
firstUserDefaultChannelGrouping
Raggruppamento dei canali predefinito della prima interazione dell'utente.defaultChannelGrouping
Raggruppamento dei canali predefinito.
10/06/2021 Modifiche allo schema API.
La dimensione
minutesAgo
è stata aggiunta allo schema in tempo reale dell'API di dati e può essere utilizzata nelle query al metodorunRealtimeReport
. Questa dimensione contiene il numero di minuti prima della raccolta di un evento. 00 indica il minuto corrente, mentre 01 indica il minuto precedente.googleAdsCreativeId
dimensione aggiunta allo schema dell'API di dati. Questa dimensione contiene l'ID della creatività Google Ads attribuita all'evento di conversione.sessionGoogleAdsCreativeId
dimensione aggiunta allo schema dell'API di dati. Questa dimensione contiene l'ID della creatività Google Ads che ha generato una sessione sul tuo sito web o nella tua app.Dimensione
firstUserCreativeId
rinominata infirstUserGoogleAdsCreativeId
nello schema dell'API di dati. Questa dimensione contiene l'ID della creatività Google Ads che ha acquisito per prima l'utente.
09/04/2021 La versione beta dell'API di dati di Google Analytics v1 è stata rilasciata.
Endpoint API aggiornato a
https://analyticsdata.googleapis.com/v1beta
.I metodi
runReport
,runPivotReport
,batchRunReports
ebatchRunPivotReports
ora accettano l'ID di una proprietà Google Analytics 4 nel parametroproperty
del percorso dell'URL anziché nel campoentity
del corpo di una richiesta:POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports
Le librerie client API sono state aggiornate in modo da utilizzare il nuovo endpoint API.
19/02/2021 Modifiche di impaginazione.
La dimensione predefinita della risposta al report è aumentata da 10 a 10.000 righe di dati sugli eventi.
Il valore
"limit" : -1
utilizzato per indicare un tentativo di recuperare tutte le righe non è più supportato in RunReportRequest.Il valore massimo del campo
limit
è impostato su100000
. Utilizza la paginazione per recuperare report contenenti più di 100.000 righe.
8/02/2021 Nuove dimensioni e metriche di e-commerce.
Nuove dimensioni e metriche di e-commerce sono state aggiunte allo schema dell'API:
Dimensioni: adFormat
, adSourceName
, adUnitName
, itemBrand
,
itemCategory
, itemCategory2
, itemCategory3
, itemCategory4
,
itemCategory5
itemId
, itemListId
, itemListName
, itemName
,
itemPromotionCreativeName
, itemPromotionId
, itemPromotionName
,
orderCoupon
, transactionId
.
Metriche: adUnitExposure
, addToCarts
, cartToViewRate
, checkouts
,
ecommercePurchases
, firstTimePurchasers
, itemListClickThroughRate
,
itemListClicks
, itemListViews
, itemPromotionClickThroughRate
,
itemPromotionClicks
, itemPromotionViews
, itemPurchaseQuantity
,
itemRevenue
, itemViews
, publisherAdClicks
,
publisherAdImpressions
, totalPurchasers
.
8/02/2021 Aggiunta di nuove dimensioni per la campagna.
Sono state aggiunte nuove dimensioni di campagna allo schema API:
campaignId
, campaignName
, googleAdsAccountName
,
googleAdsAdGroupId
, googleAdsAdGroupName
, googleAdsAdNetworkType
,
source
, trafficOrigin
8/02/2021 dayOfWeek
, week
modifiche alle dimensioni.
Il valore della dimensione
dayOfWeek
ora inizia con 0 anziché 1.Il valore della dimensione
week
ora inizia con 01 e restituisce un numero a due cifre compreso tra 01 e 53. Ogni settimana inizia di domenica. Il 1° gennaio cade sempre nella settimana 01.
28/01/2021 Sono state aggiunte varianti di aggregazione per le metriche personalizzate.
Ogni metrica personalizzata registrata da una proprietà crea tre varianti della metrica API: una somma, una media e un conteggio.
28/01/2021 Sono state aggiunte nuove dimensioni Data/ora.
Le seguenti nuove dimensioni sono state aggiunte allo schema API:
hour
, nthHour
, nthYear
, dateHour
.
28/01/2021 L'API di dati ha ridotto i token di quota addebitati per query.
L'API di dati ha ridotto i token di quota addebitati per query. I limiti di quota per i token di quota della proprietà all'ora e al giorno non sono stati modificati.
09/11/2020 Il metodo getUniversalMetadata
è stato eliminato.
Il metodo getUniversalMetadata
è stato eliminato. Utilizza
getMetadata. L'intervallo di date massimo di un anno per richiesta API è stato rimosso.
02/11/2020 è stato aggiunto un metodo di generazione dei report in tempo reale.
Consulta Creazione di un report In tempo reale per esempi e runRealtimeReport per la documentazione di riferimento REST.
19/10/2020 Elementi della libreria client aggiornati.
Artefatti della libreria client aggiornati insieme a istruzioni per l'utilizzo ed esempi di codice.
13/10/2020 Le proprietà App + web sono state rinominate Google Analytics 4 (GA4).
08/10/2020 getMetadata
metodo aggiunto all'API.
getMetadata restituisce le dimensioni e le metriche personalizzate disponibili per l'ID proprietà GA4 specificato, nonché i metadati universali.
8/10/2020 Le dimensioni e le metriche personalizzate sono disponibili nei report.
Per la documentazione su dimensioni e metriche personalizzate, consulta la documentazione relativa agli schemi API. Questo aggiornamento include dimensioni e metriche personalizzate basate sugli eventi, nonché dimensioni personalizzate basate sugli utenti.