# 手机游戏

本实战手册介绍如何为手机游戏设置 Pushwoosh：从识别玩家，到启动用于新手引导、互动、重新激活和应用内购买的 Journey。

请按以下顺序分七个阶段设置 Pushwoosh：

1. 为每位玩家设置 [User ID](/zh/tutorials/industry-playbooks/mobile-games/collect-player-data/#identify-players-by-user-id)，让 Pushwoosh 在每台设备上都能识别出同一位玩家。
2. 选择[要跟踪的事件](/zh/tutorials/industry-playbooks/mobile-games/collect-player-data/#set-up-the-events-to-track)，记录玩家在游戏中的行为。
3. 可选：将玩家数据（例如关卡，或玩家是否付费）存储在[标签](/zh/tutorials/industry-playbooks/mobile-games/collect-player-data/#store-player-data-in-tags)中。
4. 将符合条件的玩家归入[细分](/zh/tutorials/industry-playbooks/mobile-games/build-the-segments/)，例如 30 天未打开游戏的玩家。
5. 在合适的时机请求推送权限、设置发送规则并设置对照组。请参阅[做好沟通准备](/zh/tutorials/industry-playbooks/mobile-games/prepare-for-communication/)。
6. 当玩家在游戏中执行某项操作或进入某个细分时，通过 [Journey](/zh/tutorials/industry-playbooks/mobile-games/build-the-journeys/) 自动发送消息。
7. [测试每个 Journey](/zh/tutorials/industry-playbooks/mobile-games/launch-and-measure/)，然后查看其统计数据并衡量效果。

如果想从更少的步骤开始，请按照[开始向玩家发送消息的最低设置](#minimum-setup-to-start-messaging-players)操作。

## 前提条件

<Aside type="caution" icon="setting" title="需要开发人员协助">
本实战手册中的部分步骤需要修改游戏代码。请参阅[开发人员需要做什么](#what-your-developers-need-to-do)。
</Aside>

* [Pushwoosh 账户中的一个应用](/zh/product/first-steps/start-with-your-project/create-your-project/)，并已[集成 SDK](/zh/developer/first-steps/integrate-pushwoosh-sdk/)，以便设备自动注册。
* 只有在 **需要** 中列出 Email 和 App Inbox 的 Journey 才需要这两个渠道：[非活跃玩家召回](/zh/tutorials/industry-playbooks/mobile-games/build-the-journeys/loyalty-and-win-back/#reactivation-for-inactive-players)使用 Email，[限时活动与 VIP 公告](/zh/tutorials/industry-playbooks/mobile-games/build-the-journeys/loyalty-and-win-back/#live-event-and-vip-announcements)使用 App Inbox。本实战手册中的大多数 Journey 使用推送和应用内消息。

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

## 开发人员需要做什么

将以下清单交给开发人员，让他们在一次发布中完成：

* [在登录时设置 User ID](/zh/tutorials/industry-playbooks/mobile-games/collect-player-data/#identify-players-by-user-id)。
* [发送](/zh/tutorials/industry-playbooks/mobile-games/collect-player-data/#send-the-events-from-the-game) Journey 所需的事件。
* [跟踪购买](/zh/tutorials/industry-playbooks/mobile-games/collect-player-data/#track-revenue-as-pw_conversion)；如果您销售订阅，还需[随每笔商店购买传递玩家 ID](/zh/tutorials/industry-playbooks/mobile-games/collect-player-data/#track-subscriptions-from-the-stores)。
* 将[推送权限请求](/zh/tutorials/industry-playbooks/mobile-games/prepare-for-communication/#ask-for-push-permission-at-the-right-moment)移出首次启动。
* 处理指向关卡、奖励、商店和活动界面的[深层链接](/zh/product/messaging-channels/push-notifications/advanced-push-features/deep-linking/)，Journey 会从推送中打开这些界面。
* 如果您使用 [App Inbox](/zh/tutorials/industry-playbooks/mobile-games/build-the-journeys/loyalty-and-win-back/#live-event-and-vip-announcements)，请集成 Message Inbox SDK。

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

## 开始向玩家发送消息的最低设置

如果您暂时不需要全部七个阶段，这套最低设置可以完成两项基本任务：引导新玩家完成新手教程，以及召回已停止游戏的玩家。请完成以下步骤：

1. 请开发人员在登录时调用 `setUserId`。请参阅[通过 User ID 识别玩家](/zh/tutorials/industry-playbooks/mobile-games/collect-player-data/#identify-players-by-user-id)。
2. 检查游戏是否发送了 `PW_ApplicationOpen`。请开发人员同时发送 `Tutorial started` 和 `Tutorial completed` 事件。请参阅[设置要跟踪的事件](/zh/tutorials/industry-playbooks/mobile-games/collect-player-data/#set-up-the-events-to-track)和[从游戏中发送事件](/zh/tutorials/industry-playbooks/mobile-games/collect-player-data/#send-the-events-from-the-game)。
3. 将推送权限请求移到稍后的时机，例如新手教程结束后。在 iOS 上，如果玩家在首次启动时拒绝了权限提示，就无法再次向其请求。请参阅[在合适的时机请求推送权限](/zh/tutorials/industry-playbooks/mobile-games/prepare-for-communication/#ask-for-push-permission-at-the-right-moment)。
4. 设置[发送规则](/zh/tutorials/industry-playbooks/mobile-games/prepare-for-communication/#set-delivery-rules-before-you-message-players)。
5. 构建[流失风险玩家](/zh/tutorials/industry-playbooks/mobile-games/build-the-segments/#at-risk-players)细分。如果您已经使用 `PW_InAppPurchase` 跟踪购买，还要构建[近期付费玩家](/zh/tutorials/industry-playbooks/mobile-games/build-the-segments/#recent-payers)细分。
6. 按照每个方案中 **需准备的内容** 下列出的项目，为这两个 Journey 创建内容。
7. 启动[新玩家的新手引导](/zh/tutorials/industry-playbooks/mobile-games/build-the-journeys/new-and-active-players/#onboarding-for-new-players)和[非活跃玩家召回](/zh/tutorials/industry-playbooks/mobile-games/build-the-journeys/loyalty-and-win-back/#reactivation-for-inactive-players)。

当其他细分和 Journey 所需的事件开始到达后，再添加它们。

## 下一步

如需添加更多 Journey，请参阅以下指南：

* [如何在 Pushwoosh 中设置留存营销活动](/zh/tutorials/product-guides/lifecycle-marketing-campaigns/how-to-set-up-a-retention-campaign-in-pushwoosh/)
* [如何在 Pushwoosh 中设置用户互动营销活动](/zh/tutorials/product-guides/lifecycle-marketing-campaigns/how-to-set-up-a-user-engagement-campaign-in-pushwoosh/)
* [如何在 Pushwoosh 中创建再互动营销活动](/zh/tutorials/product-guides/lifecycle-marketing-campaigns/how-to-create-a-re-engagement-campaign-in-pushwoosh/)
* [如何在 Journey 中运行 A/B/n 测试](/zh/tutorials/product-guides/how-to-create-campaigns-in-pushwoosh/how-to-abn-test-customer-journeys/)