Integrar o Firebase ao projeto de serviços relacionados a jogos do Google Play

O Firebase pode ajudar a melhorar seu jogo:

• Registre eventos de jogos usando o Google Analytics, uma solução sem custo financeiro de métricas de apps que fornece insights sobre o uso do app e o engajamento do usuário.

• Use qualquer um dos produtos do Firebase compatíveis com jogos, como Crashlytics, Configuração remota e muito mais.

Primeiros passos

1. Crie um projeto do Firebase e adicione-o ao seu jogo (C++ | Unity).

   Observações:

   • Se você já tiver vinculado sua conta de desenvolvedor do Google Play a um projeto do Google Cloud no Play Console, use o mesmo projeto para começar a usar o Firebase. Nos bastidores, um projeto do Firebase é um projeto do Google Cloud (saiba mais).
   • Ative o Google Analytics durante o fluxo de criação do projeto do Firebase ou ative-o após a criação do projeto na guia Integrações do Console do Firebase.

2. Vincule o app do Firebase à sua conta de desenvolvedor do Google Play. Esse mesmo link será usado pelo seu projeto de serviços relacionados a jogos do Google Play.
   No Console do Firebase, acesse a guia Integrações. No card Google Play, clique em Vincular e siga as instruções na tela para criar a vinculação.

3. Verifique se o app no Google Play está configurado para usar os serviços relacionados a jogos do Google Play.

   Quando você receber uma solicitação para especificar se o jogo já usa APIs do Google, selecione Sim, meu jogo já usa APIs do Google. Selecione seu projeto do Firebase na lista e clique em Usar.

Registrar eventos de jogos usando o Google Analytics

1. Adicionar o Google Analytics ao app.

2. Depois de adicionar o SDK do Firebase para o Google Analytics ao seu app, é possível começar a registrar eventos do Play Games. Veja alguns exemplos de eventos que você pode registrar:

   • Eventos de login

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

   • Desbloquear conquistas

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

   • Pontuação em um placar

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

3. É possível visualizar os eventos registrados no painel do Analytics no Console do Firebase.

   Você também pode acessar o Console do Firebase diretamente no Play Console clicando no ícone do Firebase ao lado do ícone do app na página de detalhes do jogo.

Como solucionar erros comuns

Não é possível visualizar os eventos do Play Games no painel do Analytics

• Verifique se você ativou o Google Analytics para o projeto do Firebase e se integrou o Google Analytics ao seu jogo.

• Verifique se o código implementa eventos para LOGIN, UNLOCK_ACHIEVEMENT ou POST_SCORE.

• Verifique se o SDK está registrando eventos, então ative o registro detalhado. Como os dispositivos agrupam os eventos em lote para preservar a bateria, pode demorar algum tempo para que esses eventos fiquem visíveis no painel do Analytics.

Não é possível vincular o Google Play ao Firebase

O que você precisa fazer para vincular o Google Play ao Firebase usando o Console do Firebase ( > Configurações do projeto > Integrações > Google Play). Se você tiver problemas para vincular, verifique o seguinte:

• Verifique se o app atende a todos os pré-requisitos para vinculação.

• Verifique se você tem o acesso necessário para criar o link.

Não é possível acessar o Console do Firebase pelo Play Console

Verifique se a sua conta de desenvolvedor do Google Play está vinculada a um app do Firebase. No Play Console, um proprietário ou administrador da conta de desenvolvedor do Google Play pode ver o status da vinculação em Configuração > Serviços vinculados > Firebase.