使用分組 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 部分