여러 이벤트 티켓 그룹화

그룹화 ID 사용

기본적으로 Google 월렛에 추가 링크 하나에 패스 여러 개를 추가해도 사용자의 Google 월렛 앱에서 해당 패스가 그룹화되지 않습니다. 하지만 패스가 모두 동일한 그룹화 ID를 갖도록 하여 여러 패스를 그룹화할 수 있습니다. 그룹화된 패스는 Google 월렛 앱에 함께 표시됩니다. 패스 그룹을 선택하면 각 패스가 캐러셀에 표시됩니다.

다음과 같이 패스를 그룹화할 수 있습니다.

  • 초기 프로비저닝 중
  • 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",
  },
}

이벤트 티켓 자동 그룹화

이벤트 티켓을 개별적으로 사용하지 않고 그룹으로 사용하는 경우도 있습니다. 일반적인 시나리오는 여러 가족 구성원을 위한 티켓을 그룹화하는 것입니다.

이벤트 티켓에는 다음 속성을 기반으로 자동 그룹화를 사용 설정하는 추가 로직이 있습니다.

  • EventClass.eventId
  • EventClass.eventName
  • EventClass.dateTime.start
  • EventObject.id의 발급기관 ID 부분

EventClass.eventId로 그룹화

이벤트 티켓 객체는 다음 속성의 값이 같으면 자동으로 그룹화됩니다.

  • EventClass.eventId
  • EventObject.id의 발급기관 ID 부분

이벤트 티켓 객체가 이 기준을 충족하면 EventClass.eventName와 EventClass.dateTime.start가 다른 경우에도 그룹화됩니다.

EventClass.eventId 없이 그룹화

EventClass.eventId가 설정되지 않은 경우 다음 속성이 동일하면 자동으로 그룹화됩니다.

  • EventClass.eventName
  • EventClass.dateTime.start
  • EventObject.id의 발급기관 ID 부분