Google Tag Manager per Android

Come sviluppatore, puoi utilizzare Google Tag Manager per implementare e gestire i tag e i pixel di misurazione nelle tue applicazioni per dispositivi mobili, senza dover ricreare e inviare nuovamente i programmi binari delle applicazioni ai marketplace delle app. Gli sviluppatori che lavorano con l'SDK Google Analytics for Firebase possono facilmente aggiungere Tag Manager per gestire e apportare modifiche all'implementazione, anche dopo la spedizione dell'app.

Gli sviluppatori possono registrare eventi importanti e decidere in un secondo momento quali tag o pixel devono essere attivati.

Prerequisiti

Prima di iniziare:

• Nella Console Firebase, aggiungi l'app al progetto Firebase.
• Configura Google Analytics per la tua app, compresa l'attivazione di Google Analytics nel tuo progetto Firebase e l'aggiunta dell'SDK Google Analytics for Firebase alla tua app.
• Crea un account Tag Manager.
• Configurare un contenitore di Google Tag Manager.

Le seguenti sezioni illustrano la procedura per configurare e utilizzare Google Tag Manager nell'applicazione Android.

1. Aggiungi Google Tag Manager al progetto

1. Nel file Gradle del modulo (di solito app/build.gradle), aggiungi la seguente dipendenza dalla libreria di Tag Manager:

   dependencies {
     // ...
     compile 'com.google.android.gms:play-services-tagmanager:18.0.2'
   }
   

2. Accedi all'account Tag Manager.

3. Seleziona un contenitore per dispositivi mobili.

4. Fai clic su Versioni nella barra di navigazione in alto.

5. Fai clic su Azioni > Scarica nella versione del contenitore selezionata.

   

6. Crea la cartella app/src/main/assets/containers se non esiste. Copia il contenitore scaricato nella cartella.

2. Registra eventi e variabili

Tag Manager utilizza eventi, parametri e proprietà utente registrati dall'SDK Google Analytics per Firebase per attivare e creare i tag configurati in Google Tag Manager.

Leggi la documentazione per gli sviluppatori Firebase per istruzioni su come registrare gli eventi e impostare le proprietà utente.

Configurare le variabili in Tag Manager

Per acquisire il valore dei parametri evento e delle proprietà utente da utilizzare in Google Tag Manager, puoi configurare le variabili nell'interfaccia di Tag Manager.

Ad esempio, puoi registrare il seguente evento personalizzato nella tua app:

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Successivamente, puoi configurare nuove variabili parametro evento in Tag Manager, come indicato di seguito per acquisire i valori image_name e full_text parameter:

• Nome variabile: Nome immagine
• Tipo di variabile: parametro evento
• Nome chiave parametro evento: image_name

e:

• Nome variabile: testo completo
• Tipo di variabile: parametro evento
• Nome chiave parametro evento: full_text

Allo stesso modo, puoi impostare la seguente proprietà utente nell'app:

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

Successivamente, puoi configurare una nuova variabile Proprietà utente Firebase in Google Tag Manager per acquisire il valore favorite_food:

• Nome variabile: Cibo preferito
• Tipo di variabile: Proprietà utente Firebase
• Nome chiave parametro evento: favorite_food

Modificare e bloccare gli eventi

Tag Manager ti consente di modificare e bloccare gli eventi prima che vengano registrati dall'SDK di Google Analytics for Firebase. La modifica degli eventi può aiutarti ad aggiungere, rimuovere o modificare i valori dei parametri evento o a modificare i nomi degli eventi senza aggiornamenti delle app. Gli eventi che non sono bloccati verranno registrati dall'SDK di Google Analytics for Firebase.

Inoltre, l'SDK Google Analytics for Firebase registra automaticamente alcuni eventi e proprietà utente. In Tag Manager puoi utilizzare le proprietà e gli eventi raccolti automaticamente, senza dover aggiungere alcun codice. Tuttavia, non puoi bloccarli.

3. Invia eventi

Le variabili nome evento Firebase, le variabili parametro evento Firebase e altre variabili vengono utilizzate per configurare gli attivatori. Le condizioni di attivazione vengono valutate ogni volta che registri un evento Firebase. Per impostazione predefinita, gli eventi di Google Analytics for Firebase vengono attivati automaticamente. In Tag Manager puoi aggiungere un tag di Google Analytics per Firebase per bloccare l'invio degli eventi a Google Analytics.

4. Visualizzare l'anteprima, eseguire il debug e pubblicare il contenitore

Prima di pubblicare una versione del contenitore, ti consigliamo di visualizzarne l'anteprima per assicurarti che funzioni come previsto. Google Tag Manager ti consente di visualizzare l'anteprima delle versioni del contenitore generando link e codici QR nell'interfaccia web e utilizzandoli per aprire la tua applicazione. Puoi anche attivare una modalità di logging dettagliato per eseguire il debug di qualsiasi comportamento imprevisto.

Anteprima contenitore

Prima di visualizzare l'anteprima di un contenitore, genera un URL di anteprima nell'interfaccia web di Google Tag Manager selezionando la versione del contenitore di cui visualizzare l'anteprima e selezionando Anteprima. Salva questo URL di anteprima per i passaggi successivi.

Figura 1: Ottieni un URL di anteprima dall'interfaccia web di Tag Manager.

Per visualizzare l'anteprima del contenitore (se utilizzi Android Studio, vai al passaggio 3):

1. Aggiungi questa attività di anteprima al tuo file AndroidManifest:

   <!--  Add preview activity. -->
   <activity
     android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
     android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. -->
     <intent-filter>
       <data android:scheme="tagmanager.c.com.example.app" />
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE"/>
     </intent-filter>
   </activity>
   

2. Modifica questa riga per includere il nome del pacchetto dell'applicazione:

   <data android:scheme="tagmanager.c.com.example.app"/>
   

3. Nell'interfaccia web di Google Tag Manager, genera un link di anteprima:

   1. Accedi all'account Tag Manager.
   2. Seleziona un contenitore per dispositivi mobili.
   3. Fai clic su Versioni nella barra di navigazione in alto.
   4. Fai clic su Azioni > Anteprima sulla versione del contenitore di cui vuoi visualizzare l'anteprima.
   5. Inserisci il nome del pacchetto dell'applicazione.
   6. Fai clic su Genera link di anteprima all'anteprima.

4. Interrompi l'applicazione e utilizza il link di anteprima generato o il codice QR per avviarla.

5. Puoi uscire dalla modalità di anteprima facendo clic su un link generato dall'opzione Genera link di anteprima finale nell'interfaccia web.

Container di debug

Per risolvere i problemi relativi all'implementazione dei container, attiva il logging dettagliato:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Pubblica container

Dopo aver visualizzato l'anteprima del contenitore e averne verificato il funzionamento, puoi pubblicarlo. Dopo aver pubblicato il contenitore, le configurazioni dei tag diventeranno disponibili per gli utenti di app mobile.

Nota: per i contenitori per dispositivi mobili, viene utilizzato un contenitore predefinito per impostare le configurazioni dei tag iniziali fino al primo download di un contenitore. Una volta che l'app si è connessa a Internet e ha scaricato un contenitore, non utilizzerà mai più il contenitore predefinito. Le applicazioni verificano periodicamente la disponibilità di aggiornamenti dei container, in genere ogni 12 ore.

Passaggi successivi

Leggi Configurazione avanzata.