# 创建 Wallet Pass 营销活动

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

您可以选择哪些字段是 [**共享**](#set-shared-and-personal-fields)（同步更改到所有用户设备）和哪些是 [**个人**](#set-shared-and-personal-fields)（为每个用户保留唯一值，如姓名、条形码或余额）。

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

## 您可以使用 Wallet Pass 营销活动做什么

*   在营销活动中设计一个 Pass，而不是在 [Apple Wallet](/zh/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/) 或 [Google Wallet](/zh/product/messaging-channels/wallet-passes/google-wallet/pass-builder/) Pass 构建器中手动设置每个 Pass。
*   选择哪些字段在所有地方更新（共享），哪些字段保留在每个 Pass 上（个人）。
*   在保存字段编辑前，查看它会影响多少已发放的 Pass。
*   在一个 Pass 上覆盖共享字段，之后再将控制权交还给营销活动。
*   附加在营销活动之外发放的 Pass，使其开始遵循其共享字段。
*   跟踪营销活动修订版本和每次更新的交付状态。

## 先决条件

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

**Apple Wallet：**
  *   有效的 [Apple Developer Program](https://developer.apple.com/programs/) 会员资格
  *   连接到应用程序的 [iOS 平台](/zh/developer/first-steps/connect-messaging-services/ios-configuration/)
  *   上传到 Pushwoosh 的 [Pass 签名证书](/zh/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

**Google Wallet：**
  *   有效的 [Google Pay & Wallet Console](https://pay.google.com/business/console) 发行商帐户
  *   为应用程序 [配置 Google Wallet](/zh/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/)（发行商 ID 和 Google Cloud 服务帐户密钥）

## 创建营销活动

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

<img src="/wallet-pass-campaigns-1.webp" alt="Wallet Passes 中的空营销活动列表，其中“创建营销活动”按钮高亮显示"/>

### 设置营销活动详情和平台

*   **平台：** 在页面顶部选择 **Apple Wallet** 或 **Google Wallet**。此选择对营销活动是永久性的。
*   **营销活动：** 输入 **名称** 和可选的 **描述**，供内部参考。两者都不会出现在 Pass 上。
*   **Pass 格式：** 在 **Pass 样式** (Apple) 或 **Pass 类型** (Google) 下，选择您的 Pass 布局：
    *   **Apple Wallet：** 登机牌、优惠券、活动门票、商店卡、通用。请参阅[选择 Pass 样式](/zh/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/#choose-a-pass-style)。
    *   **Google Wallet：** 通用、优惠、会员卡、活动门票、礼品卡、航班、公交。创建后无法更改。请参阅[选择 Pass 类型](/zh/product/messaging-channels/wallet-passes/google-wallet/pass-builder/#choose-a-pass-type)。

<img src="/wallet-pass-campaigns-2.webp" alt="新营销活动创建表单，显示名称和描述字段，以及一个 Pass 样式选择器"/>

### 配置 Pass 设计和品牌

配置 Pass 的标准部分：

*   **基本信息、颜色和条形码：** 设置 Pass 标题、背景和文本颜色以及条形码类型。有关每个部分的详细指导，请参阅[在 Apple Wallet Pass 构建器中设计 Pass](/zh/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/) 或[在 Pass 构建器中设计 Google Wallet Pass](/zh/product/messaging-channels/wallet-passes/google-wallet/pass-builder/)。
*   **Pass 字段：** 添加应出现在卡上的字段（请参阅 [Apple Wallet Pass 字段](/zh/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/#fill-in-pass-fields) 或 [Google Wallet 字段和详细信息](/zh/product/messaging-channels/wallet-passes/google-wallet/pass-builder/#fill-in-pass-fields)）。
*   **过期：** 设置相关日期和过期规则（请参阅 [Apple Wallet 过期](/zh/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/#set-expiration-and-status) 或 [Google Wallet 过期](/zh/product/messaging-channels/wallet-passes/google-wallet/pass-builder/#expiration)）。
*   **位置：** 设置基于位置的相关性（请参阅 [Apple Wallet 位置](/zh/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/#location-based-relevance-optional) 或 [Google Wallet 位置](/zh/product/messaging-channels/wallet-passes/google-wallet/pass-builder/#add-locations-optional)）。

<Aside type="tip">
对于 Google Wallet，使用 **谁可以保存 Pass** 来控制 Pass 是绑定到单个 Google 帐户、单个设备，还是任何有链接的人都可以访问。
</Aside>

### 设置共享和个人字段

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

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

<img src="/wallet-pass-campaigns-3.webp" alt="共享和个人字段配置部分，每个字段旁边都有“个人”开关"/>

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

个人字段的值可以包含标签占位符 `{tag}` 或 `{tag|format|fallback}`（例如 `{Seat}`）。Pushwoosh 在提供 Pass 时会从接收者的 [标签](/zh/product/audience-data-and-segmentation/user-data-tags/tags/) 中填充它。如果接收者没有该标签的值，Pushwoosh 会使用占位符中的备用值，或者在占位符没有备用值时将该字段留空。

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

<Aside type="tip">
Pass 的条形码在 **条形码** 部分进行配置和个性化。有关详细信息，请参阅 [Apple Wallet 条形码](/zh/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/#add-a-barcode) 或 [Google Wallet 条形码](/zh/product/messaging-channels/wallet-passes/google-wallet/pass-builder/#add-a-barcode)。
</Aside>

### 上传营销活动图片

1.  在 **营销活动图片** 部分，点击图片槽旁边的 **选择图片**。
2.  从您的 [媒体库](/zh/product/content/media-store/) 中选择现有图片或拖放新文件进行上传。
3.  对每个可用的图片槽重复此操作：
    *   **Apple Wallet：** 图标、徽标、背景、页脚、条带和缩略图（请参阅 [Apple Wallet 图片](/zh/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/#images)）。
    *   **Google Wallet：** 徽标和主图。

<img src="/wallet-pass-campaigns-4.webp" alt="营销活动图片部分，包含用于图标、徽标和自定义 Pass 图像的上传槽"/>

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

### 预览并创建营销活动

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

<img src="/wallet-pass-campaigns-6.webp" alt="实时 Pass 预览面板，包含“以用户身份预览”字段和渲染的数字 Pass 卡"/>

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

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

<Aside type="note">
创建营销活动仅保存 Pass 设计，并不会向用户发送 Pass。要向您的受众分发 Pass，请继续 [向用户发放 Pass](#issue-passes-to-users)。
</Aside>

## 向用户发放 Pass

### 从营销活动中发放 Pass

1.  在 **Passes** 选项卡上，点击 **发放 Pass**。
2.  输入接收者的 Pushwoosh [用户 ID](/zh/product/pushwoosh-knowledge-hub/users-userids/)。

<img src="/wallet-pass-campaigns-8.webp" alt="发放 Pass 模态对话框，包含 Pushwoosh 用户 ID 字段和“发放 Pass”确认按钮"/>

3.  点击 **发放 Pass** 进行确认。

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

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

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

Pushwoosh 会根据营销活动的当前设计生成 Pass，并将其列在 [**Passes** 选项卡](#passes-tab) 和应用程序的 **所有 Pass** 表中（[Apple Wallet](/zh/product/messaging-channels/wallet-passes/apple-wallet/#view-and-manage-existing-passes) 或 [Google Wallet](/zh/product/messaging-channels/wallet-passes/google-wallet/#view-and-manage-existing-passes)）。

<Aside type="note" title="将 Pass 交付给接收者">
发放 Pass 会在 Pushwoosh 中创建 Pass 记录。要将其交付到用户设备，请分享安装链接：

1.  在 **Passes** 选项卡或 **所有 Pass** 中打开 Pass 的操作菜单。
2.  选择 **复制安装链接** 或 **二维码**。Apple Wallet Pass 还提供 **下载** 已签名的 `.pkpass` 文件。
3.  通过推送、电子邮件、短信或 [Customer Journey](/zh/product/customer-journey/pushwoosh-journey-overview/) 将链接或文件发送给接收者。

有关更多分发 Pass 的方式，请参阅[分享 Apple Wallet Pass](/zh/product/messaging-channels/wallet-passes/apple-wallet/#share-the-pass-with-users-via-pushwoosh-channels) 或[分享 Google Wallet Pass](/zh/product/messaging-channels/wallet-passes/google-wallet/#share-the-pass-with-users-via-pushwoosh-channels)。
</Aside>

### 将现有 Pass 附加到营销活动

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

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

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

<Aside type="note" title="通过 API 附加 Pass">
您也可以使用 `AttachPasses` API 方法以编程方式附加 Pass（每个请求最多 500 个序列号）。

如果无法附加 Pass，API 会返回该序列号的具体原因：
*   该 Pass 已分配给另一个营销活动。
*   Pass 样式与营销活动的格式不匹配。
*   Pass 缺少必需的营销活动字段。
*   序列号不存在或属于不同平台。
</Aside>

## 管理现有营销活动

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

<img src="/wallet-pass-campaigns-11.webp" alt="营销活动标题，包含“设计”、“Passes”和“历史记录”选项卡、一个修订计数器以及设置为“草稿”的状态下拉菜单"/>

### 更改营销活动状态

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

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

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

### 设计选项卡

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

#### 更新设计并将更改推送到 Pass

当您编辑共享字段或替换营销活动图片并点击 **保存更改** 时，Pushwoosh 会显示一个确认对话框，显示将有多少已发放的 Pass 会被更新。

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

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

<Aside type="note">
对基本 Pass 信息（如颜色或条形码类型）的更改，以及在尚未发放任何 Pass 时所做的更改，会立即保存，无需确认对话框。基本信息更改适用于从现在开始发放的 Pass。要将其推送到已发放给用户的 Pass，请编辑一个共享字段或一张图片并确认更新。
</Aside>

#### 在单个 Pass 上覆盖共享字段

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

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

<img src="/wallet-pass-campaigns-13.webp" alt="编辑 Pass 屏幕，显示一个“来自营销活动”字段，其中“使用营销活动值”按钮高亮显示"/>

您可以在 [**Passes** 选项卡](#passes-tab) 的 **覆盖** 列下跟踪哪些 Pass 具有自定义值。

### Passes 选项卡

**Passes** 选项卡列出了由营销活动发放的每个 Pass，包括其序列号、接收者用户 ID、活动覆盖、当前修订版本和最后更新日期。

<img src="/wallet-pass-campaigns-7.webp" alt="Passes 选项卡，显示已发放 Pass 的表格，包含用户 ID、覆盖、修订版本和操作按钮"/>

使用表格过滤器查找特定的 Pass：
*   **有覆盖：** 显示至少有一个自定义编辑字段的 Pass。
*   **落后于修订版本：** 显示尚未收到最新营销活动更新的 Pass。

要发放新 Pass 或附加现有 Pass，请参阅[向用户发放 Pass](#issue-passes-to-users)。

### 历史记录选项卡

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

<img src="/wallet-pass-campaigns-10.webp" alt="历史记录选项卡，显示营销活动修订版本和已更改字段键的按时间顺序列表"/>

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

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

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

## 删除营销活动

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

<img src="/wallet-pass-campaigns-12.webp" alt="营销活动工作区标题，右上角的“删除营销活动”按钮高亮显示"/>

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