그룹화 ID 사용
기본적으로 Google 월렛에 추가 링크 하나에 패스 여러 개를 추가해도 사용자의 Google 월렛 앱에서 해당 패스가 그룹화되지 않습니다. 하지만 패스가 모두 동일한 그룹화 ID를 갖도록 하여 여러 패스를 그룹화할 수 있습니다. 그룹화된 패스는 Google 월렛 앱에 함께 표시됩니다. 패스 그룹을 선택하면 각 패스가 캐러셀에 표시됩니다.
다음과 같이 패스를 그룹화할 수 있습니다.
그룹에 패스를 추가하려면 패스 객체의 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 부분