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:
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).