Raggruppare più biglietti per eventi

Utilizza un ID raggruppamento

Per impostazione predefinita, l'aggiunta di più tessere a un singolo link Aggiungi a Google Wallet non comporta il raggruppamento delle tessere nell'app Google Wallet dell'utente. Tuttavia, le tessere possono essere raggruppate assicurandoti che abbiano tutte lo stesso ID di raggruppamento. Le tessere raggruppate verranno visualizzate insieme nell'app Google Wallet. Quando viene selezionato un gruppo di tessere, ogni tessera verrà mostrata in un carosello.

I pass possono essere raggruppati:

  • Durante il provisioning iniziale
  • Utilizzando i metodi update o patch

Per aggiungere una tessera a un gruppo, è necessario impostare la proprietà groupingInfo.groupingId dell'oggetto pass. Tutti gli oggetti trasmessi con lo stesso valore groupingId verranno raggruppati automaticamente, anche se sono stati aggiunti separatamente.

L'esempio seguente mostra una carta fedeltà e un'offerta raggruppate per invogliare l'utente a utilizzare entrambe nel suo prossimo acquisto. 

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

Raggruppamento automatico di biglietti per eventi

A volte i biglietti per eventi vengono utilizzati in gruppo anziché singolarmente. Uno scenario comune per farlo è raggruppare i biglietti per più membri della famiglia.

I biglietti per gli eventi hanno una logica aggiuntiva che consente il raggruppamento automatico in base alle seguenti proprietà:

  • EventClass.eventId
  • EventClass.eventName
  • EventClass.dateTime.start
  • La parte dell'ID emittente di EventObject.id

Raggruppamento con EventClass.eventId

Gli oggetti ticket evento vengono raggruppati automaticamente quando hanno gli stessi valori per le seguenti proprietà:

  • EventClass.eventId
  • La parte dell'ID emittente di EventObject.id

Quando gli oggetti ticket evento soddisfano questi criteri, vengono raggruppati anche quando EventClass.eventName e EventClass.dateTime.start sono diversi.

Raggruppamento senza EventClass.eventId

Se l'opzione EventClass.eventId non è impostata, verranno raggruppate automaticamente se le seguenti proprietà sono le stesse.

  • EventClass.eventName
  • EventClass.dateTime.start
  • La parte dell'ID emittente di EventObject.id