Grupowanie wielu biletów na wydarzenia

Użyj identyfikatora grupy

Domyślnie dodanie wielu kart do jednego linku Dodaj do Portfela Google nie powoduje grupowania ich w aplikacji Portfel Google użytkownika. Można jednak grupować karty, upewniając się, że wszystkie mają ten sam identyfikator grupowania. Zgrupowane karty będą wyświetlać się razem w aplikacji Portfel Google. Po wybraniu grupy kart każda karta będzie wyświetlana w karuzeli.

Karty można grupować:

  • Podczas wstępnej obsługi administracyjnej
  • Za pomocą metody update lub patch

Aby dodać kartę do grupy, musisz ustawić właściwość groupingInfo.groupingId obiektu karty. Wszystkie obiekty biletu z tą samą wartością groupingId będą automatycznie grupowane, nawet jeśli zostały dodane oddzielnie.

Poniższy przykład pokazuje, jak karta lojalnościowa i oferta są grupowane, aby zachęcić użytkownika do skorzystania z obu tych opcji przy kolejnym zakupie.

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

Automatyczne grupowanie biletów na wydarzenie

Czasami bilety na wydarzenia są używane w grupie, a nie pojedynczo. Często jest to grupowanie biletów dla kilku członków rodziny.

Bilety na wydarzenia mają dodatkową logikę, która umożliwia automatyczne grupowanie na podstawie tych właściwości:

  • EventClass.eventId
  • EventClass.eventName
  • EventClass.dateTime.start
  • Część identyfikatora wydawcy EventObject.id

Grupowanie z EventClass.eventId

Obiekty biletu na wydarzenie są automatycznie grupowane, jeśli mają te same wartości tych właściwości:

  • EventClass.eventId
  • Część identyfikatora wydawcy EventObject.id

Gdy obiekty biletu na wydarzenie spełniają te kryteria, będą grupowane nawet wtedy, gdy EventClass.eventName i EventClass.dateTime.start są różne.

Grupowanie bez grupy EventClass.eventId

Jeśli zasada EventClass.eventId nie jest skonfigurowana, zostaną one automatycznie zgrupowane, o ile te właściwości są takie same.

  • EventClass.eventName
  • EventClass.dateTime.start
  • Część identyfikatora wydawcy EventObject.id