Log delle modifiche all'API Core Reporting di Google Analytics

Aggiorniamo periodicamente l'API di reporting principale di Google Analytics per offrire nuove funzionalità e correggere i difetti rilevati nelle versioni precedenti. Nella maggior parte dei casi, queste modifiche saranno trasparenti per gli sviluppatori di API. Tuttavia, a volte dobbiamo apportare modifiche che richiedono agli sviluppatori di modificare le loro applicazioni esistenti.

Questa pagina documenta le eventuali modifiche apportate all'API Core Reporting di Google Analytics che potrebbero influire sull'applicazione. Consigliamo agli sviluppatori di API di controllare periodicamente questo elenco per verificare la presenza di nuovi annunci. Puoi anche iscriverti alle modifiche tramite i feed elencati nella sezione Iscriviti di seguito.

Iscriviti ai log delle modifiche correlati

Include tutte le API di raccolta, configurazione e generazione di report.

Include l'API di reporting principale, l'API di reporting delle canalizzazioni multicanale e l'API di reporting in tempo reale.

Questa è la versione iniziale dell'API User Activity

  • L'API User Activity ti consente di recuperare tutti i dati associati a un singolo ID client o User-ID in un determinato intervallo di date. È destinata principalmente a supportare i proprietari di proprietà che vogliono fornire l'accesso automatico ai dati di un utente direttamente a questo utente. Per ulteriori dettagli, consulta la Guida all'API User Activity.

Questa release aumenta il numero massimo di righe restituito nell'insieme di risultati della versione 4 dell'API di reporting di Analytics.

Il numero massimo di righe restituite nell'oggetto ReportData dell'API di reporting di Analytics v4 viene aumentato da 10.000 a 100.000.

Questa release aggiunge un'anteprima del sistema delle quote basate sulle risorse per la versione 4 dell'API di reporting di Google Analytics, che consente di utilizzare soglie di campionamento più elevate per i clienti di Analytics 360 (Premium).

In questa release la funzionalità Prodotti correlati e le dimensioni e le metriche associate verranno ritirate; per l'elenco completo delle definizioni, consulta la sezione Riferimento dimensioni e metriche. Per informazioni dettagliate sulla rimozione dei dati, consulta le norme sul ritiro dei dati:

In questa release sono ritirate le seguenti dimensioni e metriche:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

Questa versione aggiunge una nuova dimensione all'API. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche. In questa release vengono rimosse anche diverse dimensioni e metriche obsolete. Per comprendere la procedura completa per la rimozione dei dati, consulta le Norme sul ritiro dei dati per le API di Google Analytics.

Ora

  • Nuova dimensione ga:dateHourMinute, che combina ga:date, ga:hour e ga:minute.

Rimozione dei dati

In questa release vengono rimosse le seguenti dimensioni e metriche deprecate:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

Questa release aggiorna le metriche e le dimensioni esistenti nell'API. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Metriche utente

Il calcolo delle metriche Utenti e Utenti attivi è stato aggiornato per conteggiare gli utenti in modo più efficiente. Potresti notare una piccola variazione nelle tue metriche. Per saperne di più, consulta l'articolo Modalità di identificazione degli utenti per le metriche utente.

Metriche utente interessate dall'aggiornamento del calcolo:

  • ga:users: il numero totale di utenti per il periodo di tempo richiesto.
  • ga:1dayusers: numero totale di utenti attivi in 1 giorno per ogni giorno nel periodo di tempo richiesto.
  • ga:7dayusers: numero totale di utenti attivi in 7 giorni per ogni giorno nel periodo di tempo richiesto.
  • ga:14dayusers: numero totale di utenti attivi in 14 giorni per ogni giorno nel periodo di tempo richiesto.
  • ga:30dayusers: numero totale di utenti attivi per 30 giorni per ogni giorno nel periodo di tempo richiesto.

Eventi unici

Il periodo di deprecazione per ga:uniqueEvents si sta avvicinando. Dopo il 26 marzo 2017, la definizione di ga:uniqueEvents verrà aggiornata e la metrica ga:uniqueEventsTemporary privata verrà rimossa dall'API. Per ulteriori informazioni, consulta la documentazione relativa agli eventi unici.

Questa versione aggiunge una nuova dimensione all'API, migliora i messaggi di errore e inizia ad applicare le modifiche annunciate in precedenza per le dimensioni e le metriche AdSense.

Dimensioni utente

  • Dimensione - ga:userBucket: per ogni utente, la dimensione Bucket utente (valori da 1 a 100) indica il bucket a cui è stato assegnato l'utente. Per ulteriori dettagli, consulta l'articolo Testare le campagne di remarketing.

Messaggi di errore

Se in precedenza l'API restituisceva un messaggio di errore errato (Unknown dimension(s): o Unknown metric(s):) quando richiedeva dati con condizioni che non sono state soddisfatte, ora l'API restituisce il messaggio: Restricted metric(s): ... can only be queried under certain conditions.

Dimensioni e metriche di AdSense

Alle viste non collegate ad AdSense verrà impedito di eseguire query per le dimensioni e le metriche di AdSense. L'esecuzione di query su queste dimensioni e metriche con viste non collegate ad AdSense comporterà un errore.

Questa è una versione per la correzione di bug, che corregge un problema con le dimensioni e le metriche AdSense e annuncia un'imminente modifica a queste dimensioni e metriche.

Dimensioni e metriche di AdSense

Questa versione corregge un problema iniziato il 7/1/2017 per cui, eseguendo query per dimensioni e metriche di AdSense, veniva restituito l'errore "Metrica sconosciuta" per le visualizzazioni non collegate ad AdSense.

Modifiche imminenti

A partire dal 31/1/2017, le visualizzazioni non collegate ad AdSense non potranno più eseguire query per le dimensioni e le metriche di AdSense. L'esecuzione di query su queste dimensioni e metriche con viste non collegate ad AdSense comporterà un errore.

In questa release viene aggiunta la nuova metrica seguente all'API. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Metriche calcolate

In questa release è stato aggiunto il supporto per le metriche calcolate.

  • Metrica - ga:calcMetric_: il valore della metrica calcolata richiesta, in cui si riferisce al nome definito dall'utente della metrica calcolata. Tieni presente che il tipo di dati ga:calcMetric_ può essere FLOAT, INTEGER, CURRENCY, TIME o PERCENT. Per maggiori dettagli, vedi Informazioni sulle metriche calcolate.

In questa release è stata aggiunta una nuova metrica all'API. Inoltre, ritira una metrica esistente. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Monitoraggio eventi

La definizione di ga:uniqueEvents cambierà per riflettere in modo più accurato il numero di eventi unici. Per influire su questa modifica, ritireremo tecnicamente l'attuale metrica ga:uniqueEvents in conformità con le nostre norme sul ritiro dei dati. Se vuoi provare la nuova definizione, puoi fare riferimento alla metrica privata ga:uniqueEventsTemporary, che calcola in modo più preciso il numero di eventi unici. Introdurremo anche una nuova metrica ga:uniqueDimensionCombinations che manterrà l'attuale definizione di ga:uniqueEvents. Una volta trascorso il periodo di deprecazione appropriato (circa 6 mesi), la metrica privata ga:uniqueEventsTemporary verrà rimossa e la metrica originale ga:uniqueEvents rappresenterà correttamente il numero di eventi unici. Per ulteriori informazioni, consulta i documenti della guida relativi agli eventi unici.

Eventi unici

  • Metrica - ga:uniqueEvents - La definizione di ga:uniqueEvents cambierà a breve per riflettere in modo più accurato il numero di eventi unici. Utilizza invece ga:uniqueDimensionCombinations se vuoi mantenere la definizione esistente. Per ulteriori informazioni, consulta la documentazione relativa agli eventi unici.
  • Metrica - ga:uniqueDimensionCombinations - Combinazioni di dimensioni uniche conteggia il numero di combinazioni uniche di valori di dimensione per ogni dimensione in un report. Questo consente la post-elaborazione di dimensioni combinate (concatenate) e permette di creare report in modo più flessibile, senza dover aggiornare l'implementazione del monitoraggio o utilizzare aree di dimensione personalizzata aggiuntive. Per ulteriori informazioni, consulta la documentazione relativa agli eventi unici.

Test della transizione - Privato

  • Metrica - ga:uniqueEventsTemporary: il numero di eventi unici; questa sarà la nuova definizione per ga:uniqueEvents. Puoi utilizzare questa metrica per comprendere la nuova definizione prima della modifica. Tieni presente che questa metrica è privata e non verrà visualizzata nel Riferimento dimensioni e metriche.

In questa versione vengono aggiunte nuove dimensioni e metriche all'API. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

