创建 Wallet Pass Campaign

Wallet Pass Campaign 可让你设计单个 Apple Wallet 或 Google Wallet Pass 模板，将其签发给多个用户，并集中管理更新。

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

注意

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

Wallet Pass Campaign 的功能

• 在一次营销活动中设计一个 Pass，而无需在 Apple Wallet 或 Google Wallet 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： Boarding Pass、Coupon、Event Ticket、Store Card、Generic。请参阅选择 Pass 样式。
  • Google Wallet： Generic、Offer、Loyalty card、Event ticket、Gift card、Flight、Transit。创建后无法更改。请参阅选择 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，使用谁可以保存此 Pass 来控制 Pass 是绑定到单个 Google 账户、单个设备，还是任何有链接的人都可以访问。

设置共享和个人字段

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

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

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

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

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

提示

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

上传营销活动图片

1. 在营销活动图片部分，点击图片槽旁边的选择图片。
2. 从你的媒体库中选择现有图片或拖放新文件进行上传。
3. 为每个可用的图片槽重复此操作：
   • Apple Wallet： Icon、Logo、Background、Footer、Strip 和 Thumbnail（请参阅 Apple Wallet 图片）。
   • Google Wallet： Logo 和 Hero image。

注意

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

预览并创建营销活动

1. 检查右侧的以用户身份预览面板，查看卡片的外观。你可以输入一个测试 User ID 来预览个性化字段。

提示

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

2. 点击页面底部的创建营销活动。

Pushwoosh 会以草稿状态创建营销活动，并打开其工作区，其中包含设计、Pass 和历史记录选项卡。

注意

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

向用户签发 Pass

从营销活动中签发 Pass

1. 在Pass 选项卡上，点击签发 Pass。
2. 输入接收者的 Pushwoosh User ID。

3. 点击签发 Pass 确认。

根据你配置个人字段的方式，模态框会按以下方式处理它们：

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

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

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

将 Pass 交付给接收者

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

1. 在Pass 选项卡或所有 Pass 中打开 Pass 的操作菜单。
2. 选择复制安装链接或 QR 码。Apple Wallet Pass 还提供下载已签名的 .pkpass 文件。
3. 通过推送、电子邮件、短信或 Customer Journey 将链接或文件发送给接收者。要自动签发 Pass 并在旅行者通过 Journey 时交付其链接，请使用 Issue Wallet Pass 元素，而不是在这里签发。

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

将现有 Pass 附加到营销活动

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

1. 在Pass 选项卡上，点击附加 Pass。
2. 通过 User ID、序列号或条形码搜索 Pass。
3. 选择 Pass 并确认。

附加后：

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

通过 API 附加 Pass

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

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

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

管理现有营销活动

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

更改营销活动状态

使用状态来跟踪每个营销活动的进展：仍在设计中、正在积极签发 Pass，或已完成并归档。

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

• 草稿或有效： 允许你签发新 Pass、附加现有 Pass 并推送设计更新。
• 已归档： 暂停新 Pass 的签发。当营销活动归档时，你无法签发或附加 Pass，但之前签发的 Pass 会继续工作并接收共享更新。

设计选项卡

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

更新设计并向 Pass 推送更改

编辑以下任何内容并点击保存更改，会显示一个确认对话框，显示将有多少已签发的 Pass 会被更新：

• 基本信息、颜色或条形码类型
• 过期或位置
• 一个共享字段
• 一张营销活动图片

确认更新：

• 如果没有 Pass 有覆盖： 点击更新将更改推送到所有已签发的 Pass。
• 如果某些 Pass 有覆盖： 选择是仅更新标准 Pass（保留用户覆盖）还是覆盖所有 Pass。

确认更新会增加营销活动的修订计数器（例如，到修订版 2），并自动将更改同步到用户设备。

注意

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

在单个 Pass 上覆盖共享字段

如果你需要为特定用户自定义共享字段，请直接在该用户的单个 Pass 上编辑该字段（从Pass 选项卡或所有 Pass）：

• 创建覆盖： 在单个 Pass 上保存自定义值会使该字段脱离营销活动范围的更新。将来对营销活动的更新将跳过此 Pass 的该特定字段。
• 移除覆盖： 要恢复营销活动控制，请编辑 Pass 并点击被覆盖字段旁边的使用营销活动值。

你可以在Pass 选项卡的覆盖列下跟踪哪些 Pass 具有自定义值。

Pass 选项卡

Pass 选项卡列出了营销活动签发的所有 Pass，包括其序列号、接收者 User ID、活动的覆盖、当前修订版本和最后更新日期。

使用表格过滤器查找特定 Pass：

• 有覆盖： 显示至少有一个自定义编辑字段的 Pass。
• 落后于修订版本： 显示尚未收到最新营销活动更新的 Pass。

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

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

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

历史记录选项卡

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

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

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

一旦保存了新的修订版本，旧的更新就不能再重试或取消。

删除营销活动

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

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