Ajudante do Play Games

O Play Games Sidekick é uma sobreposição que ajuda os jogadores a continuarem no seu jogo, oferecendo conteúdo e ofertas relevantes diretamente para eles.

• Mantenha os jogadores no seu jogo com vídeos oficiais e de criadores de conteúdo. Assim, eles podem encontrar guias, tutoriais e lives sem precisar trocar de app.
• Aumento da monetização com troca de pontos no momento, ofertas financiadas pelo Google Play e cupons do Pass.
• Jogabilidade premiada com sequências, missões e interações de perfil integradas.
• Maior engajamento com conteúdo e vídeos.

Recursos

Os recursos disponíveis no Sidekick variam de acordo com o jogo, dependendo do status de integração dos Serviços do Google Play Games e da inscrição no Play Points. Os jogadores podem esperar os seguintes recursos:

• Recursos de jogo:captura de tela, gravação de tela, transmissão ao vivo no YouTube e Não perturbe.
• Conquistas:exige a implementação de conquistas.
• Sequências de jogos:Sequências de jogos.
• Troca de crédito do Play Points.
• Boosters e cupons do Play Points:disponíveis para desenvolvedores inscritos no Play Points.
• Benefícios e ofertas do Play Pass.
• Quests:as Quests estão disponíveis para desenvolvedores inscritos.
• Vídeos oficiais e de criadores de conteúdo:o Sidekick mostra os vídeos que você adiciona. Para mais informações sobre como adicionar vídeos na Play Store e no Sidekick, consulte Mostrar o app com vídeos do YouTube no Google Play.

Requisitos de software e hardware

Para acessar o Sidekick, os jogadores precisam do seguinte:

• Um smartphone com o Android 13 ou versões mais recentes.

• Os jogadores precisam ter um perfil de jogador.
• O jogo precisa ser instalado pela Google Play Store.

Teste o Sidekick

Para ativar o Ajudante no seu jogo, siga estas etapas:

Definir o Sidekick como padrão no seu jogo

Crie um lançamento de teste interno ou fechado no Play Console para testar versões pré-lançamento do jogo com o Sidekick e coletar feedback direcionado. Embora os testes em uma faixa beta fechada não ofereçam uma comparação direta para métricas de performance, eles continuam sendo um método válido para testes funcionais básicos da integração do Sidekick.

Depois de testar com um grupo menor de colegas ou usuários de confiança, você pode ampliar seu teste para uma versão aberta.

1. No Play Console, configure um lançamento de teste interno ou fechado.
2. Para adicionar o Play Games Sidekick ao pacote de app, selecione O Sidekick está ativado por padrão.
3. Faça o teste.
4. Quando estiver tudo pronto, lance o build para produção. Para mais informações, consulte Preparar um lançamento em fases.

Os jogadores podem gerenciar a visibilidade do Sidekick a qualquer momento nas configurações de usuário da Google Play Store.

Testar o Sidekick com segurança

Ao integrar o Sidekick, verifique se a sobreposição se integra perfeitamente ao jogo, mantém uma experiência consistente para o jogador e não afeta negativamente métricas importantes, como integridade do jogo (falhas/ANRs), engajamento e receita. Para estabelecer uma linha de base de desempenho antes de um lançamento completo, use um lançamento gradual de 5%.

Com esse playbook de testes, você pode fazer uma comparação simultânea no ambiente de produção, minimizando os riscos e verificando o sucesso da integração.

O playbook de lançamento gradual de 5%

Ao lançar o Sidekick para um segmento pequeno e controlado do seu público-alvo, é possível isolar o impacto dele rastreando métricas na nova versão do jogo.

• Prepare seu lançamento:integre o SDK do Sidekick ao seu jogo e prepare um novo build de lançamento.
• Inicie um lançamento gradual:publique seu novo build na faixa de produção usando um lançamento gradual de 5% no Google Play Console. Isso expõe a integração do Sidekick a uma pequena fração da sua base de jogadores em tempo real.
• Isolar por versão do app:verifique se as ferramentas de análise estão configuradas para filtrar dados especificamente da versão do app que contém a integração do Sidekick.

