创建 Wallet Pass 营销活动

Wallet Pass 营销活动可让您设计单个 Apple Wallet 或 Google Wallet Pass 模板，将其发放给多个用户，并集中管理更新。

您可以选择哪些字段是共享（将更改同步到所有用户设备）和哪些是个人（为每个用户保留唯一值，如姓名、条形码或余额）。

注意

Wallet Pass 营销活动与 Customer Journey 营销活动或推送通知无关。它是一个用于管理 Pass 模板、发放和实时 Pass 更新的工具。

Wallet Pass 营销活动的功能

• 在营销活动中设计一个 Pass，而不是在 Apple Wallet 或 Google Wallet Pass 构建器中手动设置每个 Pass。
• 选择哪些字段在所有地方更新（共享），哪些字段保留在每个 Pass 中（个人）。
• 在保存字段编辑前，查看它会影响多少已发放的 Pass。
• 在一个 Pass 上覆盖共享字段，之后再将控制权交还给营销活动。
• 附加在营销活动之外发放的 Pass，使其开始遵循其共享字段。
• 跟踪营销活动修订版本和每次更新的交付状态。
• 每当字段背后的标签发生变化时，自动刷新 Pass，无需编辑营销活动。

前提条件

营销活动使用与独立 Pass 相同的一次性设置：

Apple Wallet：

• 有效的 Apple Developer Program 会员资格
• 连接到应用程序的 iOS 平台
• 上传到 Pushwoosh 的 Pass 签名证书

Google Wallet：

• 有效的 Google Pay & Wallet Console 发放方账户
• 为应用程序配置的 Google Wallet（发放方 ID 和 Google Cloud 服务账户密钥）

创建营销活动

要开始创建营销活动，请前往 Campaigns → Wallet Passes → Campaigns 并点击 Create campaign。

设置营销活动详情和平台

• 平台： 在页面顶部选择 Apple Wallet 或 Google Wallet。此选择对营销活动是永久性的。
• 营销活动： 输入一个名称和一个可选的描述，供内部参考。两者都不会出现在 Pass 上。
• Pass 格式： 在 Pass Style (Apple) 或 Pass Type (Google) 下，选择您的 Pass 布局：
  • Apple Wallet： 登机牌、优惠券、活动门票、商店卡、通用。请参阅选择 Pass 样式。
  • Google Wallet： 通用、优惠、会员卡、活动门票、礼品卡、航班、公交。创建后无法更改。请参阅选择 Pass 类型。

配置 Pass 设计和品牌

配置 Pass 的标准部分：

• 基本信息、颜色和条形码： 设置 Pass 标题、背景和文本颜色以及条形码类型。有关每个部分的详细指导，请参阅在 Apple Wallet Pass 构建器中设计 Pass 或在 Pass 构建器中设计 Google Wallet Pass。
• Pass 字段： 添加应显示在卡上的字段（请参阅 Apple Wallet Pass 字段 或 Google Wallet 字段和详情）。
• 过期： 设置相关日期和过期规则（请参阅 Apple Wallet 过期 或 Google Wallet 过期）。
• 位置： 设置基于位置的相关性（请参阅 Apple Wallet 位置 或 Google Wallet 位置）。

提示

对于 Google Wallet，使用 Who can save the pass 来控制 Pass 是绑定到单个 Google 账户、单个设备，还是对任何拥有链接的人都可访问。

设置共享和个人字段

在 Shared and personal fields 部分，配置哪些字段在所有 Pass 中全局更新，哪些字段为每个用户保留唯一值。这控制了您稍后编辑营销活动时会发生什么：共享字段会在每个已发放的 Pass 上更新，而个人字段保持不变。

对于任何应为每个用户保留唯一值的字段，打开 Personal 开关。

字段类型	行为	示例
共享	由营销活动驱动。更新此字段会将新值同步到用户设备上的每个 Pass。	活动日期、登机口号码、商店地址、折扣百分比
个人	每个用户唯一。营销活动更新时不会覆盖这些值。	用户名、座位号、会员 ID、积分余额

个人字段的值可以包含标签占位符 {tag} 或 {tag|format|fallback}（例如 {Seat}）。当 Pushwoosh 提供 Pass 时，会从接收者的标签中填充它。如果接收者没有该标签的值，Pushwoosh 会使用占位符中的备用值，或者在占位符没有备用值时将该字段留空。

• 只有标签，没有其他内容，如 {Seat}： 该字段不会出现在 Issue pass 对话框中。
• 标签与其他文本混合，如 Seat {Seat}，或者根本没有标签： 该字段会作为可编辑输入出现在 Issue pass 对话框中，并预填充该值。当 Pushwoosh 提供 Pass 时，其中的任何标签仍会根据接收者进行解析。

提示

Pass 的条形码在 Barcode 部分进行配置和个性化。详情请参阅 Apple Wallet 条形码 或 Google Wallet 条形码。

开启标签同步

在 Tag sync 部分，开启 Update pass fields from tags，让 Pushwoosh 定期重新检查营销活动字段中使用的标签占位符，并将新值推送到任何标签已更改的 Pass。

