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 jogo no Google Play Console para conferir as estatísticas dos eventos capturados.

Noções básicas sobre eventos

As APIs de eventos oferecem uma maneira de definir e coletar métricas de jogabilidade interessantes e fazer upload delas ao SDK do Play Games.

Um evento do SDK do Play Games contém estas propriedades importantes:

Propriedade Descrição
ID Uma string exclusiva gerada pelo Google Play Console para o evento em questão. Use esse ID exclusivo para se referir ao evento nos seus clientes de jogo.
Nome Um nome curto do evento com até 100 caracteres. Esse valor é usado pelo Google Play Console e pode ser mostrado 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. O valor é usado pelo Google Play Console e pode ser mostrado 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 a relatórios de Análise do jogador.

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.

Criar um evento

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

  1. Adicione o jogo ao Google Play Console, caso ainda não tenha feito isso.
  2. 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.

Editar um evento

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

  1. No Google Play Console, abra a guia Eventos e selecione a entrada do evento que você quer 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.

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 na parte de baixo do formulário.

Redefinir dados do evento

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 progresso de evento na parte de baixo do formulário correspondente.
  • 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: