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

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

Informazioni su questo codelab

Ultimo aggiornamento: lug 14, 2021

Scritto da: Haruo Takamatsu

1. Introduzione

Ultimo aggiornamento: 2021-02-19

Cosa creerai

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

Durante questo codelab, potrai sperimentare l'intero processo di business delle app che i nostri clienti devono affrontare. Per leggere un'introduzione rapida a Firebase e AdMob su iOS, inizia con AdMob + Firebase 101 Unity: Configurazione e Nozioni di base su 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 in Google Ads.
• Lanciare campagne per azione con eventi personalizzati.

Che cosa ti serve

• Xcode
• Unity
• Account Firebase
• Account Google Ads

2. Avvia un nuovo progetto Unity

Creare una semplice app Unity basata su modelli. Modifica questa semplice app per creare l'app completa.

Lancia Unity

1. Se non hai progetti aperti, seleziona Crea nuovo progetto.
2. Seleziona i modelli 3D dalla finestra di dialogo.
3. Inserisci il nome del progetto: ad es. Evento personalizzato Firebase Unity.
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. Crea e configura un progetto Firebase

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

Se hai già un progetto Firebase in cui Google Analytics non è abilitato, puoi attivarlo dalla scheda Integrazioni delle impostazioni > Impostazioni progetto. Vai al passaggio di configurazione di Firebase.

1. Accedi a Firebase.

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

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.

4. Configurazione Unity

1. In the Unity > File > Impostazioni build. Il valore importante è impostare l'ID pacchetto iOS, che si otterrà seguendo il passaggio seguente.

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 build, File > Impostazioni build (se la piattaforma non è impostata per iOS puoi selezionare la piattaforma iOS e fare clic sul pulsante Cambia piattaforma)

3. Dopo il cambiamento della piattaforma, fai clic sul pulsante Impostazioni player per impostare l'ID gruppo. Il campo di testo sarà visibile 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. Proseguendo con Firebase, segui le istruzioni per scaricare il file di configurazione GoogleService-Info.plist
8. Apri la finestra Progetto del tuo progetto Unity, quindi sposta i file di configurazione nella cartella Asset.
9. Ignora i passaggi rimanenti e torna alla pagina principale della console Firebase.

5. Configura 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 panoramica del progetto, fai clic sull'icona Unity ( ) per avviare il flusso di lavoro di 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 della build del tuo progetto Unity che vuoi registrare oppure puoi anche selezionare la registrazione di entrambe le destinazioni contemporaneamente.

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

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

• Per iOS: inserisci l'ID iOS del progetto Unity nel campo ID pacchetto iOS.
• Per Android: inserisci l'ID Android del 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 nel tuo progetto. Il valore dell'ID è sensibile alle maiuscole e non può essere modificato per queste app Firebase dopo che sono state registrate nel progetto Firebase.

6. (Facoltativo) Inserisci i nickname specifici della piattaforma del progetto Unity. Questi nickname sono identificatori di convenienza interni e sono visibili solo a te nella console Firebase.
7. Fai clic su Registra app.

Aggiungi 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 nuovamente l'SDK Firebase Unity in qualsiasi momento.
• L'SDK Firebase Unity non è specifico per la piattaforma.

2. Nel progetto Unity aperto, vai ad 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 nell'app. Ad esempio, per utilizzare Firebase Authentication e Firebase Realtime Database: FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

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

4. Nella finestra Importa pacchetto Unity, fai clic su Importa.
5. Torna alla console Firebase e fai clic su Avanti nel flusso di lavoro di configurazione.

Importante: con l'SDK Firebase Unity per iOS, non disattivare la rotazione dei metodi. Lo spinning è richiesto dall'SDK; in caso contrario, le funzionalità chiave di Firebase (come la gestione dei token FCM) non funzionano correttamente.

6. Registra eventi personalizzati con Firebase Analytics

In questo passaggio, imparerai come 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 diversi tipi di eventi personalizzati di Analytics al suo interno.

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);

Visualizza gli eventi nella console di debug Xcode

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

Puoi attivare il logging dettagliato nel seguente modo:

1. In Xcode, seleziona Product > (Prodotto > Schema > Modifica schema...
2. Seleziona Esegui nel menu a sinistra.
3. Seleziona la scheda Argomenti.
4. Nella sezione Arguments Passed On Launch (Argomenti passati al lancio), aggiungi -FIRAnalyticsDebugEnabled.

La volta successiva che eseguirai l'app, i tuoi eventi verranno visualizzati nella console di debug Xcode, aiutandoti a verificare immediatamente che gli eventi vengano inviati.

Visualizza gli eventi nella dashboard

Tra qualche ora vedrai l'evento registrato nella console Firebase. Si trova in Analytics → Eventi. Puoi trovare i valori parametro anche facendo clic sull'evento.

Segnerai "text_search" come conversione facendo scorrere "Contrassegna come conversione" passa a destra.

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

7. Importare gli eventi di analisi in Google Ads

La configurazione di Firebase-iOS è terminata ed è tutto pronto per 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.

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.

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

Ora la parte su Firebase è terminata.

Ora, vai a Google Ads e accedi.

1. Vai su Google Ads, accedi e vai a Strumenti e Impostazioni → Misurazione → Conversioni per l'importazione di 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 visualizzare tutti gli eventi di analisi che sono contrassegnati come conversioni. Trova l'evento clicked_counter che abbiamo implementato in precedenza.

5. Controlla e fai clic sul pulsante Importa e continua.

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

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

6. Vai alla scheda Campagna dell'account corrente e avvia una nuova campagna facendo clic sul pulsante +. Fai clic sulla nuova campagna e continua.
7. Per il momento, lanceremo una campagna per la promozione di app con l'opzione Installazioni di app.

8. Trova la tua app indicando il nome dell'app, il nome del pacchetto o del publisher.
9. Nella sezione Offerte, seleziona Azioni in-app nella casella personale per fare in modo che Annunci si concentrino sulle azioni.
10. puoi trovare i tuoi eventi personalizzati nell'elenco fornito. Imposta il costo per azione target e compila anche altre opzioni.

11. Configura le impostazioni della campagna. Queste informazioni non rientrano nell'ambito del codelab, quindi consulta questi documenti o contattalo tramite altri canali per ottimizzare le impostazioni.

9. Complimenti

Congratulazioni, hai completato l'integrazione di Firebase in Unity e Google Ads. In questo modo, potrai migliorare il rendimento della tua campagna.

Hai appreso

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

Documenti di riferimento

• Aggiungi Firebase al tuo progetto Unity
• GitHub: Firebase/quickstart-unity