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

1. Introduzione

Ultimo aggiornamento: 2021-02-19

Che cosa creerai

In questo codelab imparerai a implementare eventi personalizzati con GA4F iOS nell'ambiente Unity e a lanciare campagne per azione tramite Google Ads.

Durante il codelab, potrai sperimentare l'intero processo di business delle app che i nostri clienti devono affrontare. Se vuoi un'introduzione più semplice a Firebase e AdMob su iOS, inizia con AdMob+Firebase 101 Unity: configurazione e nozioni di base di Analytics.

Cosa imparerai a fare

• Come inizializzare GA4F (Google Analytics for Firebase) in Unity + iOS.
• Come creare eventi e parametri personalizzati.
• Come importare eventi da Firebase a Google Ads.
• Lanciare campagne per azione con eventi personalizzati.

Che cosa ti serve

• Xcode
• Unity
• Account Firebase
• Account Google Ads

2. Avviare un nuovo progetto Unity

Crea un'app Unity semplice basata su un modello. Modifica questa app semplice per creare l'app finita.

Avvia Unity

1. Se non hai progetti aperti, seleziona Crea un nuovo progetto.
2. Seleziona i modelli 3D dalla finestra di dialogo.
3. Compila il campo Nome progetto: ad es. Unity Firebase Custom Event.
4. Seleziona una posizione in cui salvare il progetto e fai clic su CREA.
5. Unity apre il nuovo progetto nella finestra dell'area di lavoro.

3. Creare e configurare un progetto Firebase

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

Se hai un progetto Firebase esistente in cui non è abilitato Google Analytics, puoi abilitare Google Analytics dalla scheda Integrazioni di Impostazioni > Impostazioni progetto. Passa al passaggio di configurazione di Firebase.

1. Accedi a Firebase.

Nella Console Firebase, fai clic su Aggiungi progetto(o Crea un progetto) e assegna al progetto Firebase il nome Firebase-iOS-Ads.

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

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

4. Configurazione di Unity

1. In Unity, vai a File > Impostazioni di build. Il valore importante è impostare l'ID pacchetto iOS, che otterrai nel passaggio successivo.

Verrà visualizzata la finestra di dialogo mostrata nella schermata seguente.

2. Nel progetto Unity per l'app per iOS, apri la finestra di dialogo Impostazioni di build, File > Impostazioni di build (se la piattaforma non è impostata su iOS, puoi selezionare la piattaforma iOS e fare clic sul pulsante Cambia piattaforma).

3. Dopo aver modificato la piattaforma, fai clic sul pulsante Impostazioni del giocatore per impostare l'ID pacchetto. Puoi vedere il campo di testo nell'area Identificazione.
4. Il valore del campo Identificatore bundle è l'ID pacchetto iOS (ad esempio com.yourcompany.yourproject). Copia questo valore o impostalo e copialo.
5. Nella finestra di dialogo Firebase, incolla l'ID pacchetto copiato nel campo iOS bundle ID.
6. Fai clic su Registra app.
7. Continuando in Firebase, segui le istruzioni per scaricare il file di configurazione GoogleService-Info.plist.
8. Apri la finestra Project (Progetto) del progetto Unity, quindi sposta i file di configurazione nella cartella Assets (Asset).
9. Salta i passaggi rimanenti e torna alla pagina principale della Console Firebase.

5. Configurare Firebase Analytics in Unity

In questo passaggio, inizierai ad aggiungere l'SDK Firebase al tuo progetto Unity.

1. Vai alla Console Firebase.
2. Al centro della pagina di riepilogo del progetto, fai clic sull'icona Unity ( ) per avviare il flusso di lavoro della configurazione. Se hai già aggiunto un'app al tuo progetto Firebase, fai clic su Aggiungi app per visualizzare le opzioni della piattaforma.
3. Seleziona la destinazione di build del progetto Unity che vuoi registrare oppure puoi selezionare di registrare entrambe le destinazioni contemporaneamente.

Nota: se registri solo una destinazione di build del progetto Unity, puoi sempre tornare al workflow della configurazione in un secondo momento per registrare l'altra destinazione di build.

4. Inserisci gli ID specifici della piattaforma del tuo progetto Unity.

• Per iOS : inserisci l'ID pacchetto iOS del tuo progetto Unity nel campo ID pacchetto iOS.
• Per Android : inserisci l'ID Android del tuo progetto Unity nel campo Nome pacchetto Android. I termini nome pacchetto e ID applicazione vengono spesso utilizzati in modo intercambiabile.

5. Dove trovi l'ID del tuo progetto Unity?

Nota: assicurati di inserire l'ID effettivamente utilizzato dal tuo progetto. Il valore dell'ID è sensibile alle maiuscole e non può essere modificato per queste app Firebase dopo la registrazione nel progetto Firebase.

6. (Facoltativo) Inserisci i nickname specifici della piattaforma del tuo progetto Unity. Questi nickname sono identificatori interni e pratici e sono visibili solo nella Console Firebase.
7. Fai clic su Registra app.

Aggiungere gli SDK Firebase Analytics Unity

1. Nella Console Firebase, fai clic su Scarica l'SDK Firebase Unity, quindi decomprimi l'SDK in una posizione comoda.

• Puoi scaricare di nuovo l' SDK Firebase Unity in qualsiasi momento.
• L'SDK Firebase Unity non è specifico per la piattaforma.

2. Nel tuo progetto Unity aperto, vai a Assets > Import Package > Custom Package (Asset > Importa pacchetto > Pacchetto personalizzato).
3. Dall'SDK non compresso, seleziona i prodotti Firebase supportati che vuoi utilizzare nella tua app.

