Conquistas

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Enviar feedback

As conquistas podem ser uma ótima maneira de aumentar o engajamento dos usuários no seu jogo. Você pode implementar conquistas para incentivar os jogadores a testar recursos que talvez não fossem normalmente usados ou abordar o jogo com diferentes estilos. As conquistas também podem ser uma maneira divertida de os jogadores compararem o progresso entre si e se envolverem em uma competição amigável.

Para saber como implementar conquistas na sua plataforma, consulte Implementações de clientes.

Atributos

Para entender como as conquistas funcionam, é preciso conhecer alguns dos atributos associados a elas.

Estes elementos básicos são associados a cada conquista:

• O ID é uma string exclusiva gerada pelo Google Play Console. Você vai usar esse ID exclusivo para se referir à conquista nos clientes de jogos.
• Name é um nome curto da conquista (por exemplo, "Mestre das tortas"). O valor pode ter até 100 caracteres.
• Description é uma descrição concisa da sua conquista. Normalmente, informa ao seu jogador como chegar à conquista (por exemplo, "Faça uma torta de limão antes do pôr do sol"). O valor pode ter até 500 caracteres.
• Icon é um ícone quadrado associado à sua conquista. Para conferir as práticas recomendadas ao criar ícones de conquista, consulte a seção Diretrizes de ícones.
• List order é a ordem em que as conquistas bloqueadas aparecem quando um jogador visualiza as conquistas associadas ao jogo. Ela pode estar em qualquer ordem que você quiser. As conquistas desbloqueadas aparecem na parte de cima da lista na ordem em que foram alcançadas.

Estado

As conquistas podem estar em um de três estados diferentes:

• Uma conquista oculta significa que os detalhes sobre ela não aparecem para o jogador. Os serviços relacionados a jogos do Google Play oferecem uma descrição genérica de marcador de posição e um ícone para a conquista quando ela está em um estado oculto. Recomendamos deixar uma conquista oculta se ela tiver uma informação que você não quer revelar sobre seu jogo muito cedo (por exemplo, "Descobrir que você era um fantasma o tempo todo!").
• Uma conquista revelada significa que o jogador sabe sobre a conquista, mas ainda não a ganhou. A maioria das conquistas começa no estado revelado.
• Uma conquista desbloqueada significa que o jogador ganhou a conquista. Uma conquista pode ser desbloqueada off-line. Quando o jogo fica on-line, ele é sincronizado com os serviços relacionados a jogos do Google Play para atualizar o estado desbloqueado da conquista.

Conquistas incrementais

As conquistas podem ser designadas como padrão ou incrementais. Geralmente, uma conquista incremental envolve um progresso gradual do jogador em direção à conquista em um período mais longo. À medida que o jogador avança para a conquista incremental, é possível informar o progresso parcial dele aos serviços relacionados a jogos do Google Play.

O Google Play Services monitora as informações de progresso, alerta o jogo quando o jogador atende aos critérios necessários para desbloquear essa conquista e informa ao jogador o quanto falta para atingir a meta.

As conquistas incrementais são cumulativas em sessões de jogo, e o progresso não pode ser removido ou redefinido dentro do jogo. Por exemplo, "Vencer 50 jogos" seria qualificada como uma conquista incremental. "Vencer três jogos seguidos" não seria, porque o progresso do jogador seria redefinido quando ele perdesse um jogo. "Ter 5 mil fichas de pôquer" também não se qualifica, porque o jogador pode ganhar e perder fichas ao jogar. Quanto às duas últimas conquistas, cabe a você decidir como acompanhar o estado ou a vitória de todas as conquistas do jogador e desbloquear as conquistas padrão, quando o jogador as ganhar.

Ao criar uma conquista incremental, é preciso definir o número total de etapas necessárias para desbloqueá-la. Esse número precisa estar entre 2 e 10 mil. À medida que o usuário progride para desbloquear a conquista, informe aos serviços relacionados a jogos do Google Play o número de etapas adicionais que ele realizou. Quando o número total de etapas atinge o valor de desbloqueio, a conquista é desbloqueada, mesmo que tenha sido ocultada. Não é necessário armazenar o progresso cumulativo do usuário.

Pontos

As conquistas estão associadas a uma pontuação. A pontuação do jogador precisa ser um múltiplo de 5, e um jogo nunca pode ter um total de mais de mil pontos para todas as conquistas, embora possa ter menos. Além disso, nenhuma realização única pode ter mais de 200 pontos.

Monitorar pontos de experiência (XP)

