Log delle modifiche

Per gli annunci ufficiali dell'API Google Analytics, iscriviti al gruppo di notifica dell'API Google Analytics.

20/10/2024 È stato aggiunto il tipo di filtro delle dimensioni EmptyFilter

Utilizzando il filtro della dimensione EmptyFilter, puoi creare condizioni di filtro per il confronto con un valore vuoto.

15/10/2024 È stata aggiunta la funzionalità Livello di campionamento al metodo reportTasks

Utilizzando il campo samplingLevel del metodo properties.runReportTask puoi controllare il livello di campionamento del report.

Questa funzionalità consente alle proprietà Google Analytics 360 di accedere a limiti di campionamento più elevati di 1 miliardo di eventi. Inoltre, i limiti di campionamento possono essere impostati su UNSAMPLED per i risultati non campionati con un numero elevato di eventi.

18-09-2024 È stata aggiunta la funzionalità Istantanea delle quote proprietà

Utilizzando il metodo properties.getPropertyQuotasSnapshot, puoi ottenere uno snapshot corrente di tutte le quote della proprietà organizzate per categoria di quota per una determinata proprietà.

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 e per proprietà in un intervallo di 15 minuti. Sono incluse tutte le richieste che generano una risposta con un 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, le chiamate API aggiuntive alla proprietà verranno bloccate temporaneamente per il progetto Google Cloud associato fino al termine dell'intervallo di 15 minuti.

14-05-2024 È stata aggiunta la funzionalità Confronti

Con Confronti, puoi valutare i sottoinsiemi dei tuoi dati uno accanto all'altro.

I metodi di generazione di report principali dell'API Data v1beta sono aggiornati per supportare il campo comparisons che, se incluso, specifica la configurazione dei confronti richiesti.

In una richiesta, puoi specificare un confronto di base fornendo l'espressione dimensionFilter con una richiesta oppure utilizzare un confronto salvato fornendo il nome della risorsa del confronto nel campo comparison.

Il metodo getMetadata è stato aggiornato per elencare tutti i confronti salvati disponibili per una proprietà nel campo della risposta comparisons.

Quando in una richiesta viene specificato almeno un confronto, la risposta conterrà la colonna comparison che identifica ogni confronto.

Al momento, i confronti salvati possono essere creati solo utilizzando l'interfaccia utente di Google Analytics.

08/05/2024 Aggiunta delle attività di generazione di report, una funzionalità di generazione di report asincrona, all'API di dati v1alpha.

Utilizzando le attività di generazione di report, puoi avviare una richiesta asincrona di lunga durata 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:

06-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 utilizzano la dimensione isConversionEvent in modo da utilizzare la dimensione isKeyEvent.

Modifica le richieste di report che utilizzano una metrica ritirata nella tabella seguente in modo da utilizzare la metrica Evento chiave.

Metrica ritirata Metrica evento chiave
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

Apporta modifiche simili a qualsiasi utilizzo delle metriche sugli eventi chiave per un singolo evento chiave nelle richieste di report.

La risposta al metodo properties/getMetadata riflette l'introduzione delle dimensioni e delle metriche relative agli eventi chiave negli oggetti DimensionMetadata e MetricMetadata come segue:

  • apiName, uiName e description contengono il nome dell'API evento principale, il nome dell'interfaccia utente e la descrizione.
  • Il campo ripetuto deprecatedApiNames contiene una voce con il nome dell'API di conversione ritirata.

25/03/2024 Sono state aggiunte dimensioni specifiche per il gruppo di canali principale, la sorgente di traffico manuale e l'integrazione.

Gruppo di canali principale, sorgente di traffico manuale e dimensioni specifiche dell'integrazione di CM360, DV360 e SA360 aggiunte allo schema dell'API Data.

Dimensioni dei 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 utente

  • primaryChannelGroup Gruppo di canali principale

  • sessionPrimaryChannelGroup Gruppo di canali principale della sessione

Dimensioni Sorgente di traffico manuale:

  • manualCampaignId ID campagna manuale

  • manualCampaignName Nome della campagna manuale

  • manualCreativeFormat Formato della creatività manuale

  • manualMarketingTactic Tattica di marketing manuale

  • manualMedium Mezzo manuale

  • manualSource Sorgente manuale

  • manualSourceMedium Sorgente / Mezzo manuale

  • manualSourcePlatform Piattaforma di origine manuale

  • firstUserManualCampaignId ID campagna manuale della prima interazione dell'utente

  • firstUserManualCampaignName Nome della campagna manuale della prima interazione dell'utente

  • firstUserManualCreativeFormat Formato della creatività manuale della prima interazione dell'utente

  • firstUserManualMarketingTactic Tattica di marketing manuale del primo utente

  • firstUserManualMedium Mezzo manuale della prima interazione dell'utente

  • firstUserManualSource Sorgente manuale della prima interazione dell'utente

  • firstUserManualSourceMedium Sorgente / mezzo manuale della prima interazione dell'utente

  • firstUserManualSourcePlatform Piattaforma di origine manuale della prima interazione dell'utente

  • sessionManualCampaignId ID campagna manuale della sessione

  • sessionManualCampaignName Nome della campagna manuale della sessione

  • sessionManualCreativeFormat Formato della creatività manuale della sessione

  • sessionManualMarketingTactic Tattica di marketing manuale della sessione

  • sessionManualMedium Mezzo manuale della sessione

  • sessionManualSource Sorgente manuale della sessione

  • sessionManualSourceMedium Sorgente / mezzo manuale della sessione

  • sessionManualSourcePlatform Piattaforma di origine manuale della sessione

Dimensioni di integrazione di Campaign Manager 360 (CM360):

  • cm360AccountId ID account CM360

  • cm360AccountName Nome account CM360

  • cm360AdvertiserId ID inserzionista CM360

  • cm360AdvertiserName Nome inserzionista CM360

  • cm360CampaignId ID campagna CM360

  • cm360CampaignName Nome campagna CM360

  • cm360CreativeFormat Formato della creatività CM360

  • cm360CreativeId ID creatività CM360

  • cm360CreativeName Nome della creatività CM360

  • cm360CreativeType Tipo di creatività CM360

  • cm360CreativeTypeId ID tipo di creatività CM360

  • cm360CreativeVersion Versione creatività CM360

  • cm360Medium Mezzo CM360

  • cm360PlacementCostStructure Struttura dei costi dei posizionamenti CM360

  • cm360PlacementId ID posizionamento CM360

  • cm360PlacementName Nome posizionamento CM360

  • cm360RenderingId ID rendering CM360

  • cm360SiteId ID sito CM360

  • cm360SiteName Nome sito CM360

  • cm360Source Sorgente CM360

  • cm360SourceMedium Sorgente / mezzo CM360

  • firstUserCm360AccountId ID account della prima interazione CM360

  • firstUserCm360AccountName Nome account della prima interazione CM360

  • firstUserCm360AdvertiserId ID inserzionista della prima interazione CM360

  • firstUserCm360AdvertiserName Nome inserzionista della prima interazione CM360

  • firstUserCm360CampaignId ID campagna CM360 del primo utente

  • firstUserCm360CampaignName Nome campagna della prima interazione CM360

  • firstUserCm360CreativeFormat Formato della creatività della prima interazione CM360

  • firstUserCm360CreativeId ID creatività CM360 primo utente

  • firstUserCm360CreativeName Nome della creatività della prima interazione CM360

  • firstUserCm360CreativeType Tipo di creatività della prima interazione CM360

  • firstUserCm360CreativeTypeId ID tipo di creatività CM360 primo utente

  • firstUserCm360CreativeVersion Versione creatività della prima interazione CM360

  • firstUserCm360Medium Mezzo della prima interazione CM360

  • firstUserCm360PlacementCostStructure Struttura dei costi dei posizionamenti della prima interazione CM360

  • firstUserCm360PlacementId ID posizionamento della prima interazione CM360

  • firstUserCm360PlacementName Nome posizionamento della prima interazione CM360

  • firstUserCm360RenderingId ID rendering della prima interazione CM360

  • firstUserCm360SiteId ID sito della prima interazione CM360

  • firstUserCm360SiteName Nome sito della prima interazione CM360

  • firstUserCm360Source Sorgente della prima interazione CM360

  • firstUserCm360SourceMedium Sorgente / mezzo CM360 primo utente

  • sessionCm360AccountId ID account CM360 della sessione

  • sessionCm360AccountName Nome account CM360 della sessione

  • sessionCm360AdvertiserId ID inserzionista CM360 della sessione

  • sessionCm360AdvertiserName Nome inserzionista CM360 della sessione

  • sessionCm360CampaignId ID campagna CM360 della sessione

  • sessionCm360CampaignName Nome campagna CM360 della sessione

  • sessionCm360CreativeFormat Formato della creatività CM360 della sessione

  • sessionCm360CreativeId ID creatività CM360 della sessione

  • sessionCm360CreativeName Nome creatività CM360 della sessione

  • sessionCm360CreativeType Tipo di creatività CM360 della sessione

  • sessionCm360CreativeTypeId ID tipo di creatività CM360 della sessione

  • sessionCm360CreativeVersion Versione creatività CM360 della sessione

  • sessionCm360Medium Mezzo CM360 della sessione

  • sessionCm360PlacementCostStructure Struttura dei costi dei posizionamenti CM360 della sessione

  • sessionCm360PlacementId ID posizionamento CM360 della sessione

  • sessionCm360PlacementName Nome posizionamento CM360 della sessione

  • sessionCm360RenderingId ID rendering CM360 della sessione

  • sessionCm360SiteId ID sito CM360 della sessione

  • sessionCm360SiteName Nome sito CM360 della sessione

  • sessionCm360Source Sorgente CM360 della sessione

  • sessionCm360SourceMedium Sorgente / mezzo CM360 della sessione

Dimensioni di integrazione di Google Display & Video 360 (DV360):

  • dv360AdvertiserId ID inserzionista DV360

  • dv360AdvertiserName Nome inserzionista DV360

  • dv360CampaignId ID campagna DV360

  • dv360CampaignName Nome campagna DV360

  • dv360CreativeFormat Formato della creatività DV360

  • dv360CreativeId ID creatività DV360

  • dv360CreativeName Nome creatività DV360

  • dv360ExchangeId ID piattaforma di scambio DV360

  • dv360ExchangeName Nome piattaforma di scambio DV360

  • dv360InsertionOrderId ID ordine di inserzione DV360

  • dv360InsertionOrderName Nome ordine di inserzione DV360

  • dv360LineItemId ID elemento pubblicitario DV360

  • dv360LineItemName Nome elemento pubblicitario DV360

  • dv360Medium Mezzo DV360

  • dv360PartnerId ID partner DV360

  • dv360PartnerName Nome partner DV360

  • dv360Source Sorgente DV360

  • dv360SourceMedium Sorgente / mezzo DV360

  • firstUserDv360AdvertiserId ID inserzionista DV360 della prima interazione dell'utente

  • firstUserDv360AdvertiserName Nome inserzionista della prima interazione dell'utente DV360

  • firstUserDv360CampaignId ID campagna DV360 della prima interazione dell'utente

  • firstUserDv360CampaignName Nome campagna della prima interazione dell'utente DV360

  • firstUserDv360CreativeFormat Formato della creatività DV360 della prima interazione dell'utente

  • firstUserDv360CreativeId ID creatività DV360 della prima interazione dell'utente

  • firstUserDv360CreativeName Nome creatività DV360 della prima interazione dell'utente

  • firstUserDv360ExchangeId ID piattaforma di scambio DV360 della prima interazione dell'utente

  • firstUserDv360ExchangeName Nome piattaforma di scambio DV360 della prima interazione dell'utente

  • firstUserDv360InsertionOrderId ID ordine di inserzione DV360 della prima interazione dell'utente

  • firstUserDv360InsertionOrderName Nome ordine di inserzione DV360 della prima interazione dell'utente

  • firstUserDv360LineItemId ID elemento DV360 della prima interazione dell'utente

  • firstUserDv360LinteItemName Nome elemento DV360 della prima interazione dell'utente

  • firstUserDv360Medium Mezzo DV360 della prima interazione dell'utente

  • firstUserDv360PartnerId ID partner DV360 della prima interazione dell'utente

  • firstUserDv360PartnerName Nome partner DV360 della prima interazione dell'utente

  • firstUserDv360Source Sorgente DV360 della prima interazione dell'utente

  • firstUserDv360SourceMedium Sorgente / mezzo DV360 della prima interazione dell'utente

  • sessionDv360AdvertiserId ID inserzionista della sessione DV360

  • sessionDv360AdvertiserName Nome inserzionista DV360 della sessione

  • sessionDv360CampaignId ID campagna DV360 della sessione

  • sessionDv360CampaignName Nome campagna DV360 della sessione

  • sessionDv360CreativeFormat Formato della creatività della sessione DV360

  • sessionDv360CreativeId ID creatività della sessione DV360

  • sessionDv360CreativeName Nome creatività DV360 della sessione

  • sessionDv360ExchangeId ID piattaforma di scambio della sessione DV360

  • sessionDv360ExchangeName Nome piattaforma di scambio della sessione DV360

  • sessionDv360InsertionOrderId ID ordine di inserzione DV360 della sessione

  • sessionDv360InsertionOrderName Nome ordine di inserzione della sessione DV360

  • sessionDv360LineItemId ID elemento della sessione DV360

  • sessionDv360LineItemName Nome elemento della sessione DV360

  • sessionDv360Medium Mezzo della sessione DV360

  • sessionDv360PartnerId ID partner DV360 della sessione

  • sessionDv360PartnerName Nome partner DV360 della sessione

  • sessionDv360Source Sorgente della sessione DV360

  • sessionDv360SourceMedium Sorgente / mezzo della sessione DV360

