Log delle modifiche all'API Core Reporting di Google Analytics

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 ID utente in un determinato intervallo di date. È destinata principalmente a supportare i proprietari di immobili 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.

Con questa release, il sistema di quote basate sulle risorse per la versione 4 dell'API Google Analytics Reporting è disponibile per tutti i clienti di Analytics 360 (Premium).

Questa release aumenta il numero massimo di righe restituite nel set di risultati della versione 4 dell'API Analytics Reporting.

Il numero massimo di righe restituite nell'oggetto ReportData della versione 4 dell'API Analytics Reporting viene aumentato da 10.000 a 100.000.

In questa versione viene aggiunta un'anteprima del sistema di quote basate sulle risorse per la versione 4 dell'API Google Analytics Reporting, che consente di utilizzare soglie di campionamento più elevate per i clienti di Analytics 360 (Premium).

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

Prodotti correlati

Questa release ritira 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 release aggiunge una nuova dimensione all'API. Consulta la sezione Riferimento dimensioni e metriche per l'elenco completo delle definizioni. Questa release rimuove anche diverse dimensioni e metriche ritirate. Consulta le Norme sul ritiro dei dati per le API di Google Analytics per comprendere la procedura completa di rimozione dei dati.

Tempo

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

Rimozione dei dati

Questa release rimuove le seguenti dimensioni e metriche obsolete:

• 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 sezione 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 metriche. Per saperne di più, consulta la sezione 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 un giorno per ogni giorno nel periodo di tempo richiesto.
• ga:7dayusers: numero totale di utenti attivi in sette 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 in 30 giorni per ogni giorno nel periodo di tempo richiesto.

Eventi unici

Stiamo per raggiungere la fine del periodo di deprecazione per ga:uniqueEvents. 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 i documenti della guida sugli 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 di AdSense.

Dimensioni utente

• Dimensione ga:userBucket. Per ogni utente, la dimensione Bucket utente (con 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 avrebbe restituito un messaggio di errore errato, Unknown dimension(s): o Unknown metric(s): quando richiedevano 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

Le viste non collegate ad AdSense non potranno eseguire query su dimensioni e metriche di AdSense. L'esecuzione di query per 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 di AdSense e annuncia un'imminente modifica a queste dimensioni e metriche.

Dimensioni e metriche di AdSense

In questa versione è stato corretto un problema iniziato il 7/1/2017 per cui l'esecuzione di query su dimensioni e metriche di AdSense restituiva un errore "Metrica sconosciuta" per le viste non collegate ad AdSense.

Modifiche imminenti

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

In questa release è stata aggiunta la nuova metrica riportata di seguito all'API. Per l'elenco completo delle definizioni, consulta la sezione 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 della metrica calcolata definito dall'utente. Tieni presente che il tipo di dati di ga:calcMetric_ può essere FLOAT, INTEGER, CURRENCY, TIME o PERCENT. Per maggiori dettagli, consulta 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 sezione Riferimento dimensioni e metriche.

Monitoraggio eventi

La definizione di ga:uniqueEvents verrà modificata 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 mantiene l'attuale definizione di ga:uniqueEvents. Una volta trascorso il periodo di tempo previsto per il ritiro (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 sugli 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. Usa invece ga:uniqueDimensionCombinations se vuoi mantenere la definizione esistente. Per ulteriori informazioni, consulta i documenti della guida sugli 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 i documenti della guida sugli 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 documento di riferimento su dimensioni e metriche.

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

DoubleClick Bid Manager

• Dimensione - ga:dbmClickAdvertiser: 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: nome della piattaforma di scambio pubblicitario DBM del clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
• Dimensione - ga:dbmClickExchangeId: l'ID piattaforma di scambio DBM del clic DBM corrispondente alla sessione di Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
• Dimensione - ga:dbmClickInsertionOrder: 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: 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 dell'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: 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 DBM) associato alla sessione Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
• Dimensione - ga:dbmLastEventAdvertiserId: l'ID inserzionista DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale DBM) associato alla sessione Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
• Dimensione - ga:dbmLastEventCreativeId: l'ID creatività DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale DBM) associato alla sessione Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
• Dimensione - ga:dbmLastEventExchange. Il nome della piattaforma di scambio DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale DBM) associato alla sessione Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
• Dimensione - ga:dbmLastEventExchangeId: l'ID piattaforma di scambio DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale DBM) associato alla sessione 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 DBM) associato alla sessione Google Analytics (solo Analytics 360, richiede l'integrazione con DBM).
• Dimensione - ga:dbmLastEventInsertionOrderId: l'ID ordine di inserzione DBM dell'ultimo evento DBM (impressione o clic nella finestra temporale DBM) associato alla sessione 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 DBM) associato alla sessione 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 DBM) associato alla sessione 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 DBM) associato alla sessione 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 DBM) associato alla sessione 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 per 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).

DoubleClick Search

• 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 per clic dell'inserzionista in DS (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 release aggiunge una nuova dimensione all'API. Questa release aggiunge anche alcune limitazioni sulla combinazione di dimensioni su cui è possibile eseguire query insieme. Per l'elenco completo delle definizioni, consulta la sezione Riferimento dimensioni e metriche.

Rete geografica

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

Restrizioni

