Cómo agrupar varias entradas para eventos

Cómo usar un ID de agrupación

De forma predeterminada, agregar varios pases a un solo vínculo de Agregar a la Billetera de Google no agrupará esos pases en la app de la Billetera de Google del usuario. Sin embargo, puedes agrupar los pases asegurándote de que todos tengan el mismo ID de agrupación. Los pases agrupados aparecerán juntos en la app de la Billetera de Google. Cuando se seleccione un grupo de pases, cada uno se mostrará en un carrusel.

Los pases se pueden agrupar de la siguiente manera:

  • Durante el aprovisionamiento inicial
  • Mediante los métodos update o patch

Para agregar un pase a un grupo, se debe establecer la propiedad groupingInfo.groupingId del objeto de pase. Todos los objetos de pase con el mismo valor groupingId se agruparán automáticamente, incluso si se agregaron por separado.

En el siguiente ejemplo, se muestra cómo se agrupan una tarjeta de lealtad y una oferta para motivar al usuario a usar ambas en su 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",
  },
}

Agrupación automática de entradas para eventos

En ocasiones, las entradas para eventos se usan en grupo y no de manera individual. Una situación común de esto es agrupar las entradas para varios miembros de la familia.

Las entradas para eventos tienen una lógica adicional que permite la agrupación automática según las siguientes propiedades:

  • EventClass.eventId
  • EventClass.eventName
  • EventClass.dateTime.start
  • La parte del ID de la entidad emisora de EventObject.id

Agrupación con EventClass.eventId

Los objetos de las entradas para eventos se agrupan automáticamente cuando tienen los mismos valores para las siguientes propiedades:

  • EventClass.eventId
  • La parte del ID de la entidad emisora de EventObject.id

Cuando los objetos de entradas para eventos cumplan con estos criterios, se agruparán incluso cuando EventClass.eventName y EventClass.dateTime.start sean diferentes.

Agrupación sin EventClass.eventId

Si no estableces EventClass.eventId, se agruparán automáticamente si las siguientes propiedades son iguales.

  • EventClass.eventName
  • EventClass.dateTime.start
  • La parte del ID de la entidad emisora de EventObject.id