Integrare Firebase con il progetto Servizi per i giochi di Play

Firebase può aiutarti a far fare un salto di qualità al tuo gioco:

• Registra gli eventi di Google Play con Google Analytics, una soluzione di misurazione delle app senza costi che fornisce informazioni sull'utilizzo dell'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 ancora fatto, crea un progetto Firebase e 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 dopo la creazione del progetto nella scheda Integrazioni della console Firebase.

2. Collega l'app Firebase al tuo account sviluppatoreGoogle Play. Lo 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 l'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à API di Google, scegli Sì, il mio gioco utilizza già API di Google. Seleziona il progetto Firebase dall'elenco e poi fai clic su Utilizza.

Registra gli eventi di Google Play 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);
     

   • Sbloccare 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 Firebase accanto all'icona della tua app nella pagina Dettagli del gioco.

Risolvere gli errori comuni

Impossibile visualizzare gli eventi Play Games nella dashboard Analytics

• Verifica di aver abilitato 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, può essere necessario del tempo prima che questi eventi siano visibili nella dashboard 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à a eseguire 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.