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:
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