Agrupar vários ingressos de eventos

Usar um ID de agrupamento

Por padrão, adicionar vários cartões a um único Adicionar à Carteira do Google não agrupa esses cartões na app Carteira do Google de um usuário. No entanto, os cartões podem ser agrupados garantir que todos tenham o mesmo ID de agrupamento. Os cartões agrupados vão aparecer juntos no app Carteira do Google. Quando um grupo de cartões é selecionado, cada um deles ser mostrados em um carrossel.

Os cartões podem ser agrupados:

  • Durante o provisionamento inicial
  • Ao usar o método update ou patch métodos

Para adicionar um cartão a um grupo, a propriedade groupingInfo.groupingId do o objeto do cartão precisa ser definido. Todos os objetos de cartão com o mesmo O valor groupingId será agrupado automaticamente, mesmo que eles foram adicionados separadamente.

O exemplo a seguir mostra um cartão de fidelidade e uma oferta sendo agrupados para motivar o usuário a usar ambos na próxima compra.

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

Agrupamento automático de ingressos de um evento

Às vezes, os ingressos de um evento são usados em grupo, e não individualmente. Um erro comum neste caso é um agrupamento de ingressos para vários membros da família.

Os ingressos de um evento têm uma lógica adicional que permite o agrupamento automático com base em as seguintes propriedades:

  • EventClass.eventId
  • EventClass.eventName
  • EventClass.dateTime.start
  • A parte do ID do emissor de EventObject.id
.

Agrupamento com EventClass.eventId

Os objetos de ingresso de um evento são agrupados automaticamente quando têm os mesmos valores para as seguintes propriedades:

  • EventClass.eventId
  • A parte do ID do emissor de EventObject.id

Quando os objetos de ingresso de um evento atenderem a esse critério, eles serão agrupados mesmo quando EventClass.eventName e EventClass.dateTime.start são diferentes.

Agrupamento sem EventClass.eventId

Se EventClass.eventId não estiver definido, eles serão agrupados automaticamente as seguintes propriedades são iguais.

  • EventClass.eventName
  • EventClass.dateTime.start
  • A parte do ID do emissor de EventObject.id
.