Questo documento descrive come iniziare a utilizzare l'SDK di Google Analytics per Android v3.
Prima di iniziare
Prima di implementare l'SDK, assicurati di disporre di quanto segue:
- SDK per sviluppatori Android (disponibile per Windows, Mac OS X e Linux)
- SDK Google Analytics per Android v3 (con
libGoogleAnalyticsServices.jar
incluso nella directory/libs
e nel percorso di build del progetto) - Un'app Android che puoi utilizzare per implementare Google Analytics
- Almeno una proprietà e una vista dell'app (profilo) Google Analytics a cui inviare i dati dalla tua app
Per iniziare
Per iniziare a utilizzare l'SDK sono tre i passaggi:
Dopo aver completato questi passaggi, sarai in grado di misurare quanto segue con Google Analytics:
- Installazioni di app
- Utenti attivi e dati demografici
- Schermate e coinvolgimento degli utenti
- Arresti anomali ed eccezioni
1. Aggiornamento di AndroidManifest.xml
Aggiorna il file AndroidManifest.xml
aggiungendo le seguenti autorizzazioni:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. Aggiunta di metodi EasyTracker
Aggiungi i metodi di invio ai metodi onStart()
e onStop()
di ogni Activities
come nell'esempio seguente:
package com.example.app; import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; /** * An example Activity using Google Analytics and EasyTracker. */ public class myTrackedActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } @Override public void onStart() { super.onStart(); ... // The rest of your onStart() code. EasyTracker.getInstance(this).activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance(this).activityStop(this); // Add this method. } }
3. Creazione del file analytics.xml
Quando utilizzi EasyTracker, le impostazioni di configurazione globali vengono gestite utilizzando risorse definite in XML. Crea un file denominato analytics.xml
nella directory res/values
del progetto e aggiungi le risorse seguenti:
<?xml version="1.0" encoding="utf-8" ?> <resources> <!--Replace placeholder ID with your tracking ID--> <string name="ga_trackingId">UA-XXXX-Y</string> <!--Enable automatic activity tracking--> <bool name="ga_autoActivityTracking">true</bool> <!--Enable automatic exception tracking--> <bool name="ga_reportUncaughtExceptions">true</bool> </resources>
Il controllo lint potrebbe avvisarti sull'utilizzo del trattino breve ("-") nell'ID monitoraggio. Puoi eliminare questo avviso aggiungendo altri attributi al tag <resources>
:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
Consulta il riferimento sui parametri analytics.xml per l'elenco completo dei parametri che puoi utilizzare per configurare la tua implementazione. A seconda dei requisiti della tua applicazione, ti consigliamo di modificare il periodo di invio per verificare di inviare correttamente gli hit. Ad esempio, se vuoi visualizzare dati in tempo reale, è consigliabile impostarlo su un valore basso, come 5s.
Complimenti! L'app è ora configurata per inviare dati a Google Analytics.
Passaggi successivi
Con Google Analytics puoi fare molto di più, ad esempio misurare campagne, pagamenti e transazioni in-app ed eventi di interazione degli utenti.
Le seguenti guide per gli sviluppatori forniscono dettagli aggiuntivi su come implementare le funzionalità di Google Analytics nella tua app:
- Misurazione degli eventi: scopri come misurare il coinvolgimento degli utenti con contenuti interattivi come pulsanti, video e altri contenuti multimediali utilizzando gli eventi.
- Misurazione dei pagamenti in-app: scopri come misurare le transazioni e i pagamenti in-app.
- Misurazione delle campagne: scopri come implementare la misurazione delle campagne per capire quali canali e campagne generano installazioni di app.
- Tempi utente: scopri come misurare i tempi utente nella tua app per misurare i tempi di caricamento, il coinvolgimento con i contenuti multimediali e altro ancora.
- Configurazione avanzata: scopri di più sulle opzioni di configurazione avanzate, compreso l'utilizzo di più tracker.
-
Parametri Analytics.xml: consulta l'elenco completo dei parametri di configurazione
analytics.xml
.