Dimensioni di integrazione di Google Search Ads 360 (SA360):

  • firstUserSa360AdGroupId ID gruppo di annunci SA360 della prima interazione dell'utente

  • firstUserSa360AdGroupName Nome del gruppo di annunci di SA360 della prima interazione dell'utente

  • firstUserSa360CampaignId ID campagna SA360 del primo utente

  • firstUserSa360CampaignName Campagna SA360 della prima interazione dell'utente

  • firstUserSa360CreativeFormat Formato della creatività SA360 del primo utente

  • firstUserSa360EngineAccountId ID account motore SA360 del primo utente

  • firstUserSa360EngineAccountName Nome account motore SA360 del primo utente

  • firstUserSa360EngineAccountType Tipo di account motore SA360 della prima interazione dell'utente

  • firstUserSa360KeywordText Testo della parola chiave SA360 del primo utente

  • firstUserSa360ManagerAccountId ID account amministratore SA360 della prima interazione dell'utente

  • firstUserSa360ManagerAccountName Nome dell'account amministratore SA360 del primo utente

  • firstUserSa360Medium Mezzo SA360 della prima interazione dell'utente

  • firstUserSa360Query Query SA360 del primo utente

  • firstUserSa360Source Sorgente SA360 del primo utente

  • firstUserSa360SourceMedium Sorgente / mezzo SA360 del primo utente

  • sa360AdGroupId ID gruppo di annunci SA360

  • sa360CampaignId ID campagna SA360

  • sa360AdGroupName Nome gruppo di annunci SA360

  • sa360CampaignName Campagna SA360

  • sa360CreativeFormat Formato della creatività SA360

  • sa360EngineAccountId ID account motore SA360

  • sa360EngineAccountName Nome account motore SA360

  • sa360EngineAccountType Tipo di account motore SA360

  • sa360KeywordText Testo della parola chiave SA360

  • sa360ManagerAccountId ID account amministratore SA360

  • sa360ManagerAccountName Nome dell'account amministratore SA360

  • sa360Medium Mezzo SA360

  • sa360Query Query SA360

  • sa360Source Sorgente SA360

  • sa360SourceMedium Sorgente / mezzo SA360

  • sessionSa360AdGroupId ID gruppo di annunci SA360 della sessione

  • sessionSa360CampaignId ID campagna SA360 della sessione

  • sessionSa360ManagerAccountId ID account amministratore SA360 della sessione

  • sessionSa360ManagerAccountName Nome dell'account amministratore SA360 della sessione

  • sessionSa360SourceMedium Sorgente / mezzo SA360 della sessione

06/03/2024 Supporto dei segmenti di pubblico di utenti non attivi nelle esportazioni dei segmenti di pubblico.

La funzionalità Esporta segmenti di pubblico supporta meglio l'esportazione dei segmenti di pubblico di utenti inattivi. Gli utenti entrano in questi segmenti di pubblico senza un evento idoneo. Ad esempio, un utente può entrare nel segmento di pubblico se non visita il tuo sito web per sette giorni. Esempi di segmenti di pubblico di utenti inattivi includono "Acquirenti non attivi negli ultimi 7 giorni", "Utenti non attivi negli ultimi 7 giorni" e "Utenti senza notifiche ricevute negli ultimi 7 giorni". Per saperne di più su questi segmenti di pubblico suggeriti, consulta Segmenti di pubblico suggeriti.

28-02-2024 Le esportazioni dei segmenti di pubblico restituiscono lo User-ID 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 dall'utente è attivata, questi dati, insieme allo User-ID, possono essere inviati a Google Analytics durante il tagging per migliorare la misurazione. Per saperne di più, consulta la sezione sulla raccolta dei dati forniti dall'utente.

30-01-2024 Supporto delle notifiche webhook per gli elenchi dei segmenti di pubblico ed elenchi dei segmenti di pubblico ricorrenti nell'API Data 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 di un elenco del segmento di pubblico ricorrente (utilizzando properties.recurringAudienceLists.create).

Questa funzionalità ti consente di ricevere notifiche Webhook in modo asincrono quando un elenco del segmento di pubblico diventa disponibile.

18/01/2024 Compatibilità migliorata per le dimensioni che includono la stringa di query o il componente minuto.

