对多张活动门票进行分组

使用分组 ID

默认情况下，将多个卡券添加到单个卡券 添加到 Google 钱包链接不会将这些卡券归入 用户的 Google 钱包应用。不过，您可以通过 请确保它们均具有相同的分组 ID。已分组的卡券将一起显示 。选择一组卡券后，每张卡券 可在轮播界面中展示

卡券可归为一组：

• 在初始预配期间
• 使用 update 或 patch 种方式

要向组添加卡券，groupingInfo.groupingId 属性 传递对象。所有通过 即使“groupingId”值被自动归为一组，系统也会自动将其归为一组 它们是单独添加的

以下示例展示了如何将会员卡和优惠组合到一起 吸引用户在下一次购买中同时使用这两种工具。

loyaltyObject = {
  "classId": "ISSUER_ID.GIFT_CARD_CLASS_SUFFIX",
  "id": "ISSUER_ID.GIFT_CARD_OBJECT_SUFFIX",
  "state": "ACTIVE",
  "groupingInfo": {
    # Note the same groupingId value
    "groupingId": "combinedGiftCardAndOfferId",
    "sortIndex": 1
  },
  "barcode": {
    "type": "QR_CODE",
    "value": "QR code"
  },
  "accountId": "Account id",
  "accountName": "Account name",
  "loyaltyPoints": {
  "label": "Points",
    "balance": {
      "int": 800
    }
  }
}

offerObject = {
  "classId": "ISSUER_ID.OFFER_CLASS_SUFFIX",
  "id": "ISSUER_ID.OFFER_OBJECT_SUFFIX",
  "state": "ACTIVE",
  "groupingInfo": {
    # Note the same groupingId value
    "groupingId": "combinedGiftCardAndOfferId",
    "sortIndex": 2
  },
  "barcode": {
      "type": "QR_CODE",
      "value": "QR code",
  },
}

活动门票自动分组

注意 ：卡券的 groupingInfo 属性始终优先于 活动门票使用的自动分组逻辑。

有时，活动门票需要成套使用，而不是单独使用。常见 例如，将多个家庭成员的门票分组。

活动门票具有额外的逻辑，可根据 以下属性：

• EventClass.eventId
• EventClass.eventName
• EventClass.dateTime.start
• EventObject.id 的发卡机构 ID 部分

。

注意： 如果设置了 EventClass.eventId，则它的优先级较高，才能确定 哪些对象被视为同组。

与“EventClass.eventId”分组

当活动门票对象具有相同的值时，系统会自动将其分组 ：

• EventClass.eventId
• EventObject.id 的发卡机构 ID 部分

当活动门票对象符合此条件时，即使 EventClass.eventName 和 EventClass.dateTime.start 不同。

在不使用 EventClass.eventId 的情况下分组

如果 EventClass.eventId 未设置，只要 以下属性相同。

• EventClass.eventName
• EventClass.dateTime.start
• EventObject.id 的发卡机构 ID 部分

。

注意： EventClass.dateTime.start 是一个可选属性。如果未设置，则 只有 EventClass.eventName 和 EventObject.id 的“发卡机构 ID”部分 用于确定分组。