Activar notificaciones push

Notificaciones activadas por el socio

Agregar mensaje y notificar

Fondo

Después de que un usuario agrega un pase, es posible que quieras enviarle un mensaje relacionado con el pase y asegurarte de que reciba una notificación al respecto. Cuando se usa la solicitud de la API de Add Message con un message_type igual a TEXT_AND_NOTIFY , sucede lo siguiente:

  1. Se agrega un elemento "Mensaje" a la "parte posterior del pase" (también conocida como plantilla de detalles) y se envía una notificación push a los usuarios que tienen guardado el pase.
  2. Una vez que el usuario presiona la notificación, se abre la Billetera de Google en la parte frontal del pase (también conocida como vista de tarjeta), y el usuario verá una llamada en la parte superior de la pantalla con un botón "Ver mensaje".
  3. Si hacen clic en la llamada, los usuarios accederán a la parte posterior del pase, donde se resaltarán los mensajes nuevos no leídos.

Algunas consideraciones cuando se envían mensajes con notificaciones a los usuarios

  • Los usuarios deben tener habilitadas las notificaciones para sus pases para recibir las notificaciones push relacionadas con los mensajes.
  • Los mensajes pueden contener URIs a tu sitio web o app. Los hipervínculos deben ser un sitio web o una app relacionados con el pase. Enviar a los usuarios a vínculos que no estén relacionados con el pase constituye una violación de la Política de Uso Aceptable.
  • Puedes enviar un máximo de 3 mensajes que activen una notificación push en un período de 24 horas. Google puede limitar tu cuota de entrega de notificaciones push si considera que envías spam a tus usuarios.
  • La notificación push que los usuarios ven en la pantalla de bloqueo está controlada por la Billetera de Google.
  • Puedes usar los métodos UPDATE o PATCH para editar o quitar datos de mensajes con el extremo de clase o de objeto normal.

Pasos de integración

Cuando quieras notificar a los usuarios sobre un nuevo mensaje del emisor agregado con la API de AddMessage, deberás actualizar el AddMessageRequest para que el mensaje que contiene el texto nuevo tenga el MessageType TEXT_AND_NOTIFY en lugar de TEXT.

Ejemplo de solicitud JSON para agregar un mensaje y notificar en una clase de pases

  …
  "id": ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Class message header",
        "body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

Ejemplo de solicitud JSON para agregar un mensaje y notificar en un objeto de pases

  …
  "id": OBJECT_ID",
  "classId": "ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Object message header",
        "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

Ejemplo de respuesta para agregar un mensaje y notificar en una clase de pases

  // The updated resource
  …
    {
      "kind": "walletobjects#walletObjectMessage",
      "header": "My Object message header",
      "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
      "id": "message_id",
      "messageType": "textAndNotify"
    },
  …

Manejo de excepciones

Cualquier intento de notificar más de 3 veces generará una QuotaExceededException respuesta. Se pueden configurar más actualizaciones del pase con "TEXT" en lugar de "TEXT_AND_NOTIFY", como se explicó en los pasos de integración.

Actualizar campo y notificar

Fondo

Después de que un usuario agrega un pase, es posible que quieras activar una notificación push cuando actualices ciertos campos. La notificación aparecerá en la pantalla de bloqueo del usuario y le informará que hay una actualización en su pase. Esta notificación solo se activará para un subconjunto específico de campos definidos a continuación con los métodos de la API de UPDATE y PATCH. Una vez que se realiza una llamada a la API para actualizar el pase, sucede lo siguiente:

  1. Se activa y se muestra una notificación push en la pantalla de bloqueo del usuario, que le informa sobre una actualización del pase.
  2. Una vez que el usuario presiona la notificación, se abre la Billetera de Google en la parte frontal de el pase (también conocida como vista de tarjeta), y el usuario verá una llamada en la parte superior de la pantalla con un botón "Revisar actualización".
  3. Si hace clic en el botón, el usuario accederá a una pantalla en la que podrá ver los campos que se modificaron con la actualización.

