Eventi personalizzati Google Ads con Google Analytics per Firebase - Android

1. Introduzione

Ultimo aggiornamento: 2020-12-14

Cosa costruirai

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

Questo codelab si concentra sull'implementazione di eventi con GA4F e sull'importazione degli eventi in Google Ads. Se vuoi imparare come creare un'app Android con Firebase, fai riferimento a Firebase Android Codelab-Build Friendly Chat .

Cosa imparerai

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

Di cosa avrai bisogno

• Android Studio 3.6 o versione successiva
• Conto Firebase
• Account Google Ads

2. Crea e configura un progetto Firebase

Per iniziare con Firebase, dovrai creare e configurare un progetto Firebase.

Crea un progetto Firebase

1. Accedi a Firebase .

Nella console Firebase, fai clic su Aggiungi progetto (o Crea un progetto) e dai il nome che desideri al tuo progetto Firebase.

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

Per ulteriori informazioni sui progetti Firebase, consulta Comprendere i progetti Firebase .

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

4. Ora la creazione del progetto Firebase è terminata!

Nel passaggio successivo imparerai come aggiungere Firebase alla tua app Android.

3. Aggiungi Firebase alla tua app Android

Registra l'app

1. Nella console Firebase, seleziona Panoramica del progetto nel menu di navigazione sinistro, quindi fai clic sul pulsante Android sotto "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, apri il nome file build.gradle . Nel file cercare 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 Google Sign In o Firebase Dynamic Links (tieni presente che questi non fanno parte di questo codelab, per ulteriori informazioni sulla chiave SHA-1, fai riferimento a questo documento ). .

Suggerimento : leggere Imposta l'ID dell'applicazione per ulteriori informazioni sugli ID del pacchetto e dell'applicazione.

3. Fare 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 (che hai appena scaricato sopra) nella directory app . Torna alla console Firebase, fai clic sul pulsante Avanti.

Abilita Firebase nella tua app

1. È necessario il plug-in Google Services Gradle per leggere il file google-services.json generato da Firebase.
2. In Android Studio, apri <project>/build.gradle , quindi aggiungi le seguenti righe nel 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 nel 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 come 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 Android Firebase che ti consente di gestire le versioni della libreria Firebase che stai utilizzando nella tua app specificando la versione della distinta base. Per sapere quali versioni della libreria Firebase sono mappate su una specifica versione della distinta base, consulta le note sulla versione per quella versione della distinta base.

1. Apri <project>/<app-module>/build.gradle , quindi aggiungi le seguenti righe nel 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 di analisi Firebase. Ma se desideri 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 .

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

Nel passaggio successivo imparerai come registrare gli eventi Firebase nella tua app Android.

5. Registra gli eventi con Firebase Analytics

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

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

Utilizzo degli eventi suggeriti

L'SDK di 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 ci sono alcuni eventi suggeriti che richiedono i parametri prescritti e con tali parametri puoi massimizzare i dettagli disponibili nei tuoi rapporti Firebase. ( Riferimento 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 codice seguente 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 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. Ma gli aggiornamenti avvengono periodicamente durante il giorno, non puoi visualizzare tali eventi immediatamente dopo averli registrati nella tua app.

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

Ora hai completato la registrazione degli eventi sulla tua app Android!

Nel passaggio successivo imparerai come importare tali eventi in Google Ads.

6. Importa eventi Firebase in Google Ads

La configurazione di Firebase-Android è terminata e sei pronto per lanciare la campagna per app con gli eventi di azione registrati. Inizierai collegando Firebase a Google Ads. Collegando Firebase a Google Ads, le campagne per app saranno in grado di ottenere maggiori informazioni sui segmenti di pubblico e aumentare gli apprendimenti sulle campagne per app, che in genere portano a prestazioni e conversioni migliori.

Collega Firebase e Google Ads

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

2. Nella scheda Integrazioni vedrai Google Ads e un pulsante Collegamento. Fare clic su Collega e continua.

3. Scegli l'account Google Ads che desideri collegare.

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

Importa eventi Firebase

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

Attenzione: se l'evento di destinazione non è contrassegnato come conversione, Google Ads non sarà in grado di 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 su Strumenti → Misurazione → Conversioni
4. Fare clic sul pulsante +
5. Scegli App → Proprietà Google Analytics 4 (Firebase) e fai clic su Continua.
6. Puoi visualizzare tutti gli eventi di analisi contrassegnati come conversioni. Trova l'evento che desideri importare. In questo caso scegli l'evento delete_item che abbiamo implementato in precedenza. Fare clic sul pulsante Importa e continua.
7. Hai importato correttamente un evento di conversione da Firebase.

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

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

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

Importante: per lanciare una campagna per app, è necessaria un'app a livello di produzione in Google Play. Se non sei pronto per pubblicare l'app, lascia questo passaggio per ora.

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 di promozione delle app con l'opzione Installazioni app. In basso, scegli l'app che desideri promuovere e fai clic su Continua.
3. Nella sezione Offerte, se selezioni Azioni in-app nel menu a tendina puoi visualizzare gli eventi. Scegli uno o più eventi su cui vuoi concentrarti.

4. Imposta il resto delle impostazioni della campagna e hai finito.

8. Congratulazioni

Congratulazioni, hai integrato con successo Firebase e Google Ads! Questo ti aiuterà a migliorare il rendimento della tua campagna.

Hai imparato

• Come configurare Firebase Analytics per Android
• Come registrare eventi con Firebase Analytics in un'app Android.
• Come importare eventi e utilizzarli per campagne d'azione.