Mehrere Veranstaltungstickets 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 Veranstaltungstickets

Hinweis: Das Attribut groupingInfo einer Karte bzw. eines Tickets hat immer Vorrang vor der Logik der automatischen Gruppierung, die von Veranstaltungstickets verwendet wird.

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

Hinweis: Wenn EventClass.eventId festgelegt ist, hat dieses Attribut Vorrang bei der Bestimmung, welche Objekte als Gruppe gelten.

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

Hinweis: EventClass.dateTime.start ist ein optionales Attribut. Wenn es nicht festgelegt ist, werden nur EventClass.eventName und der Aussteller-ID-Teil von EventObject.id verwendet, um die Gruppierung zu bestimmen.