Non è possibile eseguire query sulle seguenti dimensioni nei seguenti gruppi con le dimensioni degli altri 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 interna:
  • ga:internalPromotionCreative
  • ga:internalPromotionId
  • ga:internalPromotionName
  • ga:internalPromotionPosition
• Gruppo di interesse per il branding:
  • ga:interestAffinityCategory

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

Segnalazione di errori

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

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

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 al massimo 4 dimensioni.
• Le dimensioni pivot fanno parte della limitazione al numero totale di dimensioni consentite nella richiesta.
• Le metrics pivot fanno parte della limitazione al numero totale di metriche consentite nella richiesta.

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

Rete geografica

• Dimensione - ga:metroId: il codice a tre cifre della Designated Market Area (DMA) da cui è arrivato il traffico, derivato 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 un singolo annuncio viene visualizzato sul sito web. 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 attivata)."
• Metrica - ga:dfpCoverage: la copertura indica la percentuale di richieste di annunci che hanno generato la visualizzazione di 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 attivato)."
• Metrica - ga:dfpMonetizedPageviews: misura il numero totale di visualizzazioni di pagina sulla proprietà visualizzate in 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 attivato)."
• 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 attivata)."
• Metrica - ga:dfpViewableImpressionsPercent - La percentuale di impressioni dell'annuncio visibili. Un'impressione viene considerata visibile quando viene mostrata nei browser degli utenti e ha l'opportunità di essere visualizzata (collegamento DFP attivato e Nascondi entrate DFP non attivata)."
• 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 attivata)."
• 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 attivata)."
• 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 attivata)."
• Metrica - ga:dfpRevenuePer1000Sessions: il totale delle entrate stimate generate dagli annunci DFP ogni 1000 sessioni di Analytics. Tieni presente che questa metrica si basa sulle sessioni del sito, non sulle impressioni dell'annuncio (collegamento DFP attivato e Nascondi entrate DFP non attivato)."
• Metrica - ga:dfpECPM. Il costo effettivo per mille visualizzazioni di pagina. Si tratta delle entrate di 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 pubblicati 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 attivata)."
• Metrica: ga:backfillCoverage: la copertura di backfill è la percentuale di richieste di annunci di backfill che hanno restituito 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 rappresenta la media ponderata dei due account di backfill (collegamento DFP attivato e Nascondi entrate DFP non attivata).
• Metrica - ga:backfillMonetizedPageviews: misura il numero totale di visualizzazioni di pagina sulla proprietà mostrate con almeno un annuncio dagli account backfill collegati. Tieni presente che una singola visualizzazione di pagina monetizzata può includere più impressioni di annunci (collegamento DFP attivato e Nascondi entrate DFP non attivato)."
• 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 attivata)."
• Metrica - ga:backfillViewableImpressionsPercent: la percentuale di impressioni dell'annuncio backfill visibili. Un'impressione è considerata visibile quando è apparsa all'interno dei browser degli utenti e ha avuto l'opportunità di essere vista. Se AdSense e Ad Exchange forniscono entrambi annunci di backfill, questa metrica corrisponde alla media ponderata dei due account di backfill (collegamento DFP attivato e Nascondi entrate DFP non attivata).
• Metrica - ga:backfillClicks: il numero di volte in cui è stato fatto clic sugli annunci di backfill nel sito. Se AdSense e Ad Exchange forniscono entrambi annunci di backfill, questa metrica è la somma dei due account backfill (collegamento DFP attivato e Nascondi entrate DFP non attivata)."
• Metrica - ga:backfillCTR: la percentuale di impressioni backfill che ha generato un clic su un annuncio. Se AdSense e Ad Exchange forniscono entrambi annunci di backfill, questa metrica corrisponde alla media ponderata dei due account di backfill (collegamento DFP attivato e Nascondi entrate DFP non attivata).
• Metrica - ga:backfillRevenue: le entrate stimate totali generate dagli annunci backfill. Se AdSense e Ad Exchange forniscono entrambi annunci di backfill, questa metrica è la somma dei due account backfill (collegamento DFP attivato e Nascondi entrate DFP non attivata)."
• Metrica - ga:backfillRevenuePer1000Sessions: le entrate totali stimate provenienti dagli annunci di backfill ogni 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 attivata)."
• 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 attivata)."

Questa è 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 del segmento Tutti gli utenti (gaid::-1) nella API di reporting principale V3 e la suddivisione in due segmenti nella API di reporting di Analytics V4.

Campionamento

In questa release corregge un problema per cui un sottoinsieme di richieste da tabelle personalizzate restituisce dati campionati.

Questa è una release per la correzione di bug, che corregge un problema durante l'invio di richieste relative alla coorte V4 dell'API Analytics Reporting.

Richieste di coorte

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

LTV richieste relative al 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 Analytics Reporting 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 di dati. L'API offre agli sviluppatori l'accesso alla potenza della piattaforma Google Analytics. Di seguito sono riportate alcune funzionalità chiave della versione 4 dell'API di reporting di Analytics:

• 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 la richiesta di due intervalli di date, che consente di confrontare i dati di due periodi in una singola richiesta.
• Coorti e lifetime value: l'API ha un ampio vocabolario per richiedere report sulle coorti e sul lifetime value.
• Più segmenti: ora puoi richiedere più segmenti in una singola richiesta.

Per iniziare

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

Criteri per le quote

L'API Analytics Reporting 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 di compatibilità Python su GitHub.

Dimensioni e metriche