• Aggiungi il pacchetto Firebase per Google Analytics: FirebaseAnalytics.unitypackage
• Aggiungi i pacchetti per tutti gli altri prodotti Firebase che vuoi utilizzare nella tua app. Ad esempio, per utilizzare Firebase Authentication e Firebase Realtime Database: FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

Unity 5.x e versioni precedenti utilizzano il framework .NET 3.x, quindi importa il pacchetto dotnet3/. Unity 2017.x e versioni successive consentono l'utilizzo del framework .NET 4.x. Se il tuo progetto Unity utilizza .NET 4.x, importa il pacchetto dotnet4/. Unity 2019 e versioni successive non supportano più il framework .NET 3.x, quindi importa il pacchetto dotnet4/.

4. Nella finestra Import Unity Package (Importa pacchetto Unity), fai clic su Import (Importa).
5. Torna alla Console Firebase e, nel flusso di lavoro della configurazione, fai clic su Avanti.

Importante: con l'SDK Firebase Unity per iOS, non disattivare lo swizzling dei metodi. Lo swizzling è richiesto dall'SDK; senza di esso, le funzionalità chiave di Firebase (come la gestione dei token FCM) non funzionano correttamente.

6. Registrare eventi personalizzati con Firebase Analytics

In questo passaggio imparerai a registrare eventi personalizzati con Firebase Analytics nell'app Unity per iOS.

Firebase Analytics registra automaticamente alcuni eventi per te; non devi aggiungere alcun codice per riceverli. Se la tua app deve raccogliere dati aggiuntivi, puoi registrare fino a 500 tipi di eventi personalizzati di Analytics diversi.

Registra eventi

Dopo aver configurato l'istanza FirebaseApp, puoi iniziare a registrare gli eventi con il metodo logEvent().

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

Visualizzare gli eventi nella console di debug di Xcode

Puoi attivare il logging dettagliato per monitorare la registrazione degli eventi da parte dell'SDK e verificare che gli eventi vengano registrati correttamente. Sono inclusi sia gli eventi registrati automaticamente sia quelli registrati manualmente.

Puoi attivare il logging dettagliato nel modo seguente:

1. In Xcode, seleziona Product > Scheme > Edit scheme… (Prodotto > Schema > Modifica schema…).
2. Seleziona Run (Esegui) dal menu a sinistra.
3. Seleziona la scheda Arguments (Argomenti).
4. Nella sezione Arguments Passed On Launch (Argomenti passati al momento dell'avvio), aggiungi -FIRAnalyticsDebugEnabled.

La prossima volta che esegui l'app, gli eventi verranno visualizzati nella console di debug di Xcode, consentendoti di verificare immediatamente che vengano inviati.

Visualizzare gli eventi nella dashboard

Vedrai l'evento registrato nella Console Firebase dopo alcune ore. Si trova in Analytics → Eventi. Puoi anche trovare i valori dei parametri facendo clic sull'evento.

Contrassegna "text_search" come conversione spostando l'opzione "Contrassegna come conversione" verso destra.

Puoi verificare se l'evento è stato contrassegnato correttamente come conversione tramite la scheda Conversioni di Firebase Analytics. Se contrassegni l'evento come conversione, Google Ads potrà anche importarlo come conversione.

7. Importare gli eventi di Analytics in Google Ads

La configurazione di Firebase-iOS è 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 scoprire di più sui segmenti di pubblico e migliorare l'apprendimento, il che di solito porta a un miglioramento del rendimento e delle conversioni.

1. Vai alle impostazioni di Firebase facendo clic sul pulsante accanto a Panoramica progetto.
2. Nella scheda Integrazioni, vedrai Google Ads e un pulsante Collega. Fai clic su Collega e continua.

3. Scegli l'account Google Ads.

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

La parte di Firebase è terminata.

Ora vai a Google Ads e accedi.

1. Vai a Google Ads e accedi, quindi vai a Strumenti e impostazioni → Misurazione → Conversioni per importare gli eventi personalizzati come conversioni.
2. Fai clic sul pulsante + per aggiungere una nuova azione di conversione.

3. Scegli le proprietà Google Analytics 4 (Firebase) e fai clic su Continua.

4. Puoi vedere tutti gli eventi di Analytics contrassegnati come conversioni. Trova l'evento clicked_counter che abbiamo implementato in precedenza.

5. Seleziona il pulsante Importa e continua.

Dopo aver impostato text_search come azione di conversione, è il momento di lanciare una campagna che ha come target gli utenti che probabilmente attiveranno gli eventi text_search.

8. Lanciare campagne per app con eventi importati

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

6. Vai alla scheda Campagna del tuo account attuale e avvia una nuova campagna facendo clic sul pulsante +. Fai clic sulla nuova campagna e continua.
7. Per questa volta, lanceremo una campagna per la promozione di app con l'opzione Installazioni di app.

8. Trova la tua app fornendo il nome dell'app, il nome del pacchetto o l'editore.
9. Nella sezione Offerte, seleziona Azioni in-app nel menu a discesa per concentrare gli annunci sulle azioni.
10. Puoi trovare i tuoi eventi personalizzati nell'elenco fornito. Imposta il costo per azione target e compila anche le altre opzioni.

11. Configura le impostazioni della campagna. Questo argomento non rientra nell'ambito del codelab, quindi consulta questi documenti o contattaci tramite altri canali per ottimizzare le impostazioni.

9. Complimenti

Complimenti, hai integrato correttamente Firebase con Unity e Google Ads. Questo ti aiuterà a migliorare il rendimento della campagna.

Cosa hai imparato

• Come configurare Firebase per la piattaforma Unity iOS
• Come registrare eventi personalizzati con Unity e Firebase Analytics
• Come importare gli eventi e utilizzarli per le campagne per azione.

Documenti di riferimento

• Aggiungere Firebase al progetto Unity
• GitHub: firebase/quickstart-unity