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 Veranstaltungstickets
Manchmal werden Veranstaltungstickets in einer Gruppe statt einzeln verwendet. Ein häufiges Szenario dafür ist die Gruppierung von Tickets für mehrere Familienmitglieder.
Veranstaltungstickets haben eine zusätzliche Logik, die die automatische Gruppierung anhand der folgenden Attribute ermöglicht:
EventClass.eventId
EventClass.eventName
EventClass.dateTime.start
- Der Aussteller-ID-Teil von
EventObject.id
Gruppierung mit EventClass.eventId
Veranstaltungsticketobjekte werden automatisch gruppiert, wenn sie die gleichen Werte wie diese Attribute haben:
EventClass.eventId
- Der Aussteller-ID-Teil von
EventObject.id
Wenn Veranstaltungsticketobjekte diese Kriterien erfüllen, werden sie auch dann gruppiert, wenn EventClass.eventName
und EventClass.dateTime.start
unterschiedlich sind.
Gruppierung ohne EventClass.eventId
Falls EventClass.eventId
nicht festgelegt ist, werden sie automatisch gruppiert, wenn die folgenden Attribute identisch sind.
EventClass.eventName
EventClass.dateTime.start
- Der Aussteller-ID-Teil von
EventObject.id