Monitorar a performance e as métricas

Durante o lançamento gradual de 5%, monitore o desempenho do jogo e garanta que as métricas principais permaneçam estáveis usando uma combinação do Google Play Console e da sua própria configuração de análise. Ao monitorar o lançamento gradual, concentre-se no seguinte:

• Acompanhe o engajamento e a estabilidade do jogo:use o Google Play Console para garantir que o Android vitals (como taxas de falhas e ANRs) e as métricas de engajamento dos jogadores permaneçam estáveis na nova versão do app.
• Acompanhe a consistência da receita:monitore de perto as métricas de receita e compras no app usando sua infraestrutura de análise atual, como o Google Analytics ou suas ferramentas internas de business intelligence (BI). Compare o grupo de 5% que tem acesso ao Sidekick com o restante do tráfego de produção para garantir que sua monetização principal permaneça estável.

Depois de verificar se o Ajudante complementa sua receita, engajamento e estabilidade durante o lançamento gradual de 5%, você pode aumentar o lançamento para 100% dos jogadores com confiança.

Gerenciar a visibilidade do Sidekick no seu dispositivo para testes

Depois que a versão estiver disponível para os testadores no Play Console, siga estas etapas para ativar as opções do desenvolvedor da Google Play Store no dispositivo:

1. Abra o aplicativo Google Play Store.
2. Toque no ícone do seu perfil e em Configurações.
3. Toque no menu Sobre.
4. Toque em Versão da Google Play Store sete vezes até ver a mensagem You are now a developer!. Isso ativa as opções do desenvolvedor no dispositivo.
5. Toque em Geral e em Opções do desenvolvedor.
6. Ative o Play Games Sidekick.
7. Acesse o jogo para ver o Sidekick aparecer.

Configurar o ponto de entrada padrão do Sidekick

Por padrão, o ponto de entrada do Sidekick fica ancorado na borda lógica final (o lado direito da tela) e é centralizado verticalmente (com um pequeno deslocamento padrão) nas orientações retrato e paisagem. No caso da navegação com três botões, o ponto de entrada se move para o lado oposto à barra de navegação.

É possível substituir a posição padrão do ponto de entrada especificando uma posição preferida no arquivo AndroidManifest.xml.

Para configurar a posição padrão do ponto de entrada do Sidekick no seu jogo, siga estas etapas:

1. No arquivo AndroidManifest.xml, adicione o seguinte elemento <meta-data> ao elemento <application>:

   <manifest>
     <application>
      <meta-data
      android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
      android:resource="@xml/XML_RESOURCE_FILE"/>
     </application>
   
   </manifest>

2. Especifique o local do ponto de entrada no XML_RESOURCE_FILE.

   Exemplo de arquivo (res/xml/XML_RESOURCE_FILE.xml):

   <?xml version="1.0" encoding="utf-8"?>
   <deku-config>
      <!-- Entrypoint default position overrides -->
      <!-- Anchored to RIGHT edge, 25% down from top -->
      <default-entrypoint-position orientation="portrait" horizontal-position="RIGHT" vertical-position-percent="25" />
   
      <!-- Anchored to LEFT edge, vertically centered at 50% -->
      <default-entrypoint-position orientation="landscape" horizontal-position="LEFT" vertical-position-percent="50" />
   
      <!-- Extensible: Add new configuration fields here as needed -->
   </deku-config>

A tag <default-entrypoint-position> é compatível com os seguintes atributos. Os três atributos (orientation, horizontal-position e vertical-position-percent) são obrigatórios para cada tag <default-entrypoint-position>. Se horizontal-position ou vertical-position-percent for omitido ou inválido, a tag será ignorada, e essa orientação vai voltar à posição padrão do sistema.

• orientation: a orientação da tela a ser configurada. Valores aceitos:
  • landscape
  • portrait
• horizontal-position: a borda horizontal da tela para ancorar o ponto de entrada. Valores aceitos:
  • LEFT
  • RIGHT

