Este documento explica como integrar as estatísticas do jogo ao seu jogo usando o Google Play Console. Ele aborda os formatos essenciais de arquivos CSV e ZIP e descreve como criar, importar e gerenciar esses arquivos.
Criar eventos
Para criar um evento para um jogo novo e não publicado, siga estas etapas:
- Criar o arquivo CSV de eventos PlayerGameEvent.csv
- No Google Play Console, selecione um jogo.
- Na página Estatísticas do jogo dos serviços do Google Play Games (Aumentar o número de usuários > serviços do Google Play Games > Configuração e gerenciamento > Estatísticas do jogo), selecione Configurar eventos.
- Na página Configuração de eventos, solte o arquivo CSV para fazer upload.
- Depois de criar um evento, você precisa configurar as estatísticas.
Configurar estatísticas
Depois de criar um evento, configure as estatísticas:
- Crie o arquivo ZIP com estatísticas, localizações e arquivos de ícones. Diretrizes para arquivos ZIP de estatísticas.
- No Google Play Console, selecione um jogo.
- Na página Estatísticas do jogo dos serviços do Google Play Games (Aumentar o número de usuários > serviços do Google Play Games > Configuração e gerenciamento > Estatísticas do jogo), selecione Configurar estatísticas.
- Na página Configuração das estatísticas do jogo, solte o arquivo ZIP para fazer upload.
- Depois de fazer upload de todas as estatísticas, você pode publicar o jogo.
Testar estatísticas do jogo
Para verificar se as estatísticas do jogo funcionam conforme o esperado, siga as etapas para testá-las:
- Configure uma faixa de teste interno.
- Adicione contas de teste ao projeto de jogo para os testadores.
- Crie um perfil dos serviços do Google Play Games para uma das contas de teste usando o app Play Games.
- Abra o jogo usando a mesma conta de teste para a qual você criou o perfil dos serviços do Google Play Games.
- Verifique se o "aviso de boas-vindas" dos serviços do Google Play Games aparece na tela como uma confirmação de autenticação automática bem-sucedida no lançamento do jogo.
- O usuário da conta de teste pode jogar para acionar os eventos. Verifique a resposta da API para saber se os eventos foram registrados.
Publicar as estatísticas do jogo
Depois de terminar os testes, publique o jogo. Todos os eventos e estatísticas do jogo são publicados com ele.
Para publicar, siga estas etapas:
- No Google Play Console, selecione um jogo.
- Na página Serviços do Google Play Games: estatísticas do jogo (Aumentar o número de usuários > Serviços do Google Play Games > Configuração e gerenciamento > Estatísticas do jogo), clique em Analisar e publicar.
- Na página Publicação dos serviços do Google Play Games (Aumentar o número de usuários > serviços do Google Play Games > Configuração e gerenciamento > Publicação), analise as ações e corrija os problemas.
- Clique em Publicar. Todas as suas estatísticas do jogo são publicadas.
Excluir estatísticas do jogo
Depois que as estatísticas do jogo são publicadas, não é possível excluí-las.
Diretrizes para arquivos CSV de eventos
A primeira linha do arquivo CSV é um cabeçalho. Você precisa importar eventos usando o arquivo CSV de eventos, por exemplo, PlayerGameEvent.csv.
Formato PlayerGameEvent.csv
O CSV contém o evento declarado e as propriedades dele como valores separados por vírgula na seguinte ordem:
Event Name,Property Name,Property Type
Se você enviar o evento progressUpdate para o progressionStat, adicione uma linha para esse evento. Esse evento precisa conter pelo menos uma propriedade currentProgress do tipo INT ou STRING, além de outras propriedades que você queira enviar.
Esses campos são descritos na tabela a seguir:
| Títulos de colunas do CSV | Obrigatório ou opcional | Valores aceitos |
|---|---|---|
| Nome do evento | Obrigatório | Máximo de 50 caracteres Precisa conter apenas letras, números e sublinhados. Se o nome do evento especial |
| Nome da propriedade | Obrigatório | Máximo de 50 caracteres Precisa conter apenas letras, números e sublinhados. Exclusivo por evento:os nomes de propriedades precisam ser exclusivos no mesmo evento. Não use as seguintes palavras-chave reservadas: |
| Tipo de propriedade | Obrigatório | String de enum que diferencia maiúsculas de minúsculas e corresponde a um dos tipos de dados compatíveis:
INT64, DOUBLE, STRING, BOOL
|
Requisitos do arquivo PlayerGameEvent.csv:
- O arquivo aceita no máximo 20 nomes de eventos exclusivos, com até 20 propriedades por evento.
- O conteúdo do arquivo não pode estar vazio e precisa ter pelo menos uma linha.
Exemplo de tabela
| Nome do evento | Nome da propriedade | Tipo de propriedade |
|---|---|---|
| matchCompleted | duração | DOUBLE |
| matchCompleted | mata | INT64 |
| matchCompleted | isWinner | BOOL |
| matchCompleted | matchType | STRING |
| itemCollected | coinsAmount | INT64 |
| itemCollected | weaponType | STRING |
| progressUpdate | currentProgress | INT64 |
Diretrizes para arquivos ZIP de estatísticas
É possível importar estatísticas de uma só vez usando um arquivo ZIP. Consulte a tabela para saber os nomes exatos a serem usados:
| Nome do arquivo | Obrigatório ou opcional | Valores aceitos |
|---|---|---|
RepetitiveStatsConfig.csv
|
Obrigatório | Uma estatística repetitiva representa ações regulares no jogo realizadas pelos jogadores. |
ProgressionStatConfig.csv
|
Obrigatório | Uma estatística de progressão representa o progresso de um jogador em um jogo. |
StatLocalizations.csv
|
Opcional | Fornece traduções para nomes e descrições de estatísticas do jogo. |
| Arquivos de ícones | Obrigatório | Ícones nos formatos PNG, JPEG ou JPG de 512 x 512. |
O arquivo ZIP precisa atender aos seguintes requisitos:
- Limite de tamanho do arquivo ZIP:o tamanho total máximo descompactado é de 10 MB.
- Máximo de arquivos:53 (3 CSV e 50 ícones) no total dentro do arquivo ZIP.
- Limite máximo de estatísticas combinadas:no máximo 50 estatísticas totais em
ProgressionStatConfig.csveRepetitiveStatsConfig.csv. - Arquivos CSV compatíveis:
ProgressionStatConfig.csv,RepetitiveStatsConfig.csveStatLocalizations.csv(opcional). Se você quiser fazer upload apenas da estatística de progressão, não inclua o arquivo CSV de estatísticas repetitivas no ZIP. Caso contrário, o console vai emitir um erro. O mesmo se aplica se você quiser enviar apenas estatísticas repetitivas. - Arquivos de imagem de ícone:PNG (.png) ou JPEG (.jpg, .jpeg).
- Todos os ícones referenciados nos arquivos CSV precisam estar na raiz do arquivo ZIP.
- Todos os arquivos de imagem no ZIP precisam ser referenciados por pelo menos uma estatística.
- Estrutura de diretório:todos os arquivos precisam estar na raiz do arquivo ZIP. Subdiretórios não são permitidos.
Formato RepetitiveStatsConfig.csv
O CSV contém o evento declarado e as propriedades dele como valores separados por vírgula na seguinte ordem:
Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit
Esses campos são descritos na tabela a seguir:
| Títulos de colunas do CSV | Obrigatório ou opcional | Valores aceitos |
|---|---|---|
| ID da estatística | Obrigatório | Máximo de 100 caracteres Precisa conter apenas letras, números e sublinhados. Precisa ser exclusivo em todas as estatísticas do jogo. |
| Nome da propriedade do evento | Obrigatório | Máximo de 50 caracteres |
| Nome de exibição da estatística | Obrigatório | Máximo de 50 caracteres Nome de exibição padrão da estatística (localidade padrão). Precisa ser único em todas as estatísticas. |
| Descrição da estatística | Obrigatório | Máximo de 500 caracteres Descrição padrão da estatística. |
| Tipo de agregação | Obrigatório | Máximo de 50 caracteres SUM, MAX, MIN, COUNT. |
| Propriedade de filtro | Opcional | Máximo de 50 caracteres Precisa ser um nome de propriedade definido em PlayerGameEvent.csv. |
| Operador de filtro | Opcional | =, !=, >, <, >=, <=Operadores de comparação de filtro. |
| Valor do filtro | Opcional | Comparado com a propriedade de filtro.
O valor do filtro precisa ser INT64, DOUBLE, BOOL, STRING.
|
| É competitivo | Obrigatório | true, false
|
| Limite mínimo | Obrigatório quando "Is Competitive" é verdadeiro | Pontuação mínima permitida para estatísticas competitivas. |
| Limite máximo | Obrigatório quando "Is Competitive" é verdadeiro | Pontuação máxima permitida para estatísticas competitivas. |
| Nome do arquivo do ícone | Obrigatório | Nome do arquivo da imagem do ícone incluído na raiz do arquivo ZIP. Não pode entrar em conflito com nomes de arquivos de ícones usados em estatísticas repetitivas. |
| Boa direção de valor | Obrigatório | Especifica se valores mais altos INCREASING ou mais baixos DECREASING são melhores.
|
| Unidade | Opcional | Unidade de medida para valores numéricos ou de duração brutos. Por exemplo, KILOMETER, SECOND, PERCENTAGE, UNITLESS. |
Se você não quiser usar a condição de filtro, deixe a célula em branco.
Exemplo de tabela
| ID da estatística | Nome do evento | Nome da propriedade | Agregação | Nome de exibição da estatística | Descrição da estatística | Propriedade de filtro (opcional) | Operador de filtro (opcional) | Valor do filtro (opcional) | É competitivo | minLimit | maxLimit | Nome do arquivo do ícone | Número de sequência | Boa direção de valor | unidade |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | matchCompleted | duração | MAX | Sobrevivência da maior correspondência | Isso indica o tempo de sobrevivência de um jogador em qualquer partida. | isWinner | = | TRUE | TRUE | 0 | 50 | stat1.png | 1 | Diminuindo | segundos |
| 2 | matchCompleted | isWinner | COUNT | Partidas ganhas | Isso indica o número de partidas que um jogador venceu. | isWinner | = | TRUE | TRUE | 0 | 50 | stat3.png | 2 | Aumentando | |
| 3 | matchCompleted | mata | SUM | Mortes em partidas individuais | Número de eliminações em partidas individuais | matchType | = | "1:1" | FALSO | stat4.png | 4 | Aumentando | |||
| 4 | itemCollected | coinsAmount | SUM | Total de ouro coletado | O jogador coleta moedas enquanto joga uma partida. | weaponType | = | "espada" | FALSO | stat2.png | 3 | Aumentando |
Formato ProgressionStatConfig.csv
O CSV contém o evento declarado e as propriedades dele como valores separados por vírgula na seguinte ordem:
Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit
A estatística de progressão vai aparecer como a primeira estatística para um jogador no perfil de jogador.
Esses campos são descritos na tabela a seguir:
| Títulos de colunas do CSV | Obrigatório ou opcional | Valores aceitos |
|---|---|---|
| ID da estatística | Obrigatório | Máximo de 100 caracteres Precisa conter apenas letras, números e sublinhados. Precisa ser exclusivo em todas as estatísticas do jogo. |
| Nome do evento | Obrigatório | Máximo de 50 caracteres Precisa referenciar o nome do evento definido no formato PlayerGameEvent.csv. |
| Nome da propriedade do evento | Obrigatório | Máximo de 50 caracteres Precisa ser um nome de propriedade definido em PlayerGameEvent.csv. |
| Nome de exibição da estatística | Obrigatório | Precisa ser um nome exclusivo. |
| Descrição da estatística | Obrigatório | Máximo de 50 caracteres Descrição padrão da estatística. |
| Nome do arquivo do ícone | Obrigatório | Nome do arquivo da imagem do ícone incluído na raiz do arquivo ZIP. Não pode entrar em conflito com nomes de arquivos de ícones usados em estatísticas repetitivas. |
| Boa direção de valor | Obrigatório | Especifica se valores mais altos INCREASING ou mais baixos DECREASING são melhores.
|
| Unidade | Opcional | Unidade de medida para valores numéricos ou de duração brutos. Por exemplo, KILOMETER, SECOND, PERCENTAGE, UNITLESS. |
Exemplo de tabela
| ID da estatística | Nome da propriedade do evento | Nome de exibição da estatística | Descrição da estatística | Nome do arquivo do ícone | Boa direção de valor |
|---|---|---|---|---|---|
| 5 | currentProgress | Nível | Os jogadores acumulam XP jogando partidas e sobem de nível. | Level.png | aumentando |
Formato StatLocalizations.csv
O CSV contém o evento declarado e as propriedades dele como valores separados por vírgula na seguinte ordem:
Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description
Esses campos são descritos na tabela a seguir:
| Títulos de colunas do CSV | Obrigatório ou opcional | Valores aceitos |
|---|---|---|
| ID da estatística | Obrigatório | Máximo de 100 caracteres Precisa conter apenas letras, números e sublinhados. Precisa ser exclusivo em todas as estatísticas do jogo. |
| Nome de exibição da estatística | Obrigatório | Precisa ser um nome exclusivo. |
| Localidade | Obrigatório | O código da localidade, como en-US. Adicione traduções para seu jogo antes de especificar uma localidade. Não é possível especificar a localidade padrão. Os códigos de localidade compatíveis podem ser encontrados na lista de idiomas compatíveis. |
| Nome de exibição da estatística localizada | Opcional | Máximo de 50 caracteres. Nome de exibição da estatística traduzido para a localidade especificada. |
| Descrição localizada da estatística | Opcional | Máximo de 500 caracteres. Descrição traduzida da estatística para a localidade especificada. |
Exemplo de tabela
| ID da estatística | Nome de exibição da estatística | Código do idioma | Nome da estatística localizada (UTF-8) | Descrição da estatística localizada (UTF-8) | 1 | Sobrevivência da maior correspondência | es | Supervivencia más larga en partidos | Esto denota el tiempo de supervivencia de una jugadora en cualquier partido. | 1 | Sobrevivência da maior correspondência | fr | Survie du match le plus long | Cela indique la durée de survie d'un joueur dans n'importe quel match. | 4 | Total de ouro coletado | es | Oro total recolectado | La jugadora recoge monedas mientras juega en un partido | 4 | Total de ouro coletado | fr | Ou total collecté | Le joueur collecte des pièces en jouant un match |
Arquivos de ícones
Os ícones mencionados no arquivo .csv precisam existir no
arquivo ZIP atual que você importa.
As regras de validação de ícones são:
| Propriedade de validação | Restrição / regra aplicada |
|---|---|
| Tamanho máximo do arquivo | 1 MB (1.048.576 bytes) no máximo por arquivo de ícone. |
| Dimensões | Exatamente 512 × 512 pixels (largura = 512, altura = 512) |
| Proporção | Exatamente 1:1 (proporção quadrada) |
| Formatos permitidos | PNG (.png) e JPEG (.jpg, .jpeg) |
| Posicionamento no CEP | Precisa estar localizado no diretório raiz do arquivo ZIP. |
| Verificação de referência | Todos os nomes de arquivos de ícones especificados nas colunas "Nome do arquivo de ícone" precisam estar no ZIP. |
| Verificação de órfãos | Todos os arquivos de imagem no ZIP precisam ser referenciados por pelo menos uma estatística. |
| Verificação de conflitos | Os nomes de arquivos de ícones em ProgressionStatConfig.csv não podem entrar em conflito com RepetitiveStatsConfig.csv.
|
| Duplicados visuais | Os ícones duplicados são sinalizados. |
Diretrizes relativas a ícones
Os ícones precisam ser criados como arquivos PNG, JPEG ou JPG de 512 x 512.
O mesmo ícone é usado em todas as localidades. Portanto, recomendamos não incluir texto ou conteúdo localizado em um ícone.
Especificação da unidade
As colunas de unidade controlam como os valores brutos de estatísticas são formatados e localizados para os jogadores.
Propriedades de estatísticas numéricas (INT64, DOUBLE)
| Valor unitário permitido | Exemplo de valor bruto |
| (Vazio) / SEM UNIDADE / NENHUM | 1234567 |
| % / PERCENTAGE / PERCENT | 0,857 |
| Distância/comprimento: CENTÍMETRO, METRO, QUILÔMETRO, PÉ, POLEGADA, MILHA, JARDAS, MILÍMETRO, NANÔMETRO | 15 (QUILÔMETRO) |
| Velocidade: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR | 60 (MILE_PER_HOUR) |
Propriedades de estatísticas não numéricas (STRING, BOOL)
As colunas de unidade precisam ficar vazias.