Os jogadores podem ganhar níveis no Perfil de jogo ao ganhar conquistas em jogos ativados no Play Games. Para cada ponto associado a uma conquista, o jogador recebe 100 pontos de experiência (XP) quando ganha a conquista. Resumindo:

XP for an achievement = 100 * (point value for the achievement)

Os serviços relacionados a jogos do Google Play rastreiam os XP recebidos por cada jogador e enviam uma notificação ao app Google Play Games quando o jogador ganha pontos suficientes para "subir de nível". Os jogadores podem visualizar o nível e o histórico de XP na página de perfil no app Google Play Games.

Conquistas mínimas

Um jogo que integra as conquistas precisa ter pelo menos cinco conquistas antes da publicação. É possível testar com menos de cinco conquistas, mas recomendamos que você tenha pelo menos cinco conquistas criadas antes de publicar seu jogo.

Conquistas máximas

O número de conquistas tem um limite de pontos e de distribuição. Com um número máximo de mil pontos e atribuídos cinco pontos a cada conquista, o número máximo de conquistas é 200. No entanto, se forem atribuídos mais pontos às conquistas, o número de conquistas disponíveis vai diminuir.

Adicionar conquistas

Há duas maneiras de criar conquistas pela primeira vez usando o Google Play Console:

• Criar uma conquista: adicione definições e metadados para cada conquista por vez.
• Importar conquistas: importe definições e outros metadados de várias conquistas em uma única etapa.

Criar uma conquista

Para criar uma conquista para um jogo novo e não publicado, siga estas etapas:

1. No Google Play Console, selecione um jogo.
2. Na página Serviços relacionados a jogos do Google Play: conquistas (Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Conquistas), selecione Criar conquista.
3. Na página Adicionar conquistas, preencha o formulário.
4. Clique em Salvar como rascunho.
5. Depois de criar uma conquista, você precisa publicar o jogo.

Adicionar mais conquistas

Se você já tem conquistas e quer adicionar mais:

1. No Google Play Console, selecione um jogo.
2. Na página Serviços relacionados a jogos do Google Play: conquistas (Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Conquistas), selecione Adicionar conquistas.

Importar conquistas

Para adicionar várias conquistas ao jogo de uma só vez, siga estas etapas:

1. Crie um arquivo ZIP com suas conquistas.
2. Enviar o arquivo.

Para mais informações sobre o arquivo ZIP, consulte as diretrizes para arquivos ZIP.

Para importar conquistas:

1. No Google Play Console, selecione um jogo.
2. Na página Serviços relacionados a jogos do Google Play: conquistas (Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Conquistas), selecione Importar conquistas.
3. Na página Importar conquistas, clique em Fazer upload.
4. Selecione o arquivo ZIP para fazer upload.
5. Clique em Salvar como rascunho.
6. Depois de importar as conquistas, publique o jogo.

Publicar o jogo

Depois que você testa e publica o jogo, todas as conquistas dele também são publicadas.

Editar uma conquista

Para editar uma conquista já criada, selecione-a na guia Conquistas do Google Play Console. Nesse momento, você vai ter acesso ao mesmo formulário usado ao criar a conquista pela primeira vez e vai poder editar qualquer um dos campos conforme necessário.

Quando terminar de editar uma conquista, clique no botão Salvar como rascunho. A conquista recém-editada estará em um estágio "pronta para testes", e você vai poder testá-la. Se estiver funcionando corretamente, selecione Republicar na lista suspensa. Assim, seu jogo será republicado com todas as conquistas atualizadas.

Desfazer uma edição

Se você não gostar da conquista atual e quiser voltar a ela como estava antes, selecione Reverter na lista suspensa do Google Play Console. Assim, todas as suas conquistas serão revertidas para a versão publicada anteriormente.

Excluir uma conquista

Após a publicação da conquista, ela não poderá ser excluída.

Para excluir uma conquista em um estado pré-publicado, clique no botão Excluir na parte inferior do formulário da conquista.

Redefinir uma conquista

Só é possível redefinir os dados de progresso do jogador para conquistas de rascunho.

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

Diretrizes relativas a ícones

Os ícones precisam ser criados como arquivos PNG, JPEG ou JPG de 512 x 512. Você só precisa nos fornecer o ícone da conquista desbloqueada. Vamos gerar automaticamente uma versão em escala de cinza para o ícone revelado. Por esse motivo, recomendamos que os ícones de conquista incluam elementos coloridos para que os usuários possam distinguir entre conquistas reveladas e desbloqueadas.