Questa release aggiunge anche un insieme di dimensioni e metriche specifiche per la versione 4 dell'API Analytics Reporting. Per le definizioni complete degli elenchi, consulta Esplorazione dimensioni ed metriche.

• Dimensione - ga:cohort: nome della coorte a cui appartiene un utente in base alla definizione delle coorti. In base a 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 - Differenza di giorni in base a 0 rispetto 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 2015-09-04, ga:cohortNthDay sarà 3.

• ga:cohortNthMonth: offset mensile in base a 0 rispetto alla data di definizione della coorte.

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

• Dimensione - ga:acquisitionTrafficChannel. Il 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 predefinite di raggruppamento dei canali (a livello di vista, se disponibili) al momento dell'acquisizione degli utenti.

• Dimensione - ga:acquisitionSource. L'origine tramite la quale l'utente è stato acquisito. Valore derivato dalla prima sessione dell'utente.

• Dimensione - ga:acquisitionMedium. Il mezzo tramite il quale l'utente è stato acquisito. Valore derivato dalla prima sessione dell'utente.

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

• Dimensione: ga:acquisitionCampaign la campagna tramite la quale l'utente è stato acquisito. Valore derivato dalla prima sessione dell'utente.

• Metrica - ga:cohortActiveUsers - Questa metrica è pertinente nel contesto delle dimensioni di offset su base 0 (ga:cohortNthDay, ga:cohortNthWeek o ga:cohortNthMonth). Indica il numero di utenti della coorte attivi nella finestra temporale corrispondente all'ennesimo 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 della coorte.

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

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

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

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

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

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

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

• Metrica - ga:cohortTotalUsersWithLifetimeCriteria. È pertinente nel contesto di una richiesta con 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 nessuna delle dimensioni menzionate è presente, il suo valore è ga:cohortTotalUsers.

• Metrica - ga:cohortAppviewsPerUserWithLifetimeCriteria - Visualizzazioni di app per utente per la dimensione 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 Acquisizione di una coorte.

• Metrica - ga:cohortRevenuePerUserWithLifetimeCriteria - Entrate per utente per la dimensione 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 di Social Data Hub 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 base alle Norme sulla deprecazione dei dati, queste dimensioni e metriche verranno rimosse dopo il 30 settembre 2016.

Per l'elenco completo delle definizioni, consulta la sezione 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à dell'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à dell'hub di dati social, si tratta del titolo dell'attività social pubblicata dagli utenti del social network.
• Dimensione - ga:socialActivityPost.Per un'attività dell'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à dell'hub di dati social, è il momento 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à dell'hub di dati social, si tratta di un insieme di tag separati da virgole associati all'attività social."
• Dimensione - ga:socialActivityAction. Per un'attività dell'hub di dati social, rappresenta il tipo di azione social (ad esempio voto, commento, +1 e così via) associato all'attività.
• Dimensione - ga:socialActivityNetworkAction. Per un'attività dell'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 sulla rete di un partner di hub di dati social.

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

Piattaforma o dispositivo

• Dimensione - ga:browserSize: le dimensioni dell'area visibile dei browser degli utenti. La dimensione del browser è una dimensione basata sulle sessioni che 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 e non costituisce una modifica che provoca un errore, pertanto non dovrebbe richiedere un aggiornamento del codice. Per maggiori dettagli, consulta la documentazione di riferimento dell'API di reporting principale.

In questa release sono state aggiunte nuove metriche all'API. Per l'elenco completo delle definizioni, consulta la sezione 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 tra 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 1 giorno che termina alla data specificata.
• Metrica - ga:7dayUsers: numero totale di utenti attivi negli ultimi 7 giorni per ogni giorno nel periodo di tempo richiesto. Per eseguire query su questa metrica, è necessario specificare almeno un valore tra ga:nthDay, ga:date o ga:day come dimensione. Per la data specificata, il valore restituito corrisponderà al totale degli 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 tra ga:nthDay, ga:date o ga:day come dimensione. Per la data specificata, il valore restituito corrisponderà al totale degli 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 tra 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 30 giorni che termina alla data specificata.

