Per attivare le modifiche in fase di esecuzione all'implementazione di Google Analytics che non richiedono di ricreare e inviare nuovamente il programma binario dell'app ai marketplace, implementa Universal Analytics (UA) nella tua app con Google Tag Manager (GTM).
Questa guida mostra come utilizzare i tag Universal Analytics e l'SDK di Google Tag Manager per Android per:
Invia visualizzazioni di schermata
Per inviare a Google Analytics una visualizzazione di schermata ogni volta che viene aperta una nuova schermata nella tua app:
- Creare una variabile del nome schermata
- Crea un attivatore di evento schermo aperto
- Creare un tag di visualizzazione di schermata di Universal Analytics
- Esegui il push dell'evento della schermata aperta e del nome della schermata al livello dati
1. Creare una variabile del nome schermata
Per creare una variabile del nome schermata in GTM:
- Accedi all'account Google Tag Manager.
- Seleziona un contenitore per dispositivi mobili.
- Nella barra di navigazione a sinistra, fai clic su Variabili.
- In Variabili definite dall'utente, fai clic su Nuova.
- Fai clic su Variabile senza titolo per inserire il nome della variabile nome schermata.
- Scegli Variabile di livello dati come tipo di variabile.
- Inserisci screenName come Nome variabile del livello dati e imposta il valore predefinito schermata sconosciuta.
- Fai clic su Crea variabile.
2. Crea un attivatore di eventi di schermata aperta
Per creare un attivatore in GTM per attivare il tag visualizzazione di schermata di Universal Analytics:
- Accedi all'account Google Tag Manager.
- Seleziona un contenitore per dispositivi mobili.
- Nella barra di navigazione a sinistra, fai clic su Attivatori.
- Fai clic su Nuova.
- Fai clic su Trigger senza titolo per inserire il nome dell'attivatore OpenScreenEvent.
- Scegli Evento Personalizzato.
- In Attiva su, inserisci la seguente condizione:
- Fai clic su Crea attivatore.
3. Creare un tag di visualizzazione di schermata di Universal Analytics
Per creare un tag di visualizzazione di schermata di Universal Analytics attivato dall'evento schermata aperta:
- Accedi all'account Google Tag Manager.
- Seleziona un contenitore per dispositivi mobili.
- Nella barra di navigazione a sinistra, fai clic su Tag.
- Fai clic su Nuova.
- Fai clic su Tag senza titolo per inserire il nome del tag Apri schermo.
- Scegli il prodotto Google Analytics.
- Inserisci l'ID monitoraggio.
- Seleziona Vista app come Tipo di monitoraggio.
- Fai clic su Altre impostazioni.
- Fai clic su Campi da impostare.
- Fai clic ripetutamente su + Aggiungi campo per aggiungere i seguenti campi:
- Fai clic su Continua.
- In Attiva su, fai clic su Personalizzato.
- Seleziona l'attivatore personalizzato OpenScreenEvent.
- Fai clic su Salva.
- Fai clic su Crea tag.
4. Invia l'evento e il nome della schermata aperti al livello dati
Aggiungi codice alla tua app per eseguire il push di un evento openScreen
e un
valore screenName
al livello dati, ad esempio:
import com.google.tagmanager.DataLayer; import com.google.tagmanager.TagManager; import android.app.Activity; import android.os.Bundle; public class MainActivity extends Activity { private static final String SCREEN_NAME = "Home Screen"; private DataLayer mDataLayer; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(); } @Override public void onStart() { super.onStart(); mDataLayer = TagManager.getInstance(this).getDataLayer(); // Push an openScreen event and a screenName value to the data layer. // This call assumes the container has already been opened, otherwise events // pushed to the data layer will not fire tags in that container. mDataLayer.push(DataLayer.mapOf("event", "openScreen", "screenName", SCREEN_NAME)); } }
Invia eventi
Per inviare un evento a Google Analytics quando un utente interagisce con i controlli UI o i contenuti della tua app:
- (Facoltativo) Creare variabili evento
- Creare un attivatore di evento
- Creare un tag evento Universal Analytics
- Esegui il push del valore delle variabili evento e dell'evento al livello dati
I passaggi seguenti mostrano come un evento viene inviato a Google Analytics quando un utente avvia la riproduzione di un video.
1. (Facoltativo) Creare variabili evento
Se l'evento utilizza le variabili di livello dati per rappresentare i campi categoria, azione, etichetta o valore, devi prima creare queste variabili. In questo esempio, il tag evento di riproduzione video utilizza una variabile di livello dati per ottenere il nome del video.
Per creare una variabile per il nome del video in GTM:
- Accedi all'account Google Tag Manager.
- Seleziona un contenitore per dispositivi mobili.
- Nella barra di navigazione a sinistra, fai clic su Variabili.
- In Variabili definite dall'utente, fai clic su Nuova.
- Fai clic su Variabile senza titolo per inserire il nome della variabile video name.
- Scegli Variabile di livello dati come tipo di variabile.
- Inserisci videoName come Nome variabile livello dati e imposta il valore predefinito su video sconosciuto.
- Fai clic su Crea variabile.
2. Crea un attivatore di evento
Per creare un attivatore di evento in GTM che attivi il tag evento Universal Analytics:
- Accedi all'account Google Tag Manager.
- Seleziona un contenitore per dispositivi mobili.
- Nella barra di navigazione a sinistra, fai clic su Attivatori.
- Fai clic su Nuova.
- Fai clic su Attivatore senza titolo per inserire il nome dell'attivatore VideoPlayEvent.
- Scegli Evento Personalizzato.
- In Attiva su, inserisci la seguente condizione:
- Fai clic su Crea attivatore.
3. Creare un tag evento Universal Analytics
Per creare un tag evento Universal Analytics attivato dall'evento di riproduzione video:
- Accedi all'account Google Tag Manager.
- Seleziona un contenitore per dispositivi mobili.
- Nella barra di navigazione a sinistra, fai clic su Tag.
- Fai clic su Nuova.
- Fai clic su Tag senza titolo per inserire il nome del tag Evento riproduzione video.
- Scegli il prodotto Google Analytics.
- Inserisci l'ID monitoraggio.
- Seleziona Evento come Tipo di monitoraggio.
- Inserisci i seguenti parametri di monitoraggio degli eventi:
- Fai clic su Altre impostazioni.
- Fai clic su Campi da impostare.
- Fai clic ripetutamente su + Aggiungi campo per aggiungere i seguenti campi:
- Fai clic su Continua.
- In Attiva su, fai clic su Personalizzato.
- Seleziona l'attivatore personalizzato VideoPlayEvent.
- Fai clic su Salva.
- Fai clic su Crea tag.
4. Esegui il push del valore dell'evento e della variabile evento al livello dati
Scrivi il codice per eseguire il push di un evento videoPlay
e un
valore videoName
al livello dati, ad esempio:
import com.google.tagmanager.DataLayer; import com.google.tagmanager.TagManager; public class VideoPlayer { // Called when a user starts a video playback. public void onPlay(Video v) { DataLayer dataLayer = TagManager.getInstance(this).getDataLayer(); // Push a videoPlay event and a videoName value to the data layer. // This call assumes the container has already been opened, otherwise events // pushed to the data layer will not fire tags in that container. dataLayer.push(DataLayer.mapOf("event", "videoPlay", "videoName", v.getName()); play(v); } // Rest of the implementation. // ... }
Inviare transazioni e-commerce
Quando un utente completa un acquisto in-app, per inviare la transazione e gli articoli associati a Google Analytics:
- Crea un attivatore Transazione
- Crea un tag transazioni Universal Analytics
- Eseguire il push di eventi, transazioni ed elementi di transazione al livello dati
Per l'elenco dei nomi supportati per le variabili degli articoli e delle transazioni, consulta Variabili del livello dati di e-commerce supportate.
1. Crea un attivatore Transazione
Per creare l'attivatore Transazione in GTM per attivare il tag transazioni Universal Analytics:
- Accedi all'account Google Tag Manager.
- Seleziona un contenitore per dispositivi mobili.
- Nella barra di navigazione a sinistra, fai clic su Attivatori.
- Fai clic su Nuova.
- Fai clic su Attivatore senza titolo per inserire il nome dell'attivatore TransactionComplete.
- Scegli Evento Personalizzato.
- In Attiva su, inserisci la seguente condizione:
- Fai clic su Crea attivatore.
2. Creare un tag transazione di Universal Analytics
Per creare un tag transazione di Universal Analytics attivato dall'evento di transazione:
- Accedi all'account Google Tag Manager.
- Seleziona un contenitore per dispositivi mobili.
- Nella barra di navigazione a sinistra, fai clic su Tag.
- Fai clic su Nuova.
- Fai clic su Tag senza titolo per inserire il nome del tag Transazione completata.
- Scegli il prodotto Google Analytics.
- Inserisci l'ID monitoraggio.
- Seleziona Transazione come Tipo di monitoraggio.
- Fai clic su Altre impostazioni.
- Fai clic su Campi da impostare.
- Fai clic ripetutamente su + Aggiungi campo per aggiungere i seguenti campi:
- Fai clic su Continua.
- In Attiva su, fai clic su Personalizzato.
- Seleziona l'attivatore personalizzato TransactionCompleted.
- Fai clic su Salva.
- Fai clic su Crea tag.
3. Esegui il push di eventi, transazioni ed elementi al livello dati
Scrivi il codice per eseguire il push dell'evento di transazione, della transazione e degli elementi associati al livello dati. Devi utilizzare i nomi di variabili degli articoli e transazioni supportati per inviare i dati sulle transazioni e sugli articoli al livello dati. Ad esempio:
// Called when a user completes a transaction. public void onPurchaseCompleted(Purchase p) { DataLayer dataLayer = TagManager.getInstance(this).getDataLayer(); // Put maps of item data into an array to be pushed to the data layer. ArrayList<Map<String, String>> purchasedItems = new ArrayList<Map<String, String>>(); for (Item i : p.items) { HashMap<String, String> currentItem = new HashMap<String, String>(); currentItem.put("name", i.getProductName()); currentItem.put("sku", i.getProductSku()); currentItem.put("category", i.getProductCategory()); currentItem.put("price", i.getProductPrice()); currentItem.put("currency", "USD"); currentItem.put("quantity", i.getProductQty()); purchasedItems.add(currentItem); } // This call assumes the container has already been opened, otherwise events // pushed to the [DataLayer] data layer will not fire tags in that container. dataLayer.push(DataLayer.mapOf("event", "transaction", "transactionId", p.getTransId(), "transactionTotal", p.getTotal(), "transactionAffiliation", "In-app Store", "transactionTax", p.getTax(), "transactionShipping", p.getShippingCost(), "transactionCurrency", "USD", "transactionProducts", purchasedItems)); // Because the data layer is persistent, you should reset fields to null // after you are done pushing the transaction. dataLayer.push(DataLayer.mapOf("transactionId", null, "transactionTotal", null, "transactionAffiliation", null, "transactionTax", null, "transactionShipping", null, "transactionCurrency", null, "transactionProducts", null)); }
Per ulteriori informazioni sull'utilizzo dell'SDK di Google Tag Manager per Android per implementare le funzioni di e-commerce avanzato di Universal Analytics, consulta E-commerce avanzato.
Variabili del livello dati e-commerce supportate
I tag transazioni universali supportano i seguenti nomi di variabili per transazioni e articoli.
Variabili di transazione
Nome variabile | Descrizione | Tipo | Obbligatorie |
---|---|---|---|
transactionId |
Identificativo di transazione unico | stringa | Sì |
transactionAffiliation |
Partner o negozio | stringa | No |
transactionTotal |
Valore totale della transazione | stringa | No |
transactionTax |
Importo delle imposte sulla transazione | stringa | No |
transactionShipping |
Costo di spedizione per la transazione | stringa | No |
transactionCurrency |
Valuta della transazione | stringa | No |
transactionProducts |
Elenco di articoli acquistati durante la transazione | in un array di variabili elemento contenitore. | No |
Variabili elemento
Nome variabile | Descrizione | Tipo | Obbligatorie |
---|---|---|---|
name |
Nome del prodotto | stringa | Sì |
sku |
SKU prodotto | stringa | No |
category |
Categoria di prodotto | stringa | No |
price |
Prezzo del prodotto | stringa | No |
currency |
Il tipo di valuta di price |
stringa | No |
quantity |
Quantità di articoli | stringa | No |
Attribuzione del referrer di installazione
Se registri il seguente servizio e destinatario nel file AndroidManifest.xml
, i dati dei referrer di installazione disponibili verranno inclusi automaticamente in tutti gli hit di Google Analytics o nelle richieste di pixel di remarketing di AdWords:
<service android:name="com.google.tagmanager.InstallReferrerService" /> <receiver android:name="com.google.tagmanager.InstallReferrerReceiver" android:exported="true"> <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>