• 间隔（分钟）： Pushwoosh 重新读取标签的频率。默认为 60，不能低于 5。每个间隔内，一个 Pass 最多刷新一次，无论其中标签更改了多少次。
• 通知（仅限 Google Wallet）：选择持有人如何获知刷新：Silently、Own message（填写 Message text，随更新发送）或 Google field notification（Google 自己的字段更新提醒）。Google 将其限制为每个 Pass 每 24 小时 3 次。超过此限制后，新值仍会到达 Pass，只是没有通知。

注意

Apple Wallet 没有营销活动范围的通知，因此这个选择器不会出现在 Apple 营销活动中。通知文本位于字段本身。在 Apple Wallet Pass 构建器中的每个字段上填写 Change message。

警告

标签同步仅在营销活动状态为 Active 时运行。将其设置为 Draft 或 Archived 可暂停计划检查，而无需关闭开关。

对于已经发放 Pass 的营销活动开启标签同步，不会等待第一个间隔。下一次计划检查会将从未同步过的营销活动视为立即到期，在 Own message 或 Google field notification 模式下，这可能会一次性通知所有持有人，并在一次运行中用完 Pass 每 24 小时 3 次的限额。

上传营销活动图片

1. 在 Campaign images 部分，点击图片槽旁边的 Choose an image。
2. 从您的媒体库中选择现有图片，或拖放新文件进行上传。
3. 对每个可用的图片槽重复此操作：
   • Apple Wallet： 图标、徽标、背景、页脚、条带和缩略图（请参阅 Apple Wallet 图片）。
   • Google Wallet： 徽标和主图。

注意

• 图片必须小于 10 MB 且低于 2500 万像素。
• Apple Wallet： 与独立 Pass 不同（创建后图片被锁定），营销活动图片更新会到达每个已发放的 Pass。
• Google Wallet： 独立 Pass 已经允许您随时通过 Edit 更改其徽标和主图。营销活动图片的工作方式相同，只是一个编辑会一次性到达每个已发放的 Pass，而不仅仅是一个。

预览并创建营销活动

1. 检查右侧的 Preview as user 面板，查看卡片的外观。您可以输入一个测试 User ID 来预览个性化字段。

提示

点击 Validate pass，在保存前根据 Apple 或 Google 的要求检查设计，而无需立即创建营销活动。

2. 点击页面底部的 Create campaign。

Pushwoosh 会以 Draft 状态创建营销活动，并打开其工作区，其中包含 Design、Passes 和 History 选项卡。

注意

创建营销活动仅保存 Pass 设计，并不会将 Pass 发送给用户。要向您的受众分发 Pass，请继续向用户发放 Pass。

向用户发放 Pass

从营销活动中发放 Pass

1. 在 Passes 选项卡上，点击 Issue pass。
2. 输入接收者的 Pushwoosh User ID。

3. 点击 Issue pass 进行确认。

根据您配置 Personal fields 的方式，模态框会按如下方式处理它们：

• 可编辑字段： 显示默认值，您可以为该用户更改这些值。
• 标签占位符（如 {Seat}）： 不会出现在对话框中。Pushwoosh 会自动从用户的标签中填充它们。

您也可以在发放后随时编辑单个 Pass 上的任何个人字段。

Pushwoosh 会根据营销活动的当前设计生成 Pass，并将其列在 Passes 选项卡 和应用程序的 All passes 表中（Apple Wallet 或 Google Wallet）。

将 Pass 交付给接收者

发放 Pass 会在 Pushwoosh 中创建 Pass 记录。要将其交付到用户设备，请分享安装链接：

1. 在 Passes 选项卡或 All passes 中打开 Pass 的操作菜单。
2. 选择 Copy install link 或 QR code。Apple Wallet Pass 还提供 Download 选项，用于下载已签名的 .pkpass 文件。
3. 通过推送、电子邮件、短信或 Customer Journey 将链接或文件发送给接收者。要在旅行者通过旅程时自动发放 Pass 并交付其链接，请使用 Issue Wallet Pass 元素，而不是在此处发放。

有关分发 Pass 的更多方式，请参阅分享 Apple Wallet Pass 或分享 Google Wallet Pass。

将现有 Pass 附加到营销活动

您可以将独立 Pass（在任何营销活动之外创建）附加到营销活动，以便它们开始接收共享更新。

1. 在 Passes 选项卡上，点击 Attach passes。
2. 按 User ID、序列号或条形码搜索 Pass。
3. 选择 Pass 并确认。

附加后：

• 共享字段开始遵循营销活动，并在您更改 Pass 模板时更新。
• Pass 上已有的个人值（如用户详情或唯一余额）将被保留。

通过 API 附加 Pass

您也可以使用 AttachPasses API 方法以编程方式附加 Pass（每个请求最多 500 个序列号）。

如果无法附加 Pass，API 会返回该序列号的具体原因：

• 该 Pass 已分配给另一个营销活动。
• Pass 样式与营销活动的格式不匹配。
• Pass 缺少必需的营销活动字段。
• 序列号不存在或属于不同平台。

管理现有营销活动

