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" al "dorso del pase" (también conocido como Plantilla de detalles) y se envía una notificación push a los usuarios que guardaron el pase.
  2. Una vez que el usuario presione la notificación, se abrirá la Billetera de Google en la parte frontal del pase (es decir, la vista de tarjeta) y 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 irán al reverso del pase, donde se resaltarán los mensajes nuevos no leídos.

Consideraciones para enviar mensajes con notificaciones a los usuarios

  • Los usuarios deben tener habilitadas las notificaciones para sus pases si quieren recibir las notificaciones push relacionadas con los mensajes.
  • Los mensajes pueden contener URIs a tu sitio web o aplicación. Los hipervínculos deben ser a un sitio web o una aplicación relacionados con el pase. Enviar a los usuarios a vínculos que no estén relacionados con el pase constituye un incumplimiento 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. Es posible que Google limite tu cuota de entrega de notificaciones push si considera que estás enviando spam a tus usuarios.
  • Google Wallet controla la notificación push que los usuarios ven en la pantalla de bloqueo.
  • 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 AddMessageRequest para que el Message que contiene el texto nuevo tenga MessageType TEXT_AND_NOTIFY en lugar de TEXT.

Ejemplo de solicitud en formato JSON para agregar un mensaje y enviar una notificación 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 enviar una notificación en un objeto de Passes

  …
  "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 Response para agregar un mensaje y notificar una clase de pase

  // 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 enviar notificaciones más de 3 veces generará una respuesta de QuotaExceededException . Cualquier otra actualización del pase se puede configurar con "TEXT" en lugar de "TEXT_AND_NOTIFY", como se explica en los pasos de integración.

Notificaciones de Nearby

Esta función mostrará una notificación push a los usuarios que hayan habilitado las notificaciones y otorgado acceso preciso y permanente a la ubicación en la app de la Billetera de Google para recordarles 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 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 un objeto LoyaltyClass con el campo 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 deben recibir notificaciones fijas sobre sus pases cuando se encuentren en una de las MerchantLocations especificadas. Si hace clic en la notificación, se abrirá el pase en la Billetera de Google. Los usuarios pueden descartar la notificación con el gesto de deslizamiento. Cuando un usuario salga de la ubicación, la notificación desaparecerá.