Regrouper plusieurs billets pour des événements

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 :

• lors du provisionnement initial ;
• à l'aide des méthodes update ou patch.

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

Remarque : La propriété groupingInfo d'une carte prévaut toujours sur la logique de regroupement automatique utilisée par les 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

Remarque : Si l'option EventClass.eventId est définie, elle est prioritaire pour déterminer quels objets sont considérés comme appartenant à un groupe.

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

Remarque : EventClass.dateTime.start est une propriété facultative. Si elle n'est pas définie, seuls EventClass.eventName et la section d'ID de l'émetteur de EventObject.id sont utilisés pour déterminer le regroupement.