Tag Universal Analytics

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:

  1. Creare una variabile del nome schermata
  2. Crea un attivatore di evento schermo aperto
  3. Creare un tag di visualizzazione di schermata di Universal Analytics
  4. 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:

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Variabili.
  4. In Variabili definite dall'utente, fai clic su Nuova.
  5. Fai clic su Variabile senza titolo per inserire il nome della variabile nome schermata.
  6. Scegli Variabile di livello dati come tipo di variabile.
  7. Inserisci screenName come Nome variabile del livello dati e imposta il valore predefinito schermata sconosciuta.
  8. 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:

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Attivatori.
  4. Fai clic su Nuova.
  5. Fai clic su Trigger senza titolo per inserire il nome dell'attivatore OpenScreenEvent.
  6. Scegli Evento Personalizzato.
  7. In Attiva su, inserisci la seguente condizione:

    Un attivatore che viene attivato quando l'evento è uguale a openScreen

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

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Tag.
  4. Fai clic su Nuova.
  5. Fai clic su Tag senza titolo per inserire il nome del tag Apri schermo.
  6. Scegli il prodotto Google Analytics.
  7. Inserisci l'ID monitoraggio.
  8. Seleziona Vista app come Tipo di monitoraggio.
  9. Fai clic su Altre impostazioni.
  10. Fai clic su Campi da impostare.
  11. Fai clic ripetutamente su + Aggiungi campo per aggiungere i seguenti campi:

    aggiungi questi campi: nome app, versione app e nome schermata

  12. Fai clic su Continua.
  13. In Attiva su, fai clic su Personalizzato.
  14. Seleziona l'attivatore personalizzato OpenScreenEvent.
  15. Fai clic su Salva.
  16. 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:

  1. (Facoltativo) Creare variabili evento
  2. Creare un attivatore di evento
  3. Creare un tag evento Universal Analytics
  4. 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:

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Variabili.
  4. In Variabili definite dall'utente, fai clic su Nuova.
  5. Fai clic su Variabile senza titolo per inserire il nome della variabile video name.
  6. Scegli Variabile di livello dati come tipo di variabile.
  7. Inserisci videoName come Nome variabile livello dati e imposta il valore predefinito su video sconosciuto.
  8. 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:

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Attivatori.
  4. Fai clic su Nuova.
  5. Fai clic su Attivatore senza titolo per inserire il nome dell'attivatore VideoPlayEvent.
  6. Scegli Evento Personalizzato.
  7. In Attiva su, inserisci la seguente condizione:

    Un attivatore che viene attivato quando l'evento equivale a videoPlay.

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

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Tag.
  4. Fai clic su Nuova.
  5. Fai clic su Tag senza titolo per inserire il nome del tag Evento riproduzione video.
  6. Scegli il prodotto Google Analytics.
  7. Inserisci l'ID monitoraggio.
  8. Seleziona Evento come Tipo di monitoraggio.
  9. Inserisci i seguenti parametri di monitoraggio degli eventi:

    inserisci i seguenti parametri di monitoraggio: Video per la categoria, Riproduci per azione e Nome del video per l'etichetta

  10. Fai clic su Altre impostazioni.
  11. Fai clic su Campi da impostare.
  12. Fai clic ripetutamente su + Aggiungi campo per aggiungere i seguenti campi:

    aggiungi questi campi: nome app, versione app e nome schermata

  13. Fai clic su Continua.
  14. In Attiva su, fai clic su Personalizzato.
  15. Seleziona l'attivatore personalizzato VideoPlayEvent.
  16. Fai clic su Salva.
  17. 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:

  1. Crea un attivatore Transazione
  2. Crea un tag transazioni Universal Analytics
  3. 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:

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Attivatori.
  4. Fai clic su Nuova.
  5. Fai clic su Attivatore senza titolo per inserire il nome dell'attivatore TransactionComplete.
  6. Scegli Evento Personalizzato.
  7. In Attiva su, inserisci la seguente condizione:

    Un attivatore che viene attivato quando l'evento equivale a transazione.

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

  1. Accedi all'account Google Tag Manager.
  2. Seleziona un contenitore per dispositivi mobili.
  3. Nella barra di navigazione a sinistra, fai clic su Tag.
  4. Fai clic su Nuova.
  5. Fai clic su Tag senza titolo per inserire il nome del tag Transazione completata.
  6. Scegli il prodotto Google Analytics.
  7. Inserisci l'ID monitoraggio.
  8. Seleziona Transazione come Tipo di monitoraggio.
  9. Fai clic su Altre impostazioni.
  10. Fai clic su Campi da impostare.
  11. Fai clic ripetutamente su + Aggiungi campo per aggiungere i seguenti campi:

    aggiungi questi campi: nome app, versione app e nome schermata

  12. Fai clic su Continua.
  13. In Attiva su, fai clic su Personalizzato.
  14. Seleziona l'attivatore personalizzato TransactionCompleted.
  15. Fai clic su Salva.
  16. 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>