开始使用 Apple Wallet 通行证

Apple Wallet 通行证是数字卡片，例如会员卡、优惠券、活动门票、登机牌和商店卡，您的用户可以将其保存在 iPhone 和 Apple Watch 上的 Wallet 应用中。通过 Pushwoosh，您可以在控制面板中直观地设计通行证，分享它，然后随时推送更新，而无需用户重新安装任何东西。

当您更改通行证时，Pushwoosh 会通知每台添加了该通行证的设备，iOS 会静默获取新版本。用户手机上的条形码、余额、登机口号码或到期日期都会自动更新。

您可以使用 Apple Wallet 通行证做什么

通过 Pushwoosh 中的 Apple Wallet 通行证，您可以：

• 无需手动编写 pass.json，即可直观地设计通行证，包括颜色、字段、徽标、条幅图片和条形码。
• 创建会员卡、优惠券、活动门票、登机牌和通用商店卡。
• 以 .pkpass 文件、安装链接或二维码的形式向用户分发通行证。
• 更新通行证内容，并将更改交付给已添加该通行证的设备。
• 通过一次性推送、通行证更新或 Customer Journey 触达通行证持有者。请参阅向 Apple Wallet 通行证持有者发送消息。

先决条件

需要开发者协助

发行 Apple Wallet 通行证需要一个 Apple Developer 帐户和签名证书。请与您的开发团队分享此部分，以完成一次性设置。

在设计您的第一个通行证之前，请确认以下事项：

• Apple Developer Program： 您需要一个有效的会员资格来注册通行证类型 ID 和创建签名证书。注册或管理您的帐户
• iOS 平台： 您的应用程序必须在 Pushwoosh 中连接了 iOS，然后才能添加通行证签名证书。设置 iOS

开始使用 Apple Wallet 通行证

在先决条件准备就绪后，请按照以下流程操作：

1. 在 Pushwoosh 中配置 Wallet 通行证

   在您设计通行证之前，Pushwoosh 必须拥有您应用程序的 Apple 签名证书。您的开发团队在 Apple Developer 中创建它并上传到 Pushwoosh。这是每个应用程序的一次性设置。

   如何设置签名证书

2. 设计通行证

   在通行证构建器中，选择通行证样式，设置字段和品牌，并检查实时预览。

3. 生成已签名的 .pkpass

   一旦您创建并验证了通行证，在通行证构建器中，选择生成。Pushwoosh 会准备所需分辨率的图像，并用您的证书为文件签名。

4. 分发通行证

   向用户发送 .pkpass 文件、安装链接或二维码。请参阅通过 Pushwoosh 渠道与用户分享通行证。当用户将通行证添加到 Wallet 时，他们的设备会注册以接收未来的更新。

5. 更新通行证内容

   在通行证构建器中或通过 API 编辑通行证并保存。Pushwoosh 会通知已注册的设备，iOS 会在后台下载新版本。用户无需重新安装通行证。

6. 向通行证持有者发送消息

   一旦用户将通行证添加到 Wallet，您就可以通过一次性推送、通行证更新或自动化的 Customer Journey 触达他们。

   向 Apple Wallet 通行证持有者发送消息

查看和管理现有通行证

在控制面板中，转到 Campaigns → Wallet Passes 并打开 Apple Wallet 选项卡。All passes 表格列出了该应用程序的所有通行证，包括其名称、样式、关联的 User ID，以及最后更新的日期和时间。

在通行证列表上，打开操作菜单 (⋮) 以：

• 编辑： 更改通行证名称和描述、字段值和标签、更改消息、颜色、条形码消息、到期和状态以及位置。通行证样式和图像在创建后保持锁定。当您保存时，每台添加了该通行证的设备都会收到更新。

更新以静默推送方式发送

当您保存更改时，Pushwoosh 会重新签署通行证，并用一个无内容的推送通知每台注册设备。iOS 会自行获取新版本——无需重新安装。

• 下载： 下载已签名的 .pkpass 文件。
• 二维码： 显示一个安装二维码，用户可以扫描以将通行证添加到 Wallet 并注册他们的设备以接收更新。在此窗口中，您还可以使用二维码下方的复制安装链接。
• 复制安装链接： 复制安装 URL 以在您的消息渠道中分享通行证。了解更多。
• 发送消息： 打开一次性推送编辑器，向通行证持有者发送消息。当您从列表中打开它时，它会通过 User ID 定位通行证所有者。请参阅向 Apple Wallet 通行证持有者发送消息了解所有触达他们的方式。
• 删除： 移除通行证。已安装在设备上的副本将停止接收更新，并在下次刷新时失效。

通过 Pushwoosh 渠道与用户分享通行证

您在构建器中复制的安装链接（复制安装链接）是一个常规 URL。在 iPhone 上打开它会将通行证添加到 Apple Wallet。您可以在您已经用来触达受众的相同 Pushwoosh 渠道中使用此链接：

• 电子邮件： 在电子邮件编辑器中将链接添加到按钮或文本链接，例如，“添加到 Apple Wallet” 的号召性用语。
• 推送通知： 将链接设置为通知的打开操作，这样点击就会打开通行证。
• SMS： 在 SMS 内容中包含链接。

每个通行证一个链接

每个安装链接都与单个通行证绑定（它携带该通行证的序列号和令牌），因此一个链接适用于一个共享的通行证，这对于通用的优惠券或活动门票很方便。要为每个接收者提供他们自己的通行证，请使用 PassKit API 为每个用户生成一个通行证，并向每个用户发送他们自己的链接。Wallet 通行证仅在 Apple 设备上安装——iPhone 和 Apple Watch。

通过 API 管理通行证

通行证构建器所做的一切也可以通过 PassKit Designer API 以编程方式实现：创建、更新、列出、下载和删除通行证。

Apple Wallet PassKit API

在 User Explorer 中查看通行证持有者

当用户将您的通行证添加到 Wallet 时，Pushwoosh 会在 User Explorer 的 Devices and platforms 选项卡中列出它。

1. 转到 Audience → User Explorer 并打开用户个人资料。
2. 打开 Devices and platforms 选项卡。
3. 在侧边栏中选择 Apple Wallet。

在平台个人资料中，您可以查看：

• 订阅状态： 例如，SUBSCRIBED
• 平台标识符： 显示在平台名称下的通行证标识符
• 元数据： First subscription、Timezone 以及其他可用字段
• 标签： 平台标签，包括您在发行通行证时设置的任何标签

了解更多