从 Campaigns → Wallet Passes → Campaigns 打开已创建的营销活动，会显示其状态、修订计数器、实时 Pass 预览以及三个主要选项卡：Design、Passes 和 History。

更改营销活动状态

使用状态来跟踪每个营销活动所处的阶段：仍在设计中、正在积极发放 Pass，或已完成并存档。

要更改状态，请从营销活动标题中的 Status 下拉菜单中选择一个选项。更改会立即保存，无需单独的确认步骤：

• Draft 或 Active： 允许您发放新 Pass、附加现有 Pass 并推送设计更新。
• Archived： 暂停新 Pass 的发放。当营销活动存档时，您无法发放或附加 Pass，但之前发放的 Pass 会继续工作并接收共享更新。

Design 选项卡

在 Design 选项卡上，您可以更新 Pass 模板、更改颜色、修改共享和个人字段、上传新的营销活动图片或更改标签同步设置。

更新设计并向 Pass 推送更改

1. 在 Design 选项卡上，编辑基本信息、颜色、条形码类型、过期时间、位置、共享字段或营销活动图片。
2. 点击 Save changes。
3. 在 Apply the campaign edit 对话框中，确认更新：
   • 没有 Pass 覆盖已更改的字段： 点击 Update N, keep hand edits 将编辑推送到所有 N 个 Pass。
   • 某些 Pass 覆盖了已更改的字段： 对话框会显示字段名称以及有多少个 Pass 覆盖了它。点击 Update N, keep hand edits 将编辑推送到除这些 Pass 之外的所有 Pass，或点击 Overwrite all N 将其推送到所有 N 个 Pass，包括被覆盖的 Pass。覆盖会清除覆盖值。

无论您点击哪个按钮，更新都会保存为一个新的修订版本（例如 Revision 2），因此您可以在 History 选项卡上查看更改内容和时间。

注意

在尚未发放任何 Pass 时进行的编辑会立即保存，无需确认对话框，因为没有现有的 Pass 需要更新。

在单个 Pass 上覆盖共享字段

如果您需要为特定用户自定义共享字段，请直接在其个人 Pass 上编辑该字段（从 Passes 选项卡或 All passes）：

• 创建覆盖： 在单个 Pass 上保存自定义值会将该字段与营销活动范围的更新分离。未来对营销活动的更新，包括计划的标签同步刷新，将跳过此 Pass 的该特定字段。
• 移除覆盖： 要恢复营销活动控制，请编辑 Pass 并点击被覆盖字段旁边的 Use the campaign value。

您可以在 Passes 选项卡的 Pinned fields 列下跟踪哪些 Pass 具有自定义值。

Passes 选项卡

Passes 选项卡列出了营销活动发放的每个 Pass，包括其序列号、接收者 User ID、活动的固定字段、当前修订版本和最后更新日期。

如果标签同步已开启，该选项卡还会在表格上方显示一行 Tags synced，其中包含上次计划运行的日期和时间，或者在第一次运行前显示 not yet。

使用表格筛选器查找特定的 Pass：

• With pinned fields： 显示至少有一个自定义编辑字段的 Pass。
• Behind the revision： 显示尚未收到最新营销活动更新的 Pass。

要发放新 Pass 或附加现有 Pass，请参阅向用户发放 Pass。

打开一行的操作菜单 (⋮) 来管理该 Pass：

• Edit： 在其平台的编辑页面上打开 Pass，以更改个人字段或覆盖共享字段。
• Download： 在 Apple Wallet 营销活动中，下载已签名的 .pkpass 文件。Google Wallet 营销活动不显示此选项，因为 Google Wallet 没有可下载的文件等效物。
• Send message： 打开一次性推送编辑器，按 User ID 向 Pass 的接收者发送消息。有关联系他们的所有方式，请参阅向 Wallet Pass 持有人发送消息。
• QR code： 显示一个安装二维码，用户可以扫描以添加 Pass 并注册其设备以接收更新。
• Copy install link： 复制安装 URL，以便在您的消息渠道中分享 Pass。
• Delete： 移除 Pass。此操作无法撤销。在 Apple Wallet 上，已安装的副本将停止接收更新，并在下次刷新时失效。在 Google Wallet 上，Google 不允许强制移除已保存在设备上的 Pass，因此它会失效并移至用户的 Expired passes，同时 Pushwoosh 会移除其记录。在此处删除 Pass 不会删除营销活动或任何其他已发放的 Pass。

History 选项卡

History 选项卡按时间顺序列出营销活动的所有修订版本，显示每个版本中修改了哪些字段。

最新更新的交付状态显示在选项卡下方：

• Cancel： 停止向尚未到达的 Pass 发送更新。这些 Pass 将保留其先前的修订版本。
• Retry failed： 为更新失败的 Pass（在 5 次尝试后标记为失败）重新尝试交付。

一旦保存了新的修订版本，旧的更新将无法再重试或取消。

删除营销活动

打开营销活动，然后点击页面右上角的 Delete campaign。

删除营销活动不会删除或使已发放的 Pass 失效。已发放的 Pass 会保留其当前内容和图片，但会停止接收共享更新。任何未来的更改都必须在每个 Pass 上单独进行。