In questa release sono state aggiunte nuove metriche all'API. Per l'elenco completo delle definizioni, consulta la sezione 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 che hanno generato la visualizzazione di almeno un annuncio. In genere, la copertura può aiutarti a identificare i siti nei quali il tuo account AdX non è in grado di fornire annunci mirati. (Impressioni dell'annuncio / Totale richieste di annunci) * 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 un singolo annuncio viene visualizzato sul sito web. 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: il totale delle entrate stimate generate dagli annunci AdX.
• Metrica - ga:adxRevenuePer1000Sessions: il totale delle entrate stimate generate dagli annunci AdX per 1000 sessioni di 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 versione ritira le dimensioni o le metriche esistenti. Per l'elenco completo delle definizioni, consulta la sezione 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 release aggiunge una nuova dimensione all'API. Per l'elenco completo di dimensioni e metriche, consulta la sezione Riferimento per dimensioni e metriche.

AdWords

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

In questa release sono state aggiunte nuove dimensioni all'API. Per l'elenco completo di dimensioni e metriche, consulta la sezione Riferimento per 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.

Ricerca interna

• Dimensione - ga:searchAfterDestinationPage. La pagina che l'utente ha visitato 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 sezione Riferimento dimensioni e metriche.

ECommerce

• Metrica - ga:transactionsPerUser: il numero totale di transazioni diviso per il numero totale di utenti.
• Metrica - ga:revenuePerUser. Le entrate totali derivanti dalle vendite fornite nella transazione, escluse spese di spedizione e tasse, divise 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, derivato 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 forniti 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 forniti 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 - Usa invece ga:dcmROAS. + Metrica - ga:dcmMargen - Usa invece ga:dcmROAS.

In questa release è stata aggiunta una nuova metrica all'API e vengono ritirate due metriche esistenti. Consulta la Guida di riferimento a dimensioni e metriche per l'elenco completo delle definizioni.

AdWords

• Metrica - ga:ROAS: il ritorno sulla spesa pubblicitaria (ROAS) indica le entrate totali delle transazioni e il valore dell'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 - Usa invece ga:ROAS. + Metrica - ga:margin - Usa invece ga:ROAS.

In questa release sono state aggiunte nuove metriche all'API. Consulta la Guida di riferimento a dimensioni e metriche per l'elenco completo delle definizioni.

AdSense

• Metrica - ga:adsenseCoverage: la percentuale di richieste di annunci che hanno restituito almeno un annuncio.
• Metrica - ga:adsenseViewableImpressionPercent: la percentuale di impressioni visibili.

Questa versione include l'aggiunta di una nuova metrica relativa alla sessione, di una nuova dimensione Sorgenti di traffico e di nuove dimensioni e metriche di DoubleClick Campaign Manager.

Dimensioni e metriche

Per l'elenco completo delle definizioni, consulta la sezione 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, tempi 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 Google Analytics (solo Premium).
• Dimensione - ga:dcmClickAdId: l'ID annuncio DCM del clic DCM corrispondente alla sessione Google Analytics (solo Premium).
• Dimensione - ga:dcmClickAdType. Il nome del tipo di annuncio DCM del clic DCM corrispondente alla sessione Google Analytics (solo premium).
• Dimensione - ga:dcmClickAdTypeId: ID del tipo di annuncio DCM del clic DCM corrispondente alla sessione Google Analytics (solo Premium).
• Dimensione - ga:dcmClickAdvertiser: nome dell'inserzionista DCM del clic DCM corrispondente alla sessione Google Analytics (solo Premium).
• Dimensione - ga:dcmClickAdvertiserId - L'ID inserzionista DCM del clic DCM corrispondente alla sessione Google Analytics (solo Premium).
• Dimensione - ga:dcmClickCampaign. Nome della campagna DCM del clic DCM corrispondente alla sessione Google Analytics (solo premium).
• Dimensione - ga:dcmClickCampaignId: ID campagna DCM del clic DCM corrispondente alla sessione Google Analytics (solo premium).
• Dimensione - ga:dcmClickCreative. 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 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: versione della creatività DCM del clic DCM corrispondente alla sessione Google Analytics (solo premium).
• Dimensione - ga:dcmClickRenderingId: ID di rendering DCM del clic DCM corrispondente alla sessione Google Analytics (solo premium).
• Dimensione - ga:dcmClickSite. Nome del sito in cui la creatività DCM è stata pubblicata e ha fatto clic per il clic DCM corrispondente alla sessione Google Analytics (solo premium).
• Dimensione - ga:dcmClickSiteId. ID sito DCM in cui è stata pubblicata e selezionata la creatività DCM per il clic DCM corrispondente alla sessione Google Analytics (solo premium).
• Dimensione - ga:dcmClickSitePlacement. Nome del posizionamento nel sito DCM del clic DCM corrispondente alla sessione Google Analytics (solo premium).
• Dimensione - ga:dcmClickSitePlacementId: ID posizionamento del sito DCM del clic DCM corrispondente alla sessione Google Analytics (solo premium).
• Dimensione - ga:dcmClickSpotId: ID di configurazione Floodlight in DCM del clic DCM corrispondente alla sessione 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 associati 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 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 configurazione Floodlight in DCM associato alla conversione Floodlight (solo Premium).
• Dimensione - ga:dcmLastEventAd: nome annuncio DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione 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 Google Analytics (solo Premium).
• Dimensione - ga:dcmLastEventAdType. Il nome del tipo di annuncio DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione Google Analytics (solo Premium).
• Dimensione - ga:dcmLastEventAdTypeId: ID tipo di annuncio DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione 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 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 Google Analytics (solo Premium).
• Dimensione - ga:dcmLastEventAttributionType. Sono possibili due valori (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à Viewthrough (solo premium).
• Dimensione - ga:dcmLastEventCampaign: nome della campagna DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione 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 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 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 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 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 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 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 Google Analytics (solo premium).
• Dimensione - ga:dcmLastEventSite. Nome del sito in cui la creatività DCM è stata mostrata e selezionata per l'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione Google Analytics (solo premium).
• Dimensione - ga:dcmLastEventSiteId: ID sito DCM in cui la creatività DCM è stata mostrata e selezionata per l'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione Google Analytics (solo premium).
• Dimensione - ga:dcmLastEventSitePlacement. Il nome del posizionamento del sito DCM dell'ultimo evento DCM (impressione o clic nella finestra temporale di DCM) associato alla sessione 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 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 Google Analytics (solo Premium).
• Metrica - ga:dcmFloodlightQuantity: il numero di conversioni Floodlight DCM (solo premium).
• Metrica - dcmFloodlightRevenue - Entrate Floodlight in DCM (solo premium).

In questa versione sono state aggiunte nuove dimensioni e metriche di raggruppamento di contenuti.

Dimensioni e metriche

Per l'elenco completo delle definizioni, consulta la sezione 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.
• Dimensione - ga:contentGroupXX. Gruppo di contenuti su 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 all'espressione regolare titolo/URL della pagina o da regole predefinite.
• Dimensione - ga:previousContentGroupXX: si riferisce al gruppo di contenuti che è stato visitato prima di un altro raggruppamento.
• Metrica - ga:contentGroupUniqueViewsXX. Il numero di pagine diverse (uniche) all'interno di una sessione per il gruppo di contenuti specificato. Questo prende in considerazione sia pagePath che pageTitle per determinare l'unicità.

Questa versione include una nuova condizione dateOfSession per i Segmenti e l'aggiunta di nuove dimensioni e metriche 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 maggiori dettagli, consulta la Guida per gli sviluppatori di segmenti.

Dimensioni e metriche

Consulta la sezione 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 sulla pagina web o sulla schermata dell'applicazione.
• Dimensione - ga:orderCouponCode. 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 prodotto, 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. Le 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 in 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 per un determinato prodotto nella valuta locale.
• Metrica - ga:localRefundAmount: importo totale del rimborso per la 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 quando è comparso nell'elenco dei prodotti.
• Metrica - ga:productListViews: numero di volte in cui il prodotto è comparso in un elenco di prodotti.
• Metrica - ga:productListCTR: la frequenza con cui gli utenti hanno fatto clic su un 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 utilizzato con il codice coupon prodotto).
• Metrica - ga:buyToDetailRate - Acquisti unici diviso per le 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 - Importo in valuta 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 sezione Riferimento dimensioni e metriche.

Sistema

• Dimensione - ga:sourcePropertyDisplayName. 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).

