如何通知 Wallet 通行证持有者获得奖励

在忠诚度会员获得奖励的那一刻就告诉他们奖励已就绪，消息会显示在他们的 Apple Wallet 或 Google Wallet 通行证上。在本指南中，您将构建一个 Customer Journey，仅向已添加您通行证的会员发送该消息。

前提条件

• 针对您支持的平台，完成 Apple Wallet 通行证设置，和/或配置 Android 版 Google Wallet。
• 按 User ID 向会员发放忠诚度通行证，且发放所在的应用须与此 Journey 相同，例如通过 Wallet Pass 营销活动发放，或参考如何在注册时发放 Wallet 通行证。

创建奖励事件

事件是您的系统在用户身上发生某件事时发送的信号。在这里，它在会员获得奖励时发送，例如会员累积到 100 个忠诚度积分，或在咖啡卡上集满第十个印章时。

1. 转到 受众 → 事件，点击 创建事件，然后选择 自定义事件。
2. 将其命名为 RewardUnlocked。该事件不需要任何属性，因为每位会员收到的消息文本都相同。
3. 请开发人员在会员获得奖励时发送该事件。详细了解如何创建事件

需要开发者协助

使用 postEvent API 调用或 SDK 发送 RewardUnlocked，并在其中传递会员的 User ID。请使用发放通行证时所用的同一个 User ID，否则 Journey 将找不到该会员的通行证。

准备消息

创建一个包含奖励消息的推送预设，例如：

• 标题： Riverside Café Rewards
• 文本： Your free coffee is ready. Show your loyalty card at the counter.

务必填写文本。通行证会显示该文本；在 Apple Wallet 上，没有文本的推送只会刷新通行证，持有者什么也看不到。

持有者看到的内容取决于所用的钱包：

• Apple Wallet： 一条来自通行证的通知，在推送标题下方显示推送的 iOS 文本。Pushwoosh 会在大约一小时后从通行证上移除该消息。只有文本发生变化时 Apple Wallet 才会发出通知，因此在这一小时内再次发送相同文本的推送不会显示通知。
• Google Wallet： 一条显示推送标题和文本的 Android 通知，消息同时显示在通行证上。通行证只保留最新的一条消息。Google 还会限制通行证通知持有者的频率。请参阅 Google Wallet 通知。

构建 Journey

转到 营销活动 → Customer Journey Builder，点击 创建营销活动，然后在同一个画布上构建以下所有内容。

设置入口

1. 在画布上添加一个基于触发的入口元素。
2. 在 节点名称 中输入 Reward unlocked。
3. 在 事件 下选择 RewardUnlocked。

仅保留持有通行证的会员

1. 在入口之后添加一个可达性检查元素，并将其命名为 Holds the pass?。
2. 在 可通过以下方式触达 下，点击 添加渠道 中的 Wallet Pass，然后删除该元素默认带有的 推送通知 渠道。
3. 保持选中 所有平台，以同时检查 Apple Wallet 和 Google Wallet 通行证。
4. 在 检查哪些设备 下，选择 用户的所有设备。通行证注册为会员的一台独立设备，因此如果只检查发送事件的设备，就会漏掉它。

该元素会生成两个分支。已添加您通行证的会员进入 Wallet 分支，其他所有人进入 所有其他 分支。

发送奖励消息

1. 在 Wallet 分支上添加一个推送元素，并将其命名为 Reward message。
2. 在 预设 中，选择您准备好的预设。
3. 选择 事务性消息。会员获得了奖励并期待收到相关通知，因此该消息会送达每一位持有通行证的会员，包括全局对照组中的会员以及已达到频率上限的会员。详细了解消息类型。

4. 保持开启 发送到用户的所有设备（按 UserID）。这样推送会发送到与会员 User ID 绑定的每台设备，包括通行证以及安装了您应用的手机等设备。如果关闭此设置，推送只会发送到发送事件的设备，通行证将收不到任何内容。

5. 您也可以在 Reward message 之后添加一个 退出旅程 元素，并将 所有其他 分支连接到另一个 退出旅程 元素。

当 RewardUnlocked 触发时，会员进入 Journey。如果会员已添加您的通行证，Reward message 会将推送发送到其所有设备，钱包会在通行证上显示该消息。未持有通行证的会员会通过 所有其他 离开 Journey，不会收到任何消息。在该应用中没有任何设备的会员会在 Holds the pass? 处流失，原因为未找到设备。

启动并检查

1. 画布准备就绪后，启动 Journey。
2. 请开发人员为一位持有通行证的会员发送一个测试 RewardUnlocked 事件。
3. 在 Holds the pass? 上，查看有多少用户进入了 Wallet 和 所有其他。
4. 在 Reward message 上，查看统计数据。

更新通行证内容（可选）

推送不会更改您通行证设计中的字段。在 Apple Wallet 上，推送标题会替代通行证的组织名称显示，直到该消息被移除。如需在卡片本身上显示奖励（例如新的积分余额），请单独更新通行证：

• 在 Control Panel 中，通过所有凭证中的 编辑，或在该通行证所属的 Wallet Pass 营销活动中更改设计。
• 通过 Apple PassKit API 或 Google Wallet API。

启动 Journey 的其他方式

• 基于受众的入口： 一次性或按计划向整个分群发送消息，例如每周向忠诚度计划会员发送优惠。
• 基于 API 的入口： 从您自己的系统启动 Journey，例如当某场活动的开始时间发生变化时，通知所有持票人。