Nhóm nhiều vé xem sự kiện

Sử dụng mã nhóm

Theo mặc định, việc thêm nhiều thẻ và vé vào một tài khoản Đường liên kết Thêm vào Google Wallet sẽ không nhóm các thẻ và vé đó trong ứng dụng Google Wallet của người dùng. Tuy nhiên, bạn có thể nhóm các thẻ và vé lại với nhau bằng cách tạo đảm bảo tất cả đều có cùng một mã nhóm. Thẻ và vé được nhóm sẽ xuất hiện cùng nhau trong ứng dụng Google Wallet. Khi bạn chọn một nhóm thẻ và vé, mỗi thẻ và vé sẽ sẽ xuất hiện trên băng chuyền.

Bạn có thể nhóm các thẻ và vé với nhau:

• Trong quá trình cấp phép ban đầu
• Bằng cách sử dụng update hoặc patch phương thức

Để thêm thẻ và vé vào một nhóm, thuộc tính groupingInfo.groupingId của bạn phải đặt đối tượng truyền. Tất cả đối tượng truyền có cùng Giá trị groupingId sẽ được tự động nhóm lại với nhau, ngay cả khi chúng được thêm riêng biệt.

Ví dụ sau đây cho thấy một thẻ khách hàng thân thiết và mặt hàng được nhóm lại với nhau để thu hút người dùng sử dụng cả hai trong lần mua hàng tiếp theo.

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",
  },
}

Tự động nhóm vé xem sự kiện

Lưu ý: Thuộc tính groupingInfo của thẻ/vé sẽ luôn được ưu tiên hơn thuộc tính logic nhóm tự động mà vé xem sự kiện sử dụng.

Đôi khi, vé xem sự kiện được dùng theo nhóm thay vì từng vé. Điểm chung trường hợp cho trường hợp này là nhóm vé cho nhiều thành viên gia đình.

Vé xem sự kiện có logic bổ sung cho phép nhóm tự động dựa trên các thuộc tính sau:

• EventClass.eventId
• EventClass.eventName
• EventClass.dateTime.start
• Phần Mã nhà phát hành của EventObject.id

Lưu ý: Nếu bạn đặt EventClass.eventId, nó sẽ được ưu tiên để xác định đối tượng nào được coi là thuộc một nhóm.

Nhóm bằng EventClass.eventId

Các đối tượng vé xem sự kiện được tự động nhóm lại khi chúng có cùng giá trị cho các thuộc tính sau:

• EventClass.eventId
• Phần Mã nhà phát hành của EventObject.id

Khi các đối tượng vé xem sự kiện đáp ứng tiêu chí này, chúng sẽ được nhóm lại ngay cả khi EventClass.eventName và EventClass.dateTime.start khác nhau.

Nhóm mà không có EventClass.eventId

Nếu bạn không đặt EventClass.eventId, các mục hàng này sẽ tự động được nhóm nếu các thuộc tính sau đều giống nhau.

• EventClass.eventName
• EventClass.dateTime.start
• Phần Mã nhà phát hành của EventObject.id

Lưu ý: EventClass.dateTime.start là thuộc tính không bắt buộc. Nếu bạn không đặt chính sách này, thì chỉ EventClass.eventName và phần Mã nhà phát hành của EventObject.id là dùng để xác định nhóm.