Integrare Firebase con il progetto Servizi per i giochi di Play

Firebase può aiutarti a migliorare il tuo gioco:

• Registra gli eventi di gioco con Google Analytics, una soluzione di misurazione delle app senza costi che fornisce insight sull'utilizzo delle app e sul coinvolgimento degli utenti.

• Utilizza uno dei prodotti Firebase che supportano i giochi, come Crashlytics, Remote Config e altri.

Inizia

1. Se non l'hai già fatto, crea un progetto Firebase, quindi aggiungi Firebase al tuo gioco (C++ | Unity).

   Tieni presente quanto segue:

   • Se in precedenza hai collegato il tuo account sviluppatore Google Play a un progetto Google Cloud nella console Play, utilizza lo stesso progetto per iniziare a utilizzare Firebase. Dietro le quinte, un progetto Firebase è un progetto Google Cloud (scopri di più).
   • Assicurati di attivare Google Analytics durante il flusso di creazione del progetto Firebase o di attivarlo dopo la creazione del progetto nella scheda Integrazioni della console Firebase.

2. Collega la tua app Firebase al tuo account sviluppatore Google Play. Questo stesso link verrà utilizzato dal tuo progetto Play Games services.
   Nella console Firebase, vai alla scheda Integrazioni. Nella scheda Google Play, fai clic su Collega e segui le istruzioni sullo schermo per creare il collegamento.

3. Assicurati che la tua app in Google Play sia configurata per l'utilizzo di Play Games services.

   Quando ti viene chiesto di specificare se il tuo gioco utilizza già le API di Google, scegli Sì, il mio gioco utilizza già le API di Google. Seleziona il tuo progetto Firebase dall'elenco e poi fai clic su Utilizza.

Registra gli eventi di Games utilizzando Google Analytics

1. Aggiungi Google Analytics alla tua app.

2. Dopo aver aggiunto l'SDK Firebase per Google Analytics alla tua app, puoi iniziare a registrare gli eventi Play Games. Ecco alcuni esempi di eventi che puoi registrare:

   • Eventi di accesso

     Bundle bundle = new Bundle();
     mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.LOGIN, bundle);
     

   • Sblocca obiettivi

     Bundle bundle = new Bundle();
     bundle.putString(FirebaseAnalytics.Param.ACHIEVEMENT_ID, achievementId);
     mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.UNLOCK_ACHIEVEMENT, bundle);
     

   • Punteggi in una classifica

     Bundle bundle = new Bundle();
     bundle.putLong(FirebaseAnalytics.Param.SCORE, score);
     bundle.putString("leaderboard_id", leaderboardId);
     mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.POST_SCORE, bundle);
     

3. Puoi visualizzare gli eventi registrati nella dashboard Analytics della console Firebase.

   Puoi accedere alla console Firebase anche dalla Console Play facendo clic sull'icona di Firebase accanto all'icona della tua app nella pagina Dettagli del gioco.

Risoluzione dei problemi comuni

Impossibile visualizzare gli eventi Play Games nella dashboard Analytics

• Verifica di aver attivato Google Analytics per il tuo progetto Firebase e di aver integrato Google Analytics nel tuo gioco.

• Verifica che il codice implementi gli eventi per LOGIN, UNLOCK_ACHIEVEMENT o POST_SCORE.

• Verifica che l'SDK registri gli eventi attivando il logging dettagliato. Poiché i dispositivi raggruppano gli eventi per preservare la durata della batteria, potrebbe essere necessario un po' di tempo prima che questi eventi siano visibili nella dashboard di Analytics.

Impossibile collegare Google Play a Firebase

Devi collegare Google Play a Firebase utilizzando la console Firebase ( > Impostazioni progetto > Integrazioni > Google Play). Se hai difficoltà con il collegamento, controlla quanto segue:

• Assicurati che la tua app soddisfi tutti i prerequisiti per il collegamento.

• Assicurati di disporre dell'accesso richiesto per creare il collegamento.

Impossibile accedere alla console Firebase dalla console Play

Assicurati che il tuo account sviluppatore Google Play sia collegato a un'app Firebase. Nella Console Play, un proprietario o un amministratore dell'account sviluppatore Play può visualizzare lo stato del collegamento in Configurazione > Servizi collegati > Firebase.