要创建 Google Wallet 卡券，您需要在 Google Pay & Wallet Console 中拥有一个发卡方（issuer）账号，以及一个能生成卡券并返回 Add to Google Wallet 链接的工具。在 Pushwoosh 中，只需用 Issuer ID 接入一次 issuer，无需 JSON 密钥。此后，运营和市场人员无需写代码即可设计和更新卡券。
对出海 App 来说，这意味着面向欧美、东南亚、中东等多个海外市场的 Android 用户，可以共用同一套 issuer 配置、同一个构建器和同一套 API。
文中截图来自 Pushwoosh 的 Google Wallet 卡券构建器。它把每张卡券发放在与推送、邮件和用户旅程相同的 User ID 上。
开始前需要准备什么
Google Wallet 卡券由发卡方账号发放，而不是由 App 发放。每个应用只需配置一次。
-
发卡方账号
在 Google Pay & Wallet Console 中完成 Google Wallet API 的开通流程，您会获得一个数字格式的 Issuer ID。
-
为卡券工具开通权限
在控制台中打开 Users，以 Developer 权限级别邀请该工具的服务账号。Pushwoosh 的服务账号是
wallet-issuer@pushwoosh-wallet.iam.gserviceaccount.com。跳过这一步，任何工具都无法替您创建或更新卡券。 -
共同用户
issuer 的 Users 列表中至少要有 1 人同时是您的 Pushwoosh 账号用户，且使用相同的邮箱。
-
生产环境权限
新的 issuer 默认处于演示模式。上线前请在控制台中申请生产环境权限。
然后在 Pushwoosh 中进入 Settings → Configure platforms，在 Android 下打开 Google Wallet 设置，填入 Issuer ID 并点击 Apply。如果您已经在用自己的服务账号发放卡券，也可以在这里改为上传它的 JSON 密钥。完成后，该应用的构建器即可使用。完整步骤见 Google Wallet 配置文档。
1 条配置经验：尽早申请生产环境权限。这一步要等 Google 审核，而不是等您的团队。如果计划在黑五或双十一的海外大促期间上线，请提前几周提交申请。
在 7 种卡券类型中选择 1 种
Google Wallet 有 7 种卡券类型。请谨慎选择，因为类型在创建卡券时就会锁定。会员卡之后无法改成优惠券。
| 卡券类型 | 典型用途 | Google 更新提醒 |
|---|---|---|
| Generic | 会员资格、预订，以及不属于其他类型的一切 | 无 |
| Offer | 优惠券和促销 | 无 |
| Loyalty | 积分、集章、会员等级 | 有 |
| Event ticket | 演唱会、体育赛事、会议 | 有 |
| Gift card | 储值余额 | 无 |
| Flight | 登机牌 | 有 |
| Transit | 铁路、巴士和渡轮票 | 无 |
最后一列比看上去更重要。只有 Loyalty、Event ticket 和 Flight 卡券在字段变更时会收到 Google 自己的提醒。其余 4 种会静默刷新，除非您通过 API 或卡券活动为这次更新附加自定义通知。
在可视化构建器中设计卡券
在 Control Panel 中进入 Campaigns → Wallet Passes，打开 All passes 标签页，选择 Google Wallet，然后点击 Create pass。
-
卡券类型
在 Pass type 中从 7 种类型里选择 1 种。
-
品牌元素
添加 logo、主图和配色。Loyalty 和 Transit 卡券必须有 logo。
-
字段
填写文案。您可以插入用户标签，例如姓名或积分余额。Pushwoosh 在创建卡券时填入这些值，并在每次更新时刷新。面向多语言市场时，可以按目标市场分别准备文案。
-
条形码
可选 QR、PDF417、Aztec、Code128 或 EAN-13。以您门店扫码设备能识别的格式为准。
-
地点
如果卡券与门店或场馆相关，最多可添加 10 个地点。半径由 Google 设定。
-
谁可以保存
设置允许哪些人把卡券添加到 Google Wallet。卡券创建后无法更改。
每张卡券都归属于 1 个 User ID。正因如此，您才能在之后更新它，并在用户分群中定位持卡人。所有字段说明见 Google Wallet 卡券构建器文档。
获取保存链接并添加按钮
卡券效果满意后，点击 Generate。Pushwoosh 会在 Google Wallet 中创建卡券对象，并给您一个保存链接。它是以 pay.google.com/gp/v/save/ 开头的普通 URL。用户打开后，会被询问是否保存卡券。
把链接放在官方的 Add to Google Wallet 按钮后面，用于邮件、短信、应用内消息或网页，也可以生成二维码用于线下物料。Google 对这个按钮的样式要求严格，请使用官方素材，并按目标市场选择对应语言版本。
用户保存后更新卡券
已保存的卡券不是静态文件。在构建器中或通过 Google Wallet API 修改后，Google 会把变更同步到用户保存过这张卡券的每台设备上。
您还可以管理卡券状态。将卡券设为失效，它会移到用户的已过期卡券中。需要时可以重新激活。删除卡券后，它会在 Google 中失效，并从 Pushwoosh 中移除。
上线前需要了解的限制
通知只能与卡券本身相关。 Google 允许发送与卡券相关的通知，用它推送促销则违反其规范。Google 还把通知上限设为每张卡券 24 小时内 3 条；对于活动门票和航班，只有在开始时间不足 3 小时时才会触发更新提醒。
您无法把卡券直接推送到用户手机上。 用户需要先通过链接、二维码、邮件或短信保存卡券，之后更新才能送达。
国家和地区可用性。 Google Wallet 卡券并非在所有国家都可用。出海 App 往往同时覆盖多个市场，规划上线前请逐一确认目标市场是否支持。
Apple Wallet 需要单独的卡券。 Apple 和 Google 使用不同的卡券格式（两种钱包对比），因此请为 iPhone 用户制作同一张卡券的 Apple Wallet 版本。
常见错误
选错类型代价最高。很多团队因为灵活而选择 Generic，后来才发现 Google 从不为它发送自己的更新提醒。如果提醒很重要，请从 Loyalty、Event ticket 或 Flight 开始。
第二个错误是在 issuer 仍处于演示模式时上线。生产环境权限取决于 Google，而不是您的团队。
第三个错误是收银设备读不了的条形码。在印刷任何二维码之前，先用真实扫码设备扫描一张真实卡券。
借助 Pushwoosh 更快上线 Google Wallet 卡券
Pushwoosh 只需与您的 Google Wallet issuer 连接一次。此后，团队可以在可视化构建器中或通过 API 设计、发放和更新卡券，每张卡券都与推送、应用内消息、邮件和短信归属于同一个用户档案。Pushwoosh 已获得 ISO 27001:2022 和 SOC 2 Type 2 认证，符合 GDPR 要求，并在欧盟和美国设有数据中心。
上线 Google Wallet 的关键其实不在卡券文件本身，而在于为每位保存卡券的用户持续保持卡面信息最新。