Algunas consideraciones cuando se envían notificaciones de actualización de campos

  • Los usuarios deben tener habilitadas las notificaciones para sus pases para recibir las notificaciones push relacionadas con las actualizaciones.
  • Una notificación solo se activa si la hora de inicio del evento o del vuelo es de 3 horas o menos para evitar enviar spam a los usuarios.
  • Puedes enviar un máximo de 3 actualizaciones que activen una notificación push en un período de 24 horas. Google puede limitar tu cuota de entrega de notificaciones push si considera que envías spam a tus usuarios.
  • La notificación push que los usuarios ven en la pantalla de bloqueo está controlada por la Billetera de Google.
  • El campo notifyPreference es un campo transitorio que solo existe en esta solicitud. Para solicitudes futuras en las que desees activar una notificación, deberás restablecer este campo en la solicitud de clase o de objeto.

Pasos de integración

Para activar estas notificaciones, deberás usar las llamadas existing UPDATE or PATCH calls existentes y especificar notifyPreference. Cuando actualices un campo en una clase o un objeto, puedes agregar un campo nuevo, notifyPreference, a la solicitud de clase o de objeto para activar la notificación.

Ejemplo de solicitud JSON para actualizar y notificar en una clase

    …
    "dateTime":
        {
            "kind": "walletobjects#eventDateTime",
            "doorsOpen": "2024-09-23T19:20:50.00"
        },
    "multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
    "notifyPreference": "notifyOnUpdate",
    …

Si configuras notifyPreference como notifyOnUpdate, se activará una notificación, siempre que el campo actualizado sea compatible actualmente.

Campos disponibles

LoyaltyClass
  • rewardsTier
  • secondaryRewardsTier
  • programName
LoyaltyObject
  • loyaltyPoints.balance
  • secondaryLoyaltyPoints.balance

Notificaciones cercanas

Esta función mostrará a los usuarios que habilitaron las notificaciones y otorgaron acceso preciso y siempre activo a la ubicación a la app de la Billetera de Google una notificación push que les recordará que guardaron un pase relevante para su ubicación actual.

Pasos de integración

Modo de uso

Para usar esta función, debes agregar ubicaciones a tus clases y objetos. Puedes agregar hasta 10 ubicaciones por clase y 10 por objeto. Usa MerchantLocations en la definición de tu clase o de tu objeto. Puedes agregar estas ubicaciones cuando usas los métodos insert, patch o update.

Después de agregar ubicaciones a una clase o un objeto, Google enviará notificaciones a los usuarios cuando estén cerca. Google decide qué tan cerca debe estar un usuario y cuánto tiempo debe permanecer en el área antes de que se envíe la notificación. Google también controla el texto de la notificación.

Ejemplo de LoyaltyClass con MerchantLocations establecido: 
{
  "kind": "walletobjects#loyaltyClass",
  "programLogo": {
  "kind": "walletobjects#image",
  "sourceUri": {
    "uri":
    ...
  }
  },
  "localizedProgramName": {
    "kind": "walletobjects#localizedString",
    "defaultValue": {
      "kind": "walletobjects#translatedString",
      "language": "en",
      "value": "Program Name",
    }
  },
  "id": Id1234,
  "version": "1",
  "allowMultipleUsersPerObject": true,
  "reviewStatus": "underReview",
  "enableSmartTap": false,
  "localizedIssuerName": {
    "kind": "walletobjects#localizedString",
    "defaultValue": {
      "kind": "walletobjects#translatedString",
      "language": "en",
      "value": "Issuer Name"
    }
  },
  "multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
  "merchantLocations": [
    {
      "latitude": 37.79020867928078,
      "longitude": -122.39004
    },
    {
      "latitude": 37.42587,
      "longitude": -122.08620
    },
  ]
}

Comportamiento esperado

Los usuarios deberían recibir notificaciones fijas sobre sus pases cuando se encuentren en una de las MerchantLocations especificadas. Si hacen clic en la notificación, se abrirá su pase en la Billetera de Google. Los usuarios pueden descartar la notificación con el gesto de deslizar el dedo. Cuando un usuario abandona la ubicación, la notificación desaparece.