Le dimensioni che includono la stringa di query ora sono compatibili con la maggior parte dei campi. Dimensioni come pagePathPlusQueryString, unifiedPageScreen, pageLocation e fullPageUrl ora sono compatibili con molti altri campi, 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 lo strumento di esplorazione delle metriche e delle dimensioni di GA4.

13-12-2023 Parametri personalizzati basati sugli articoli

Ora le dimensioni personalizzate basate sugli articoli possono essere incluse nelle query dell'API di dati di Analytics utilizzando la seguente sintassi:

Nome API generico Descrizione
customItem:parameter_name Dimensione personalizzata basata sugli articoli per parameter_name

Per ulteriori informazioni, consulta la sezione Dimensioni e metriche dell'API.

05-12-2023 Gli elenchi di segmenti di pubblico sono disponibili nell'API di dati v1 beta come esportazioni di segmenti di pubblico

La funzionalità Elenchi dei segmenti di pubblico è stata rinominata Esportazione dei segmenti di pubblico ed è stata aggiunta all'API Data v1 beta.

Sono stati aggiunti i seguenti metodi all'API Data v1 beta:

28/11/2023 È stato aggiunto samplingMetadatas alla risposta al report

samplingMetadatas è stato aggiunto a ResponseMetaData. Questa raccolta conterrà un SampleMetadata per ogni intervallo di date nella richiesta per cui sono stati campionati i risultati. Google Analytics applicherà il campionamento solo quando prevede che i limiti di cardinalità ridurranno la qualità dei dati.

28/11/2023 È stata aggiunta la funzionalità di esportazione degli elenchi dei segmenti di pubblico ricorrenti all'API Data v1 alpha

Sono stati aggiunti i metodi properties.recurringAudienceLists.create, properties.recurringAudienceLists.create, properties.recurringAudienceLists.list all'API Data v1 alpha.

Questa funzionalità ti consente di generare elenchi di segmenti di pubblico ogni giorno man mano che le appartenenze ai segmenti di pubblico cambiano. Gli elenchi dei segmenti di pubblico ricorrenti ti consentono di lavorare con i risultati più recenti relativi all'appartenenza al segmento di pubblico.

08/11/2023 È stata aggiunta la funzionalità di esportazione dell'elenco del segmento di pubblico in Fogli all'API di dati v1 alpha

È stato aggiunto il metodo properties.audienceLists.exportSheet alla versione alpha 1 dell'API di dati, 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 durate dell'abbonamento di 1 giorno

I segmenti di pubblico con durate di appartenenza di 1 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 di report dell'API Data: 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 falso
ABC falso
AAA true

Dopo questa modifica, riceverai il seguente report:

deviceId isAdsPersonalizationAllowed
AAA true
ABC falso
ABC true
DAC falso

15/08/2023 È stata aggiunta la dimensione isLimitedAdTracking allo schema di esportazione degli elenchi dei segmenti di pubblico

  • isLimitedAdTracking L'impostazione della limitazione del monitoraggio degli annunci sul dispositivo. I valori possibili includono: true, false e (not set).

    Per scoprire di più, consulta la sezione Dimensioni degli elenchi del segmento di pubblico.

15-08-2023 È stata aggiunta la dimensione currencyCode e la metrica itemDiscountAmount

  • currencyCode Il codice 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 dal parametro elemento "discount".

Per saperne di più, consulta lo schema di reporting dell'API Data.

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 restituisce true. Se un utente non è idoneo alla personalizzazione degli annunci, isAdsPersonalizationAllowed restituisce false.

    Per scoprire di più, consulta la sezione Dimensioni degli elenchi del segmento di pubblico.

10-07-2023 Elenchi dei segmenti di pubblico

Il supporto degli elenchi dei segmenti di pubblico è stato aggiunto all'API Data v1alpha. Gli elenchi dei segmenti di pubblico includono uno snapshot degli utenti nel segmento di pubblico al momento della creazione dell'elenco.

I seguenti metodi sono stati aggiunti all'API Data v1 alpha:

19/05/2023 Gruppi di canali personalizzati

Il supporto dei gruppi di canali personalizzati è stato 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 riassegnato in modo da consentire un numero maggiore di query di generazione di report semplici, addebitando al contempo un numero molto maggiore di token di quota per i report con date di grandi dimensioni.

Dopo questa modifica, mentre l'addebito per alcune richieste rimarrà invariato, subirà un notevole aumento per le query più complesse. Ad esempio, le richieste di dati di più di 6 mesi possono comportare l'addebito di 1000 o più token quota.

Proprietà standard

