Mehrere Bordkarten gruppieren

Gruppierungs-ID verwenden

Standardmäßig werden diese Karten/Tickets durch das Hinzufügen mehrerer Karten/Tickets zu einem einzelnen Link Zu Google Wallet hinzufügen in der Google Wallet-App des Nutzers nicht gruppiert. Karten/Tickets können jedoch gruppiert werden, indem du sicherstellst, dass sie alle dieselbe Gruppierungs-ID haben. Gruppierte Karten/Tickets werden gemeinsam in der Google Wallet-App angezeigt. Wenn eine Gruppe von Karten/Tickets ausgewählt wird, wird jede Karte/jedes Ticket in einem Karussell angezeigt.

Es gibt verschiedene Möglichkeiten, Karten/Tickets zu gruppieren:

  • Während der anfänglichen Bereitstellung
  • Über die Methoden update oder patch

Zum Hinzufügen einer Karte/eines Tickets zu einer Gruppe musst du das Attribut groupingInfo.groupingId des Karten-/Ticketobjekts festlegen. Alle Karten-/Ticketobjekte mit demselben Wert groupingId werden automatisch gruppiert, auch wenn diese separat hinzugefügt werden.

Das folgende Beispiel zeigt, wie eine Kundenkarte und ein Angebot gruppiert werden, um den Nutzer dazu zu verleiten, beide bei seinem nächsten Kauf zu verwenden. 

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",
  },
}

Automatische Gruppierung von Bordkarten

Manchmal werden Bordkarten in einer Gruppe statt einzeln verwendet. Ein häufiges Szenario dafür ist die Gruppierung von Tickets für Flüge mit Zwischenstopps.

Bordkarten verwenden eine zusätzliche Logik, die die Bordkarten automatisch gruppiert, wenn sie dieselben Werte für folgende Eigenschaften haben:

  • FlightClass.flightHeader.carrier.carrierIataCode
  • FlightClass.flightHeader.flightNumber
  • FlightClass.localScheduledDepartureDateTime
  • FlightObject.reservationInfo.confirmationCode
  • Der Aussteller-ID-Teil von FlightObject.id

Wenn sich zwei Bordkarten in einer der obigen Eigenschaften unterscheiden, werden sie nicht gruppiert (außer du verwendest groupingInfo). Wie du siehst, beeinflussen sowohl Klassen- als auch Objekteigenschaften die automatische Gruppierung. So ist es möglich, Bordkarten unterschiedlicher Klassen zu gruppieren (z. B. wenn die einzelnen Flüge einer Reise von verschiedenen Fluggesellschaften durchgeführt werden).