# 开始使用 Apple Wallet 通行证

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

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

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

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

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

## 先决条件

<Aside type="caution" icon="setting" title="需要开发者协助">
发行 Apple Wallet 通行证需要一个 Apple Developer 帐户和签名证书。请与您的开发团队分享此部分，以完成一次性设置。
</Aside>

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

*   **Apple Developer Program：** 您需要一个有效的会员资格来注册通行证类型 ID 和创建签名证书。[注册或管理您的帐户](https://developer.apple.com/programs/)
*   **iOS 平台：** 您的应用程序必须在 Pushwoosh 中连接了 iOS，然后才能添加通行证签名证书。[设置 iOS](/zh/developer/first-steps/connect-messaging-services/ios-configuration/)

## 开始使用 Apple Wallet 通行证

在[先决条件](#prerequisites)准备就绪后，请按照以下流程操作：

<Steps>

1.  **在 Pushwoosh 中配置 Wallet 通行证**

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

    [如何设置签名证书](/zh/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

2.  **设计通行证**

    在[通行证构建器](/zh/product/messaging-channels/apple-wallet-passes/pass-builder/)中，选择通行证样式，设置字段和品牌，并检查实时预览。

3.  **生成已签名的 `.pkpass`**

    一旦您创建并验证了通行证，在[通行证构建器](/zh/product/messaging-channels/apple-wallet-passes/pass-builder/#generate-the-pass)中，选择**生成**。Pushwoosh 会准备所需分辨率的图像，并用您的证书为文件签名。

4.  **分发通行证**

    向用户发送 `.pkpass` 文件、安装链接或二维码。请参阅[通过 Pushwoosh 渠道与用户分享通行证](#share-the-pass-with-users-via-pushwoosh-channels)。当用户将通行证添加到 Wallet 时，他们的设备会注册以接收未来的更新。

5.  **更新通行证内容**

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

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

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

    [向 Apple Wallet 通行证持有者发送消息](/zh/product/messaging-channels/apple-wallet-passes/message-pass-holders/)

</Steps>

## 查看和管理现有通行证

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

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

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

<Aside type="note" title="更新以静默推送方式发送">
当您保存更改时，Pushwoosh 会重新签署通行证，并用一个无内容的推送通知每台注册设备。iOS 会自行获取新版本——无需重新安装。
</Aside>

*   **下载：** 下载已签名的 `.pkpass` 文件。
*   **二维码：** 显示一个安装二维码，用户可以扫描以将通行证添加到 Wallet 并注册他们的设备以接收更新。在此窗口中，您还可以使用二维码下方的**复制安装链接**。
*   **复制安装链接：** 复制安装 URL 以在您的消息渠道中分享通行证。[了解更多](#share-the-pass-with-users-via-pushwoosh-channels)。
*   **发送消息：** 打开一次性推送编辑器，向通行证持有者发送消息。当您从列表中打开它时，它会通过 [User ID](/zh/product/pushwoosh-knowledge-hub/users-userids/) 定位通行证所有者。请参阅[向 Apple Wallet 通行证持有者发送消息](/zh/product/messaging-channels/apple-wallet-passes/message-pass-holders/)了解所有触达他们的方式。
*   **删除：** 移除通行证。已安装在设备上的副本将停止接收更新，并在下次刷新时失效。

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

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

*   **电子邮件：** 在[电子邮件编辑器](/zh/product/content/email-content/drag-and-drop-email-editor/)中将链接添加到按钮或文本链接，例如，“添加到 Apple Wallet” 的号召性用语。
*   **推送通知：** 将链接设置为通知的[打开操作](/zh/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#define-what-happens-when-the-push-is-clicked)，这样点击就会打开通行证。
*   **SMS：** 在 [SMS 内容](/zh/product/messaging-channels/sms/send-sms/send-sms-via-customer-journey/#configure-sms-content)中包含链接。

<Aside type="note" title="每个通行证一个链接">
每个安装链接都与单个通行证绑定（它携带该通行证的序列号和令牌），因此一个链接适用于一个共享的通行证，这对于通用的优惠券或活动门票很方便。要为每个接收者提供他们自己的通行证，请使用 [PassKit API](/zh/developer/api-reference/apple-wallet-passkit-api/) 为每个用户生成一个通行证，并向每个用户发送他们自己的链接。Wallet 通行证仅在 Apple 设备上安装——iPhone 和 Apple Watch。
</Aside>

## 通过 API 管理通行证

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

<LinkCard title="Apple Wallet PassKit API" href="/developer/api-reference/apple-wallet-passkit-api/" />

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

当用户将您的通行证添加到 Wallet 时，Pushwoosh 会在 [User Explorer](/zh/product/audience-data-and-segmentation/user-explorer/) 的 **Devices and platforms** 选项卡中列出它。

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

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

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

[了解更多](/zh/product/audience-data-and-segmentation/user-explorer/#devices-and-platforms-tab)