• vertical-position-percent: um valor numérico no intervalo de 0 a 100 (por exemplo, "25" ou "50") que especifica o posicionamento vertical como uma porcentagem da altura disponível da tela de cima para baixo. Por exemplo, "25" coloca o ponto de entrada 25% abaixo da borda superior, e "50" o centraliza verticalmente. Valores fora do intervalo de 0 a 100 são definidos como o limite mais próximo.

  vertical-position-percent é aplicado à altura total da janela do jogo. O ponto de acesso sempre mantém uma pequena margem das bordas superior e inferior da tela e é movido automaticamente para evitar sobreposição com um corte da câmera ou um entalhe da tela. Como resultado, 0 coloca o ponto de entrada perto da borda superior e 100 o coloca perto da borda inferior.

Esses valores representam posições físicas na tela. Por exemplo, LEFT ancora o ponto de entrada na borda esquerda da tela, mesmo quando o dispositivo está definido para um layout da direita para a esquerda (RTL).

Se um jogador arrastar e reposicionar manualmente o ponto de entrada durante o jogo, a posição escolhida vai persistir nas sessões e terá precedência sobre a configuração XML padrão personalizada.

Configurar a duração da suspensão do ponto de entrada durante a FTUE

Por padrão, o ponto de entrada do Play Games Sidekick aparece imediatamente. É possível adiar o ponto de entrada no jogo por uma duração personalizada configurada no XML_RESOURCE_FILE.

Quando uma duração de adiamento é definida, o ponto de entrada do Sidekick fica oculto durante a primeira experiência do usuário (FTUE, na sigla em inglês) pelo tempo configurado. Depois que o período de adiamento termina, o ponto de entrada aparece.

1. No arquivo AndroidManifest.xml, adicione o seguinte elemento <meta-data> ao elemento <application>:

   <manifest>
    <application>
     <meta-data
     android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
     android:resource="@xml/XML_RESOURCE_FILE"/>
    </application>
   
   </manifest>

2. Especifique a duração da soneca no XML_RESOURCE_FILE.

   Exemplo de arquivo (res/xml/XML_RESOURCE_FILE.xml):

   <?xml version="1.0" encoding="utf-8"?>
   <deku-config>
     <!-- Entrypoint default position overrides -->
     <default-entrypoint-position orientation="portrait" horizontal-position="RIGHT" vertical-position-percent="25" />
     <default-entrypoint-position orientation="landscape" horizontal-position="LEFT" vertical-position-percent="50" />
   
     <!-- Custom Snooze Period -->
     <snooze duration_seconds="300" />
   
     <!-- Extensible: Add new configuration fields here as needed -->
   </deku-config>

A duração personalizada da soneca é limitada a 30 minutos. Se você especificar um valor que exceda esse limite, o sistema vai usar automaticamente o limite de 30 minutos.

Adicionar automaticamente o Ajudante a todos os envios de pacotes

Quando você cria uma versão e ativa o Sidekick por padrão no seu jogo, ele é adicionado a todos os pacotes de apps futuros.

Para mudar se o Sidekick está ativado por padrão para todos os novos pacotes de apps que você enviar, siga estas etapas:

1. Abra o Play Console.
2. Selecione um jogo.
3. Acesse Teste > Configurações avançadas.
4. Na guia Play Games Sidekick, selecione
   • Definir automaticamente o Sidekick como padrão para novos pacotes de apps que você enviar.
   • Não definir automaticamente o Sidekick como padrão para novos pacotes de apps que você enviar.
5. Selecione Salvar alterações.

Se as atualizações do app forem pouco frequentes, podemos atualizar o Sidekick periodicamente para você. É possível desativar o Sidekick usando as configurações avançadas no Google Play Console a qualquer momento.

Promover o Ajudante para produção

Se você promover uma versão que contenha o Sidekick para a produção, os jogadores vão ver o Sidekick. Os jogadores podem gerenciar a visibilidade do Sidekick a qualquer momento nas configurações de usuário do app Google Play Store.

Os jogos que promovem um lançamento com o Sidekick atendem às diretrizes do Level Up.

Enviar feedback

Para enviar feedback sobre o Sidekick, use o formulário de feedback.

Perguntas frequentes