OneTrace.pro 帮助中心

Wallet 卡券

Apple Wallet 和 Google Wallet 中的会员卡始终放在顾客的手机里:卡上显示积分余额、等级、当前有效的优惠码以及结账用的条形码。OneTrace.pro 会自动更新会员卡:下单、获得积分或发放优惠码后,顾客会看到新的数值,Apple Wallet 还会显示通知。会员卡也是一个消息渠道:简短的消息以通知形式送达,并保留在卡片背面。

Wallet 卡券从“增长版”套餐起提供(套餐)。在菜单中打开用户互动 → Wallet 卡券。“经理”“观察者”及以上角色可以查看统计和卡券外观,有权管理集成的角色(“管理员”和“所有者”)可以修改外观。

连接

会员卡由您的店铺以自己的名义、使用自己的 Apple 和 Google 密钥发放。连接其中一个或两个平台:

  1. 打开集成,点击添加集成 → Wallet 卡券(集成)。
  2. Apple Wallet:
    • 在 Apple Developer 中打开 Certificates, Identifiers & Profiles → Identifiers,注册一个 Pass Type ID,例如 pass.com.example.loyalty;
    • 为其创建 Pass Type ID Certificate 证书,安装到 Mac 上,然后在“钥匙串访问”中将证书连同私钥导出为 .p12 文件;
    • 在 Pass Type ID 证书字段中粘贴 base64 编码的 .p12 内容,或 PEM 格式的证书和私钥,在密钥密码字段中填写导出密码。Apple WWDR 中间证书由 OneTrace.pro 自动添加。
  3. Google Wallet:
    • 在 Google Pay & Wallet Console 中创建发卡方,并复制 Issuer ID;
    • 在 Google Cloud 中启用 Google Wallet API,创建服务账号及其 JSON 密钥;
    • 在 Google Pay & Wallet Console 中将服务账号的邮箱添加为发卡方用户;
    • 将 Issuer ID 和 JSON 密钥粘贴到集成中。
  4. 点击保存和测试:对于 Apple,测试会显示 Pass Type ID、团队和证书有效期;对于 Google,会显示卡券类别已创建。

在 Google 批准您的发卡方发布之前,只有在控制台中添加的测试用户才能保存 Google 卡券。Apple 证书有效期为一年:请在到期前签发新证书并在集成中替换,否则会员卡将停止更新。

卡券外观

打开 Wallet 卡券,或在集成中点击卡券设计。如果有多个集成,请在顶部选择所需的集成。

字段 作用
卡面名称 发卡的商店。留空则使用集成名称
背景、文字、标签 卡片颜色。Google Wallet 只使用背景色,文字颜色由其自动选择
徽标 Apple:位于左上角,替代名称显示。请上传不小于 480×150 像素的图片
横幅 Apple:徽标下方、积分背后的宽幅图片;Google:卡券顶部。约 1125×369 像素
图标 不小于 660×660 像素的正方形:用作 Apple 通知图标和 Google Wallet 中的计划徽标
条形码 二维码、Code 128、PDF417 或 Aztec,取决于收银台扫码器能识别哪种。条形码中是卡号
自定义字段 最多 4 个字段:卡面标签和档案属性,例如“城市”— city。档案没有该属性时,其卡券上也不显示此字段

图片从媒体库中选择,为此需要有消息模板的访问权限。卡券正在使用的图片无法从媒体库中删除。右侧是使用示例数据的预览;通过切换可以查看卡券在 Apple Wallet 和 Google Wallet 中的效果。预览仅为大致效果:实际外观取决于手机。

点击保存。顾客已安装的卡券将在几分钟内更新。

带 Apple Wallet 预览的卡券外观设置

Google Wallet 中的卡券预览

卡上显示什么

  • 积分和等级:来自顾客在会员积分计划中的账户。
  • 姓名:来自 first_name 和 last_name 属性。
  • 优惠码:发放给顾客且尚未使用的最近一个专属优惠码。
  • 卡号和条形码。如果档案已有会员卡号(标识符 loyalty_card,例如来自线下小票),Wallet 卡券使用同一个卡号;否则 OneTrace.pro 会生成一个新的 13 位卡号。
  • 外观中的自定义字段和最近一条消息:显示在卡片背面。

当积分、等级、姓名、自定义字段或优惠码发生变化时,卡券会更新。Apple Wallet 会就新的余额、等级和优惠码显示通知。如果两个档案合并为一个,卡券会转移到保留的档案。

卡券通过个人专属链接发放:这是您品牌域名上的一个页面,带有添加到 Apple 钱包和添加到 Google 钱包按钮。打开页面所用平台的按钮会显示在最前面。链接有效期为 90 天,页面使用档案的语言。

  • 在邮件和其他消息中:使用变量 {{ wallet_url }}(模板),例如在会员积分计划的欢迎旅程中。
  • 在订阅偏好中心中:钱包中的会员卡链接。
  • 在店铺的个人中心中:使用具有“读取档案”权限的私密密钥调用 GET /api/v1/profiles/{type}/{value}/wallet(API 密钥),返回链接及其有效期、平台和档案的卡券。

当项目中有已启用、带 Apple 证书或 Google 密钥的“Wallet 卡券”集成时,才会生成该链接。

向卡券发送消息

Wallet 卡券渠道与其他渠道一样,可用于模板、旅程和群发,支持 A/B 变体和投递状态。模板中有标题(卡片背面字段的标签)、文本和可选的链接,均可使用变量。

  • Apple Wallet 以通知形式显示文本,并将其保留在卡片背面,直到下一条消息。手机获取更新后的卡券时,消息即视为已送达。
  • Google Wallet 会将消息添加到卡券并发送通知。Google 每张卡券每天最多显示 3 条通知。

只有安装了该集成卡券的顾客才能收到消息。如果没有卡券,发送会以“该档案没有已安装的 Wallet 卡券”错误结束。请使用条件或分群,只向持有卡券的顾客发送 Wallet 消息。

统计

卡券统计模块按平台显示:

  • 已发放:通过链接创建了多少张卡券;
  • 已安装:目前顾客的 Wallet 中有多少张卡券;
  • 已删除:有多少顾客移除了卡券。

下方图表按项目时区显示 30 天内每天的安装数和删除数。

Wallet 卡券统计

在档案卡片中,Wallet 卡券模块显示顾客的卡券:平台、卡号和日期,即卡券的安装、删除时间,或已发放但未安装的时间。