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 for Firebase(GA4F) e a lanciare campagne per azione tramite Google Ads.

Questo codelab si concentra sull'implementazione degli eventi con GA4F e sull'importazione degli eventi in Google Ads. Se vuoi scoprire come creare un'app per Android con Firebase, consulta Firebase Android Codelab-Build Friendly Chat.

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 eventi da Firebase a Google Ads
  • Lanciare campagne per azione 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.

Crea un progetto Firebase

  1. Accedi alla console Firebase utilizzando il tuo Account Google.
  2. Fai clic sul pulsante per creare un nuovo progetto, quindi inserisci un nome (ad esempio, FriendlyChat).
  3. Fai clic su Continua.
  4. Se richiesto, leggi e accetta i termini di Firebase, quindi fai clic su Continua.
  5. (Facoltativo) Attiva l'assistenza AI nella console Firebase (denominata "Gemini in Firebase").
  6. Per questo codelab, hai bisogno di Google Analytics per monitorare gli eventi di azione e le conversioni, quindi mantieni l'opzione attiva per l'opzione Google Analytics. Segui le istruzioni sullo schermo per configurare Google Analytics.
  7. Fai clic su Crea progetto, attendi il provisioning del progetto, poi fai clic su Continua.

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

Nel passaggio successivo, imparerai ad 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".

6cbb33ad3e7c9132.png

  1. Compila le informazioni necessarie.

3b7d3b33d81fe8ea.png

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

Non abbiamo bisogno della chiave SHA-1 qui, a meno che tu non preveda di utilizzare l'accesso con Google o i link dinamici Firebase (tieni presente che non fanno parte di questo codelab. Per ulteriori informazioni sulla chiave SHA-1, consulta questo documento).

  1. Fai clic sul pulsante Registra app.

Scarica il file di configurazione

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

52f08aa18c8d59d0.png

  1. 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.

Abilitare 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, quindi 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
      ...
      }
   }
}
  1. 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'

Ora hai completato l'aggiunta di Firebase alla tua app Android.

Nel passaggio successivo, imparerai ad 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 Android, che ti consente di gestire le versioni della libreria di Firebase che utilizzi nella tua app specificando la versione della distinta base. Per scoprire quali versioni della libreria Firebase sono mappate a una specifica versione della distinta base, consulta le note di rilascio per quella versione della 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 Firebase Analytics. Tuttavia, se vuoi utilizzare la versione desiderata per la libreria Firebase indipendentemente dalla versione designata nella distinta base, devi specificare la versione desiderata nel seguente modo:

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'
  1. Ora sincronizza la tua app facendo clic sul pulsante Sync Now. 937206076c88ae5c.png

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

Nel passaggio successivo, imparerai a registrare gli eventi Firebase nella tua app per Android.

5. Registrare eventi con Firebase Analytics

In questo passaggio, imparerai a registrare gli eventi con Firebase Analytics nell'app per Android.

Esistono due modi per registrare gli eventi: utilizzando gli eventi suggeriti o gli eventi 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. Inoltre, sono presenti alcuni eventi suggeriti che richiedono i relativi parametri obbligatori e con questi parametri puoi massimizzare i dettagli disponibili nei report Firebase. ( Riferimento agli eventi suggeriti)

  1. Dichiara l'oggetto FirebaseAnalytics nella parte superiore dell'attività:
private lateinit var firebaseAnalytics: FirebaseAnalytics
  1. Inizializza l'oggetto nel metodo onCreate():
firebaseAnalytics = Firebase.analytics
  1. 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")
}

Utilizzo di eventi personalizzati

Se hai bisogno di eventi non coperti da quelli 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 e report aggregati sugli eventi nella console Firebase. Tuttavia, gli aggiornamenti vengono eseguiti periodicamente durante il giorno, quindi non puoi visualizzare gli eventi subito dopo averli registrati nell'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, consulta la sezione Debug degli eventi.

Ora hai completato la registrazione degli eventi nella tua app per Android.

Nel passaggio successivo, imparerai a importare questi eventi in Google Ads.

6. Importare gli eventi Firebase in Google Ads

La configurazione di Firebase-Android è terminata e puoi lanciare la campagna per app con gli eventi di azione registrati. Inizierai collegando Firebase a Google Ads. Se colleghi Firebase a Google Ads, le campagne per app potranno ottenere maggiori informazioni sui segmenti di pubblico e migliorare l'apprendimento delle campagne per app, il che di solito porta a un rendimento e a conversioni migliori.

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

412830708c61fdc0.png

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

796c921fb2b873ae.png

  1. Scegli l'account Google Ads da collegare.

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

Importare gli eventi Firebase

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

a5f302ba01a1863c.png

  1. Ora vai su Google Ads e accedi all'account che hai collegato a Firebase.
  2. In Google Ads, vai a Strumenti → Misurazione → Conversioni 7acf268d7e799a7e.png
  3. Fai clic sul pulsante + d0eed72946d038d8.png.
  4. Scegli App → Proprietà Google Analytics 4 (Firebase) e fai clic su Continua. 983f06edb15724de.png
  5. Puoi visualizzare 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. f9bdee80c0d40999.png
  6. Hai importato correttamente un evento di conversione da Firebase. be75f6a11913236.png

Ora hai completato l'importazione degli eventi Firebase in Google Ads.

Nel passaggio successivo, imparerai a lanciare una campagna per azione con l'evento che hai appena importato.

7. Lancio di campagne per azioni nell'app con eventi importati

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

19856a65ab999ad7.png

  1. 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. 8146b5a7a4f961bd.png
  2. Nella sezione Offerte, se selezioni Azioni in-app nel menu a discesa, puoi visualizzare gli eventi. Scegli gli eventi su cui vuoi concentrarti.

b75e410c7dbdfec8.png

  1. Imposta le altre impostazioni della campagna e il gioco è fatto.

8. Complimenti

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

Cosa hai imparato

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