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 đườ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, các thẻ và vé có thể được nhóm lại với nhau bằng cách đảm bảo rằng tất cả chúng đều có cùng mã nhóm. Các 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ẽ xuất hiện trên một băng chuyền.

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

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

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

Ví dụ sau đây cho thấy một thẻ khách hàng thân thiết và ưu đãi đượ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",
  },
}

Nhóm tự động vé sự kiện

Đôi khi vé xem sự kiện được sử dụng trong một nhóm thay vì từng vé riêng lẻ. Một trường hợp phổ biến cho trường hợp này là việc nhóm các 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

Đang nhóm bằng EventClass.eventId

Các đối tượng vé xem sự kiện tự động được nhóm lại khi 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é sự kiện đáp ứng tiêu chí này, các đối tượng đó sẽ được nhóm 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 thuộc tính này sẽ tự động được nhóm lại nếu các thuộc tính sau giống nhau.

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