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

1. Introduzione

Ultimo aggiornamento: 2020-12-14

Cosa creerai

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

Questo codelab riguarda l'implementazione degli eventi con GA4F e l'importazione degli eventi in Google Ads. Se vuoi imparare a creare un'app Android con Firebase, consulta l'articolo sulla chat ottimizzata per la creazione di codelab per Android di Firebase.

Cosa imparerai a fare

• Come creare un progetto Firebase
• Implementare l'SDK Firebase nell'app per Android
• Come creare eventi e parametri.
• Come importare eventi da Firebase in Google Ads
• Lanciare 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 impostare 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 il nome che preferisci al progetto Firebase.

2. Fai clic sulle varie opzioni di creazione del progetto. Accetta i termini di Firebase, se richiesto. Dovresti abilitare Google Analytics per questo progetto perché hai bisogno degli eventi di Google Analytics per monitorare gli eventi di azione e le conversioni.

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

3. Scegli un account Google Analytics. Se ne hai una, scegli quella o creane una nuova. Fai clic sul pulsante Crea progetto.

4. Ora la build del progetto Firebase è terminata.

Nel prossimo passaggio 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 menu di navigazione a sinistra, quindi fai clic sul pulsante Android in "Inizia aggiungendo Firebase alla tua app"

2. Inserisci le informazioni necessarie.

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

Qui non abbiamo bisogno della chiave SHA-1, a meno che tu non abbia intenzione di utilizzare Accedi con Google o Firebase Dynamic Links. Tieni presente che questi link non fanno parte di questo codelab. Per saperne di più sulla chiave SHA-1, consulta questo documento.

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

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

2. In Android Studio, vai alla directory app e sposta il file google-services.json (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, devi disporre del 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
      ...
      }
   }
}

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 imparerai ad aggiungere l'SDK Firebase alla tua app.

4. Aggiungi l'SDK Firebase alla tua 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 Firebase in uso nell'app specificando la versione della distinta base. Per sapere quali versioni della libreria Firebase sono mappate 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 è necessario specificare la versione della libreria Firebase Analytics. Tuttavia, se vuoi utilizzare la versione desiderata per la tua libreria Firebase indipendentemente dalla versione designata nella distinta base, devi solo specificare la versione desiderata in questo 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'

2. Ora sincronizza la tua 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 imparerai a registrare gli eventi Firebase nella tua app per Android.

5. Registra eventi con Firebase Analytics

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

Esistono due modi per registrare gli eventi: utilizzare 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, alcuni eventi suggeriti richiedono l'utilizzo di parametri prescritti, con i quali puoi massimizzare i dettagli disponibili nei report Firebase. ( Informazioni sugli 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 i parametri personalizzati:

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

Eventi di debug

Puoi visualizzare i dati aggregati e i report sugli eventi nella console Firebase. Tuttavia, gli aggiornamenti vengono eseguiti periodicamente nel corso della giornata e non potrai visualizzarli subito dopo averli collegati all'app.

Per eseguire 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 Evento di debug.

Hai completato la registrazione degli eventi nell'app per Android.

Nel passaggio successivo, imparerai come 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. Inizia collegando Firebase a Google Ads. Se colleghi Firebase a Google Ads, le campagne per app potranno acquisire una conoscenza di più sui segmenti di pubblico e migliorare le conoscenze acquisite sulle campagne per app, il che, in genere, migliora il rendimento e le 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 Link. Fai clic su Collega e continua.

3. Scegli l'account Google Ads da collegare.

Hai completato il collegamento tra Firebase e Google Ads. Importa gli eventi Firebase in Google Ads.

Importare gli eventi Firebase

1. Nella console Firebase, vai al menu Eventi e contrassegna l'evento da 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 su Google Ads e accedi all'account collegato a Firebase.
3. In Google Ads, vai a Strumenti → Misurazione → Conversioni
4. Fai clic sul pulsante +
5. Scegli App → Proprietà Google Analytics 4 (Firebase) e fai clic su Continua.
6. Puoi visualizzare tutti gli eventi di analisi che sono contrassegnati come conversioni. Trova l'evento da importare. In questo caso, scegli l'evento delete_item che abbiamo implementato in precedenza. Fai clic sul pulsante Importa e continua.
7. Hai importato un evento di conversione da Firebase.

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

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

7. Lancio di campagne per app per azione con eventi importati

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

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

2. Lanceremo una campagna per la promozione di app con l'opzione Installazioni di app. In basso, scegli l'app da promuovere e fai clic su Continua.
3. Nella sezione Offerte, se selezioni Azioni in-app nel menu a discesa, puoi visualizzare gli eventi. Scegli uno o più eventi su cui concentrarti.

4. Configura le altre impostazioni della campagna ed è fatta.

8. Complimenti

Congratulazioni, hai completato l'integrazione tra Firebase e Google Ads. In questo modo, potrai migliorare il rendimento della tua 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 per azione.