Pete Frisella, Google Analytics Developer Advocate – Luglio 2013
Questo documento riguarda il superproxy di Google Analytics e spiega come iniziare, utilizzare funzionalità specifiche e illustra importanti considerazioni.
Introduzione
Google Analytics superProxy ti consente di condividere pubblicamente i dati dei report di Google Analytics. Puoi utilizzarla per potenziare dashboard e widget personalizzati, trasformare le risposte in vari formati, eseguire test e molto altro ancora.
Il superproxy Google Analytics funziona con l'API di reporting principale, l'API di reporting in tempo reale e l'API di reporting Canalizzazioni multicanale.
Caratteristiche principali delle funzionalità:
- Condividi pubblicamente i tuoi dati di Google Analytics.
- Utilizza il proxy per potenziare le tue dashboard personalizzate.
- Converti in CSV, tabella dati, TSV.
- Sono supportate le date relative (ad es. ultimi 7 giorni).
- Aggiorna automaticamente i dati del report.
- Memorizzazione nella cache: risposte rapide e utilizzo efficiente della quota.
Come funziona
Crea una query per i tuoi dati di Google Analytics e i dati dei report specifici saranno disponibili pubblicamente a un nuovo URL che puoi condividere. Chiunque visiti l'URL avrà accesso ai dati dei report senza richiedere alcuna autorizzazione.
Ad esempio, potresti creare una query per recuperare i primi 10 browser in base alle visualizzazioni di pagina dell'ultima settimana e una query per il numero di sessioni di ieri e così via. Sei tu a decidere quali query rendere pubbliche e con quale frequenza vuoi che i dati vengano aggiornati e il superproxy di Google Analytics si occuperà di tutto il resto.
Suggerimento: puoi utilizzare Query Explorer per generare report e poi copiare Query URI da utilizzare con il superproxy di Google Analytics
Configurazione e creazione di una query
Il superproxy di Google Analytics è un'applicazione web che viene eseguita nell'ambiente Google App Engine. Puoi scaricare questa applicazione ed eseguirne il deployment seguendo un semplice insieme di istruzioni.
Gestione degli utenti
Il superproxy Google Analytics include una semplice interfaccia di gestione utenti che puoi utilizzare per aggiungere utenti. Ogni utente potrà elencare e gestire solo le query API che crea.
Solo gli amministratori possono gestire gli utenti. Per aggiungere un nuovo utente:
- Nell'interfaccia di amministrazione del superproxy Google Analytics, ad esempio
https://your-application-id.appspot.com/admin, fai clic sul pulsante Gestisci utenti. - Nella pagina Gestisci utenti, inserisci l'indirizzo email dell'utente che vuoi aggiungere e fai clic sul pulsante Aggiungi utente. L'utente verrà aggiunto, ma non avrà accesso fino a quando non attiverà l'account.
- Chiedi all'utente di attivare il proprio account visitando la pagina
/admin/activate. Ad esempiohttps://your-application-id.appspot.com/admin/activate. Affinché l'attivazione funzioni, dovranno aver eseguito l'accesso all'Account Google associato all'indirizzo email che hai aggiunto. - Una volta attivato l'account, l'utente potrà visitare la pagina
/admin, autorizzare l'accesso al proprio account Google Analytics e iniziare a creare le proprie query API.
Utenti amministratori
Gli utenti amministratori superproxy di Google Analytics vengono aggiunti utilizzando la console di amministrazione di App Engine. Qualsiasi utente aggiunto tramite questa console, di qualunque ruolo, sarà un amministratore.
Gli amministratori possono elencare e gestire qualsiasi query API degli utenti.
Restrizioni per i domini
In alcuni casi, puoi usufruire delle funzionalità offerte da Google Analytics superProxy, ma non vuoi rendere pubblici i dati oltre a un determinato insieme di utenti o domini. Per impostazione predefinita, per qualsiasi applicazione senza costi ospitata su App Engine, chiunque abbia eseguito l'accesso con un Account Google può accedere ai tuoi endpoint pubblici.
Se vuoi limitare ulteriormente l'accesso alla tua applicazione, devi implementare il tuo livello di autenticazione davanti a Google Analytics SuperProxy oppure utilizzare G Suite, che ti consente di limitare un'applicazione agli utenti gestiti dal tuo dominio. Per maggiori dettagli, consulta Configurazione dell'autenticazione dell'app.
Considerazioni sulle quote
Il superproxy di Google Analytics ti aiuta a risparmiare quota pubblicando i dati dei report dalla cache o dal datastore. Tuttavia, l'impostazione di intervalli di aggiornamento brevi potrebbe comunque causare un rapido consumo della quota. Per evitare che ciò accada, assicurati di aggiornare le query a un intervallo ragionevole per il tipo di dati richiesti.
App Engine
I limiti di quota predefiniti senza costi per le applicazioni App Engine sono generosi e probabilmente saranno sufficienti per la maggior parte dei casi d'uso. Tuttavia, puoi abilitare la fatturazione per aumentare o rimuovere i limiti predefiniti. Per maggiori dettagli, consulta Quote di App Engine.
Community e monitoraggio problemi
Il forum SuperProxy di Google Analytics è un gruppo di discussione in cui è possibile porre domande, condividere idee e ricevere feedback sui propri progetti creativi.
Lo Issue Tracker ti consente di segnalare e tenere traccia dei problemi e delle richieste di funzionalità per il superproxy di Google Analytics.