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.

• Retenção de usuários com o Gemini Live e dicas para que os jogadores não precisem sair do jogo para receber ajuda ou conselhos.
• Monetização aumentada 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:requer 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 uma versão de teste interno ou fechado no Play Console para testar versões pré-lançamento do seu jogo com o Sidekick e colete 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 confiáveis, 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 as principais métricas, 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, é possível 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 jogo e prepare um novo build de lançamento.
• Comece 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.
• Isolamento 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 a performance 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 do jogador 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 a coorte 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.

Gerenciar a visibilidade do Sidekick no seu dispositivo para testes

Quando 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 seu 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 End (o lado MIDDLE_RIGHT 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 -->
     <default-entrypoint-position orientation="landscape" value="MIDDLE_LEFT" />
     <default-entrypoint-position orientation="portrait" value="TOP_RIGHT" />
   
     <!-- Extensible: Add new configuration fields here as needed -->
   </deku-config>

Os valores aceitos para a orientação do ponto de entrada são:

• landscape
• retrato

Esses valores representam as posições físicas na tela. Por exemplo, MIDDLE_LEFT sempre vai ancorar o ponto de entrada na borda esquerda da tela, mesmo quando o dispositivo estiver definido como da direita para a esquerda (RTL). Confira a seguir os valores compatíveis para posições alinhadas à borda.

• MIDDLE_LEFT
• MIDDLE_RIGHT
• TOP_LEFT
• TOP_RIGHT
• BOTTOM_LEFT
• BOTTOM_RIGHT

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 soneca 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) 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 do adiamento 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="landscape" value="MIDDLE_LEFT" />
     <default-entrypoint-position orientation="portrait" value="TOP_RIGHT" />
   
     <!-- Custom Snooze Period -->
     <snooze duration_seconds="300" />
   
     <!-- Extensible: Add new configuration fields here as needed -->
   </deku-config>

A duração personalizada do adiamento é 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 define o Sidekick como padrão para seu jogo, ele é adicionado a todos os seus futuros pacotes de apps.

Para mudar se o Sidekick fica ativado por padrão para todos os novos pacotes de apps que você envia, 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 raras, 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 Ajudante obedecem às diretrizes do Level Up.

Enviar feedback

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

Perguntas frequentes