Log delle modifiche all'API Real Time Reporting di Google Analytics

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

Questa pagina documenta qualsiasi modifica apportata all'API Real-Time Reporting di Google Analytics che potrebbe influire sulla tua applicazione. Consigliamo agli sviluppatori di API di controllare periodicamente questo elenco per verificare la presenza di eventuali nuovi annunci. Puoi anche iscriverti alle modifiche tramite i feed elencati nella sezione Iscriviti di seguito.

Iscriviti ai log delle modifiche correlati

Tutti i log delle modifiche dell'API Google Analytics
–
Abbonati rss

Include tutte le API di raccolta, configurazione e reporting.

Tutti i log delle modifiche dell'API di reporting
–
Abbonati rss

Include API Core Reporting, API di reporting delle canalizzazioni multicanale e API di reporting in tempo reale.

Log delle modifiche all'API Real Time Reporting
–
Abbonati rss

Questa release introduce alcune modifiche alle quote e ai limiti dell'API Analytics Real Time.

Le chiamate all'API Real Time Reporting di Analytics utilizzate per contribuire al limite di 10.000 chiamate per vista (profilo) al giorno rispetto ad altre chiamate API di Analytics. Ora le chiamate all'API Real Time Reporting di Analytics vengono conteggiate separatamente, il che significa che è possibile effettuare 10.000 chiamate al giorno per vista (profilo) utilizzando l'API Real Time Reporting di Analytics E effettuare altre 10.000 chiamate al giorno per vista (profilo) utilizzando qualsiasi altra API di Analytics. Per saperne di più, consulta la pagina Limiti e quote.

Questa modifica fornisce un approccio più granulare e a prova di errore alla gestione delle quote, in modo che le chiamate frequenti che utilizzano l'API Real Time Reporting di Analytics non bloccherebbero accidentalmente tutte le altre chiamate all'API Analytics per il resto della giornata per un singolo profilo.

Questa è una release per la correzione di bug:

  • In questa release è stato corretto un problema relativo all'applicazione dei vincoli di filtro nella query dell'API Real Time Reporting. Le richieste con rt:activeUsers e un filtro su una dimensione a livello di evento genererebbero un errore con un motivo badRequest e un messaggio con il messaggio OR operator not supported for a hit level filter. Per ulteriori dettagli sui vincoli delle query, consulta la guida per gli sviluppatori dell'API di reporting in tempo reale.

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

Tempo

  • Dimensione - rt:minutesAgo. Il numero di minuti prima che si sia verificato un hit.

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

Dimensioni e metriche rinominate

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

Utente

  • Dimensione - rt:visitorType. Usa invece rt:userType.
  • Metrica - rt:activeVisitors. Usa invece rt:activeUsers.

Prefisso ga: deprecato

Il prefisso ga: è stato ritirato per tutte le dimensioni e le metriche in tempo reale ed è stato sostituito dal nuovo prefisso rt:. Le richieste API che utilizzano il prefisso ga: continueranno a funzionare per 6 mesi, dopodiché verrà restituito un errore.

Nuove dimensioni e metriche

Questo aggiornamento aggiunge nuove dimensioni e metriche all'API Real Time Reporting. Per l'elenco completo, consulta la pagina Riferimento dimensioni e metriche.

Monitoraggio eventi

  • Dimensione rt:eventAction: l'azione dell'evento.
  • Dimensione, rt:eventCategory, che indica la categoria dell'evento.
  • Dimensione - rt:eventLabel: l'etichetta dell'evento.
  • Dimensione - rt:totalEvents: il numero totale di eventi per il profilo, in tutte le categorie.

Monitoraggio obiettivi

  • Dimensione - rt:goalId: una stringa corrispondente all'ID obiettivo.
  • Metrica - rt:goalXXValue: il valore numerico totale del numero di obiettivo richiesto, dove XX è un numero compreso tra 1 e 20.
  • Metrica - rt:goalValueAll: il valore numerico totale per tutti gli obiettivi definiti per il tuo profilo.
  • Metrica - rt:goalXXCompletions: il numero totale di completamenti per il numero di obiettivo richiesto, dove XX è un numero compreso tra 1 e 20.
  • Metrica - rt:goalCompletionsAll: il numero totale di completamenti per tutti gli obiettivi definiti per il tuo profilo.

Monitoraggio pagine

  • Metrica - rt:pageViews: il numero totale di visualizzazioni di pagina.

Monitoraggio app

  • Metrica - rt:screenViews: il numero totale di visualizzazioni di schermate.

Questa è la versione iniziale dell'API Real Time Reporting in versione beta limitata:

  • L'API Real Time Reporting ti consente di generare report sulle attività che si verificano nella tua proprietà in questo momento. Puoi utilizzare l'API di reporting in tempo reale per eseguire query su dimensioni e metriche al fine di creare dashboard e widget web rivolti ai clienti. Per ulteriori dettagli, consulta la panoramica dell'API di reporting in tempo reale.