发放钱包凭证

发放钱包凭证 (Issue Wallet Pass) 元素会从 钱包凭证活动 中为旅行者创建 Apple Wallet 或 Google Wallet 凭证。运行后，您可以将安装或保存链接插入到同一 Journey 的后续消息中。

注意

此元素仅发放凭证，不会将其发送给用户。请在其后添加 发送推送 或 发送邮件 元素以发送安装链接。请参阅下文的将凭证发送给旅行者。

使用场景示例

办理登机手续后的登机牌

旅行者办理登机手续后，立即发放 Apple 或 Google Wallet 登机牌。根据值机事件个性化座位和登机口信息，然后在出发前通过推送发送安装链接。

• 触发器： CheckInCompleted
• 个人字段： 将 Seat 和 Gate 映射到匹配的事件属性
• 发送： 发送推送，包含 apple_install_link 或 google_save_link

注册时的忠诚度卡

旅行者首次加入奖励计划时，发放一张忠诚度卡。使用他们的初始积分余额进行个性化设置。

• 触发器： LoyaltySignup
• 个人字段： 将 Points 映射到事件的 points 属性
• 发送： 之后立即发送邮件，在欢迎消息中包含保存链接

购买后的活动门票

旅行者完成购票后，发放一张门票。根据订单个性化座位或排号。

• 触发器： TicketPurchased
• 个人字段： 将 Seat 和 Row 映射到订单属性
• 发送： 确认邮件中包含 apple_install_link，以便旅行者可以一键添加门票

先决条件

在添加此元素之前：

• 钱包凭证活动： 为应用程序创建至少一个 钱包凭证活动。发放钱包凭证只能从现有活动中发放凭证，不能设计凭证。
• Apple Wallet： 连接 iOS 平台 并为应用程序完成 Apple Wallet 凭证设置。另请参阅 Apple Wallet 凭证入门。
• Google Wallet： 为应用程序配置 适用于 Android 的 Google Wallet。另请参阅 Google Wallet 凭证入门。

两个平台的完整活动先决条件：钱包凭证活动先决条件。

添加元素

1. 将发放钱包凭证元素拖到画布上，放在应触发凭证发放的步骤之后。
2. 双击该元素以打开其设置。
3. 在 Step Name 中输入一个易于识别的名称，例如 Loyalty card。稍后在将凭证链接插入“发送推送”或“发送邮件”元素时，您将使用此名称。
4. 在 Apple Wallet campaign 和 Google Wallet campaign 中，为任一平台或两个平台选择一个活动。每个下拉菜单接受一个活动。将下拉菜单留空以跳过该平台。

提示

选择两个平台可以让同一个 Journey 步骤同时覆盖 iPhone 和 Android 旅行者。每个平台都会为同一旅行者独立地发放（或重用，请参阅下文的重复进入和丢弃条件）自己的凭证。

两个下拉菜单仅列出此应用程序的匹配平台的活动，并已排除已归档的活动。

注意

草稿 (Draft) 状态的活动仍会列出，并且会像活动 (Active) 状态的活动一样发放凭证，因此将活动从草稿状态切换出来不是此处的先决条件。

填写个人字段

在 Personal fields on the pass 下，为出现的每个字段设置一个值。

在您选择上面的活动之前，该列表为空。然后它会显示该活动的 个人字段，与您在活动的发放凭证对话框中填写的字段相同。如果您切换活动，列表会更新以匹配。

对于每个字段，打开值下拉菜单并选择以下之一：

• 静态值 (Static value)： 为到达此元素的每个旅行者键入一个值。例如，在 OFFER 字段中键入 SUMMER2026，这样此元素发放的每个凭证都带有相同的促销代码。

• 来自旅行者在 Journey 路径中较早前的一个事件。然后选择一个属性 (Attribute) 来从中提取字段的值。例如，选择进入事件及其 offer_code 属性，以使用每个旅行者自己的值来填充 OFFER 字段，而不是为所有人使用一个值。当此元素运行时，Pushwoosh 会从旅行者自己的事件数据中读取该属性，因此每个旅行者的凭证都会获得自己的值。

注意

这里没有列出两种字段，因为它们不需要您输入：

• 仅写为 {Seat} 的字段会自动为每个旅行者填充。
• 活动的共享字段在每个凭证上都带有相同的值。您在活动本身中一次性设置该值。

为两个平台都选择了活动后，列表会显示来自两个活动的字段。只有一个活动拥有的字段仅为该平台的凭证填充。

注意

如果源事件从未为某个旅行者触发，或者属性为空，则凭证将使用活动自己为该字段设置的值，该值在设置共享和个人字段中设置。旅行者不会被丢弃。

