AI-generated Key Takeaways
-
Adding multiple passes to Google Wallet with the same
groupingIdwill group them together, enhancing user experience. -
Grouped passes are displayed as a carousel when selected in the Google Wallet app.
-
Passes can be grouped during initial creation or later using the
updateorpatchmethods. -
The
groupingInfo.groupingIdproperty is essential for assigning passes to a specific group. -
Grouping passes, such as loyalty cards and offers, can incentivize users to utilize them together.
Use a grouping ID
By default, adding multiple passes to a single Add to Google Walletlink will not group those passes in the user's Google Wallet app. However, passes can be grouped together by making sure they all have the same grouping ID. Grouped passes will appear together in the Google Wallet app. When a group of passes is selected, each pass will be shown on a carousel.
Passes can be grouped together:
To add a pass to a group, the groupingInfo.groupingId
property of
the pass object must be set. All pass objects with the same groupingId
value will be automatically grouped together, even if
they were added separately.
The following example shows a loyalty card and offer being grouped together to entice the user to make use of both in their next purchase.
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" , }, }