Prodotti correlati

• Dimensione - ga:correlationModelId - ID modello di correlazione per i prodotti correlati.
• Dimensione - ga:queryProductId: ID del prodotto oggetto della query.
• Dimensione - ga:queryProductName. Il 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: il 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 - La quantità del prodotto correlato.

Correzione nome colonna intestazione

• C'era un bug nella release 16/04/2014; se hai chiesto una dimensione o una metrica deprecata, l'API restituisceva le intestazioni di colonna con la dimensione o la metrica sostitutiva. Ora restituisce correttamente lo stesso nome di dimensione o metrica utilizzato nella richiesta.

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

Nuove dimensioni e metriche

Le seguenti dimensioni sono state aggiunte all'API Core Reporting:

AdWords

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

Tempo

• Dimensione - ga:nthHour. Indice per ogni ora nell'intervallo di date specificato. L'indice per la 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 sui visitatori e visita sono state rinominate in modo da utilizzare rispettivamente l'utilizzo di 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.

Ricerca interna

• 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 Core Reporting.

• Il parametro segment ora supporta i segmenti di utenti e sequenze. È 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 lo sviluppo di segmenti
• Il prefisso dynamic:: è stato ritirato. Ti consigliamo di migrate alla nuova sintassi il prima possibile.

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

Output tabella dati

Per semplificare il rendering dei dati di Google Analytics utilizzando le visualizzazioni dei grafici di Google, l'API può facoltativamente restituire un oggetto Tabella di 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, nella risposta è inclusa una proprietà dataTable che contiene un oggetto Tabella dati. Questo oggetto può essere utilizzato direttamente con Google Graph. Per maggiori dettagli, consulta la documentazione sull'API di reporting principale.

Nuove dimensioni e metriche

Le seguenti dimensioni e metriche sono state aggiunte all'API Core Reporting:

Tempo

• Dimensione - ga:minute - Restituisce il minuto nell'ora. I valori possibili sono compresi tra 00 e 59.
• Dimensione - ga:nthMinute. Indice per 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 di 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 sono più propensi 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ù pronti ad acquistare.

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.Usa invece ga:deviceCategory (ad es. ga:deviceCategory==mobile).
• Dimensione - ga:isTablet.Usa invece ga:deviceCategory (ad es. ga:deviceCategory==tablet).
• Metrica - ga:entranceBounceRate. Usa invece ga:visitBounceRate.

In questa release sono state aggiunte nuove dimensioni e metriche all'API. Consulta la Guida di riferimento a dimensioni e metriche per l'elenco completo delle definizioni.

AdSense

• È stato aggiunto l'accesso ai dati AdSense:

  • Soddisfatte - ga:adsenseRevenue - Le entrate totali generate dagli annunci AdSense.
  • Soddisfatto - ga:adsenseAdUnitsViewed - Il numero di unità pubblicitarie AdSense visualizzate. Un'unità pubblicitaria è un insieme di annunci pubblicati 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.
  • Soddisfatta - ga:adsenseCTR: la percentuale di impressioni sulla pagina che ha generato 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:adsensePageImpressioni/1000).
  • Raggiunto - ga:adsenseExits: il numero di sessioni terminate in seguito al clic di un utente su un annuncio AdSense.

Tempo

• 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.
• Diminuisci ulteriormente ga:isoYearIsoWeek - Valori combinati di ga:isoYear e ga:isoWeek.

AdWords

