# Jogos mobile

Este playbook mostra como configurar a Pushwoosh para um jogo mobile, desde a identificação dos jogadores até o lançamento de Journeys de onboarding, engajamento, reativação e compras no aplicativo.

Configure a Pushwoosh em sete etapas, nesta ordem:

1. Defina um [User ID](/pt/tutorials/industry-playbooks/mobile-games/collect-player-data/#identify-players-by-user-id) para cada jogador, para que a Pushwoosh reconheça o mesmo jogador em todos os dispositivos.
2. Escolha os [eventos a rastrear](/pt/tutorials/industry-playbooks/mobile-games/collect-player-data/#set-up-the-events-to-track) para registrar o que os jogadores fazem no jogo.
3. Opcional: armazene dados do jogador, como o nível ou se o jogador já pagou, em [tags](/pt/tutorials/industry-playbooks/mobile-games/collect-player-data/#store-player-data-in-tags).
4. Agrupe os jogadores que atendem às suas condições em [segmentos](/pt/tutorials/industry-playbooks/mobile-games/build-the-segments/), por exemplo, jogadores que não abrem o jogo há 30 dias.
5. Peça a permissão de push no momento certo, defina as regras de entrega e configure um grupo de controle. Consulte [Preparar a comunicação](/pt/tutorials/industry-playbooks/mobile-games/prepare-for-communication/).
6. Envie mensagens automaticamente com [Journeys](/pt/tutorials/industry-playbooks/mobile-games/build-the-journeys/) quando um jogador fizer algo no jogo ou entrar em um segmento.
7. [Teste cada Journey](/pt/tutorials/industry-playbooks/mobile-games/launch-and-measure/), depois consulte as estatísticas e meça os resultados.

Para começar com menos, siga a [Configuração mínima para começar a enviar mensagens aos jogadores](#minimum-setup-to-start-messaging-players).

## Pré-requisitos

<Aside type="caution" icon="setting" title="É necessária a ajuda dos desenvolvedores">
Algumas etapas deste playbook são alterações no código do seu jogo. Consulte [O que seus desenvolvedores precisam fazer](#what-your-developers-need-to-do).
</Aside>

* Um [aplicativo na sua conta da Pushwoosh](/pt/product/first-steps/start-with-your-project/create-your-project/), com o [SDK integrado](/pt/developer/first-steps/integrate-pushwoosh-sdk/) para que os dispositivos se registrem automaticamente.
* E-mail e App Inbox somente para as Journeys que os listam em **Requisitos**: [Reativação de jogadores inativos](/pt/tutorials/industry-playbooks/mobile-games/build-the-journeys/loyalty-and-win-back/#reactivation-for-inactive-players) usa e-mail, e [Anúncios de eventos ao vivo e VIP](/pt/tutorials/industry-playbooks/mobile-games/build-the-journeys/loyalty-and-win-back/#live-event-and-vip-announcements) usa App Inbox. A maioria das Journeys deste playbook usa push e mensagens in-app.

<span id="what-your-developers-need-to-do" />

## O que seus desenvolvedores precisam fazer

Entregue esta lista aos seus desenvolvedores para que eles possam implementá-la em uma única versão:

* [Definir o User ID no login](/pt/tutorials/industry-playbooks/mobile-games/collect-player-data/#identify-players-by-user-id).
* [Enviar os eventos](/pt/tutorials/industry-playbooks/mobile-games/collect-player-data/#send-the-events-from-the-game) de que suas Journeys precisam.
* [Rastrear as compras](/pt/tutorials/industry-playbooks/mobile-games/collect-player-data/#track-revenue-as-pw_conversion) e, se você vende assinaturas, [passar o ID do jogador em cada compra nas lojas](/pt/tutorials/industry-playbooks/mobile-games/collect-player-data/#track-subscriptions-from-the-stores).
* [Tirar a solicitação de permissão de push](/pt/tutorials/industry-playbooks/mobile-games/prepare-for-communication/#ask-for-push-permission-at-the-right-moment) da primeira abertura.
* Tratar os [deep links](/pt/product/messaging-channels/push-notifications/advanced-push-features/deep-linking/) para as telas de nível, recompensa, loja e eventos, que as Journeys abrem a partir dos pushes.
* Integrar o SDK do Message Inbox se você usar o [App Inbox](/pt/tutorials/industry-playbooks/mobile-games/build-the-journeys/loyalty-and-win-back/#live-event-and-vip-announcements).

<span id="minimum-setup-to-start-messaging-players" />

## Configuração mínima para começar a enviar mensagens aos jogadores

Se você ainda não precisa de todas as sete etapas, esta configuração mínima cobre duas tarefas básicas: levar os novos jogadores até o fim do tutorial e recuperar os jogadores que pararam de jogar. Conclua estas etapas:

1. Peça aos seus desenvolvedores que chamem `setUserId` no login. Consulte [Identificar jogadores por User ID](/pt/tutorials/industry-playbooks/mobile-games/collect-player-data/#identify-players-by-user-id).
2. Verifique se `PW_ApplicationOpen` está chegando do jogo. Peça aos seus desenvolvedores que também enviem os eventos `Tutorial started` e `Tutorial completed`. Consulte [Configurar os eventos a rastrear](/pt/tutorials/industry-playbooks/mobile-games/collect-player-data/#set-up-the-events-to-track) e [Enviar os eventos a partir do jogo](/pt/tutorials/industry-playbooks/mobile-games/collect-player-data/#send-the-events-from-the-game).
3. Mova a solicitação de permissão de push para um momento posterior, por exemplo, depois do tutorial. No iOS, um jogador que recusa a solicitação na primeira abertura não pode ser solicitado novamente. Consulte [Pedir a permissão de push no momento certo](/pt/tutorials/industry-playbooks/mobile-games/prepare-for-communication/#ask-for-push-permission-at-the-right-moment).
4. Defina as [regras de entrega](/pt/tutorials/industry-playbooks/mobile-games/prepare-for-communication/#set-delivery-rules-before-you-message-players).
5. Crie o segmento [Jogadores em risco](/pt/tutorials/industry-playbooks/mobile-games/build-the-segments/#at-risk-players). Se você já rastreia compras com `PW_InAppPurchase`, crie também [Pagantes recentes](/pt/tutorials/industry-playbooks/mobile-games/build-the-segments/#recent-payers).
6. Crie o conteúdo para essas duas Journeys, conforme listado em **Conteúdo a preparar** em cada receita.
7. Lance [Onboarding para novos jogadores](/pt/tutorials/industry-playbooks/mobile-games/build-the-journeys/new-and-active-players/#onboarding-for-new-players) e [Reativação de jogadores inativos](/pt/tutorials/industry-playbooks/mobile-games/build-the-journeys/loyalty-and-win-back/#reactivation-for-inactive-players).

Adicione os outros segmentos e Journeys mais tarde, à medida que os eventos deles começarem a chegar.

## Próximos passos

Para adicionar mais Journeys, consulte estes guias:

* [Como configurar uma campanha de retenção no Pushwoosh](/pt/tutorials/product-guides/lifecycle-marketing-campaigns/how-to-set-up-a-retention-campaign-in-pushwoosh/)
* [Como configurar uma campanha de engajamento de usuários na Pushwoosh](/pt/tutorials/product-guides/lifecycle-marketing-campaigns/how-to-set-up-a-user-engagement-campaign-in-pushwoosh/)
* [Como criar uma campanha de reengajamento no Pushwoosh](/pt/tutorials/product-guides/lifecycle-marketing-campaigns/how-to-create-a-re-engagement-campaign-in-pushwoosh/)
* [Como executar testes A/B/n em Journeys](/pt/tutorials/product-guides/how-to-create-campaigns-in-pushwoosh/how-to-abn-test-customer-journeys/)