Nhóm nhiều Thẻ lên máy bay

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 thẻ lên máy bay

Đôi khi, thẻ lên máy bay được sử dụng theo nhóm chứ không phải từng người. Một trường hợp phổ biến cho trường hợp này là nhóm các vé của các chuyến bay có quá trình quá cảnh hoặc nhiều điểm dừng.

Thẻ lên máy bay có thêm logic bổ sung giúp tự động nhóm các thẻ và vé lại với nhau nếu chúng có cùng giá trị cho các thuộc tính sau:

  • FlightClass.flightHeader.carrier.carrierIataCode
  • FlightClass.flightHeader.flightNumber
  • FlightClass.localScheduledDepartureDateTime
  • FlightObject.reservationInfo.confirmationCode
  • Phần Mã nhà phát hành của FlightObject.id

Nếu bất kỳ thuộc tính nào ở trên khác nhau đối với 2 Thẻ lên máy bay, thì chúng sẽ không được nhóm lại (trừ phi bạn làm như vậy bằng cách sử dụng groupingInfo). Như bạn có thể thấy, cả thuộc tính lớp và đối tượng đều ảnh hưởng đến việc nhóm tự động. Điều này cho phép nhóm các thẻ lên máy bay khác nhau với nhau (chẳng hạn như khi các chuyến bay khác nhau trong cùng một chuyến đi có các hãng vận hành khác nhau).