Nome quota Vecchio limite Nuovo limite
Token principali per proprietà al giorno 25.000 200.000
Token core per proprietà all'ora 5000 40.000
Token core per progetto, per proprietà, per 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 Vecchio limite Nuovo limite
Token principali per proprietà al giorno 250.000 2.000.000
Token core per proprietà all'ora 50.000 400.000
Token core per progetto, per proprietà, per 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

02-03-2023 Sono state aggiunte le dimensioni relative alle date.

  • dayOfWeekName Nome del giorno della settimana. Il giorno della settimana in inglese. Questa dimensione ha valori Sunday, Monday e così via.

  • isoWeek settimana ISO dell'anno. Numero di settimana ISO, dove ogni settimana inizia di lunedì. Per maggiori dettagli, visita la pagina https://en.wikipedia.org/wiki/ISO_week_date. Alcuni valori di esempio sono 01, 02 e 53.

  • Anno ISO isoYear. L'anno ISO dell'evento. Per maggiori dettagli, visita la pagina https://en.wikipedia.org/wiki/ISO_week_date. Alcuni valori di esempio sono 2022 e 2023.

  • isoYearIsoWeek Settimana ISO dell'anno ISO. I valori combinati di isoWeek e isoYear. Alcuni valori di esempio sono 201652 e 201701.

  • yearMonth Mese dell'anno. I valori combinati di year e month. Alcuni valori di esempio sono 202212 o 202301.

  • yearWeek Settimana dell'anno. I valori combinati di year e week. Alcuni valori di esempio sono 202253 o 202301.

27/02/2023 Sono state aggiunte le dimensioni di e-commerce.

  • itemListPosition Posizione nell'elenco di articoli. La posizione di un articolo (ad es. un prodotto che vendi) in un elenco. Questa dimensione viene compilata nel tagging dal parametro "index" nell'array items.

  • itemLocationID ID posizione elemento. La sede fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare l'ID posizione Google corrispondente all'articolo associato. È possibile utilizzare anche un ID posizione personalizzato. Questo campo viene compilato nel tagging dal parametro "location_id" nell'array items.

  • itemPromotionCreativeSlot Area creatività per promozione articolo. Il nome dell'area della creatività promozionale associata all'articolo. Questa dimensione può essere specificata nel tagging tramite il parametro creative_slot a livello di evento o di articolo. Se il parametro è 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 è stata ritirata 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" e "Utenti che hanno eseguito scorrimento".

  • 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 con conversione di scorrimento. Il numero di utenti unici che hanno fatto scorrere verso il basso almeno il 90% della pagina.

23/01/2023 Sono state aggiunte le dimensioni "Continente" e "ID continente".

  • continent Continente. Il continente in cui ha avuto origine l'attività utente. Ad esempio, Americas o Asia

  • continentId ID continente. L'ID geografico del continente in cui ha avuto origine l'attività utente, dedotto 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 e spesso viene abbreviato in CPC.
  • advertiserAdCostPerConversion Costo per conversione. 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) è dato dalle entrate totali divise per il costo dell'annuncio dell'inserzionista.

17/10/2022 Sono state aggiunte le 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à pagate per un singolo articolo.
  • itemsClickedInList Articoli selezionati tramite clic nell'elenco. Il numero di unità selezionate tramite clic nell'elenco per un singolo articolo.
  • itemsClickedInPromotion Articoli selezionati tramite clic nella promozione. Il numero di unità su cui è stato fatto clic nella promozione per un singolo articolo.
  • itemsViewed Articoli 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 per un singolo articolo.

13-09-2022 Annuncio relativo alle modifiche alla compatibilità con Schema.

Il 1° dicembre 2022 verranno apportate le seguenti modifiche non compatibili:

  1. Le dimensioni basate sugli articoli come itemName stanno diventando incompatibili con le metriche basate sugli eventi come eventCount. Le dimensioni basate sugli articoli continueranno a essere compatibili con le metriche basate sugli articoli come itemRevenue, le metriche basate sugli utenti come activeUsers e le metriche basate sulla sessione come sessions.

  2. Le dimensioni di attribuzione come source stanno diventando incompatibili con alcune metriche basate sugli eventi come eventCount. Le dimensioni di attribuzione continueranno a essere compatibili con le metriche attribuibili come conversions, le metriche basate sugli utenti come activeUsers e le metriche basate sulle sessioni come sessions.

  3. Le dimensioni che includono la stringa di query, come pagePathPlusQueryString , saranno compatibili solo con un insieme limitato di dimensioni e metriche.

Per scoprire di più, consulta la spiegazione dettagliata delle modifiche alla compatibilità.

