跳到内容

Apple Wallet pass 入门

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

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

您可以使用 Apple Wallet pass 做什么

Anchor link to

通过 Pushwoosh 中的 Apple Wallet pass,您可以:

  • 可视化地设计 pass,包括颜色、字段、徽标、条形图和条形码,无需手动编写 pass.json
  • 创建会员卡、优惠券、活动门票、登机牌和通用商店卡。
  • .pkpass 文件、安装链接或二维码的形式向用户分发 pass。
  • 更新 pass 内容,并将更改交付给已添加该 pass 的设备。

前提条件

Anchor link to

在设计您的第一个 pass 之前,请确认以下事项:

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

开始使用 Apple Wallet pass

Anchor link to

前提条件准备就绪后,请按以下流程操作:

  1. 在 Pushwoosh 中配置 Wallet pass

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

    如何设置签名证书

  2. 设计 pass

    凭证构建器中,选择一个 pass 样式,设置字段和品牌,并检查实时预览。

  3. 生成一个已签名的 .pkpass

    创建并验证 pass 后,在凭证构建器中选择生成。Pushwoosh 会准备所需分辨率的图像,并用您的证书对文件进行签名。

  4. 分发 pass

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

  5. 更新 pass 内容

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

查看和管理现有 pass

Anchor link to

在控制面板中,转到 Campaigns → Apple Wallet 打开 pass 列表。该页面列出了应用程序的每个 pass,包括其名称、样式、关联的 User ID,以及上次更新的日期和时间。

在 pass 列表上,打开操作菜单 (⋮) 以:

  • 编辑: 更改 pass 名称和描述、字段值和标签、更改消息、颜色、条形码消息、到期和状态以及位置。Pass 样式和图像在创建后保持锁定。当您保存时,每台添加了该 pass 的设备都会收到更新。
  • 下载: 下载已签名的 .pkpass 文件。
  • 二维码: 显示一个安装二维码,用户可以扫描以将 pass 添加到 Wallet 并注册其设备以接收更新。在此窗口中,您还可以使用二维码下方的复制安装链接
  • 复制安装链接: 复制安装 URL 以在您的消息渠道中分享 pass。了解更多
  • 删除: 移除 pass。已安装在设备上的副本将停止接收更新,并在下次刷新时失效。

通过 Pushwoosh 渠道与用户分享 pass

Anchor link to

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

  • 电子邮件:邮件编辑器中将链接添加到按钮或文本链接,例如,“添加到 Apple Wallet” 的行动号召。
  • 推送通知: 将链接设置为通知的打开操作,这样点击就会打开 pass。
  • 短信:短信内容中包含链接。

通过 API 管理 pass

Anchor link to

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