Questa guida alla migrazione descrive le novità della versione 2 dell'SDK e fornisce agli sviluppatori suggerimenti per la migrazione da un'implementazione v1.x. Gli sviluppatori che non hanno bisogno di eseguire la migrazione da un'implementazione v1.x possono iniziare ora con la versione 2.
Introduzione
Di recente, Google Analytics ha rilasciato l'SDK di Google Analytics aggiornato per Android versione 2. La versione 2 dell'SDK supporta nuove funzionalità e una nuova interfaccia di reporting progettata appositamente per gli sviluppatori di app.
Consigliamo a tutti gli sviluppatori di Google Analytics esistenti di eseguire la migrazione alla versione 2 dell'SDK di Google Analytics per Android per poter usufruire delle nuove funzionalità e dei nuovi report.
Novità della versione 2
L'SDK di Google Analytics per Android versione 2 introduce una nuova esperienza di generazione dei report progettata per gli sviluppatori di app, nuove potenti dimensioni e metriche e molto altro ancora. Ecco cosa offre agli sviluppatori la versione 2:
- Report più efficaci per gli sviluppatori di app
- I report standard sono stati riprogettati per gli sviluppatori di app e sono stati aggiunti nuovi report, come Flusso di coinvolgimento e Sorgenti di Google Play, per aiutare gli sviluppatori a ottenere nuove informazioni sull'acquisizione e sull'esperienza degli utenti. Leggi le nostre best practice per la configurazione dell'account per scoprire di più su come configurare al meglio la tua proprietà per la versione 2.
- Nuove dimensioni e metriche dell'app
- Con la versione 2 dell'SDK sono state introdotte nuove metriche e dimensioni specifiche delle app, tra cui Nome schermata e Visualizzazioni di schermata, Nome app, Versione app e molte altre.
- Misurare arresti anomali ed eccezioni
- L'SDK Google Analytics per Android introduce la misurazione delle eccezioni e il tipo di hit delle eccezioni. Utilizzando la misurazione delle eccezioni, puoi misurare il numero e il tipo di arresti anomali ed eccezioni non irreversibili. Per scoprire come implementare la misurazione delle eccezioni, consulta la Guida per gli sviluppatori sulle eccezioni.
- Dimensioni e metriche personalizzate
- Crea dimensioni personalizzate per segmentare i tuoi dati in nuovi modi. Scopri di più sulle dimensioni e sulle metriche personalizzate.
- Misurare le interazioni social
- Ottieni nuove informazioni sul valore dei social nella tua app misurando le interazioni degli utenti con widget e plug-in social incorporati. Scopri di più sulla misurazione delle interazioni social.
Prima di iniziare
Tutti gli sviluppatori vorranno eseguire questi due passaggi prima di iniziare la migrazione:
- Scarica l'SDK di Google Analytics per Android v2
- Crea una vista (profilo) dell'app da utilizzare per accedere ai nuovi report e dati dell'app.
Una volta completati i passaggi precedenti, segui questi passaggi per il tuo percorso di migrazione.
Migrazione da EasyTracker
Per eseguire la migrazione della tua app dalla versione 1 alla versione 2 della libreria di EasyTracker, sono previsti tre passaggi:
- Aggiorna i parametri nel file di risorse GoogleAnalytics.xml
- Aggiornare i nomi dei metodi
- Aggiorna il ricevitore della trasmissione (monitoraggio della campagna Google Play)
1. Aggiorna parametri in GoogleAnalytics.xml
Quando esegui la migrazione alla versione 2, aggiorna i parametri nel file di risorse GoogleAnalytics.xml, poiché alcuni sono cambiati dalla versione 1.x e nella versione 2 sono stati aggiunti nuovi parametri.
La tabella seguente mostra i parametri che sono stati aggiornati nella versione 2:
| Nome parametro v1.x | Nome parametro v2.x |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | ritirato |
Per saperne di più, consulta i parametri nuovi e aggiornati di EasyTracker.
2. Aggiorna nomi metodo
Sebbene gran parte della sintassi rimanga la stessa nella versione 2 di EasyTracker, esistono alcune differenze significative nei nomi dei metodi e nella sintassi che richiedono l'aggiornamento dell'implementazione:
trackPageView()èsendView()nella versione 2. Per ulteriori informazioni, consulta la Guida per il monitoraggio dello schermo per gli sviluppatori.- L'implementazione dell'e-commerce è stata semplificata. Scopri come implementare la misurazione dell'e-commerce nella versione 2.
- Le variabili personalizzate sono state sostituite da dimensioni e metriche personalizzate. Tutte le chiamate a
setCustomVar()devono essere aggiornate per sfruttare la nuova funzionalità. Scopri come implementare le dimensioni e le metriche personalizzate.
3. Aggiorna ricevitore trasmissione (monitoraggio campagna Google Play)
Gli sviluppatori che avevano implementato il monitoraggio delle campagne di Google Play utilizzando la versione 1.x devono tenere presente che il percorso della classe del destinatario è cambiato. Per ulteriori informazioni, consulta la guida al monitoraggio delle campagne di Google Play.
Migrazione da un'implementazione personalizzata
Se non utilizzavi la libreria EasyTracker nella versione 1.x dell'SDK di Analytics per Android, ti consigliamo di iniziare a utilizzare EasyTracker nella versione 2.
La libreria EasyTracker è ora inclusa nell'SDK ed è consigliata per tutti gli sviluppatori. Inizia a utilizzare EasyTracker nell'SDK di Google Analytics v2.
Se hai esigenze avanzate di raccolta dati, ad esempio l'utilizzo di più ID proprietà in un'unica implementazione, leggi la Guida alla configurazione avanzata per scoprire di più sull'utilizzo delle funzionalità avanzate della versione 2.x dell'SDK.