完成后，单击 Apply 保存元素设置。

重复进入和丢弃条件

如果同一旅行者再次到达此元素（例如，在 Journey 中循环返回后），Pushwoosh 会返回已发放给他们的凭证，而不是创建一个新的。每个旅行者每个活动最多持有一个凭证。

在两种情况下，发放钱包凭证会丢弃旅行者，且不会自动重试：

• 旅行者完全没有 User ID，甚至没有普通 SDK 会话自动设置的默认设备 HWID。当旅行者在没有 User ID 的情况下进入 Journey 时会发生这种情况，例如通过基于 API 的进入或没有 User ID 字段的事件负载。
• 为已配置的活动发放凭证失败，例如，在您添加元素后该活动被删除或归档。当两个平台都配置时，会首先尝试 Apple。如果失败，旅行者会在尝试 Google 之前被丢弃，因此永远不会出现部分结果。

请参阅无 User ID 和凭证发放失败以了解应检查的内容。

将凭证发送给旅行者

当您个性化后续的推送或电子邮件时，您可以通过您给定的步骤名称 (Step Name) 从此发放钱包凭证步骤中提取值。您可以插入以下属性：

属性	平台	包含
apple_install_link	Apple Wallet	安装凭证的 URL
google_save_link	Google Wallet	保存凭证的 URL

只有您在元素上配置的平台的属性才可用。

警告

该元素仅为您配置的平台发放凭证，而不是根据旅行者的实际设备。在另一个平台上的旅行者仍会进入默认输出，只是带有一个他们无法使用的链接。如果您的受众同时使用两个平台，请同时配置 Apple Wallet 和 Google Wallet。

1. 在发放钱包凭证之后添加一个 发送推送 或 发送邮件 元素。
2. 在消息正文中，键入带竖线的安装链接占位符，例如 {apple_install_link|regular|}。不要使用普通的 {apple_install_link}。有关完整语法，请参阅Journey 中的动态内容或 Liquid 模板。
3. 打开使用事件属性个性化消息 (Personalise message with event attributes)。
4. 在表格中，选中占位符旁边的覆盖占位符 (Overwrite placeholder) 复选框。在此之前，其源事件 (Source event) 和动态属性 (Dynamic attribute) 下拉菜单将保持禁用状态。
5. 在源事件 (Source event) 中，通过您给定的步骤名称 (Step Name) 选择您的发放钱包凭证步骤，例如 Loyalty card。
6. 在动态属性 (Dynamic attribute) 中，选择 apple_install_link 或 google_save_link 以匹配您使用的占位符。

注意

对于发送推送，在编辑消息后重新选择预设，以便映射能够识别新的占位符。对于发送邮件，带竖线的占位符在主题行中也有效，而不仅仅是在消息正文中。

每个发放的凭证还有一个序列号（在点的上下文中为 apple_serial_number 或 google_serial_number）。使用 数据到应用 或 Webhook 元素将其传递给您自己的系统，例如记录在 CRM 或支持工具中。要通过序列号在 Pushwoosh 中找到匹配的凭证，请使用钱包凭证活动的凭证选项卡或 AttachPasses API，当您需要将独立凭证附加到活动时。

警告

该元素的面板显示进入和丢弃情况，包括旅行者被丢弃的原因：无 User ID 或凭证发放失败。要了解实际发放了多少凭证，请检查下游的“发送推送”或“发送邮件”元素的统计信息。

场景示例：咖啡店忠诚度优惠

一家咖啡店希望为每位新的忠诚度会员提供一张折扣凭证，他们可以将其添加到手机钱包中。

1. 创建事件 CoffeeClubJoined 并确保它包含一个欢迎优惠的属性，例如 offer_code。了解有关创建事件的更多信息
2. 将此事件设置为 Journey 的触发器，以便每个新会员在加入时立即进入。

3. 在触发器后添加发放钱包凭证。
4. 将其命名为 Loyalty card。
5. 为 Apple Wallet campaign（如果支持 Android，也为 Google Wallet campaign）选择忠诚度活动，例如 Coffee discount。
6. 在 Personal fields on the pass 下，将 OFFER 设置为触发器进入事件。
7. 选择 offer_code 作为属性 (Attribute)。

8. 在发放钱包凭证之后立即添加一个发送邮件元素。
9. 使用 apple_install_link（或 google_save_link）对其进行个性化，以便欢迎邮件中包含一个一键添加凭证的链接。

当 CoffeeClubJoined 触发时，旅行者进入 Journey，发放钱包凭证会使用该事件的 offer_code 发放他们的凭证，然后发送邮件会发送包含添加凭证链接的欢迎消息。