01-09-2022 Modifiche alla quota.

  • Le quote Requests per day , Requests Per Minute, Requests Per Minute Per User vengono rimosse dall'API Data.

  • La quota Tokens Per Project Per Property Per Hour è stata aggiunta all'API.

  • Ogni richiesta consuma quota sia per Tokens Per Property Per Hour sia per Tokens Per Project Per Property Per Hour.

    Per informazioni dettagliate sulle nuove quote, consulta la documentazione sulle quote.

03-08-2022 Sono state aggiunte le dimensioni SA360 basate sulla sessione.

  • sessionSa360AdGroupName Nome 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 di 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 dell'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 di Search Ads 360 che ha generato questa sessione. Ad esempio, "example.com" o "google".

  • Le dimensioni sessionCampaignId e sessionCampaignName ora supportano le campagne Search Ads 360.

11/07/2022 Sono state aggiunte le metriche sul 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 uno specifico evento di conversione.

  • userConversionRate:event_name La percentuale di utenti che hanno attivato uno specifico evento di conversione.

05-05-2022 È stata aggiunta la funzionalità di generazione di report sulle canalizzazioni al canale alpha.

16/02/2022 Sono state aggiunte nuove dimensioni.

Termini e contenuti manuali

  • firstUserManualAdContent Contenuto dell'annuncio manuale della prima interazione dell'utente. Il contenuto dell'annuncio con cui l'utente è stato acquisito per la prima volta. Completato dal parametro utm_content.

  • firstUserManualTerm Termine manuale della prima interazione dell'utente. Il termine che ha acquisito per la prima volta l'utente. Completato dal parametro utm_term.

  • manualAdContent Contenuto dell'annuncio manuale. I contenuti dell'annuncio attribuiti all'evento di conversione. Completato dal parametro utm_content.

  • manualTerm Termine manuale. Il termine attribuito all'evento di conversione. Completato dal parametro utm_term.

  • sessionManualAdContent Contenuto dell'annuncio manuale della sessione. Il contenuto dell'annuncio che ha generato una sessione. Completato dal parametro utm_content.

  • sessionManualTerm Termine manuale della sessione. Il termine che ha generato una sessione. Completato dal parametro utm_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

  • averagePurchaseRevenuePerUserEntrate 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 con cui l'utente è stato acquisito per la prima volta.

  • googleAdsCampaignType Il tipo di campagna Google Ads attribuito all'evento di conversione.

  • sessionGoogleAdsCampaignType Il tipo di campagna Google Ads che ha generato questa sessione.

07-09-2021 Sono state aggiunte nuove dimensioni Data/ora.

  • dateHourMinute I valori combinati di data, ora e minuti nel formato AAAAMMGGHHMM.

  • minute Il minuto a due cifre dell'ora in cui è stato registrato l'evento.

  • nthMinute Il numero di minuti dall'inizio dell'intervallo di date.

07-09-2021 Sono state aggiunte nuove dimensioni completate dai parametri evento.

  • achievementId L'ID dell'obiettivo in un gioco per un evento.

  • character Il personaggio di un giocatore in un gioco per un evento.

  • fileExtension L'estensione del file scaricato.

  • fileName Il percorso pagina del file scaricato.

  • groupId L'ID del gruppo di giocatori in un gioco per un evento.

  • linkClasses L'attributo HTML class per un link in uscita.

  • linkDomain Il dominio di destinazione del link in uscita.

  • linkId L'attributo HTML id 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 il link in uscita o il download di un file.

  • method Il metodo tramite il quale un evento è stato attivato.

  • outbound Restituisce "true" se il link rimanda a un sito che non fa parte del dominio della proprietà.

  • pageLocation Il protocollo, il nome host, il percorso pagina e la stringa di query per le pagine web visitate.

  • pageReferrer L'URL di riferimento completo, inclusi il nome host e il 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 i contenuti sono visibili.

  • unifiedPagePathScreen Il percorso pagina (web) o la classe schermata (app) su cui è stato registrato l'evento.

07-09-2021 Modifiche allo schema dell'API.

Modifiche alle dimensioni esistenti:

  • unifiedPageScreen Per gli eventi generati sul web, ora questa dimensione restituisce il percorso pagina e la stringa di query su cui è stato registrato l'evento.

Annuncio relativo alle modifiche imminenti:

  • firstUserTrafficOrigin L'origine del traffico che ha acquisito per prima l'utente. Non fare affidamento sul fatto che questo campo restituisca "Manuale" per il traffico che utilizza gli UTM. In seguito al lancio imminente di una funzionalità, questo campo passerà dal restituire "Manuale" a restituire "(not set)".

  • sessionTrafficOrigin L'origine del traffico della campagna della sessione. Non fare affidamento sul fatto che questo campo restituisca "Manuale" per il traffico che utilizza gli UTM. In seguito al lancio imminente di una funzionalità, questo campo passerà dal restituire "Manuale" a restituire "(not set)".

  • 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 gli UTM. In seguito al lancio imminente di una funzionalità, questo campo passerà dal restituire "Manuale" a restituire "(not set)".

07-09-2021 Metodo checkCompatibility aggiunto all'API.

Il metodo checkCompatibility elenca le dimensioni e le metriche che possono essere aggiunte a una richiesta di report e mantenere la compatibilità.

21/07/2021 Modifiche ai report in tempo reale.

Ora è possibile specificare gli intervalli di minuti dei 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 per il primo utente.

  • defaultChannelGrouping Raggruppamento dei canali predefinito.

10-06-2021 Modifiche allo schema dell'API.

  • La dimensione minutesAgo aggiunta allo schema in tempo reale dell'API di dati può essere utilizzata nelle query al metodo runRealtimeReport. Questa dimensione contiene il numero di minuti fa in cui è stato raccolto un evento. 00 indica il minuto corrente e 01 il minuto precedente.

  • Dimensione googleAdsCreativeId aggiunta allo schema dell'API Data. Questa dimensione contiene l'ID della creatività Google Ads attribuita all'evento di conversione.

  • Dimensione sessionGoogleAdsCreativeId aggiunta allo schema dell'API Data. Questa dimensione contiene l'ID della creatività Google Ads che ha generato una sessione sul tuo sito web o nella tua app.

  • La dimensione firstUserCreativeId è stata rinominata in firstUserGoogleAdsCreativeId nello schema dell'API di dati. Questa dimensione contiene l'ID della creatività Google Ads che ha acquisito per la prima volta l'utente.

09/04/2021 È stata rilasciata la versione beta dell'API di dati di Google Analytics v1.

  • L'endpoint API è stato aggiornato a https://analyticsdata.googleapis.com/v1beta.

  • I metodi runReport, runPivotReport, batchRunReports, batchRunPivotReports ora accettano l'ID di una proprietà Google Analytics 4 nel parametro property del percorso dell'URL anziché nel campo entity del corpo della richiesta:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • Le librerie client API sono state aggiornate per utilizzare il nuovo endpoint API.

19/02/2021 Modifiche alla paginazione.

  • Le dimensioni predefinite della risposta del report sono aumentate da 10 a 10.000 righe di dati sui eventi.

  • Il valore "limit" : -1 utilizzato per indicare un tentativo di recupero di tutte le righe non è più supportato in RunReportRequest.

  • Il valore massimo del campo limit è impostato su 100000. Utilizza la paginazione per recuperare i report contenenti più di 100.000 righe.

08/02/2021 Nuove dimensioni e metriche di e-commerce.

Al schema dell'API sono state aggiunte nuove dimensioni e metriche di e-commerce:

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.

08/02/2021 Sono state aggiunte nuove dimensioni delle campagne.

Nel schema dell'API sono state aggiunte nuove dimensioni della campagna: campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

08-02-2021 Modifiche alle dimensioni dayOfWeek e week.

  • Il valore della dimensione dayOfWeek ora inizia con 0 anziché con 1.

  • Il valore della dimensione week ora inizia con 01 e restituisce un numero di due cifre da 01 a 53. Ogni settimana inizia di domenica. Il 1° gennaio è sempre la 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 di metriche 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 dell'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 quota della proprietà per ora e per 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 di report in tempo reale.

Consulta la sezione Creare un report in tempo reale per gli esempi e consulta runRealtimeReport per la documentazione di riferimento REST.

19-10-2020 Elementi della libreria client aggiornati.

Elementi della libreria client aggiornati insieme alle istruzioni di utilizzo e agli esempi di codice.

13/10/2020 Le proprietà App + Web sono state rinominate in Google Analytics 4 (GA4).

08-10-2020 Metodo getMetadata aggiunto all'API.

Il metodo getMetadata restituisce le dimensioni personalizzate e le metriche disponibili per l'ID proprietà GA4 specificato, nonché i metadati universali.

08-10-2020 Le dimensioni e le metriche personalizzate sono disponibili nei report.

Consulta la documentazione dello schema dell'API per informazioni sulle dimensioni e sulle metriche personalizzate. Questo aggiornamento include le dimensioni e le metriche personalizzate basate sugli eventi, nonché le dimensioni personalizzate basate sugli utenti.