Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
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.
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:
No Google Play Console,
clique no ícone Serviços relacionados a jogos à esquerda e
selecione a entrada do jogo.
Selecione a guia Eventos à esquerda e clique no botão Adicionar evento.
Preencha os detalhes do evento que você quer criar.
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:
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.
Faça as mudanças.
Quando terminar de editar o evento, clique no botão Salvar.
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.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-26 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-26 UTC."],[],[],null,["# Events\n\nThe Google Play Games events service allows you to collect cumulative\ndata generated by your players during gameplay and store them in Google's\nservers for game analytics. You can flexibly define what player data your game\nshould collect; this might include metrics such as how often:\n\n- Players use a particular item\n- Players reach a certain level\n- Players perform some specific game action\n\nYou can use the events data as feedback on how to improve your game. For\nexample, you can adjust the difficulty level of certain levels in your game\nthat players are finding too hard to complete.\n\nTo learn how to implement events for your platform, see\n[Client implementations](#implement-event).\n\nIntegrate events in your game\n-----------------------------\n\nThe following workflow describes how you can apply events in your\ngame:\n\n1. **Define events** . To define new events to capture in your game:\n 1. Go to the *Events* page for your game in the [Google Play Console](//play.google.com/apps/publish/).\n 2. Click the *Add new event* button and configure the [event properties](#event-basics).\n 3. Publish your event definitions by following the steps described in [Publishing your game changes](/games/pgs/console/publish).\n2. **Implement event capturing in your game using the events APIs** . For\n example, in your Android code, call the events `increment` method whenever\n your game detects that an event that it cares about has been triggered.\n\n | **Note:** On mobile clients, Play Games SDK updates events in batches, so you will see cumulative, rather than fine-grained, changes to your events. When using the REST API, implement your own batching to avoid sending event updates too frequently, as this might cause you to quickly exceed your [rate limits](/games/pgs/quota).\n3. **View events data** . Go to the *Events* page for your game in\n Google Play Console to view statistics for the captured events.\n\nEvent basics\n------------\n\nThe events APIs provide you with a way to define and collect interesting gameplay\nmetrics and upload these metrics to Play Games SDK.\n\nA Play Games SDK event contains these key properties:\n\n| Property | Description |\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **ID** | A unique string generated by Google Play Console for this event. Use this unique ID to refer to the event in your game clients. |\n| **Name** | A short name of the event. The name can be up to 100 characters. This value is used by Google Play Console and can be displayed in your game. Examples: - *\"Zombies Killed\"* - *\"Red Gems Collected\"* |\n| **Description** | A longer description of the event (for example, \"Number of times a player has killed a zombie\" or \"The total number of red gems the player has eliminated and matched\"). The description can be up to 500 characters. This value is used by Google Play Console and can be displayed in your game. |\n| **Event type** | A field that declares the type of data the event is tracking. This value is used by Google Play Console to support Player Analytics reporting. Two event types are supported: Premium currency source : Select this type for events that track sources of a premium currency. For example: - *\"Gold coins earned\"* - *\"Emeralds bought\"* Premium currency sink : Select this type for events that track sinks, or consumption, of a premium currency. For example: - *\"Gold coins spent\"* - *\"Emeralds used\"* \u003cbr /\u003e |\n| **Icon** | A square icon that will be associated with your event. |\n\n### Create an event\n\nTo create a new event for your game, follow these steps:\n\n1. In the [Google Play Console](https://play.google.com/apps/publish/), click the **Game services** icon on the left and select the entry for your game.\n2. Select the **Events** tab on the left, and click the **Add event** button.\n3. Fill in the details for the event you want to create.\n4. Click **Save** . If there are no errors, your event is placed in the \"Ready to publish\" state. You can now proceed to [publish your game changes](/games/pgs/console/publish).\n\n### Edit an event\n\nTo edit an event that you've created:\n\n1. In the [Google Play Console](https://play.google.com/apps/publish/), open the **Events** tab and select the entry for the event you want to edit. You should see the same form you used when creating the event.\n2. Make your edit changes.\n3. When you've finished editing the event, click the **Save** button.\n4. Test your game to verify the modified event. If it is working correctly, [republish your game changes](/games/pgs/console/publish).\n\n### Delete an event\n\nYou can delete events that are in draft state or that have been published. To\ndelete an event in Google Play Console, click the button labeled **Delete**\nat the bottom of the form for that event.\n\n### Reset event data\n\nYou can reset player progress data for testers of your events.\n\n- To reset draft events in Google Play Console, click the button labeled **Reset event progress** at the bottom of the form for that event.\n- To reset event data programmatically, call the [Management API `Events` methods](/games/services/management/api/events).\n\nClient implementations\n----------------------\n\nTo learn how to implement events for your platform, see the following resources:\n\n- [Android](/games/pgs/android/events)\n- [Web](/games/services/web/api/rest#rest-resource:-events)"]]
