Eventi personalizzati di Google Ads con Google Analytics per Firebase - Android

1. Introduzione

Ultimo aggiornamento: 14-12-2020

Cosa creerai

In questo codelab imparerai a implementare gli eventi con Google Analytics per Firebase(GA4F) e a lanciare campagne di azioni tramite Google Ads.

Questo codelab si concentra sull'implementazione degli eventi con GA4F e sulla loro importazione in Google Ads. Se vuoi scoprire come creare un'app per Android con Firebase, consulta il Codelab Firebase per Android: crea una chat amichevole.

Cosa imparerai a fare

• Come creare un progetto Firebase
• Come implementare l'SDK Firebase nell'app per Android
• Come creare eventi e parametri.
• Come importare gli eventi da Firebase in Google Ads
• Lancia campagne per azione di Google Ads con eventi personalizzati.

Che cosa ti serve

• Android Studio 3.6 o versioni successive
• Account Firebase
• Account Google Ads

2. Crea e configura un progetto Firebase

Per iniziare a utilizzare Firebase, devi creare e configurare un progetto Firebase.

Creare un progetto Firebase

1. Accedi a Firebase.

Nella console Firebase, fai clic su Aggiungi progetto(o Crea un progetto) e assegna un nome al progetto Firebase.

2. Fai clic sulle opzioni di creazione del progetto. Accetta i Termini di Firebase, se richiesto. Devi attivare Google Analytics per questo progetto, poiché hai bisogno degli eventi di Google Analytics per monitorare le conversioni e gli eventi di azione.

Per scoprire di più sui progetti Firebase, consulta Informazioni sui progetti Firebase.

3. Scegli l'account Google Analytics. Se ne hai uno, sceglilo o creane uno nuovo. Fai clic sul pulsante Crea progetto.

4. La compilazione del progetto Firebase è stata completata.

Nel passaggio successivo, scoprirai come aggiungere Firebase alla tua app per Android.

3. Aggiungi Firebase alla tua app Android

Registra app

1. Nella console Firebase, seleziona Panoramica del progetto nel riquadro di navigazione a sinistra, quindi fai clic sul pulsante Android in "Inizia aggiungendo Firebase alla tua app"

2. Compila le informazioni necessarie.

Per il nome del pacchetto Android, in Android Studio vai alla directory dell'app e apri un nome file build.gradle. Nel file, cerca applicationId. Questo valore è il nome del pacchetto Android. Copia e incolla questo valore.

Qui non abbiamo bisogno della chiave SHA-1, a meno che tu non intenda utilizzare Accedi con Google o Link dinamici Firebase (tieni presente che questi non fanno parte di questo codelab). Per ulteriori informazioni sulla chiave SHA-1, consulta questo documento.

Suggerimento: leggi l'articolo Impostare l'ID applicazione per saperne di più sugli ID pacchetto e applicazione.

3. Fai clic sul pulsante Registra app.

Scaricare il file di configurazione

1. Fai clic sul pulsante Scarica google-services.json per scaricare il file di configurazione google-services.json.

2. In Android Studio, vai alla directory app e sposta il file google-services.json (che hai appena scaricato sopra) nella directory app. Torna alla Console Firebase e fai clic sul pulsante Avanti.

Attiva Firebase nella tua app

1. Per leggere il file google-services.json generato da Firebase, è necessario il plug-in Gradle dei servizi Google.
2. In Android Studio, apri <project>/build.gradle e aggiungi le seguenti righe al file:

buildscript { 
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
   }
   dependencies {
      ...
      // Add this line
      classpath 'com.google.gms:google-services:4.3.4'
   }
}

allprojects {
   ...
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
      ...
      }
   }
}

3. Apri <project>/<app-module>/build.gradle, quindi aggiungi le seguenti righe al file:

apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

Hai completato l'aggiunta di Firebase alla tua app per Android.

Nel passaggio successivo scoprirai come aggiungere l'SDK Firebase alla tua app.

4. Aggiungere l'SDK Firebase all'app

In questo passaggio aggiungerai l'SDK Firebase, in particolare l'SDK Firebase per Google Analytics.

Utilizzeremo la distinta base di Firebase per Android, che ti consente di gestire le versioni delle librerie di Firebase che utilizzi nella tua app specificando la versione della distinta base. Per scoprire quali versioni delle librerie Firebase sono associate a una versione distinta base specifica, consulta le note di rilascio relative a quella versione distinta base.

1. Apri <project>/<app-module>/build.gradle, quindi aggiungi le seguenti righe al file:

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx'

Come puoi vedere, specificando solo la versione della distinta base, non devi specificare la versione della libreria di Firebase Analytics. Tuttavia, se vuoi utilizzare la versione che preferisci per la libreria Firebase, indipendentemente da quella designata nella distinta base, devi solo specificarla come segue:

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'

2. Ora sincronizza l'app facendo clic sul pulsante Sync Now.

Hai completato l'aggiunta dell'SDK Firebase per Google Analytics alla tua app per Android.

Nel passaggio successivo, scoprirai come registrare gli eventi Firebase nella tua app per Android.

5. Registrare gli eventi con Firebase Analytics

In questo passaggio scoprirai come registrare gli eventi con Firebase Analytics nell'app per Android.

Esistono due modi per registrare gli eventi: utilizzando gli eventi suggeriti o quelli personalizzati.

Utilizzare gli eventi suggeriti

L'SDK Firebase Analytics definisce una serie di eventi suggeriti che possono essere utilizzati in vari tipi di app, come giochi, vendita al dettaglio, viaggi ed e-commerce. Esistono anche alcuni eventi suggeriti che richiedono i relativi parametri obbligatori, con i quali puoi massimizzare i dettagli disponibili nei report di Firebase. ( Riferimento agli eventi suggeriti)

1. Dichiara l'oggetto FirebaseAnalytics nella parte superiore dell'attività:

private lateinit var firebaseAnalytics: FirebaseAnalytics

2. Inizializza l'oggetto nel metodo onCreate():

firebaseAnalytics = Firebase.analytics

3. Inizia a registrare gli eventi con il metodo logEvent(). Il seguente codice registra un evento PURCHASE quando un utente acquista uno o più articoli nell'app:

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

Utilizzare gli eventi personalizzati

Se hai bisogno di eventi non coperti dagli eventi suggeriti, puoi registrare i tuoi eventi personalizzati con parametri personalizzati:

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

Eventi di debug

Puoi visualizzare dati aggregati e report sui tuoi eventi nella Console Firebase. Tuttavia, poiché gli aggiornamenti vengono eseguiti periodicamente nell'arco della giornata, non puoi visualizzare questi eventi subito dopo averli registrati nella tua app.

Per test e debug immediati, puoi utilizzare Firebase Debugview. DebugView ti consente di visualizzare i dati sugli eventi registrati dalla tua app sui dispositivi di sviluppo quasi in tempo reale. Per DebugView, fai riferimento alla sezione Evento di debug.

Hai completato la registrazione degli eventi nella tua app per Android.

Nel passaggio successivo scoprirai come importare questi eventi in Google Ads.

6. Importare gli eventi di Firebase in Google Ads

La configurazione di Firebase per Android è stata completata e puoi lanciare la campagna per app con gli eventi di azione registrati. Per iniziare, collega Firebase a Google Ads. Collegando Firebase a Google Ads, le campagne per app potranno scoprire di più sui segmenti di pubblico e migliorare le informazioni acquisite, il che in genere si traduce in un miglioramento del rendimento e delle conversioni.

Collegare Firebase e Google Ads

1. Vai alle impostazioni di Firebase facendo clic sul pulsante accanto a Panoramica del progetto.

2. Nella scheda Integrazioni, vedrai Google Ads e un pulsante Collega. Fai clic su Collega e continua.

3. Scegli l'account Google Ads da collegare.

Hai completato il collegamento di Firebase e Google Ads. Importiamo gli eventi di Firebase in Google Ads.

Importare gli eventi di Firebase

1. Nella console di Firebase, vai al menu Eventi e contrassegna l'evento che vuoi importare come conversione.

Attenzione:se l'evento target non è contrassegnato come conversione, Google Ads non potrà importarlo. Assicurati che l'evento sia contrassegnato correttamente come conversione.

2. Ora vai a Google Ads e accedi all'account collegato a Firebase.
3. In Google Ads, vai a Strumenti → Misurazione → Conversioni
4. Fai clic sul pulsante Più .
5. Scegli App → Proprietà Google Analytics 4 (Firebase) e fai clic su Continua.
6. Puoi vedere tutti gli eventi di analisi contrassegnati come conversioni. Trova l'evento che vuoi importare. In questo caso, scegli l'evento delete_item che abbiamo implementato in precedenza. Fai clic sul pulsante Importa e continua.
7. Hai importato correttamente un evento di conversione da Firebase.

Hai completato l'importazione degli eventi Firebase in Google Ads.

Nel passaggio successivo scoprirai come lanciare una campagna per azione con l'evento che hai appena importato.

7. Lanciare campagne di azioni in-app con eventi importati

Importante:per lanciare una campagna per app, devi avere un'app a livello di produzione in Google Play. Se non vuoi ancora pubblicare l'app, per il momento salta questo passaggio.

1. Vai alla scheda Campagne per app nel tuo account Google Ads attuale e avvia una nuova campagna facendo clic sul pulsante Più.

2. Lanceremo una campagna di promozione dell'app con l'opzione Installazioni di app. In basso, scegli l'app che vuoi promuovere e fai clic su Continua.
3. Nella sezione Aste, se selezioni Azioni in-app nel menu a discesa, puoi visualizzare gli eventi. Scegli gli eventi su cui vuoi concentrarti.

4. Imposta le restanti impostazioni della campagna e il gioco è fatto.

8. Complimenti

Congratulazioni, hai integrato Firebase e Google Ads. In questo modo, potrai migliorare il rendimento della campagna.

Hai appreso

• Come configurare Firebase Analytics per Android
• Come registrare gli eventi con Firebase Analytics in un'app per Android.
• Come importare gli eventi e utilizzarli per le campagne di azioni.