Eventos

O serviço de eventos do Google Play Games permite coletar dados cumulativos gerados pelos jogadores durante as partidas e armazenar essas informações nos servidores do Google para análises de jogos. É possível definir de maneira flexível quais dados o jogo precisa coletar. Isso inclui métricas como a frequência com queos jogadores:

  • Usam um item específico
  • Alcançam um determinado nível
  • Realizam alguma ação específica no jogo

É possível usar os dados de eventos como feedback para melhorar o jogo. Por exemplo, você pode ajustar o nível de dificuldade de determinados níveis que os jogadores têm dificuldade de concluir.

Para aprender a implementar eventos na sua plataforma, consulte Implementações de clientes.

Como integrar eventos no jogo

O fluxo de trabalho abaixo descreve como aplicar eventos ao jogo:

  1. Defina os eventos. Para definir os novos eventos que vão ser capturados no jogo, siga estas etapas:
    1. Acesse a página Eventos do jogo no Google Play Console.
    2. Clique no botão Adicionar novo evento e configure as propriedades do evento.
    3. Publique as definições do evento seguindo as etapas descritas em Como publicar as mudanças no seu jogo.

  2. Implemente a captura de eventos no seu jogo usando as APIs de eventos. Por exemplo, no código Android, chame o método increment de eventos sempre que o jogo detectar que um evento importante foi acionado.

  3. Confira os dados dos eventos. Acesse a página Eventos do seu jogo na Google Play Console para conferir as estatísticas dos eventos capturados.

Noções básicas sobre eventos

As APIs de eventos oferecem uma forma de definir e coletar informações de gameplay e faça o upload delas nos serviços relacionados a jogos do Google Play.

Um evento dos serviços relacionados a jogos do Google Play contém estas propriedades principais:

Propriedade Descrição
ID É uma string exclusiva gerada pelo Google Play Console para o evento. Usar esse ID exclusivo para se referir ao evento nos clientes do jogo.
Nome Um nome curto do evento com até 100 caracteres. Esse valor é usado pelo Google Play Console e pode ser exibido no jogo.

Exemplos:

  • "Zumbis derrotados"
  • "Joias vermelhas coletadas"
Descrição Uma descrição mais longa do evento, como "número de vezes que um jogador matou um zumbi" ou "número total de joias vermelhas que o jogador destriu". Essa descrição pode ter até 500 caracteres. Esse valor é usado pelo Google Play Console e pode ser exibido no jogo.
Tipo de evento

Um campo que declara o tipo de dados que o evento está rastreando. Esse valor é usado pelo Google Play Console para oferecer suporte ao Player Relatórios do Google Analytics.

Há suporte para dois tipos de evento:

Fonte de moeda premium
Selecione esse tipo para eventos que rastreiam fontes de uma moeda premium. Por exemplo:
  • "Moedas de ouro conquistadas"
  • "Esmeraldas compradas"
Coletor de moeda premium
Selecione esse tipo para eventos que rastreiam coletores ou consumos de uma moeda premium. Por exemplo:
  • "Moedas de ouro gastas"
  • "Esmeraldas usadas"
Ícone Um ícone quadrado que é associado ao evento.

Como criar um evento

Para criar um novo evento no jogo, siga estas etapas:

  1. Adicione o jogo ao Google Play Console, se: ainda não tenha feito isso.
  2. No Google Play Console, clique no ícone dos serviços relacionados a jogos à esquerda e selecione a entrada do jogo.
  3. Selecione a guia Eventos à esquerda e clique no botão Adicionar evento.
  4. Preencha os detalhes do evento que você quer criar.
  5. Clique em Salvar. Se não houver erros, seu evento vai ser colocado no estado "Pronto para publicar". Agora, você pode publicar as mudanças no jogo.

Como editar um evento

Para editar um evento que você criou, siga estas etapas:

  1. No Google Play Console, abra a guia Eventos e selecione o entrada para o evento que você deseja editar. Você vai encontrar o mesmo formulário usado na criação.
  2. Faça as mudanças.
  3. Quando terminar de editar o evento, clique no botão Salvar.
  4. Teste o jogo para verificar o evento modificado. Se ele estiver funcionando corretamente, publique as mudanças no jogo.

Como excluir um evento

Você pode excluir eventos em estado de rascunho ou que foram publicados. Para excluir um evento no Google Play Console, clique no botão Excluir em parte inferior do formulário para o evento.

Como redefinir dados de eventos

Você pode redefinir os dados de progresso do jogador para os testadores de eventos.

  • Para redefinir os eventos de rascunho no Google Play Console, clique no botão Redefinir o progresso do evento na parte inferior do formulário.
  • Para redefinir os dados de eventos de forma programática, chame os métodos Events da API Management.

Implementações do cliente

Para aprender a implementar eventos na sua plataforma, consulte estes recursos: