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 interessare la tua applicazione. Consigliamo agli sviluppatori di API di controllare periodicamente questo elenco per verificare la presenza di nuovi annunci. Puoi anche iscriverti alle modifiche tramite i feed elencati nella sezione Iscriviti di seguito.

Iscriviti ai log delle modifiche correlati

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

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

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

Chiamate all'API Analytics Real Time Reporting utilizzate per contribuire al limite di 10.000 chiamate per vista (profilo) al giorno rispetto alle 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. Consulta la pagina Limiti e quote per saperne di più.

Questa modifica fornisce un approccio più granulare e sicuro per la gestione delle quote, in modo che le chiamate frequenti che utilizzano l'API Real Time Reporting di Analytics non bloccheranno accidentalmente tutte le altre chiamate API di 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 potrebbero restituire 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 pagina Riferimento dimensioni e metriche.

Ora

  • 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 pagina 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: obsoleto

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: 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 schermata.

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 in questo momento nella tua proprietà. 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 Real Time Reporting.