Utiliser un identifiant de regroupement
Par défaut, l'ajout de plusieurs cartes via un même lien Ajouter à Google Wallet ne permet pas de regrouper ces cartes dans l'application Google Wallet de l'utilisateur. Toutefois, il est possible de regrouper les cartes en veillant à ce qu'elles partagent un même identifiant de regroupement. Les cartes regroupées apparaissent ensemble dans l'application Google Wallet. Lorsque l'utilisateur sélectionne un groupe de cartes, chacune des cartes s'affiche dans un carrousel.
Les cartes peuvent être regroupées :
Pour pouvoir ajouter une carte à un groupe, la propriété groupingInfo.groupingId
de la carte doit être définie. Tous les objets Cartes possédant la même valeur groupingId
sont automatiquement regroupés, même s'ils ont été ajoutés séparément.
L'exemple suivant présente une offre et une carte de fidélité regroupées afin d'inciter l'utilisateur à s'en servir ensemble lors de son prochain achat.
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", }, }
Regroupement automatique de billets pour un événement
Les billets pour un événement sont parfois utilisés au sein d'un groupe plutôt qu'individuellement. L'un des scénarios courants est le regroupement des billets de plusieurs membres de la famille.
Les billets pour un événement appliquent une logique supplémentaire qui permet de les regrouper automatiquement sur la base des propriétés suivantes :
EventClass.eventId
EventClass.eventName
EventClass.dateTime.start
- Section d'ID de l'émetteur de
EventObject.id
Regroupement avec EventClass.eventId
Les objets de billet pour un événement sont regroupés automatiquement lorsqu'ils présentent la même valeur pour les propriétés suivantes :
EventClass.eventId
- Section d'ID de l'émetteur de
EventObject.id
Lorsque les objets de billet pour un événement répondent à ces critères, ils sont regroupés même si les valeurs EventClass.eventName
et EventClass.dateTime.start
sont différentes.
Regroupement sans EventClass.eventId
Si la valeur EventClass.eventId
n'est pas définie, les billets sont regroupés automatiquement si les propriétés suivantes sont identiques.
EventClass.eventName
EventClass.dateTime.start
- Section d'ID de l'émetteur de
EventObject.id