• Questi dati sono disponibili nei report AdWords:

  • Attenuato - ga:adKeywordMatchType: i tipi di corrispondenza applicati alle tue parole chiave (a frase, esatta, generica). Dettagli: Informazioni sul report sui termini di ricerca.

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

Date relative

• Nell'API Core Reporting è stato aggiunto il supporto per le 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 determinerà 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 un 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 Riferimento API e il Campionamento.

Correzioni di bug

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

Nell'ambito del lancio dei 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 legacy continueranno a essere supportati per 6 mesi. Consigliamo di utilizzare applicazioni che salvano gli ID dei segmenti utenti per 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, i nuovi segmenti predefiniti non sono attualmente supportati.

In questa release sono state aggiunte nuove dimensioni e metriche all'API. Consulta la Guida di riferimento a dimensioni e metriche per l'elenco completo delle definizioni.

Monitoraggio app

• Questi dati sono disponibili nei report del profilo dell'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 l'app è stata scaricata. 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.
  • Attenuazione - ga:screenDepth: il numero di visualizzazioni di schermate per sessione riportato 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 di visualizzazione della schermata corrente.
  • Raggiunto - ga:screenviews: il numero totale di visualizzazioni di schermata. Usa questo valore anziché ga:appviews.
  • Soddisfatto - ga:uniqueScreenviews: il numero di ga:screenviews diversi (unici) in una sessione. Usa questo valore anziché ga:uniqueAppviews.
  • Soddisfatto - ga:screenviewsPerSession: il numero medio di ga:screenviews per sessione. Usa questo valore anziché ga:appviewsPerVisit.

Deprecata

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

• Raggiunto - ga:appviews. Usa invece ga:screenviews.
• Raggiunto - ga:uniqueAppviews. Usa invece ga:uniqueScreenviews.
• Raggiunto - 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 fa riferimento al numero/indice della dimensione personalizzata.
  • Met - 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 di 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 valuta locale della transazione in base allo standard ISO 4217.
• Soddisfatto - ga:localItemRevenue - Entrate generate dal prodotto in valuta locale.
• Met - ga:localTransactionRevenue - Entrate da transazioni in valuta locale.
• Soddisfatto - ga:localTransactionShipping - Costo di spedizione della transazione in valuta locale.
• Met - 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 che corrisponde a qualsiasi completamento dell'obiettivo per 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 destinazione, tre passaggi prima della posizione di completamento dell'obiettivo.

Modifiche alla documentazione

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

• ga:goal(n)AbandonRate → ga:goalXXAbandonRate
• ga:goal(n)Abandons → ga:goalXXAbandons
• ga:goal(n)Completions → ga:goalXXCompletions
• ga:goal(n)ConversionRate → ga:goalXXConversionRate
• ga:goal(n)Starts → ga:goalXXStarts
• ga:goal(n)Value → ga:goalXXValue
• ga:searchGoal(n)ConversionRate → ga:searchGoalXXConversionRate

Ricerca interna

• Soddisfatto - ga:percentSearchRefinements: la percentuale di volte in cui un perfezionamento (ovvero una transizione) si verifica tra le parole chiave per la ricerca interna all'interno di una sessione.

Monitoraggio pagine

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

Piattaforma o dispositivo

• Questi dati provengono 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 il 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.

Tempo

• Diminuisci ulteriormente ga:dateHour - Valori combinati di ga:date e ga:hour.
• Attenuato - ga:dayOfWeekName. Il nome del giorno della settimana (in inglese).
• Attenuato - ga:isoWeek: il numero della settimana ISO, in cui ogni settimana inizia con un lunedì. Dettagli: http://en.wikipedia.org/wiki/ISO_week_date.
• Diminuisci ulteriormente ga:yearMonth - Valori combinati di ga:year e ga:month.
• Diminuisci ulteriormente 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.
• Dim - ga:sourceMedium. I valori combinati di ga:source e ga:medium.

• In questa release sono state aggiunte due nuove metriche per gli esperimenti: - ga:experimentId - ga:experimentVariant

• In questa release sono state aggiunte cinque nuove metriche relative alla velocità del sito:
  • ga:domInteractiveTime
  • ga:avgDomInteractiveTime
  • ga:domContentLoadedTime
  • ga:avgDomContentLoadedTime
  • ga:domLatencyMetricsSample

• In questa release è stato aggiunto un nuovo segmento predefinito per il traffico da tablet, gaid::-13.

In questa release sono state aggiunte nuove dimensioni e metriche all'API. Consulta la Guida di riferimento a dimensioni e metriche per conoscere le definizioni.

Monitoraggio app

• Questi dati sono disponibili nei report dell'SDK di monitoraggio dell'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, oppure al social network per le attività di social data hub. Ad es. Google+, Blogger, reddit ecc.
• Attenuato - ga:hasSocialSourceReferral: indica le visite che sono 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 in maiuscolo.

Attività social