DoubleClick Bid Manager

  • Dimensione - ga:dbmClickAdvertiser - Il nome dell'inserzionista DBM del clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmClickAdvertiserId - L'ID inserzionista DBM del clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmClickCreativeId - L'ID creatività DBM del clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmClickExchange: il nome della piattaforma di scambio DBM del clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmClickExchangeId - L'ID della piattaforma di scambio DBM del clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmClickInsertionOrder - Il nome dell'ordine di inserzione DBM del clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmClickInsertionOrderId: l'ID ordine di inserzione DBM del clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmClickLineItem: il nome dell'elemento pubblicitario DBM del clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmClickLineItemId: l'ID elemento pubblicitario DBM del clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmClickSite - Nome del sito DBM in cui è stata mostrata e selezionata la creatività DBM per il clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360 richiede l'integrazione con DBM).
  • Dimensione - ga:dbmClickSiteId: l'ID sito DBM in cui è stata mostrata e selezionata la creatività DBM per il clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmLastEventAdvertiser: nome dell'inserzionista DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale di DBM) associato alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmLastEventAdvertiserId: ID inserzionista DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale di DBM) associato alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmLastEventCreativeId: ID creatività DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale di DBM) associato alla sessione di Google Analytics (solo Analytics 360; richiede l'integrazione con DBM).
  • Dimensione - ga:dbmLastEventExchange - Nome della piattaforma di scambio DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale di DBM) associato alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmLastEventExchangeId: ID piattaforma di scambio DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale di DBM) associato alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmLastEventInsertionOrder - Nome dell'ordine di inserzione DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale di DBM) associato alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmLastEventInsertionOrderId: ID ordine di inserzione DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale di DBM) associato alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmLastEventLineItem: nome dell'elemento pubblicitario DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale di DBM) associato alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmLastEventLineItemId: ID elemento pubblicitario DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale di DBM) associato alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmLastEventSite - Nome del sito DBM in cui è stata mostrata e selezionata la creatività DBM per l'ultimo evento DBM (impressione o clic nella finestra temporale di DBM) associato alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dbmLastEventSiteId: ID sito DBM in cui è stata mostrata e selezionata la creatività DBM per l'ultimo evento DBM (impressione o clic nella finestra temporale di DBM) associato alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
  • Metrica - ga:dbmCPA - eCPA entrate DBM (solo Analytics 360, richiede l'integrazione con DBM).
  • Metrica - ga:dbmCPC - CPCO entrate DBM (solo Analytics 360, richiede l'integrazione con DBM).
  • Metrica - ga:dbmCPM - eCPM entrate DBM (solo Analytics 360, richiede l'integrazione con DBM).
  • Metrica - ga:dbmCTR - CTR DBM (solo Analytics 360, richiede l'integrazione con DBM).
  • Metrica - ga:dbmClicks - Clic totali DBM (solo Analytics 360, richiede l'integrazione con DBM).
  • Metrica - ga:dbmConversions - Conversioni totali DBM (solo Analytics 360, richiede l'integrazione con DBM).
  • Metrica - ga:dbmCost - Costo DBM (solo Analytics 360, richiede l'integrazione con DBM).
  • Metrica - ga:dbmImpressions - Impressioni totali DBM (solo Analytics 360, richiede l'integrazione con DBM).
  • Metrica - ga:dbmROAS - ROAS DBM (solo Analytics 360, richiede l'integrazione con DBM).
  • Dimensione - ga:dsAdGroup - Gruppo di annunci DS (solo Analytics 360, richiede l'integrazione con DS).
  • Dimensione - ga:dsAdGroupId - ID gruppo di annunci DS (solo Analytics 360, richiede l'integrazione con DS).
  • Dimensione - ga:dsAdvertiser - Inserzionista DS (solo Analytics 360, richiede l'integrazione con DS).
  • Dimensione - ga:dsAdvertiserId - ID inserzionista DS (solo Analytics 360, richiede l'integrazione con DS).
  • Dimensione - ga:dsAgency - Agenzia DS (solo Analytics 360, richiede l'integrazione con DS).
  • Dimensione - ga:dsAgencyId - ID agenzia DS (solo Analytics 360, richiede l'integrazione con DS).
  • Dimensione - ga:dsCampaign - Campagna DS (solo Analytics 360, richiede l'integrazione con DS).
  • Dimensione - ga:dsCampaignId - ID campagna DS (solo Analytics 360, richiede l'integrazione con DS).
  • Dimensione - ga:dsEngineAccount - Account motore DS (solo Analytics 360, richiede l'integrazione con DS).
  • Dimensione - ga:dsEngineAccountId - ID account motore DS (solo Analytics 360, richiede l'integrazione con DS).
  • Dimensione - ga:dsKeyword - Parola chiave DS (solo Analytics 360, richiede l'integrazione con DS).
  • Dimensione - ga:dsKeywordId - ID parola chiave DS (solo Analytics 360, richiede l'integrazione con DS).
  • ga:dsCPC - Costo DS per inserzionista per clic (solo Analytics 360, richiede l'integrazione con DS).
  • ga:dsCTR: percentuale di clic DS (solo Analytics 360, richiede l'integrazione con DS).
  • ga:dsClicks: clic DS (solo Analytics 360, richiede l'integrazione con DS).
  • ga:dsCost: costo DS (solo Analytics 360, richiede l'integrazione con DS).
  • ga:dsImpressions: impressioni DS (solo Analytics 360, richiede l'integrazione con DS).
  • ga:dsProfit - DS Profie (solo Analytics 360, richiede l'integrazione con DS).
  • ga:dsReturnOnAdSpend - Ritorno sulla spesa pubblicitaria di DS (solo Analytics 360, richiede l'integrazione con DS).
  • ga:dsRevenuePerClick - Entrate per clic DS (solo Analytics 360, richiede l'integrazione con DS).

Questa versione aggiunge una nuova dimensione all'API. Questa release aggiunge anche alcune limitazioni alla combinazione di dimensioni che è possibile eseguire query insieme. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Rete geografica

  • Dimensione - ga:continentId: l'ID del continente degli utenti, derivato dagli indirizzi IP o dagli ID geografici degli utenti.

Restrizioni

Non è possibile eseguire query sulle seguenti dimensioni nei seguenti gruppi:

  • Visita il gruppo di informazioni su Shopping
    • ga:checkoutOptions
    • ga:shoppingStage
  • Gruppo di esperimenti GWO
    • ga:experimentVariant
    • ga:experimentId
  • Gruppo di interesse
    • ga:interestOtherCategory
  • Gruppo di interesse in-market
    • ga:interestInMarketCategory
  • Gruppo di promozione interno:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • Gruppo di interesse per il branding:
    • ga:interestAffinityCategory

Questa release introduce nuovi limiti e quote. Per ulteriori dettagli, consulta la documentazione su Limiti e quote.

Segnalazione di errori

Questa release inizia ad applicare limiti per le richieste di reporting non riuscite (5XX).

  • 10 richieste non riuscite per progetto per profilo all'ora.
  • 50 richieste non riuscite al giorno per progetto per profilo.

Limiti di pivot

Questa release inizia ad applicare limiti alle richieste pivot:

  • Una richiesta di report può ora avere un massimo di 2 pivot.
  • Un pivot può avere un massimo di 4 dimensioni.
  • Le dimensioni pivot fanno parte della limitazione sul numero totale di dimensioni consentite nella richiesta.
  • Le metrics pivot fanno parte della limitazione al numero totale di metriche consentite nella richiesta.

In questa versione vengono aggiunte nuove dimensioni e metriche all'API. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Rete geografica

  • Dimensione - ga:metroId: il codice a tre cifre della Designated Market Area (DMA) da cui è arrivato il traffico, recuperato dagli indirizzi IP o dagli ID geografici degli utenti.

DoubleClick for Publishers

  • Metrica - ga:dfpImpressions: viene registrata un'impressione dell'annuncio DFP ogni volta che sul sito web viene visualizzato un singolo annuncio. Ad esempio, se una pagina con due unità pubblicitarie viene visualizzata una volta, vengono mostrate due impressioni (collegamento DFP attivato e Nascondi entrate DFP non attivate)."
  • Metrica - ga:dfpCoverage - La copertura indica la percentuale di richieste di annunci per le quali è stato generato almeno un annuncio. In genere, la copertura consente di identificare i siti nei quali l'account DFP non è in grado di fornire annunci mirati. (Impressioni dell'annuncio / Richieste di annunci totali) * 100 (Collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica - ga:dfpMonetizedPageviews: misura il numero totale di visualizzazioni di pagina sulla proprietà visualizzate con un annuncio dall'account DFP collegato. Tieni presente che una singola pagina può avere più unità pubblicitarie (collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica - ga:dfpImpressionsPerSession - Il rapporto tra le impressioni dell'annuncio DFP e le sessioni di Analytics (Impressioni dell'annuncio / Sessioni di Analytics) (collegamento DFP attivato e Nascondi entrate DFP non attivate)."
  • Metrica - ga:dfpViewableImpressionsPercent - La percentuale di impressioni dell'annuncio visibili. Un'impressione viene considerata visibile quando viene visualizzata nei browser degli utenti e ha la possibilità di essere visualizzata (collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica: ga:dfpClicks: il numero di volte in cui è stato fatto clic sugli annunci DFP sul sito (collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica - ga:dfpCTR: la percentuale di visualizzazioni di pagina che ha generato un clic su un annuncio DFP (collegamento DFP attivato e Nascondi entrate DFP non attivate)."
  • Metrica - ga:dfpRevenue - Le entrate DFP sono una stima delle entrate pubblicitarie totali in base alle impressioni pubblicate (collegamento DFP attivato e Nascondi entrate DFP non attivate)."
  • Metrica - ga:dfpRevenuePer1000Sessions: le entrate totali stimate provenienti dagli annunci DFP ogni 1000 sessioni di Analytics. Tieni presente che questa metrica si basa sulle sessioni sul sito, non sulle impressioni dell'annuncio (collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica - ga:dfpECPM - Il costo effettivo per mille visualizzazioni di pagina. Si tratta delle entrate DFP per 1000 visualizzazioni di pagina (collegamento DFP attivato e Nascondi entrate DFP non attivato)."
  • Metrica - ga:backfillImpressions - Impressioni di backfill è la somma di tutte le impressioni degli annunci AdSense o Ad Exchance pubblicate come backfill tramite DFP. Viene registrata un'impressione dell'annuncio ogni volta che sul sito web viene visualizzato un singolo annuncio. Ad esempio, se una pagina con due unità pubblicitarie viene visualizzata una volta, vengono mostrate due impressioni (collegamento DFP attivato e Nascondi entrate DFP non attivate)."
  • Metrica - ga:backfillCoverage: la copertura di backfill è la percentuale di richieste di annunci backfill che hanno generato la visualizzazione di almeno un annuncio. In genere, la copertura consente di identificare i siti nei quali l'account publisher non è in grado di fornire annunci mirati. (Impressioni dell'annuncio/Totale richieste di annunci) * 100. Se sia AdSense sia Ad Exchange forniscono annunci di backfill, questa metrica è la media ponderata dei due account backfill (collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica - ga:backfillMonetizedPageviews: misura il numero totale di visualizzazioni di pagina sulla proprietà visualizzate con almeno un annuncio degli account backfill collegati. Tieni presente che una singola visualizzazione di pagina monetizzata può includere più impressioni dell'annuncio (collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica - ga:backfillImpressionsPerSession: il rapporto tra le impressioni dell'annuncio di backfill e le sessioni di Analytics (impressioni dell'annuncio / sessioni di Analytics). Se sia AdSense sia Ad Exchange forniscono annunci di backfill, questa metrica è la somma dei due account backfill (collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica - ga:backfillViewableImpressionsPercent: la percentuale di impressioni dell'annuncio backfill visibili. Un'impressione viene considerata visibile quando è stata visualizzata nei browser degli utenti e ha avuto l'opportunità di essere vista. Se AdSense e Ad Exchange forniscono entrambi annunci backfill, questa metrica è la media ponderata dei due account backfill (collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica: ga:backfillClicks: il numero di volte in cui è stato fatto clic sugli annunci backfill sul sito. Se AdSense e Ad Exchange forniscono entrambi annunci backfill, questa metrica è la somma dei due account backfill (collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica: ga:backfillCTR: la percentuale di impressioni backfill che ha generato un clic su un annuncio. Se AdSense e Ad Exchange forniscono entrambi annunci backfill, questa metrica è la media ponderata dei due account backfill (collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica - ga:backfillRevenue: le entrate totali stimate provenienti dagli annunci backfill. Se AdSense e Ad Exchange forniscono entrambi annunci backfill, questa metrica è la somma dei due account backfill (collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica - ga:backfillRevenuePer1000Sessions: le entrate totali stimate provenienti dagli annunci di backfill per 1000 sessioni di Analytics. Tieni presente che questa metrica si basa sulle sessioni sul sito e non sulle impressioni dell'annuncio. Se sia AdSense sia Ad Exchange forniscono annunci di backfill, questa metrica è la somma dei due account backfill (collegamento DFP attivato e Nascondi entrate DFP non attivati)."
  • Metrica - ga:backfillECPM - Il costo effettivo per mille visualizzazioni di pagina. Si tratta delle entrate di backfill in DFP per 1000 visualizzazioni di pagina. Se sia AdSense sia Ad Exchange forniscono annunci di backfill, questa metrica è la somma dei due account backfill (collegamento DFP attivato e Nascondi entrate DFP non attivati)."

Si tratta di una release per la correzione di bug che corregge un problema relativo ai segmenti e al campionamento.

Segmenti

In questa release è stato corretto un problema che causava la sottostima di un sottoinsieme di richieste con il segmento Tutti gli utenti (gaid::-1) nella API di reporting principale V3 e la suddivisione in due segmenti nell'API di reporting di Analytics V4.

Sampling

In questa release è stato corretto un problema per cui un sottoinsieme di richieste da tabelle personalizzate restituirebbe dati campionati.

Si tratta di una release per la correzione di bug che corregge un problema relativo all'invio di richieste relative alla coorte V4 dell'API di reporting di Analytics.

Richieste di coorte

Le richieste di coorte possono ora chiedere tutte le dimensioni della coorte; in precedenza, l'API restituisceva un errore durante la richiesta di ga:acquisition... dimensioni.

LTV richieste di lifetime value

Tieni presente che le richieste di lifetime value possono generare report sul lifetime value solo per le viste di app.

Questa release annuncia una nuova versione dell'API, l'API di reporting di Analytics V4. Questa nuova API è il metodo programmatico più avanzato per accedere ai dati dei report in Google Analytics.

Funzionalità principali

Google Analytics si basa su una potente infrastruttura per la generazione di report sui dati. L'API offre agli sviluppatori l'accesso alla potenza della piattaforma Google Analytics. Ecco alcune funzionalità chiave dell'API di reporting di Analytics V4:

  • Espressioni metriche - L'API consente di richiedere non solo le metriche integrate, ma anche le espressioni di metriche matematiche. Ad esempio, i completamenti obiettivo per numero di sessioni possono essere espressi nella richiesta come ga:goal1completions/ga:sessions.
  • Più intervalli di date: supporto per richiedere due intervalli di date, in modo da poter confrontare i dati di due periodi in una singola richiesta.
  • Coorti e lifetime value: l'API dispone di un ricco vocabolario per richiedere report di coorti e lifetime value.
  • Più segmenti: ora puoi richiedere più segmenti in una singola richiesta.

Per iniziare

Per tutti i dettagli su come iniziare a utilizzare l'API, consulta la documentazione per gli sviluppatori.

Criteri per le quote

L'API di reporting di Analytics V4 è dotata di quote e limiti propri; poiché si tratta di una nuova API, questi limiti e quote sono soggetti a modifica.

Migrazione

Oltre alla guida alla migrazione, mettiamo a disposizione anche una libreria per la compatibilità di Python su GitHub.

Dimensioni e metriche

Questa versione aggiunge anche un insieme di dimensioni e metriche specifiche per la versione 4 dell'API di reporting di Analytics. Consulta Esplorazione dimensioni ed esplora metriche per le definizioni complete dell'elenco.

  • Dimensione - ga:cohort: nome della coorte a cui appartiene un utente in base alla definizione delle coorti. A seconda di come vengono definite le coorti, un utente può appartenere a più coorti, in modo simile a come un utente può appartenere a più segmenti.

  • Dimensione - ga:cohortNthDay: offset di 0 giorni in base alla data di definizione della coorte. Ad esempio, se una coorte è definita con la data della prima visita come 2015-09-01, per la data 04-09-2015, ga:cohortNthDay sarà 3.

  • ga:cohortNthMonth: offset mese su base 0 rispetto alla data di definizione della coorte.

  • Dimensione - ga:cohortNthWeek - Differenza di settimana in base a 0 rispetto alla data di definizione della coorte.

  • Dimensione - ga:acquisitionTrafficChannel: canale di traffico attraverso il quale l'utente è stato acquisito. Viene estratto dalla prima sessione dell'utente. Il canale di traffico viene calcolato in base alle regole di raggruppamento dei canali predefinite (a livello di vista, se disponibili) al momento dell'acquisizione degli utenti.

  • Dimensione - ga:acquisitionSource. La sorgente con cui l'utente è stato acquisito. Deriva dalla prima sessione dell'utente.

  • Dimensione - ga:acquisitionMedium: il mezzo attraverso il quale l'utente è stato acquisito. Deriva dalla prima sessione dell'utente.

  • Dimensione - ga:acquisitionSourceMedium. Il valore combinato di ga:userAcquisitionSource e ga:AcquisitionMedium.

  • Dimensione: ga:acquisitionCampaign la campagna con cui l'utente è stato acquisito. Deriva dalla prima sessione dell'utente.

  • Metrica - ga:cohortActiveUsers - Questa metrica è pertinente nel contesto delle dimensioni di offset in base a 0 (ga:cohortNthDay, ga:cohortNthWeek o ga:cohortNthMonth). Indica il numero di utenti della coorte attivi nell'intervallo di tempo corrispondente all'n° giorno/settimana/mese della coorte. Ad esempio, per ga:cohortNthWeek = 1, il numero di utenti (nella coorte) attivi nella seconda settimana. Se una richiesta non contiene ga:cohortNthDay, ga:cohortNthWeek o ga:cohortNthMonth, questa metrica avrà lo stesso valore di ga:cohortTotalUsers.

  • Metrica: ga:cohortTotalUsers: numero di utenti appartenenti alla coorte, noto anche come dimensione coorte.

  • Metrica - ga:cohortAppviewsPerUser - Visualizzazioni di app per utente per una coorte.

  • Metrica - ga:cohortGoalCompletionsPerUser - Completamenti obiettivo per utente per una coorte.

  • Metrica - ga:cohortPageviewsPerUser - Visualizzazioni di pagina per utente per una coorte.

  • Metrica - ga:cohortRetentionRate - Tasso di fidelizzazione coorte.

  • Metrica - ga:cohortRevenuePerUser - Entrate per utente per una coorte.

  • Metrica - ga:cohortVisitDurationPerUser - Durata della sessione per utente per una coorte.

  • Metrica - ga:cohortSessionsPerUser - Sessioni per utente per una coorte.

  • Metrica - ga:cohortTotalUsersWithLifetimeCriteria. È pertinente nel contesto di una richiesta con le dimensioni ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium o ga:acquisitionCampaign. Rappresenta il numero di utenti nelle coorti che vengono acquisiti tramite il canale, la sorgente, il mezzo o la campagna correnti. Ad esempio, per ga:acquisitionTrafficChannel=Direct rappresenta il numero di utenti della coorte, che sono stati acquisiti direttamente. Se non è presente nessuna delle dimensioni menzionate, il suo valore è uguale a ga:cohortTotalUsers.

  • Metrica - ga:cohortAppviewsPerUserWithLifetimeCriteria - Visualizzazioni di app per utente per la dimensione di acquisizione di una coorte.

  • Metrica - ga:cohortGoalCompletionsPerUserWithLifetimeCriteria - Completamenti obiettivi per utente per la dimensione Acquisizione di una coorte.

  • Metrica - ga:cohortPageviewsPerUserWithLifetimeCriteria - Visualizzazioni di pagina per utente per la dimensione di acquisizione di una coorte.

  • Metrica - ga:cohortRevenuePerUserWithLifetimeCriteria: entrate per utente per la dimensione di acquisizione di una coorte.

  • Metrica - ga:cohortSessionsPerUserWithLifetimeCriteria - Durata della sessione per utente per la dimensione di acquisizione di una coorte.

Le dimensioni e le metriche relative all'hub di dati social sono state ritirate e genereranno report sui dati storici solo a partire dal 30 aprile 2016; dopo questa data, non verranno più visualizzati nuovi dati. In conformità alle norme sul ritiro dei dati, queste dimensioni e metriche verranno rimosse dopo il 30 settembre 2016.

Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Attività social

Queste dimensioni e metriche sono state ritirate e verranno rimosse dopo il 30 settembre 2016. Per informazioni dettagliate sulla rimozione dei dati, consulta le norme sul ritiro dei dati:

  • Dimensione - ga:socialActivityEndorsingUrl. Per un'attività hub di dati social, si tratta dell'URL dell'attività social (ad es. l'URL di un post di Google+, l'URL di un commento sul blog e così via).
  • Dimensione - ga:socialActivityDisplayName. Per un'attività di hub di dati social, è il titolo dell'attività social pubblicata dagli utenti del social network.
  • Dimensione - ga:socialActivityPost.Per un'attività relativa all'hub di dati social, si tratta dei contenuti dell'attività social (ad es. i contenuti di un messaggio pubblicato su Google+) pubblicati dagli utenti dei social network.
  • Dimensione - ga:socialActivityTimestamp. Per un'attività hub di dati social, indica l'ora in cui si è verificata l'attività social sul social network.
  • Dimensione - ga:socialActivityUserHandle - Per un'attività hub di dati social, si tratta dell'handle di social network (ad es. nome o ID) degli utenti che hanno avviato l'attività social."
  • Dimensione - ga:socialActivityUserPhotoUrl - Per un'attività relativa all'hub di dati social, si tratta dell'URL della foto associata ai profili dei social network degli utenti.
  • Dimensione - ga:socialActivityUserProfileUrl: per un'attività relativa all'hub di dati social, si tratta dell'URL dei profili dei social network degli utenti associati.
  • Dimensione - ga:socialActivityTagsSummary - Per un'attività hub di dati social, si tratta di un insieme di tag separati da virgole associati all'attività social."
  • Dimensione - ga:socialActivityAction. Per un'attività relativa all'hub di dati social, rappresenta il tipo di azione social (ad es. voto, commento, +1 e così via) associato all'attività.
  • Dimensione - ga:socialActivityNetworkAction. Per un'attività relativa all'hub di dati social, indica il tipo di azione social e il social network da cui ha avuto origine l'attività.
  • Dimensione - ga:socialActivityContentUrl. Per un'attività relativa all'hub di dati social, si tratta dell'URL condiviso dagli utenti del social network associati.
  • Metrica - ga:socialActivities: numero totale di attività in cui un URL di contenuti è stato condiviso o menzionato su una rete partner dell'hub di dati social.

Questa versione aggiunge una nuova dimensione all'API. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Piattaforma o dispositivo

  • Dimensione - ga:browserSize: la dimensione dell'area visibile dei browser degli utenti. La dimensione del browser è basata sulle sessioni e acquisisce le dimensioni iniziali dell'area visibile in pixel e viene formattata come larghezza X altezza. Ad esempio, 1920 x 960.

In questa release è stato aggiunto un nuovo parametro all'API.

Includi righe vuote

  • In questa release viene aggiunto il nuovo parametro facoltativo include-empty-rows, che se impostato su false righe senza dati verrà omesso dalla risposta. Il valore predefinito è true, che rappresenta una modifica non irreversibile e pertanto non dovrebbe richiedere un aggiornamento del codice. Per informazioni dettagliate, consulta la documentazione di riferimento dell'API di reporting principale.

In questa release vengono aggiunte nuove metriche all'API. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Utente

  • Metrica - ga:1dayUsers: numero totale di utenti attivi in 1 giorno per ogni giorno nel periodo di tempo richiesto. Per eseguire query su questa metrica, è necessario specificare almeno un valore ga:nthDay, ga:date o ga:day come dimensione. Per la data specificata, il valore restituito corrisponderà al totale di utenti unici per il periodo di un giorno che termina alla data specificata.
  • Metrica - ga:7dayUsers: numero totale di utenti attivi in 7 giorni per ogni giorno nel periodo di tempo richiesto. Per eseguire query su questa metrica, è necessario specificare almeno un valore ga:nthDay, ga:date o ga:day come dimensione. Per la data specificata, il valore restituito corrisponderà al totale di utenti unici per il periodo di 7 giorni che termina alla data specificata.
  • Metrica - ga:14dayUsers: numero totale di utenti attivi in 14 giorni per ogni giorno nel periodo di tempo richiesto. Per eseguire query su questa metrica, è necessario specificare almeno un valore ga:nthDay, ga:date o ga:day come dimensione. Per la data specificata, il valore restituito corrisponderà al totale di utenti unici per il periodo di 14 giorni che termina alla data specificata.
  • Metrica - ga:30dayUsers: numero totale di utenti attivi in 30 giorni per ogni giorno nel periodo di tempo richiesto. Per eseguire query su questa metrica, è necessario specificare almeno un valore ga:nthDay, ga:date o ga:day come dimensione. Per la data specificata, il valore restituito corrisponderà al totale di utenti unici per un periodo di 30 giorni che termina alla data specificata.

In questa release vengono aggiunte nuove metriche all'API. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

DoubleClick Ad Exchange (AdX)

  • Metrica - ga:adxCTR: la percentuale di visualizzazioni di pagina che ha generato un clic su un annuncio AdX.
  • Metrica: ga:adxClicks. Il numero di volte in cui è stato fatto clic sugli annunci AdX sul tuo sito.
  • Metrica - ga:adxCoverage - La copertura indica la percentuale di richieste di annunci per le quali è stato generato almeno un annuncio. In genere, la copertura consente di identificare i siti nei quali il tuo account AdX non è in grado di fornire annunci mirati. (Impressioni dell'annuncio / Richieste di annunci totali) * 100
  • Metrica - ga:adxECPM - Il costo effettivo per mille visualizzazioni di pagina. Corrisponde alle entrate AdX per 1000 visualizzazioni di pagina.
  • Metrica - ga:adxImpressions. Viene registrata un'impressione dell'annuncio AdX ogni volta che sul sito web viene visualizzato un singolo annuncio. Ad esempio, se una pagina con due unità pubblicitarie viene visualizzata una volta, vengono registrate due impressioni.
  • Metrica - ga:adxImpressionsPerSession - Il rapporto tra le impressioni dell'annuncio AdX e le sessioni Analytics (Impressioni dell'annuncio / Sessioni di Analytics).
  • Metrica - ga:adxMonetizedPageviews - Visualizzazioni di pagina monetizzate misura il numero totale di visualizzazioni di pagina sulla tua proprietà visualizzate in un annuncio dal tuo account AdX collegato. Nota: una singola pagina può avere più unità pubblicitarie.
  • Metrica - ga:adxRevenue - Le entrate totali stimate provenienti dagli annunci AdX.
  • Metrica - ga:adxRevenuePer1000Sessions: le entrate totali stimate generate dagli annunci AdX per 1000 sessioni Analytics. Tieni presente che questa metrica si basa sulle sessioni sul tuo sito e non sulle impressioni dell'annuncio.
  • Metrica - ga:adxViewableImpressionsPercent - La percentuale di impressioni dell'annuncio visibili. Un'impressione viene considerata visibile quando è stata visualizzata nel browser di un utente e ha avuto l'opportunità di essere vista.

Questa release ritira le dimensioni o le metriche esistenti. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Dimensioni obsolete

Queste dimensioni sono state ritirate. Per informazioni dettagliate sulla rimozione dei dati, consulta le norme sul ritiro dei dati:

  • Dimensione - ga:adSlotPosition - Usa invece ga:adSlot.
  • Dimensione - ga:nextPagePath - Usa invece ga:pagePath.
  • Dimensione - ga:nextContentGroupXX - Usa invece ga:contentGroupXX.

Questa versione aggiunge una nuova dimensione all'API. Per un elenco completo delle dimensioni e delle metriche, consulta la sezione Riferimento dimensioni e metriche.

AdWords

  • Dimensione - ga:adQueryWordCount: il numero di parole nella query di ricerca.

Questa versione aggiunge nuove dimensioni all'API. Per un elenco completo delle dimensioni e delle metriche, consulta la sezione Riferimento dimensioni e metriche.

Piattaforma o dispositivo

  • Dimensione - ga:dataSource: l'origine dati di un hit. Gli hit inviati da ga.js e analytics.js vengono registrati come "web", mentre gli hit inviati da SDK mobile vengono registrati come "app". Questi valori possono essere sostituiti.
  • Dimensione - ga:searchAfterDestinationPage: la pagina visitata dall'utente dopo aver eseguito una ricerca interna sul tuo sito.

In questa versione vengono aggiunte nuove dimensioni e metriche all'API e vengono ritirate due metriche esistenti. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

ECommerce

  • Metrica: ga:transactionsPerUser: il numero totale di transazioni diviso per il numero totale di utenti.
  • Metrica - ga:revenuePerUser: il totale delle entrate derivanti dalle vendite fornite nella transazione, escluse spese di spedizione e tasse, diviso per il numero totale di utenti.

Utente

  • Metrica - ga:sessionsPerUser: il numero totale di sessioni diviso per il numero totale di utenti.

Rete geografica

  • Dimensione - ga:cityId: gli ID città degli utenti, ricavati da indirizzi IP o ID geografici.
  • Dimensione - ga:countryIsoCode: il codice ISO del paese degli utenti, ricavato da indirizzi IP o ID geografici. I valori sono indicati come codice ISO-3166-1 alpha-2.
  • Dimensione - ga:regionId. L'ID regione degli utenti, derivato da indirizzi IP o ID geografici. Negli Stati Uniti, una regione corrisponde a uno stato, ad esempio New York.
  • Dimensione - ga:regionIsoCode: il codice ISO della regione degli utenti, derivato da indirizzi IP o ID geografici. I valori sono indicati sotto forma di codice ISO-3166-2.
  • Dimensione - ga:subContinentCode. Il codice del subcontinente degli utenti, derivato da indirizzi IP o ID geografici. ad esempio Polinesia o Europa settentrionale. I valori sono indicati come codice UN M.49.

DoubleClick Campaign Manager

  • Metrica - ga:dcmROAS - Ritorno sulla spesa pubblicitaria (ROAS) DCM (solo premium).

Metriche deprecate

Queste metriche sono state ritirate. Per informazioni dettagliate sulla rimozione dei dati, consulta le norme sul ritiro dei dati: + Metrica - ga:dcmROI - Utilizza ga:dcmROAS. + Metrica - ga:dcmMargen - Usa invece ga:dcmROAS.

In questa versione viene aggiunta una nuova metrica all'API e vengono ritirate due metriche esistenti. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

AdWords

  • Metrica - ga:ROAS - Il ritorno sulla spesa pubblicitaria (ROAS) indica le entrate totali delle transazioni e il valore obiettivo diviso per la spesa pubblicitaria derivata.

Dimensioni e metriche deprecate

Queste dimensioni e metriche sono state ritirate. Per informazioni dettagliate sulla rimozione dei dati, consulta le norme sul ritiro dei dati: + Metrica - ga:ROI - Utilizza ga:ROAS. + Metrica - ga:margin - Usa invece ga:ROAS.

In questa release vengono aggiunte nuove metriche all'API. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

AdSense

  • Metrica - ga:adsenseCoverage: la percentuale di richieste di annunci per le quali è stato restituito almeno un annuncio.
  • Metrica - ga:adsenseViewableImpressionPercent - La percentuale di impressioni visibili.

Questa versione include l'aggiunta di una nuova metrica relativa alle sessioni, delle sorgenti di traffico e di dimensioni e metriche di DoubleClick Campaign Manager.

Dimensioni e metriche

Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Sessione

  • Metrica - ga:hits: numero totale di hit inviati a Google Analytics. Questa metrica somma tutti i tipi di hit (ad es. visualizzazione di pagina, evento, tempistiche e così via).

Sorgenti di traffico

  • Dimensione - ga:campaignCode - Se utilizzi il monitoraggio manuale della campagna, il valore del parametro di monitoraggio della campagna utm_id.

DoubleClick Campaign Manager

  • Dimensione - ga:dcmClickAd: nome dell'annuncio DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickAdId: l'ID annuncio DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickAdType: nome del tipo di annuncio DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickAdTypeId: ID del tipo di annuncio DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickAdvertiser - Il nome dell'inserzionista DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickAdvertiserId - L'ID inserzionista DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickCampaign: nome della campagna DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickCampaignId: l'ID campagna DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickCreative. Il nome della creatività DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickCreativeId: l'ID creatività DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickCreativeType. Nome del tipo di creatività DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickCreativeTypeId: ID del tipo di creatività DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickCreativeVersion. La versione della creatività DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickRenderingId: ID di rendering DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickSite. Nome del sito in cui è stata pubblicata la creatività DCM e su cui è stato fatto clic per il clic DCM corrispondente alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmClickSiteId. L'ID del sito DCM in cui è stata pubblicata la creatività DCM e su cui è stato fatto clic per il clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmClickSitePlacement: nome del posizionamento nel sito DCM del clic DCM corrispondente alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmClickSitePlacementId: ID posizionamento sul sito DCM del clic DCM corrispondente alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmClickSpotId - L'ID di configurazione Floodlight in DCM del clic DCM corrispondente alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmFloodlightActivity - Nome dell'attività Floodlight in DCM associato alla conversione Floodlight (solo Premium).
  • Dimensione - ga:dcmFloodlightActivityAndGroup: nome dell'attività Floodlight in DCM e nome del gruppo associato alla conversione Floodlight (solo Premium).
  • Dimensione - ga:dcmFloodlightActivityGroup - Nome del gruppo attività Floodlight in DCM associato alla conversione Floodlight (solo Premium).
  • Dimensione - ga:dcmFloodlightActivityGroupId: ID gruppo attività Floodlight in DCM associato alla conversione Floodlight (solo Premium).
  • Dimensione - ga:dcmFloodlightActivityId: ID attività Floodlight in DCM associato alla conversione Floodlight (solo Premium).
  • Dimensione - ga:dcmFloodlightAdvertiserId - ID inserzionista Floodlight in DCM associato alla conversione Floodlight (solo Premium).
  • Dimensione - ga:dcmFloodlightSpotId - ID di configurazione Floodlight in DCM associato alla conversione Floodlight (solo Premium).
  • Dimensione - ga:dcmLastEventAd. Nome dell'annuncio DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmLastEventAdId: ID annuncio DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmLastEventAdType. Nome del tipo di annuncio DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmLastEventAdTypeId: ID del tipo di annuncio DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmLastEventAdvertiser: nome dell'inserzionista DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmLastEventAdvertiserId: ID inserzionista DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmLastEventAttributionType. I valori possibili sono due: Click-through e View-through. Se l'ultimo evento DCM associato alla sessione di Google Analytics è stato un clic, il valore sarà Click-through. Se l'ultimo evento DCM associato alla sessione di Google Analytics è un'impressione dell'annuncio, il valore sarà View-through (solo premium).
  • Dimensione - ga:dcmLastEventCampaign: nome della campagna DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmLastEventCampaignId: ID campagna DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmLastEventCreative: nome della creatività DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmLastEventCreativeId: ID creatività DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmLastEventCreativeType: nome del tipo di creatività DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmLastEventCreativeTypeId: ID del tipo di creatività DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmLastEventCreativeVersion. Versione della creatività DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmLastEventRenderingId: ID di rendering DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo Premium).
  • Dimensione - ga:dcmLastEventSite: nome del sito in cui la creatività DCM è stata mostrata e su cui è stata fatta clic per l'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmLastEventSiteId: ID del sito DCM in cui è stata mostrata e selezionata la creatività DCM per l'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmLastEventSitePlacement: nome del posizionamento del sito DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmLastEventSitePlacementId: ID posizionamento del sito DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo premium).
  • Dimensione - ga:dcmLastEventSpotId: ID di configurazione Floodlight in DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione di Google Analytics (solo Premium).
  • Metrica - ga:dcmFloodlightQuantity: il numero di conversioni Floodlight in DCM (solo Premium).
  • Metrica - dcmFloodlightRevenue - Entrate Floodlight in DCM (solo Premium).

In questa release sono state aggiunte nuove dimensioni e metriche relative al raggruppamento di contenuti.

Dimensioni e metriche

Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Raggruppamento di contenuti

  • Dimensione - ga:landingContentGroupXX. Il primo gruppo di contenuti corrispondente nella sessione di un utente.
  • Dimensione - ga:nextContentGroupXX. Si riferisce al gruppo di contenuti visitato dopo un altro raggruppamento di contenuti.
  • Dimensione - ga:contentGroupXX - Gruppo di contenuti in una proprietà. Un gruppo di contenuti è una raccolta di contenuti che offre una struttura logica che può essere determinata dal codice di monitoraggio, dalla corrispondenza con espressione regolare titolo/URL della pagina o da regole predefinite.
  • Dimensione - ga:previousContentGroupXX. Si riferisce al gruppo di contenuti visitato prima di un altro gruppo di contenuti.
  • Metrica - ga:contentGroupUniqueViewsXX: il numero di pagine diverse (uniche) in una sessione per il gruppo di contenuti specificato. Per determinare l'univocità vengono presi in considerazione sia pagePath che pageTitle.

Questa release include una nuova condizione dateOfSession per i segmenti e l'aggiunta di nuove dimensioni e metriche di E-commerce avanzato.

Segmenti

I segmenti ora supportano una nuova condizione dateOfSession che può limitare un segmento a un gruppo di utenti che hanno avviato una sessione in un determinato intervallo di date. Per ulteriori dettagli, consulta la Guida per gli sviluppatori di segmenti.

Dimensioni e metriche

Consulta la Guida di riferimento a dimensioni e metriche per l'elenco completo delle definizioni dell'E-commerce avanzato.

E-commerce avanzato

  • Dimensione - ga:internalPromotionCreative: i contenuti della creatività progettati per una promozione.
  • Dimensione - ga:internalPromotionId: l'ID che stai utilizzando per la promozione.
  • Dimensione - ga:internalPromotionName: il nome della promozione.
  • Dimensione - ga:internalPromotionPosition. La posizione della promozione nella pagina web o nella schermata dell'applicazione.
  • Dimensione - ga:orderCouponCode. Il codice del coupon a livello di ordine.
  • Dimensione - ga:productBrand: il nome del brand con cui il prodotto viene venduto.
  • Dimensione - ga:productCategoryHierarchy: la categoria gerarchica in cui è classificato il prodotto (e-commerce avanzato).
  • Dimensione - ga:productCategoryLevelXX - Livello (1-5) nella gerarchia delle categorie di prodotti, a partire dall'alto.
  • Dimensione - ga:productCouponCode. Codice del coupon a livello di prodotto.
  • Dimensione - ga:productListName: il nome dell'elenco di prodotti in cui compare il prodotto.
  • Dimensione - ga:productListPosition: la posizione del prodotto nell'elenco dei prodotti.
  • Dimensione - ga:productVariant - La variante specifica di un prodotto, ad esempio XS, S, M, L per la taglia o Rosso, Blu, Verde, Nero per il colore.
  • Dimensione - ga:checkoutOptions: opzioni utente specificate durante la procedura di pagamento, ad esempio FedEx, DHL, UPS per le opzioni di consegna oppure Visa, MasterCard, AmEx per le opzioni di pagamento. Questa dimensione deve essere utilizzata insieme a Fase di acquisto.
  • Dimensione - ga:shoppingStage: varie fasi dell'esperienza di acquisto completate dagli utenti durante una sessione, ad esempio PRODUCT_VIEW, ADD_TO_CART, CHECKOUT ecc.
  • Metrica - ga:internalPromotionCTR: la frequenza alla quale gli utenti hanno fatto clic per visualizzare la promozione interna (numero di clic / numero di visualizzazioni della promozione).
  • Metrica: ga:internalPromotionClicks: il numero di clic su una promozione interna.
  • Metrica: ga:internalPromotionViews: il numero di visualizzazioni di una promozione interna.
  • Metrica - ga:localProductRefundAmount - Importo del rimborso di un determinato prodotto nella valuta locale.
  • Metrica - ga:localRefundAmount: importo totale del rimborso della transazione nella valuta locale.
  • Metrica: ga:productAddsToCart: numero di volte in cui il prodotto è stato aggiunto al carrello degli acquisti.
  • Metrica: ga:productCheckouts: numero di volte in cui il prodotto è stato incluso nella procedura di pagamento.
  • Metrica: ga:productDetailViews: numero di volte in cui gli utenti hanno visualizzato la pagina dei dettagli del prodotto.
  • Metrica: ga:productListClicks: numero di volte in cui gli utenti hanno fatto clic sul prodotto dopo averlo visualizzato nell'elenco dei prodotti.
  • Metrica: ga:productListViews: numero di volte in cui il prodotto è stato visualizzato in un elenco di prodotti.
  • Metrica: ga:productListCTR: la frequenza alla quale gli utenti hanno fatto clic sul prodotto in un elenco di prodotti.
  • Metrica: ga:productRefunds: numero di volte in cui è stato emesso un rimborso per il prodotto.
  • Metrica - ga:productRefundAmount - Importo totale del rimborso associato al prodotto.
  • Metrica: ga:productRemovesFromCart: numero di volte in cui il prodotto è stato rimosso dai carrelli degli acquisti.
  • Metrica - ga:productRevenuePerPurchase - Entrate medie generate dal prodotto per acquisto (comunemente utilizzata con il codice coupon prodotto).
  • Metrica - ga:buyToDetailRate - Acquisti unici diviso per il numero di visualizzazioni delle pagine dei dettagli del prodotto.
  • Metrica - ga:cartToDetailRate - Numero di aggiunte di prodotti diviso per il numero di visualizzazioni dei dettagli del prodotto.
  • Metrica - ga:quantityAddedToCart: numero di unità di prodotto aggiunte al carrello.
  • Metrica - ga:quantityCheckedOut: numero di unità di prodotto incluse nel pagamento.
  • Metrica - ga:quantityRefunded - Numero di unità di prodotto rimborsate.
  • Metrica - ga:quantityRemovedFromCart: numero di unità di prodotto rimosse dal carrello.
  • Metrica - ga:refundAmount - Valuta dell'importo rimborsato per una transazione.
  • Metrica - ga:totalRefunds - Numero di rimborsi emessi.

Questa release include una correzione di bug per i nomi delle intestazioni di colonna, nonché l'aggiunta di nuove dimensioni e metriche.

Dimensioni e metriche

Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Sistema

  • Dimensione - ga:sourcePropertyDisplayName - Il nome visualizzato della proprietà sorgente delle proprietà di aggregazione. È valido solo per le proprietà di aggregazione.
  • Dimensione - ga:sourcePropertyTrackingId - ID monitoraggio proprietà sorgente delle proprietà di aggregazione. È valido solo per le proprietà di aggregazione

Raggruppamento dei canali

  • Dimensione - ga:channelGrouping: il raggruppamento dei canali predefinito condiviso all'interno della vista (profilo).
  • Dimensione - ga:correlationModelId - ID modello di correlazione per i prodotti correlati.
  • Dimensione - ga:queryProductId - ID del prodotto oggetto della query.
  • Dimensione - ga:queryProductName - Nome del prodotto oggetto della query.
  • Dimensione - ga:queryProductVariation - Variante del prodotto oggetto della query.
  • Dimensione - ga:relatedProductId - ID del prodotto correlato.
  • Dimensione - ga:relatedProductName - Nome del prodotto correlato.
  • Dimensione - ga:relatedProductVariation - Variante del prodotto correlato.
  • Metrica - ga:correlationScore - Punteggio di correlazione per prodotti correlati.
  • Metrica: ga:queryProductQuantity - La quantità del prodotto oggetto della query.
  • Metrica - ga:relatedProductQuantity - Quantità del prodotto correlato.

Correzione del nome della colonna dell'intestazione

  • Nella versione del 16/04/2014 era presente un bug; se hai eseguito una query su una dimensione o una metrica ritirata, l'API restituisceva intestazioni di colonna con la dimensione o la metrica sostitutive. Ora restituisce correttamente lo stesso nome di dimensione o metrica utilizzato nella richiesta.

Questa release include l'aggiunta e la ridenominazione di dimensioni e metriche. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Nuove dimensioni e metriche

Le seguenti dimensioni sono state aggiunte all'API di reporting principale:

AdWords

  • Dimensione - ga:isTrueViewVideoAd - Yes o No: indica se l'annuncio è un annuncio video TrueView di AdWords.

Ora

  • Dimensione - ga:nthHour - Indice di ogni ora nell'intervallo di date specificato. L'indice della prima ora del primo giorno (ad esempio data di inizio) nell'intervallo di date è 0, 1 per l'ora successiva e così via.

Dimensioni e metriche rinominate

Tutte le dimensioni e le metriche basate su visitatore e visita sono state rinominate per utilizzare, invece, rispettivamente utente e sessione.

Le seguenti dimensioni e metriche sono state rinominate. Per informazioni dettagliate sulla ridenominazione dei dati, consulta le Norme sul ritiro dei dati:

Pubblico

  • Dimensione - ga:visitorAgeBracket - Usa invece ga:userAgeBracket.
  • Dimensione - ga:visitorGender - Usa invece ga:userGender.

E-commerce

  • Metrica - ga:transactionRevenuePerVisit - Usa invece ga:transactionRevenuePerSession.
  • Metrica - ga:transactionsPerVisit - Usa invece ga:transactionsPerSession.

Monitoraggio eventi

  • Metrica - ga:eventsPerVisitWithEvent - Usa invece ga:eventsPerSessionWithEvent.
  • Metrica - ga:visitsWithEvent - Usa invece ga:sessionsWithEvent.

Conversioni all'obiettivo

  • Metrica - ga:goalValuePerVisit - Usa invece ga:goalValuePerSession.
  • Metrica - ga:percentVisitsWithSearch - Usa invece ga:percentSessionsWithSearch.
  • Metrica - ga:searchVisits - Usa invece ga:searchSessions.

Monitoraggio pagine

  • Metrica - ga:pageviewsPerVisit - Usa invece ga:pageviewsPerSession.

Sessione

  • Dimensione - ga:visitLength - Usa invece ga:sessionDurationBucket.
  • Metrica - ga:avgTimeOnSite - Usa invece ga:avgSessionDuration.
  • Metrica - ga:timeOnSite - Usa invece ga:sessionDuration.
  • Metrica - ga:visitBounceRate - Usa invece ga:bounceRate.
  • Metrica - ga:visits - Usa invece ga:sessions.

Interazioni social

  • Dimensione - ga:socialInteractionNetworkActionVisit - Usa invece ga:socialInteractionNetworkActionSession.
  • Metrica - ga:socialInteractionsPerVisit - Usa invece ga:socialInteractionsPerSession.

Utente

  • Dimensione - ga:daysSinceLastVisit - Usa invece ga:daysSinceLastSession.
  • Dimensione - ga:visitCount - Usa invece ga:sessionCount.
  • Dimensione - ga:visitorType - Usa invece ga:userType.
  • Dimensione - ga:visitsToTransaction - Usa invece ga:sessionsToTransaction.
  • Metrica - ga:newVisits - Usa invece ga:newUsers.
  • Metrica - ga:percentNewVisits - Usa invece ga:percentNewSessions.
  • Metrica - ga:visitors - Usa invece ga:users.

Segmenti: API di reporting principale v2.4 e v3.0

Supporto di nuovi segmenti nell'API di reporting principale.

  • Il parametro segment ora supporta i segmenti utente e sequenza. È possibile eseguire query sui segmenti a livello di utente e a livello di sessione creati nell'interfaccia web con il parametro segment.
  • È disponibile una nuova sintassi per i segmenti dinamici da utilizzare con il parametro segment. Per informazioni dettagliate, consulta la Guida per gli sviluppatori dei segmenti.
  • Il prefisso dynamic:: è stato ritirato. Ti consigliamo di migrate alla nuova sintassi il prima possibile.

Questa release include un nuovo formato di risposta Tabella di dati e l'aggiunta e il ritiro di dimensioni e metriche (consulta la sezione Riferimento dimensioni e metriche per l'elenco completo delle definizioni).

Output tabella di dati

Per semplificare il rendering dei dati di Google Analytics utilizzando le visualizzazioni di Google Chart, l'API può facoltativamente restituire un oggetto Tabella dati nella risposta.

  • Un parametro di query output facoltativo è stato aggiunto all'API. Può essere utilizzato per selezionare il formato di output dei dati di Analytics nella risposta, che è JSON per impostazione predefinita. Se impostato su datatable, una proprietà dataTable contenente un oggetto Tabella dati è inclusa nella risposta. Questo oggetto può essere utilizzato direttamente con Google Graph. Per informazioni dettagliate, consulta la documentazione di riferimento sull'API di reporting principale.

Nuove dimensioni e metriche

Le seguenti dimensioni e metriche sono state aggiunte all'API di reporting principale:

Ora

  • Dimensione - ga:minute - Restituisce il minuto nell'ora. I valori possibili sono compresi tra 00 e 59.
  • Dimensione - ga:nthMinute - Indice di ogni minuto nell'intervallo di date specificato. L'indice del primo minuto del primo giorno (ad esempio, data di inizio) nell'intervallo di date è 0, 1 per il minuto successivo e così via.

Pubblico

  • Dimensione - ga:visitorAgeBracket - Fascia d'età del visitatore.
  • Dimensione - ga:visitorGender - Genere del visitatore.
  • Dimensione - ga:interestAffinityCategory - Indica che gli utenti hanno maggiori probabilità di essere interessati a conoscere la categoria specificata.
  • Dimensione - ga:interestInMarketCategory - Indica che gli utenti hanno maggiori probabilità di essere pronti ad acquistare prodotti o servizi nella categoria specificata.
  • Dimensione - ga:interestOtherCategory. Indica che gli utenti hanno maggiori probabilità di essere interessati a conoscere la categoria specificata e di essere più propensi a effettuare un acquisto.

Dimensioni e metriche consentite nei segmenti

Queste dimensioni e metriche ora possono essere utilizzate nei segmenti:

  • Dimensione - ga:sourceMedium - Valori combinati di ga:source e ga:medium.
  • Metrica - ga:localItemRevenue - Entrate generate dal prodotto in valuta locale.

Dimensioni e metriche deprecate

Queste dimensioni e metriche sono state ritirate. Per informazioni dettagliate sulla rimozione dei dati, consulta le norme sul ritiro dei dati:

  • Dimensione - ga:isMobile - Utilizza ga:deviceCategory (ad es. ga:deviceCategory==mobile).
  • Dimensione - ga:isTablet - Utilizza ga:deviceCategory (ad es. ga:deviceCategory==tablet).
  • Metrica - ga:entranceBounceRate - Usa invece ga:visitBounceRate.

In questa versione vengono aggiunte nuove dimensioni e metriche all'API. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

AdSense

  • È stato aggiunto l'accesso ai dati AdSense:

    • Soddisfatto - ga:adsenseRevenue: le entrate totali generate dagli annunci AdSense.
    • Soddisfatti - ga:adsenseAdUnitsViewed: il numero di unità pubblicitarie AdSense visualizzate. Un'unità pubblicitaria è un insieme di annunci pubblicato come risultato di una porzione di codice dell'annuncio AdSense. Dettagli: https://support.google.com/adsense/answer/32715.
    • Soddisfatto - ga:adsenseAdsViewed: il numero di annunci AdSense visualizzati. All'interno di un'unità pubblicitaria possono essere visualizzati più annunci.
    • Soddisfatto - ga:adsenseAdsClicks: il numero di volte in cui è stato fatto clic sugli annunci AdSense sul tuo sito.
    • Soddisfatto - ga:adsensePageImpressions: il numero di visualizzazioni di pagina durante le quali è stato pubblicato un annuncio AdSense. Un'impressione sulla pagina può avere più unità pubblicitarie.
    • Soddisfatto - ga:adsenseCTR: la percentuale di impressioni sulla pagina che ha portato a un clic su un annuncio AdSense. (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • Soddisfatto - ga:adsenseECPM: il costo stimato per mille impressioni sulla pagina. Corrisponde alle Entrate AdSense per 1000 impressioni sulla pagina. (ga:adsenseRevenue/(ga:adsensePageImpressions/1000).
    • Soddisfatto - ga:adsenseExits: il numero di sessioni terminate a causa del clic di un utente su un annuncio AdSense.

Ora

  • Attenuato - ga:isoYear: l'anno ISO della visita. Dettagli: http://en.wikipedia.org/wiki/ISO_week_date. ga:isoYear deve essere utilizzato solo con ga:isoWeek poiché ga:week rappresenta il calendario gregoriano.
  • Attenuazione - ga:isoYearIsoWeek - Valori combinati di ga:isoYear e ga:isoWeek.

AdWords

  • Questi dati sono disponibili nei report AdWords:

Nuove funzionalità di controllo delle dimensioni dei campioni e date relative

Date relative
  • Nell'API di reporting principale è stato aggiunto il supporto per date relative. today, yesterday e NdaysAgo sono ora valori validi per i parametri di query start-date e end-date.
  • L'utilizzo di questi valori determina automaticamente l'intervallo di date in base alla data corrente al momento in cui viene eseguita la query e al fuso orario della vista (profilo) specificata nella query. Per ulteriori dettagli, consulta la documentazione di riferimento API.
Livello di campionamento
  • È stato introdotto il nuovo parametro samplingLevel che consente di impostare il livello di campionamento (ovvero il numero di visite utilizzato per calcolare il risultato) per una query di report. I valori consentiti sono: DEFAULT, FASTER e HIGHER_PRECISION.
  • Sono stati aggiunti 2 nuovi campi alla risposta dell'API: sampleSize e sampleSpace. Puoi utilizzare questi valori per calcolare la percentuale di visite utilizzate per una risposta campionata.
  • Per ulteriori dettagli, consulta la documentazione di riferimento sulle API e il campionamento.

Correzioni di bug

  • Ora il ga:adwordsCustomerID restituisce correttamente l'ID cliente AdWords a 10 cifre corrispondente all'AccountInfo.customerId dell'API di AdWords. Questa correzione consente di unire i dati Analytics a più account AdWords.

Nell'ambito del lancio di nuovi segmenti, implementeremo le seguenti modifiche all'API di reporting principale.

  • Il parametro segment ora supporta il nuovo ID alfanumerico per i segmenti avanzati personalizzati, che viene restituito nella raccolta dei segmenti dell'API di gestione.
  • Gli attuali ID numerici per i segmenti personalizzati sono ora in fase di ritiro. Questi ID precedenti continueranno a essere supportati per 6 mesi. Consigliamo nelle applicazioni che salvano gli ID segmento di utenti di passare ai nuovi ID alfanumerici. Al termine del periodo di deprecazione, tutte le query con i vecchi ID numerici restituiranno un errore.
  • Al momento, solo i segmenti a livello di visita creati nell'interfaccia web saranno interrogabili tramite il parametro segment.
  • I segmenti predefiniti esistenti con ID numerici negativi non saranno interessati. Tuttavia, al momento i nuovi segmenti predefiniti non sono supportati.

In questa versione vengono aggiunte nuove dimensioni e metriche all'API. Per l'elenco completo delle definizioni, consulta la pagina Riferimento dimensioni e metriche.

Monitoraggio app

  • Questi dati sono disponibili nei report del profilo app:
    • Attenuato - ga:appId: l'ID dell'applicazione.
    • Attenuato - ga:appInstallerId: ID dell'utente che ha eseguito l'installazione (ad es. Google Play Store) da cui è stata scaricata l'app. Per impostazione predefinita, l'ID programma di installazione dell'app è impostato in base al metodo PackageManager#getInstallerPackageName.
    • Attenuato - ga:appName: il nome dell'applicazione.
    • Attenuato - ga:appVersion: la versione dell'applicazione.
    • Attenuato: ga:exitScreenName: il nome dello schermo quando l'utente è uscito dall'applicazione.
    • Attenuato - ga:landingScreenName: il nome della prima schermata visualizzata.
    • Attenuato - ga:screenDepth: il numero di visualizzazioni di schermata per sessione indicato come stringa. Può essere utile per gli istogrammi.
    • Attenuato - ga:screenName: il nome dello schermo.
    • Soddisfatto - ga:avgScreenviewDuration: il tempo medio trascorso dagli utenti su uno schermo in secondi.
    • Soddisfatto - ga:timeOnScreen: il tempo trascorso a visualizzare la schermata corrente.
    • Soddisfatto - ga:screenviews - Il numero totale di visualizzazioni di schermata. Da usare al posto di ga:appviews.
    • Soddisfatto - ga:uniqueScreenviews: il numero di ga:screenviews diversi (unici) all'interno di una sessione. Da usare al posto di ga:uniqueAppviews.
    • Soddisfatto - ga:screenviewsPerSession: il numero medio di ga:screenviews per sessione. Da usare al posto di ga:appviewsPerVisit.

Deprecata

Le seguenti metriche sono state ritirate. Usa invece il nuovo nome della metrica.

  • Soddisfatto - ga:appviews - Usa invece ga:screenviews.
  • Soddisfatto - ga:uniqueAppviews - Usa invece ga:uniqueScreenviews.
  • Soddisfatto - ga:appviewsPerVisit - Usa invece ga:screenviewsPerSession.

Variabili o colonne personalizzate

  • Accesso alla dimensione e alle metriche personalizzate:

    • Attenuato - ga:dimensionXX: il nome della dimensione personalizzata richiesta, in cui XX si riferisce al numero/indice della dimensione personalizzata.
    • Soddisfatto - ga:metricXX: il nome della metrica personalizzata richiesta, in cui XX si riferisce al numero/indice della metrica personalizzata.

Modifiche alla documentazione

Le seguenti dimensioni e metriche delle variabili personalizzate sono state rinominate. Si tratta solo di una modifica alla documentazione e non richiede l'aggiornamento delle query.

  • ga:customVarName(n)ga:customVarNameXX
  • ga:customVarValue(n)ga:customVarValueXX

E-commerce

  • Attenuato - ga:currencyCode: il codice della valuta locale della transazione in base allo standard ISO 4217.
  • Soddisfatto - ga:localItemRevenue - Entrate generate dal prodotto in valuta locale.
  • Soddisfatto - ga:localTransactionRevenue - Entrate delle transazioni in valuta locale.
  • Soddisfatto - ga:localTransactionShipping: costo di spedizione della transazione in valuta locale.
  • Soddisfatto - ga:localTransactionTax - Imposta sulle transazioni nella valuta locale.

Eccezioni

  • Questi dati provengono dal monitoraggio delle eccezioni.
    • Attenuato - ga:exceptionDescription: la descrizione dell'eccezione.
    • Soddisfatto - ga:exceptionsPerScreenview: il numero di eccezioni generate diviso per il numero di visualizzazioni di schermata.
    • Soddisfatto - ga:fatalExceptionsPerScreenview: il numero di eccezioni irreversibili generate diviso per il numero di visualizzazioni di schermata.

Conversioni all'obiettivo

  • Attenuato - ga:goalCompletionLocation: il percorso pagina o il nome della schermata corrispondente a qualsiasi completamento obiettivo del tipo di destinazione.
  • Attenuato - ga:goalPreviousStep1: il percorso pagina o il nome della schermata corrispondente a qualsiasi obiettivo di tipo di destinazione, un passaggio prima della posizione di completamento dell'obiettivo.
  • Attenuato - ga:goalPreviousStep2: il percorso pagina o il nome della schermata corrispondente a qualsiasi obiettivo di tipo destinazione, due passaggi prima della posizione di completamento dell'obiettivo.
  • Attenuato - ga:goalPreviousStep3: il percorso pagina o il nome della schermata corrispondente a qualsiasi obiettivo di tipo di destinazione, tre passaggi prima della posizione di completamento dell'obiettivo.

Modifiche alla documentazione

La dimensione e le metriche Conversioni all'obiettivo riportate di seguito sono state rinominate. Si tratta solo di una modifica alla documentazione e non richiede l'aggiornamento delle query.

  • ga:goal(n)AbandonRatega:goalXXAbandonRate
  • ga:goal(n)Abandonsga:goalXXAbandons
  • ga:goal(n)Completionsga:goalXXCompletions
  • ga:goal(n)ConversionRatega:goalXXConversionRate
  • ga:goal(n)Startsga:goalXXStarts
  • ga:goal(n)Valuega:goalXXValue
  • ga:searchGoal(n)ConversionRatega:searchGoalXXConversionRate
  • Soddisfatto - ga:percentSearchRefinements: la percentuale di volte in cui un perfezionamento (transizione) si verifica tra le parole chiave per la ricerca interna all'interno di una sessione.

Monitoraggio pagine

  • Soddisfatto - ga:pageValue: il valore medio di questa pagina o di questo insieme di pagine. Il valore pagina è ((Entrate per transazione + Valore totale obiettivo) diviso per Visualizzazioni di pagina uniche della pagina o dell'insieme di pagine).

Piattaforma o dispositivo

  • Questi dati derivano dalla stringa user agent HTTP.

    • Attenuato - ga:deviceCategory - Il tipo di dispositivo: computer, tablet o dispositivo mobile.
    • Attenuato - ga:isTablet - Indica i visitatori che utilizzano tablet. I valori possibili sono Yes o No.
    • Attenuato - ga:mobileDeviceMarketingName: nome commerciale utilizzato per il dispositivo mobile.

Interazioni social

  • Questi dati provengono dal monitoraggio delle interazioni social sul sito.

    • Attenuato - ga:socialEngagementType - Tipo di coinvolgimento. I valori possibili sono Socially Engaged o Not Socially Engaged.

Ora

  • Attenuazione - ga:dateHour - Valori combinati di ga:date e ga:hour.
  • Attenuato - ga:dayOfWeekName: il nome del giorno della settimana (in inglese).
  • Attenuazione - ga:isoWeek: il numero della settimana ISO, dove ogni settimana inizia di lunedì. Dettagli: http://en.wikipedia.org/wiki/ISO_week_date.
  • Attenuazione - ga:yearMonth - Valori combinati di ga:year e ga:month.
  • Attenuazione - ga:yearWeek - Valori combinati di ga:year e ga:week.

Sorgenti di traffico

  • Attenuato - ga:fullReferrer: l'URL di riferimento completo, inclusi il nome host e il percorso.
  • Attenuato - ga:sourceMedium: i valori combinati di ga:source e ga:medium.
  • In questa release sono state aggiunte 5 nuove metriche relative alla velocità del sito:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • Questa release aggiunge un nuovo segmento predefinito per il traffico da tablet, gaid::-13.

In questa versione vengono aggiunte nuove dimensioni e metriche all'API. Consulta la pagina Riferimento dimensioni e metriche per conoscere le definizioni.

Monitoraggio app

  • Questi dati sono disponibili nei report dell'SDK di monitoraggio delle app mobile:
    • Soddisfatto - ga:uniqueAppviews: il numero di visualizzazioni dell'app per sessione.
    • Soddisfatto - 'ga:appviews: il numero totale di visualizzazioni dell'app.
    • Soddisfatto - ga:appviewsPerVisit: il numero medio di visualizzazioni dell'app per sessione.

Sorgenti di traffico

  • Attenuato - ga:socialNetwork: una stringa che rappresenta il nome del social network. Ciò può essere correlato al social network di riferimento per le sorgenti di traffico o al social network per le attività relative all'hub di dati social. Ad es. Google+, Blogger, reddit ecc.
  • Attenuato - ga:hasSocialSourceReferral. Indica le visite arrivate al sito da una sorgente social, ad esempio un social network come Google+, Facebook, Twitter e così via. I valori possibili sono Sì o No, dove la prima lettera deve essere maiuscola.

Attività social

  • Questi dati provengono da attività esterne al sito importate dai partner dell'hub di dati social.
    • Attenuato - ga:socialActivityDisplayName: per un'attività hub di dati social, questa stringa rappresenta il titolo dell'attività social pubblicata dall'utente del social network.
    • Attenuato - ga:socialActivityEndorsingUrl: per un'attività hub di dati social, questa stringa rappresenta l'URL dell'attività social (ad es. l'URL di un post di Google+, l'URL di un commento sul blog e così via)
    • Attenuato - ga:socialActivityPost: per un'attività relativa all'hub di dati social, questa stringa rappresenta i contenuti dell'attività social pubblicata dall'utente del social network, ad esempio il contenuto di un post di Google+
    • Attenuato - ga:socialActivityTimestamp: per un'attività nell'hub di dati social, questa stringa rappresenta il momento in cui si è verificata l'attività social sul social network.
    • Attenuato - ga:socialActivityUserPhotoUrl: per un'attività relativa all'hub di dati social, questa stringa rappresenta l'URL della foto associata al profilo del social network dell'utente.
    • Attenuato - ga:socialActivityUserProfileUrl: per un'attività relativa all'hub di dati social, questa stringa rappresenta l'URL del profilo di social network dell'utente associato.
    • Attenuato - ga:socialActivityContentUrl: per un'attività relativa all'hub di dati social, questa stringa rappresenta l'URL condiviso dall'utente del social network associato.
    • Attenuato - ga:socialActivityTagsSummary. In un'attività hub di dati social, si tratta di un insieme separato da virgole di tag associati all'attività social.
    • Attenuato - ga:socialActivityUserHandle: per un'attività hub di dati social, questa stringa rappresenta l'handle del social network (ovvero il nome) dell'utente che ha avviato l'attività social.
    • Attenuato - ga:socialActivityAction: per un'attività dell'hub di dati social, questa stringa rappresenta il tipo di azione social associata all'attività (ad esempio voto, commento, +1 e così via).
    • Attenuato - ga:socialActivityNetworkAction: per un'attività di hub di dati social, questa stringa rappresenta il tipo di azione social e il social network da cui l'attività ha avuto origine.
    • Soddisfatto - ga:socialActivities: il numero di attività in cui un URL di contenuti è stato condiviso/menzionato su una rete partner dell'hub di dati social.

Interazioni social

  • Questi dati provengono dal monitoraggio delle interazioni social sul sito.
    • Attenuato - ga:socialInteractionAction: per le interazioni social, una stringa che rappresenta l'azione social monitorata (ad es. +1, Mi piace, preferito)
    • Attenuato - ga:socialInteractionNetwork: per le interazioni social, una stringa che rappresenta il social network monitorato (ad es. Google, Facebook, Twitter, LinkedIn)
    • Attenuato - ga:socialInteractionNetworkAction: per le interazioni social, una stringa che rappresenta la concatenazione di ga:socialInteractionNetwork e ga:socialInteractionAction monitorati (ad es. Google: +1, Facebook: Mi piace)
    • Attenuato - ga:socialInteractionTarget: per le interazioni social, una stringa che rappresenta l'URL (o la risorsa) che riceve l'azione sui social network.
    • Soddisfatto - ga:socialInteractions: il numero totale di interazioni social sul tuo sito.
    • Soddisfatto - ga:uniqueSocialInteractions: il numero totale di interazioni social uniche sul tuo sito. In base alla coppia di valori ga:socialInteractionNetwork e ga:socialInteractionAction
    • Soddisfatto - ga:socialInteractionsPerVisit - ga:socialInteractions / ga:uniqueSocialInteractions. Il numero medio di interazioni social per visita al tuo sito.

Dati geografici / di rete

  • Attenuato - ga:metro: la Designated Market Area (DMA) da cui ha avuto origine il traffico.

Monitoraggio pagine

  • Attenuato - ga:pagePathLevel1: questa dimensione raccoglie tutti i pagePath del primo livello gerarchico in pagePath.
  • Attenuato - ga:pagePathLevel2: questa dimensione raccoglie tutti i pagePath del secondo livello gerarchico in pagePath.
  • Attenuato - ga:pagePathLevel3: questa dimensione raccoglie tutti i pagePath del terzo livello gerarchico in pagePath.
  • Attenuato - ga:pagePathLevel4: questa dimensione raccoglie tutti i pagePath del quarto livello gerarchico in pagePath. In questa dimensione vengono raggruppati anche tutti i livelli aggiuntivi della gerarchia pagePath.

Monitoraggio eccezioni

  • Questi dati provengono dai dati di monitoraggio delle eccezioni.

    • Soddisfatto - ga:exceptions: il numero di eccezioni inviate a Google Analytics.
    • Soddisfatto: ga:fatalExceptions. Il numero di eccezioni in cui isFatal è impostato su true.

Tempi utente

  • Questi dati provengono dai dati dei tempi utente.

    • Attenuato - ga:userTimingCategory - Una stringa per la classificazione di tutte le variabili di tempo utente in gruppi logici per la generazione di report più semplici.
    • Attenuato - ga:userTimingLabel: una stringa che indica il nome dell'azione della risorsa monitorata.
    • Attenuato - ga:userTimingVariable: una stringa che può essere utilizzata per una maggiore flessibilità nella visualizzazione dei tempi utente nei report.
    • Attenuato - ga:userTimingValue il numero di millisecondi di tempo trascorso inviati a Google Analytics.
    • Soddisfatto - ga:userTimingSample: il numero di campioni inviati.
    • Soddisfatto - ga:avgUserTimingValue: il valore medio del tempo utente. ga:userTimiingValue / ga:userTimiingSample.

Dispositivo / piattaforma

  • Questi dati provengono dallo user agent dei dati raccolti.
    • Attenuato - ga:mobileDeviceBranding: produttore del dispositivo mobile o nome del brand (ad esempio: Samsung, HTC, Verizon, T-Mobile).
    • Attenuato - ga:mobileDeviceModel - Modello di dispositivo mobile (esempio: Nexus S)
    • Attenuato - ga:mobileInputSelector: selettore utilizzato sul dispositivo mobile (ad es. touchscreen, joystick, rotellina, stilo)
    • Dim - ga:mobileDeviceInfo: branding, modello e nome commerciale utilizzati per identificare il dispositivo mobile.

Correzioni di bug

  • Ora l'API gestisce correttamente i caratteri UTF-8 in un filtro o in un segmento dinamico.

Questa versione consente agli account Google Analytics premium di accedere a un massimo di 50 variabili personalizzate.

In questa release sono stati corretti due bug:

Correzioni di bug

  • I filtri di query che contengono caratteri speciali all'interno di espressioni regolari non restituiscono più errori del server.

  • Se combini un filtro di metrica con un segmento avanzato, non viene più restituito un errore.

In questa release sono state aggiunte nuove metriche relative alla velocità del sito all'API.

Nuove metriche

  • Sono state aggiunte le seguenti metriche relative alla velocità del sito:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

Consulta la pagina Riferimento dimensioni e metriche per conoscere le definizioni.

Promemoria relativo al ritiro della versione 2.3 dell'API

  • La versione 2.3 dell'API di esportazione dei dati è stata ritirata per 2 mesi. Tra circa altri 4 mesi disattiveremo questo servizio e supporteremo solo la nuova versione 3.0 e la versione 2.4 dell'API Core Reporting.

  • Ti consigliamo vivamente di eseguire la migrazione delle tue applicazioni alla versione 3.0.

  • Tra 4 mesi le richieste al feed di dati XML della versione 2.3 della versione precedente verranno inoltrate alla versione 2.4 e restituiranno una risposta XML della versione 2.4. A quel punto, tutti i criteri per le quote della versione 2.4 verranno applicati alle richieste della versione 2.3.

  • Tutte le richieste per la versione JSON 2.3 o per la libreria client JavaScript di dati di Google che utilizza l'output JSON della versione 2.3 restituiranno codici di stato 404.

  • Per ottenere la quota completa, sia la versione 3.0 che la versione 2.4 richiedono la registrazione dell'applicazione nella console API di Google e l'utilizzo di una chiave API (o un token OAuth 2.0) in ogni richiesta.

Abbiamo corretto un piccolo bug in ga:visitLength. Questa dimensione ora restituisce i dati corretti.

Questa release è valida per tutti gli sviluppatori dell'API Google Analytics. Annuncia due nuove versioni dell'API, richiede la registrazione delle applicazioni, introduce un nuovo criterio per le quote e cambia il nome dell'API nell'API di reporting principale. Infine, ritira l'attuale versione 2.3 dell'API di esportazione dei dati.

Versione 3.0

  • La versione 3.0 dell'API di reporting principale è l'ultima versione principale dell'API e non è compatibile con le versioni precedenti. Tutti i futuri sviluppi dell'API verranno eseguiti su questa versione.

  • Nuove funzionalità

    • Il nuovo output basato su JSON riduce di circa 10 volte le dimensioni della risposta rispetto all'output XML precedente.
    • Nuove librerie client delle API di Google che supportano Java, JavaScript, Python, PHP, Ruby e .Net.
    • Supporto per l' API Google Discovery.
    • Supporto per OAuth 2.0 come nuovo metodo consigliato per autorizzare gli utenti.
  • Aggiornamenti

    • Nuovo URL per effettuare richieste: https://www.googleapis.com/analytics/v3/data/ga….
    • Sono richiesti i token di registrazione e sviluppatori.
    • Tutte le richieste di dati di configurazione devono essere effettuate tramite l' API di gestione.

Versione 2.4

  • La versione 2.4 dell'API di reporting principale è un upgrade della versione secondaria che è per lo più compatibile con le versioni precedenti dell'API di esportazione dati esistente versione 2.3.

  • Aggiornamenti

    • Nuovo URL per effettuare richieste: https://www.googleapis.com/analytics/v2.4/data…
    • Sono richiesti i token di registrazione e sviluppatori.
    • Output XML conforme alla versione 2.3, in modo che le altre librerie client di dati di Google esistenti continueranno a funzionare.
    • Codice di errore per errori di quota modificato da 503 a 403
    • Le risposte JSON non sono supportate.
    • Libreria client JavaScript dei dati di Google non supportata.
    • Nessun feed account. Tutte le richieste di dati di configurazione devono essere effettuate tramite l' API di gestione.

Iscrizione

  • Tutte le applicazioni create utilizzando l'API Google Analytics devono essere registrate come progetto tramite la console API di Google.

  • Ogni richiesta all'API deve includere una chiave API o, per OAuth 2.0, un ID client e un client secret.

Criteri per le quote

  • La seguente quota si applica ad entrambe le API Anlaytics (API di gestione e API di esportazione dei dati)

    • 50.000 richieste per progetto al giorno
    • 10 query al secondo (QPS) per indirizzo IP
  • La seguente quota si applica all'API di esportazione dei dati

    • 10.000 richieste per profilo al giorno
    • 10 richieste in parallelo per profilo
  • Per le applicazioni non registrate, offriamo una quota di tolleranza molto bassa per consentire l'esecuzione di un numero ridotto di test.

Deprecazioni

  • In questa versione viene inoltre annunciato il ritiro della versione 2.3 e l'imminente disattivazione del feed account dell'API di esportazione dei dati. Tra 6 mesi:

    • Le richieste inviate al feed di dati XML della versione 2.3 verranno inoltrate alla versione 2.4 e restituiranno una risposta alla versione 2.4. A quel punto, tutti i criteri per le quote della versione 2.4 verranno applicati alle richieste della versione 2.3.

    • Le richieste all'output JSON della versione 2.3 non saranno supportate dalla risposta della versione 2.4 e restituiranno i codici di stato 404 Not Found. Se hai bisogno di una risposta JSON, esegui l'upgrade alla versione 3.0.

    • Le richieste inviate al feed dell'account nell'API di esportazione dei dati restituiranno codici di stato 404 Not Found. Tutte le richieste di dati di configurazione devono essere effettuate tramite l' API di gestione.

In questa versione vengono aggiunti dati AdWords più aggiornati e altre combinazioni per le dimensioni e le metriche di AdWords.

  • I dati AdWords vengono ora aggiornati entro un'ora. Prima che i dati fossero aggiornati quotidianamente.

  • Abbiamo attenuato un numero limitato di limitazioni relative a combinazioni valide con i dati di AdWords.

Qualche settimana fa abbiamo apportato una modifica per non consentire le query dell'API che richiedevano ga:adGroup o ga:adContent con ga:impressions, in quanto questa combinazione ha restituito 0. Con questa modifica, questa combinazione è stata ripristinata ed è stata corretta per restituire dati corretti.

In questa release sono state corrette alcune combinazioni non valide di dimensioni e metriche

Correzioni delle combinazioni di metriche/dimensioni non valide

  • Il mese scorso abbiamo annunciato alcune modifiche imminenti all'API per non consentire alcune query non valide nel feed di dati che non restituiscono dati. Abbiamo apportato queste modifiche all'API e le seguenti combinazioni non sono più valide:

    • Le dimensioni del prodotto non possono essere combinate con le metriche delle transazioni.
    • ga:adContent o ga:adGroup non possono essere combinati con ga:impressions.

    Invece di restituire una risposta con 0 risultati, l'API ora restituisce il codice di errore 400 per tutte le query che richiedono queste combinazioni.

Questa release ritira il valore dell'intervallo di confidenza nelle metriche.

Ritiro dell'intervallo di confidenza

  • Se non lo hai già fatto, interrompi l'utilizzo dei valori dell'intervallo di confidenza per le metriche. In questa release, il feed di dati dell'API di esportazione dei dati restituisce 0,0 per tutti i valori dell'intervallo di confidenza. Tra circa un mese rimuoveremo completamente questo attributo da tutti gli elementi delle metriche.

    Per determinare se una risposta è stata campionata, utilizza il campo containsSampledData nella risposta.

Questa release aggiunge tre nuove metriche e aggiorna il valore restituito di due.

Nuovi aggiornamenti dati

  • Abbiamo aggiunto all'API tre nuove metriche relative alle prestazioni relative alla velocità del sito:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

Aggiornamenti delle metriche

  • Per specificare i valori di valuta nei filtri, devi specificare il valore effettivo trasmesso dal codice di monitoraggio (ad es. 1 unità verrà ora specificata come 1).

  • ga:CTR ora restituisce la percentuale effettiva (ad es. un valore del 2% viene restituito come 2).

Questa release migliora il rendimento dei feed di dati e aggiunge nuovi dati:

Miglioramento delle prestazioni

  • Questa release migliora la latenza del feed di dati del 30-35%.

Nuovi aggiornamenti dati

  • Abbiamo aggiornato l'elenco di dimensioni e metriche consentite nei segmenti avanzati. Consulta l'elenco aggiornato per assicurarti che le tue richieste siano valide.

Prossime modifiche

  • Al momento, devi specificare il valore del filtro della valuta come micro unità (ad es.1 unità di valuta è specificata come 1000000). Nel prossimo futuro, dovrai specificare il valore effettivo trasmesso dal codice di monitoraggio (ad es. 1 unità verrà ora indicata come 1).

  • Attualmente, ga:CTR è un percent e restituisce il valore 0,02. Nel prossimo futuro questo valore cambierà e restituirà la percentuale effettiva (ad es. 2).

In questa release vengono aggiunti altri dati al feed di dati:

Nuovi aggiornamenti dati

  • È stata aggiunta la seguente dimensione Tempo: ga:dayOfWeek

  • È stata aggiunta la seguente metrica di ricerca interna: ga:percentVisitsWithSearch

  • Sono state aggiunte le seguenti metriche di Monitoraggio eventi:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

Prossime modifiche

Al momento l'API restituisce codici di stato 401 per vari problemi di autorizzazione. Entro un paio di settimane, lo stato 401 verrà utilizzato esclusivamente per i token non validi, offrendo agli sviluppatori un modo per gestire gli errori in questa particolare eccezione.

Questa release aggiunge molti più dati al feed di dati:

Nuovi aggiornamenti dati

  • Il calcolo di ga:visitors è stato modificato per restituire il numero di visitatori unici nell'intervallo di date e ora supporta più combinazioni di dimensioni e metriche.

  • Sono state aggiunte dieci nuove dimensioni AdWords: ga:adDistributionNetwork, ga:adMatchType, ga:adMatchedQuery, ga:adPlacementDomain, ga:adPlacementUrl, ga:adFormat, ga:adTargetingType, ga:adTargetingOption, ga:adDisplayUrl e ga:adDestinationUrl.

  • La metrica ga:organicSearches è stata aggiunta al gruppo di campagne.

  • La metrica ga:searchResultViews è stata aggiunta al gruppo di ricerca interna su sito.

  • Sono state aggiunte tre nuove dimensioni basate sul tempo: ga:nthDay, ga:nthWeek e ga:nthMonth.

  • I raggruppamenti di dimensioni e metriche sono stati modificati per riflettere meglio le funzionalità che rappresentano.

Nuove metriche calcolate

Le seguenti metriche calcolate derivano da calcoli utilizzando le metriche di base. Nota: ogni nome con (n) supporta valori compresi tra 1 e 20.

  • In base agli obiettivi: ga:costPerConversion, ga:costPerGoalConversion, ga:costPerTransaction, ga:goal(n)AbandonRate, ga:goal(n)Abandons, ga:goal(n)ConversionRate, ga:goalAbandonRateAll, ga:goalAbandonsAll, ga:goalConversionRateAll, ga:goalValueAllPerSearch, ga:goalValuePerVisit.

  • Basate sui contenuti: ga:entranceBounceRate, ga:visitBounceRate, ga:entranceRate, ga:exitRate, ga:pageviewsPerVisit, ga:avgTimeOnPage, ga:avgTimeOnSite, ga:avgEventValue.

  • Basato sulla ricerca interna sul sito: ga:avgSearchDepth, ga:avgSearchDuration, ga:avgSearchResultViews, ga:searchGoalConversionRateAll, ga:searchGoal(n)ConversionRate, ga:searchExitRate.

  • Basato sull'e-commerce: ga:itemsPerPurchase, ga:margin, ga:percentNewVisits, ga:revenuePerItem, ga:revenuePerTransaction, ga:ROI, ga:RPC, ga:totalValue, ga:transactionRevenuePerVisit e ga:transactionsPerVisit.

In questa versione è stata aggiunta una nuova funzione al feed di dati:

Nuove funzionalità

  • È stato aggiunto un nuovo elemento XML che consente agli utenti di sapere se i dati sono stati campionati. true. Questo elemento restituirà sempre se i dati sono stati campionati o meno con true o false. Anche le librerie Java e JavaScript sono state aggiornate con metodi helper per accedere a questo elemento.

In questa release sono stati corretti due bug:

Correzioni di bug

  • In precedenza, hai aggiunto un operatore OR a un'espressione di filtro con una dimensione (ad es. ga:keyword==store,ga:keyword==bar) potrebbe generare valori diversi rispetto a quando ogni filtro venisse applicato singolarmente a più query. Il problema è stato risolto e l'utilizzo dell'operatore OPPURE ora restituisce valori coerenti.

  • Alcuni dei messaggi di errore dell'API relativi a filtri non validi sono stati aggiornati in modo da NON indicare se l'errore è stato causato da un filtro di dimensione o di metrica (sebbene venga ancora restituita l'espressione di filtro in questione).

In questa release sono stati corretti tre bug:

Correzioni di bug

  • È stato risolto un problema di codifica nella libreria client JavaScript. Strumento di monitoraggio dei problemi di Analytics

  • È stato risolto un bug che impediva la restituzione del feed dell'account in caso di impostazione errata di nome obiettivo, percorso obiettivo, valore di confronto obiettivo o tipo di confronto obiettivo.

  • Non è valido per una dimensione e una metrica nel parametro del filtro di query del feed di dati. Ad esempio: ga:source==google,ga:visits>5. Il messaggio di errore per questa query non valida è stato aggiornato e ora è: Cannot OR dimension filter(s) with metric filter.

In questa release sono stati aggiunti nuovi dati e è stato corretto un bug:

Nuove funzionalità

  • Nella nuova categoria D8. Adwords sono state aggiunte le seguenti cinque dimensioni:

    • ga:adwordsAdGroupId: corrisponde all'attributo AdGroup.id dell'API di AdWords
    • ga:adwordsCampaignId: corrisponde al valore Campaign.id dell'API di AdWords
    • ga:adwordsCreativeId: corrisponde all'API di AdWords Ad.id
    • ga:adwordsCriteriaId: corrisponde al valore Criterion.id dell'API AdWords
    • ga:adwordsCustomerId: corrisponde all'AccountInfo.customerId dell'API di AdWords

Correzioni di bug

  • Abbiamo risolto un problema per cui il feed dell'account non restituisceva dati se uno dei profili aveva un obiettivo o un passaggio configurato in modo errato.

In questa versione sono state aggiunte nuove funzioni e sono stati corretti bug:

Nuove funzionalità

  • Il segmento predefinito iPhone (gaid::-11) è stato migliorato per ora generare report su tutti i dispositivi mobili. L'ID è uguale a prima (-11), ma il nome del segmento ora è: Mobile Traffic.

  • La frequenza di campionamento utilizzata dall'API è ora la stessa dell'interfaccia web. In questo modo i dati dei report campionati sono in linea con l'interfaccia web e si aumenta la coerenza tra i due.

  • I criteri per le quote sono stati aggiornati nel tentativo di garantire che tutti gli utenti ricevano un accesso equo alle risorse. Per ulteriori dettagli, consulta la nostra documentazione relativa ai criteri per le quote. La nuova norma è:

    • Una singola proprietà web può effettuare un massimo di 10.000 richieste ogni 24 ore.
    • Un'applicazione può effettuare solo 10 richieste in un determinato periodo di 1 secondo.
    • Un'applicazione può avere solo 4 richieste in attesa alla volta.
  • Alcune limitazioni sulle combinazioni di dimensioni e metriche sono state allentate. ga:nextPagePath e ga:previousPagePath ora fanno parte del gruppo D3. Content. Il gruppo D8. Custom Variable ora si chiama gruppo D6. Custom Variable. Consulta la guida di riferimento aggiornata per queste nuove combinazioni.

Correzioni di bug

  • Abbiamo corretto un bug relativo al modo in cui l'API segnalava il valore confidenceInterval per le metriche. In precedenza, gli intervalli di confidenza potevano avere un valore INF o un numero compreso tra 0 e 1. Ora tutti gli intervalli di confidenza avranno un valore INF o un numero maggiore o uguale a 0.

  • ga:itemQuantity e ga:uniquePurchases sono stati precedentemente scambiati e si sono restituiti il valore reciproco. Ora il problema è stato risolto in modo da restituire i dati corretti.

Promemoria relativo al ritiro di dimensioni e metriche

  • Se non l'hai ancora fatto, interrompi l'utilizzo delle dimensioni e delle metriche che erano state ritirate in precedenza.

In questa versione è stata aggiunta una serie di nuove funzionalità:

Questa release incrementa il numero di versione principale a 2

  • Alcune funzionalità richiedono l'utilizzo delle librerie client più recenti. Supportiamo ufficialmente: Java e JavaScript. Le librerie di terze parti potrebbero non essere ancora aggiornate.

    • La versione 2 può essere richiesta aggiungendo l'intestazione GData-Version: 2 a ogni account o richiesta di feed di dati. Per ulteriori informazioni, consulta la documentazione.
    • È stato aggiunto un nuovo spazio dei nomi XML sia all'account che ai feed di dati:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • L'API ora supporta la versione 2 del protocollo Google Data.

Supporto per la segmentazione avanzata

  • Parametro di query dei segmenti dinamici:

    • ...&segment=dynamic::espressione
    • consente di creare segmenti avanzati "al volo".
    • espressione può essere qualsiasi dimensione o metrica e deve seguire la stessa sintassi dei filtri.
  • Parametro di query dei segmenti predefiniti e personalizzati:

    • ...&segment=gaid::numero
    • dove numero è un ID che fa riferimento a un segmento avanzato definito nell'interfaccia web di Google Analytics.
    • Puoi trovare l'ID nel feed dell'account.
  • Il feed dell'account descrive i dati del segmento tramite i seguenti elementi e attributi XML:

    • ga:visitorType==Returning Visitor
  • Il feed di dati fornisce inoltre un elemento XML che indica se un segmento è stato applicato nella richiesta API.

  • Ulteriori dettagli sui segmenti avanzati sono disponibili nella nostra documentazione.

Nuovi dati sugli obiettivi disponibili

  • Obiettivi di tipo destinazione e coinvolgimento disponibili nel feed dell'account:

  • Per gli obiettivi 5-20 sono state aggiunte 48 nuove metriche degli obiettivi che seguono la convenzione goal(n)Completions, dove (n) è un numero compreso tra 1 e 20.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value
  • GoalCompletionAll, GoalStartsAll e GoalValueAll sono stati aggiornati per tenere conto dei nuovi dati relativi agli obiettivi.

Nuovi dati sulle variabili personalizzate

  • Tutte le variabili personalizzate mai raccolte da ciascun profilo sono state aggiunte al feed dell'account come nuovo elemento XML:

  • Sono state aggiunte 10 nuove dimensioni per le variabili personalizzate. Seguono la convenzione customVar(n), in cui (n) può essere un numero compreso tra 1 e 5.

    • ga:customVarName(n)
    • ga:customVarValue(n)

Dimensioni e metriche obsolete da rimuovere.

  • Se non l'hai ancora fatto, interrompi l'utilizzo delle dimensioni e delle metriche che erano state ritirate in precedenza. Verranno rimossi a breve e, se richiesto, restituiranno errori dalla nostra API.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Le seguenti dimensioni sono state rinominate:

    • ga:countOfVisits ora è ga:visitCount
    • ga:countOfVisitsToATransaction ora è ga:visitsToTransaction

In questa release sono state aggiunte nuove funzioni e sono state ritirate alcune funzionalità precedenti:

  • Le seguenti dimensioni e metriche sono state ritirate. Tra un mese verranno rimossi definitivamente dalla nostra API. Assicurati di aggiornare il codice in modo che le applicazioni non si interrompano:

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Le seguenti dimensioni sono state rinominate:

    • ga:countOfVisits ora è ga:visitCount
    • ga:countOfVisitsToATransaction ora è ga:visitsToTransaction
  • Tutti i dati del monitoraggio eventi sono ora mostrati in due nuovi gruppi:

    D7. Eventi (dimensioni) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. Eventi (metriche) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

  • I dati generali sulla navigazione del sito vengono ora esposti tramite le seguenti dimensioni:

    D6. Navigazione * ga:previousPagePath * ga:nextPagePath

  • La navigazione nelle pagine di destinazione viene ora mostrata tramite le seguenti dimensioni:

    D3. Contenuti * ga:landingPagePath * ga:secondPagePath

  • La lunghezza massima delle espressioni regolari nel parametro di query di filtro del feed di dati è stata aumentata da 32 a 128 caratteri.

  • Il report Durata della visita, disponibile nell'interfaccia utente in Visitatori -> Fedeltà dei visitatori, viene ora presentato tramite la nuova dimensione:

    • ga:visitLength

Questa versione aggiorna l'API di esportazione dei dati di Google Analytics nel seguente modo:

  • Alcune limitazioni sulle combinazioni di dimensioni e metriche sono state allentate. Ora puoi eseguire query sulla maggior parte delle dimensioni di contenuti e a livello di visitatore, ad esempio ga:pagePath e ga:source ora sono una combinazione valida. Consulta la guida di riferimento aggiornata per queste nuove combinazioni: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • Il numero totale di righe che è possibile richiedere in una singola richiesta è stato aumentato a 10.000. Il numero predefinito di righe restituite è ancora 1000, ma ora può essere aumentato impostando il parametro di query max-results.

  • Il feed dell'account ora restituisce due nuovi elementi di dati per ogni ID tabella (valuta e fuso orario).

  • Ora applichiamo che le query sui dati devono includere almeno una metrica valida.

  • Sono state applicate tutte le precedenti modifiche al ritiro.

Questa release rimuove le funzionalità deprecate dalla nostra versione beta privata:

  • Le richieste di feed dell'account non supporteranno più un nome utente. ma accetterà solo richieste nel seguente formato:
    https://www.google.com/analytics/feeds/accounts/default

  • Le seguenti metriche sono in fase di rimozione e non funzioneranno più. Abbiamo fornito invece istruzioni su come calcolare questi valori qui: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:abandonedFunnels1
    • ga:abandonedFunnels2
    • ga:abandonedFunnels3
    • ga:abandonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • Le seguenti dimensioni e metriche sono state rinominate. I nomi precedenti non funzioneranno più. Accertati di utilizzare i nomi ufficiali riportati nella nostra documentazione all'indirizzo: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html.

    Dimensioni * ga:subContinentRegion → ga:subContinent * ga:organization fin:ga:networkLocation

    ga:gaGAcompletamenti:gagaobiettivo3