增值机会

背景

现在，您可以更新对象和类，以添加增值型业务机会模块。模块将显示在详情页面上，并且可以链接到发卡机构的内容。本文档详细介绍了使用 Google Wallet API 启用和使用模块所需的关键步骤。

地图项示例

价值机会模块单个示例 价值机会模块列表示例
统一数据视图 列表视图

以下指南假定您熟悉 Google 钱包的基本概念，并且已完成建议的前提条件。 如有任何问题或反馈，请发送给您的 Google 钱包联系人。

集成步骤

如需添加新模块，您需要更新对象和/或类，以添加 ValueAddedModuleData。 ValueAddedModuleData 包含以下字段：

[必需] LocalizedString 标题

模块上显示的标题。字符数限制为 60 个字符，超过此数的字符串将被截断。 价值机会标题示例

LocalizedString 正文

模块上显示的正文。字符数限制为 50 个，超过此数的字符串将被截断。
价值机会正文示例

图片

模块上显示的图片。建议的图片宽高比为 1:1，系统会调整图片大小以适应此比例。
价值机会图片示例

[必需] 字符串 URI

点击模块后会跳转到的 URI。此链接可以是网页链接，也可以是深层链接。

ModuleViewConstraints viewConstraints

必须满足所有限制条件才能显示模块。ModuleViewConstraints 包含以下字段：

TimeInterval displayInterval

向用户显示模块的时间段。可以同时定义 `startTime` 和 `endTime`。除非设置了 `startTime`，否则模块会在插入后立即显示。如果未设置 `endTime`，模块将无限期显示。

int32 sortIndex

用于对模块进行排序的索引。排序索引低的模块显示在排序索引高的模块前面。如果未指定，系统会假定排序索引为 INT_MAX。如果两个模块的索引相同，则排序行为未定义。

ValueAddedModuleData 示例：

  {
    "valueAddedModuleData": [
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off merch"
          }
        },
        "body": {
          "defaultValue": {
            "language": "en-US",
            "value": "Shirts, caps, mugs, and more"
          }
        },
        "image": {
          "sourceUri": {
            "uri": "http://www.images.google.com/opportunity"
          }
        },
        "uri": "http://www.google.com/opportunity",
        "viewConstraints": {
          "displayInterval": {
            "start": {
              "date": "2024-08-01T18:30:00"
            },
            "end": {
              "date": "2025-08-01T18:30:00"
            }
          }
        },
        "sortIndex": 0
      },
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off concessions"
          }
        },
        "uri": "http://www.google.com/new_opportunity"
      }
    ]
  }

预期行为

成功更新对象和/或类后，您现在会在相应传递中看到模块。如果您只添加了一个模块，则会在卡券正面看到该模块。

增值型业务机会模块指南

您可以通过模块来实现额外操作来增强用户的卡券体验。 在创建和管理模块时，应考虑以下事项：

  • 您应使用适当的语言定义模块，以表明模块是可行的，从而帮助用户了解这些模块是可点击的。
  • 模块应定义与特定模块相关的适当图像。
  • 您可以控制这些模块，并应根据重要性和相关性主动管理模块的优先级。
  • 您应仅向用户显示处于活跃状态的模块。您可以通过在模块上设置 displayInterval 来控制此行为，也可以主动在类或对象中添加或移除它。

异常处理

短信 原因
ValueAddedModuleData 必须包含标头。 ValueAddedModuleData 没有标头。
ValueAddedModuleData 必须包含非空 URI。 ValueAddedModuleData 没有非空 URI。
每门课程最多可包含 10 个增值模块。 需要减少类中的增值模块。
每个对象最多只能包含 10 个增值模块。 需要减少对象的增值模块。