• Questi dati provengono da attività esterne al sito importate dai partner dell'hub di dati social.
  • Attenuato - ga:socialActivityDisplayName: per un'attività dell'hub di dati social, questa stringa rappresenta il titolo dell'attività social pubblicato dall'utente del social network.
  • Attenuato - ga:socialActivityEndorsingUrl: per un'attività dell'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à dell'hub di dati social, questa stringa rappresenta i contenuti dell'attività social pubblicato dall'utente del social network (ad es. il contenuto del messaggio di un post di Google+)
  • Attenuato - ga:socialActivityTimestamp: per un'attività dell'hub di dati social, questa stringa rappresenta quando si è verificata l'attività social sul social network.
  • Attenuato - ga:socialActivityUserPhotoUrl: per un'attività dell'hub di dati social, questa stringa rappresenta l'URL della foto associata al profilo di social network dell'utente.
  • Attenuato - ga:socialActivityUserProfileUrl: per un'attività hub di dati social, questa stringa rappresenta l'URL del profilo di social network dell'utente associato.
  • Attenuato - ga:socialActivityContentUrl: per un'attività dell'hub di dati social, questa stringa rappresenta l'URL condiviso dall'utente del social network associato.
  • Attenuato - ga:socialActivityTagsSummary: per un'attività dell'hub di dati social, si tratta di un insieme di tag separati da virgole 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 associato all'attività (ad esempio voto, commento, +1 e così via).
  • Attenuato - ga:socialActivityNetworkAction: per un'attività dell'hub di dati social, questa stringa rappresenta il tipo di azione social e il social network da cui ha avuto origine l'attività.
  • Soddisfatto - ga:socialActivities: il numero di attività in cui un URL di contenuti è stato condiviso/menzionato su una rete partner di 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, segnalibro)
  • 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
  • Raggiunto - 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 aggrega tutti i pagePath nel primo livello gerarchico in pagePath.
• Attenuato - ga:pagePathLevel2: questa dimensione aggrega tutti i pagePath nel secondo livello gerarchico in pagePath.
• Attenuato - ga:pagePathLevel3: questa dimensione aggrega tutti i pagePath di terzo livello gerarchico in pagePath.
• Attenuato - ga:pagePathLevel4: questa dimensione aggrega tutti i pagePath nel quarto livello gerarchico in pagePath. Tutti i livelli aggiuntivi della gerarchia pagePath sono raggruppati anche in questa dimensione.

Monitoraggio eccezioni

• Questi dati provengono da 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 del tempo utente.

  • Attenuato - ga:userTimingCategory - Una stringa per classificare tutte le variabili dei tempi utente in gruppi logici per semplificare la generazione di report.
  • Attenuato - ga:userTimingLabel: una stringa per indicare 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 - Nome del produttore o del brand del dispositivo mobile (ad es. Samsung, HTC, Verizon, T-Mobile).
  • Attenuato - ga:mobileDeviceModel - Modello del dispositivo mobile (esempio: Nexus S)
  • Attenuato - ga:mobileInputSelector - Selettore utilizzato sul dispositivo mobile (ad esempio: touchscreen, joystick, rotellina, stilo)
  • Dim - ga:mobileDeviceInfo: il branding, il modello e il nome commerciale utilizzati per identificare il dispositivo mobile.

Correzioni di bug

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

Questa release 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 Guida di riferimento a dimensioni e metriche per conoscere le definizioni.

Promemoria sul ritiro dell'API versione 2.3

• 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 le nuove versione 3.0 e 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 saranno applicati alle richieste della versione 2.3.

• Tutte le richieste per la versione JSON 2.3 o per la libreria client JavaScript di Google Data 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 token OAuth 2.0) in ogni richiesta.

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

Questa versione è valida per tutti gli sviluppatori dell'API Google Analytics. Annuncia due nuove versioni dell'API, richiede la registrazione delle applicazioni, introduce una nuova norma per le quote e cambia il nome dell'API in API Core Reporting. Infine, ritira la versione 2.3 dell'API di esportazione dei dati esistente.

Versione 3.0

• La versione 3.0 dell'API Core Reporting è l'ultima versione principale dell'API e non è compatibile con le versioni precedenti. Tutto lo sviluppo futuro dell'API verrà effettuato su questa versione.

• Nuove funzionalità

  • Il nuovo output basato su JSON riduce le dimensioni della risposta di circa 10 volte 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 degli sviluppatori.
  • Tutte le richieste di dati di configurazione devono essere effettuate tramite l' API di gestione.

Versione 2.4

• L'API Core Reporting versione 2.4 è un upgrade di versione secondaria per lo più compatibile con le versioni precedenti dell'API di esportazione dati versione 2.3.