Quando um ícone de conquista é exibido em um aviso do Android, ele aparece sobreposto por um círculo com os cantos externos ocultos. Verifique se o ícone ainda é exibido de maneira adequada nessas circunstâncias.

O mesmo ícone é usado em todas as localidades. Portanto, recomendamos não incluir texto ou conteúdo localizado em um ícone.

Diretrizes para arquivos ZIP

É possível importar vários prêmios de uma só vez usando um arquivo ZIP. Consulte a tabela para saber os nomes de arquivo exatos a serem usados no arquivo ZIP:

Requisitos do arquivo ZIP:

• Sem subdiretórios.
• Nomes de arquivos exclusivos.
• Somente arquivos CSV, PNG, JPEG ou JPG.
• Os arquivos CSV não podem ter uma linha de cabeçalho.
• Cada arquivo precisa ter menos de 1 MB.
• O arquivo ZIP não pode conter mais de 203 arquivos.
• O tamanho total do arquivo ZIP precisa ser inferior a 200 MB.

Formato AchievementsMetadata.csv

O arquivo AchievementsMetadata.csv contém os metadados de cada conquista. Ele precisa incluir as informações como valores separados por vírgulas na seguinte ordem:

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

Esses campos são descritos na tabela a seguir:

Requisitos do arquivo AchievementsMetadata.csv:

• Cada linha precisa ter sete valores. Se você quiser omitir um valor, deixe o campo em branco.
• Os campos Name e Description são usados como a localidade padrão.
• O campo Name precisa ser exclusivo em todas as conquistas.
• Os campos a seguir não podem conter vírgulas: Name e Description.

Um arquivo AchievementsMetadata.csv de amostra:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

Formato AchievementsLocalizations.csv

O arquivo AchievementsLocalizations.csv é opcional e configura todos os dados necessários para descrever cada conquista aos usuários em diferentes localidades. As conquistas são traduzidas de acordo com as localidades especificadas para o jogo.

Ele precisa incluir as informações como valores separados por vírgulas na seguinte ordem:

   Name, Localized name, Localized description, locale

Esses campos são descritos na tabela a seguir:

Requisitos do arquivo AchievementsLocalizations.csv:

• Os nomes das conquistas em um jogo precisam ser exclusivos por localidade. Por exemplo, se um jogo tiver suporte para as localidades en-US e fr-FR, uma conquista chamada "Achievement1" para en-US também poderá ser chamada de "Achievement1" para fr-FR.
• Cada linha precisa ter quatro valores. Se você quiser omitir o valor da descrição localizada, deixe em branco.

Um arquivo AchievementsLocalizations.csv de amostra:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE

Formato AchievementsIconMappings.csv

O arquivo AchievementsIconMappings.csv é opcional e é usado para mapear seus feitos com o ícone fornecido. Ele precisa incluir as informações como valores separados por vírgulas na seguinte ordem:

Name, icon filename

Esses campos são descritos na tabela a seguir:

Requisitos do arquivo AchievementsIconMappings.csv:

• Cada linha precisa ter dois valores.
• Os arquivos de ícones só podem estar nos formatos PNG ou JPEG.

Um arquivo AchievementsIconMappings.csv de amostra:

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

Arquivos de ícones

Os ícones que você referencia no arquivo AchievementsIconMappings.csv precisam existir no arquivo zip atual que você importa. Para mais informações, consulte as diretrizes de ícones.

Adicionar traduções para conquistas

Você pode especificar suas próprias traduções para conquistas associadas ao seu jogo. Antes de fazer isso, conclua as etapas descritas em Como adicionar traduções ao seu jogo.

Há duas maneiras de adicionar traduções ao jogo:

• Você pode usar a opção import achievements para fazer upload de traduções de muitas conquistas novas de uma vez. Não é possível usar essa opção para enviar traduções de conquistas já existentes.

• É possível adicionar traduções para cada conquista no jogo. Para adicionar sua própria tradução para cada conquista:

  1. No Google Play Console, abra a guia Conquistas do jogo e selecione uma conquista.
  2. Na página de detalhes das conquistas, selecione a guia de um idioma adicionado anteriormente na guia Detalhes do jogo.
  3. Na página de detalhes da conquista para esse idioma, edite o formulário com as traduções.
  4. Clique em Salvar para armazenar os detalhes traduzidos da conquista.

Implementações do cliente

Para saber como implementar conquistas na sua plataforma, consulte os seguintes recursos:

• Android
• Unity
• Web
• Práticas recomendadas para implementação de conquistas