• Aggiornamenti

  • Nuovo URL per effettuare richieste: https://www.googleapis.com/analytics/v2.4/data…
  • Sono richiesti i token di registrazione e degli sviluppatori.
  • L'output XML è conforme alla versione 2.3, pertanto le altre librerie client di dati di Google esistenti continueranno a funzionare.
  • Codice di errore per errori di quota cambiato da 503 a 403
  • Le risposte JSON non sono supportate.
  • Libreria client JavaScript di Google Data 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 Analytics (API di gestione e API di esportazione 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 domande non registrate, offriamo una quota di tolleranza molto bassa per consentire un numero limitato di test.

Deprecazioni

• Questa release annuncia anche il ritiro della versione 2.3 e l'imminente disattivazione del feed account nell'API Data Export. Tra 6 mesi:

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

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

  • Le richieste 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 più aggiornati di AdWords e più combinazioni per le dimensioni e le metriche di AdWords.

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

• Abbiamo attenuato un numero di combinazioni valide con i dati di AdWords.

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

Questa release corregge 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.
  • Impossibile combinare ga:adContent o ga:adGroup con ga:impressions.

  Anziché restituire una risposta con 0 risultati, l'API ora restituisce un 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, non utilizzare più i valori dell'intervallo di confidenza per le metriche. Con questa versione, il feed di dati dell'API di esportazione dei dati restituisce 0,0 per tutti i valori dell'intervallo di confidenza. Tra un mese circa rimuoveremo questo attributo da tutti gli elementi delle metriche.

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

In questa release sono state aggiunte tre nuove metriche e viene aggiornato 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 del rendimento

• Questa release migliora la latenza dei 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

• Attualmente, devi specificare un valore del filtro di valuta sotto forma di unità micro, ad esempio 1 unità di valuta viene indicata come 1000000. Nel prossimo futuro, dovrai specificare il valore effettivo trasmesso dal codice di monitoraggio, ad esempio 1 unità verrà ora specificata come 1.

• Attualmente, ga:CTR è un percent e restituisce il valore 0,02. Nel prossimo futuro questo valore cambierà per restituire 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 temporale: 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 e gestire questa particolare eccezione.

Questa versione 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 3 nuove dimensioni basate sul tempo: ga:nthDay, ga:nthWeek, 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 dai calcoli che utilizzano le metriche di base. Nota: ogni nome con (n) supporta i valori 1-20.

• Basato sugli 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.

• Basati 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 release è 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, aggiungevi un operatore OR a un'espressione di filtro con una dimensione (ad es. ga:keyword==store,ga:keyword==bar) potrebbe restituire valori diversi rispetto a quando ogni filtro fosse applicato singolarmente a più query. Il problema è stato risolto e l'utilizzo dell'operatore OPPURE ora restituisce valori coerenti.

• Alcuni 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 metrica (anche se l'espressione di filtro in questione continuerà a essere restituita).

In questa release sono stati corretti tre bug:

Correzioni di bug

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

• È stato corretto un bug che impediva la mancata restituzione del feed dell'account quando il nome dell'obiettivo, un percorso obiettivo, un valore di confronto o un tipo di confronto obiettivi erano stati erroneamente impostati.

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

In questa release sono stati aggiunti nuovi dati e sono stati corretti un bug:

Nuove funzionalità

• Le cinque dimensioni seguenti sono state aggiunte alla nuova categoria D8. Adwords:

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

Correzioni di bug

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

In questa release sono state aggiunte nuove funzionalità e sono stati corretti un 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.
  • Una richiesta può avere solo 4 richieste in attesa alla volta.

• Alcune limitazioni sulle combinazioni di dimensioni e metriche sono state ridotte. ga:nextPagePath e ga:previousPagePath fanno ora 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 segnala 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 i rispettivi valori. Ora sono corretti per restituire i dati corretti.

Ritiro del promemoria relativo a dimensioni e metriche

• Se non l'hai ancora fatto, non utilizzare più le dimensioni e le metriche deprecate in precedenza

Questa release aggiunge una serie di nuove funzioni:

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 richiesta di account o feed di dati. Per ulteriori dettagli, 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 il protocollo Google Data versione 2.

Supporto della segmentazione avanzata

• Parametro di query dei segmenti dinamici:

  • ...&segment=dynamic::espressione
  • consente di creare segmenti avanzati "al volo".
  • 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.
  • L'ID è disponibile 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 sull'obiettivo disponibili

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

• Sono state aggiunte 48 nuove metriche degli obiettivi per gli obiettivi 5-20 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 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), dove (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, non utilizzare più le dimensioni e le metriche deprecate 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. Li rimuoveremo definitivamente dalla nostra API tra un mese. 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:countOfVisites ora è ga:visitCount
  • ga:countOfVisitesToATransaction ora è ga:visitsToTransaction

• Tutti i dati del monitoraggio eventi sono ora esposti come 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 attraverso le seguenti dimensioni:

  D6. Navigazione * ga:previousPagePath * ga:nextPagePath

• La navigazione nelle pagine di destinazione viene ora esposta con le seguenti dimensioni:

  D3. Contenuti * ga:landingPagePath * ga:secondPagePath

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

• Il rapporto Durata della visita (disponibile nell'interfaccia utente in Visitatori -> Fedeltà dei visitatori) è ora visibile attraverso 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 ridotte. Ora puoi eseguire query sulla maggior parte delle dimensioni dei contenuti e a livello di visitatore contemporaneamente, 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 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 account ora restituisce due nuovi elementi di dati per ogni ID tabella (valuta e fuso orario).
  
  

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

• Tutte le precedenti modifiche relative al ritiro sono state applicate.

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

• Le richieste del 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 invece fornito le 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:abbandonedFunnels1
  • ga:abbandonedFunnels2
  • ga:abbandonedFunnels3
  • ga:abbandonedFunnels4
  • ga:goalConversionRate
  • ga:obiettivoConversioneTasso1
  • ga:obiettivoConversioneTasso2
  • ga:obiettivoConversioneTasso3
  • ga:obiettivoConversioneTasso4
  • 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: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

  Dimensioni * ga:subContinentRegion > ga:subContinent * ga:organizzazione > ga:networkLocation* ga:dominio > ga:networkDomain * ga:visitNumber > ga:countOfVisite * ga:platform > ga:operatingSystem * ga:platformVersion > ga:dell'organizzazione >

  ga:Obiettivo di ricerca: rga: