Push-Benachrichtigungen auslösen

Von Partnern ausgelöste Benachrichtigungen

Nachricht und Benachrichtigung hinzufügen

Hintergrund

Nachdem ein Nutzer eine Karte bzw. ein Ticket hinzugefügt hat, möchten Sie ihm möglicherweise eine Nachricht dazu senden und sicherstellen, dass er darüber benachrichtigt wird. Wenn Sie die Add Message API-Anfrage mit einem message_type gleich TEXT_AND_NOTIFY verwenden, passiert Folgendes:

1. Der Rückseite der Karte bzw. des Tickets (auch Vorlagendetails genannt) wird ein Element vom Typ Mitteilung hinzugefügt und Nutzer, die die Karte bzw. das Ticket gespeichert haben, erhalten eine Push-Benachrichtigung.
2. Wenn der Nutzer auf die Benachrichtigung tippt, wird Google Wallet mit der Vorderseite des Tickets (Kartenansicht) geöffnet. Oben auf dem Bildschirm wird ein Hinweis mit der Schaltfläche „Nachricht ansehen“ angezeigt.
3. Durch Klicken auf den Hinweis gelangen Nutzer zur Rückseite der Karte, auf der neue, ungelesene Nachrichten hervorgehoben werden.

Hinweise zum Senden von Nachrichten mit Benachrichtigungen an Nutzer

• Nutzer müssen Benachrichtigungen für ihre Karten aktiviert haben, um Push-Benachrichtigungen zu Nachrichten zu erhalten.
• Nachrichten können URIs zu Ihrer Website oder App enthalten. Hyperlinks müssen zu einer Website oder App führen, die mit der Karte oder dem Ticket in Verbindung steht. Es ist ein Verstoß gegen die Richtlinie zur zulässigen Nutzung, Nutzer zu Links zu leiten, die nicht mit dem Pass in Verbindung stehen.
• Sie können innerhalb von 24 Stunden maximal drei Nachrichten senden, die eine Push-Benachrichtigung auslösen. Google kann Ihr Kontingent für die Zustellung von Push-Benachrichtigungen drosseln, wenn Sie Ihre Nutzer mit Spam belästigen.
• Die Push-Benachrichtigung, die Nutzer auf ihrem Sperrbildschirm sehen, wird von Google Wallet gesteuert.
• Sie können die Methoden UPDATE oder PATCH verwenden, um Nachrichtendaten über den regulären Klassen- oder Objektendpunkt zu bearbeiten oder zu entfernen.

Integrationsschritte

Wenn Sie Nutzer über eine neue Ausstellerbenachrichtigung informieren möchten, die mit der AddMessage API hinzugefügt wurde, müssen Sie den AddMessageRequest so aktualisieren, dass die Message, die Ihren neuen Text enthält, den MessageType TEXT_AND_NOTIFY anstelle von TEXT hat.

Beispiel für eine JSON-Anfrage zum Hinzufügen einer Nachricht und zum Senden einer Benachrichtigung in einer Passes-Klasse

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

Beispiel für eine JSON-Anfrage zum Hinzufügen einer Nachricht und zum Senden einer Benachrichtigung in einem Pass-Objekt

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

Beispiel für Antwort zum Hinzufügen einer Nachricht und zum Benachrichtigen für eine Pass-Klasse

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

Ausnahmebehandlung

Bei mehr als drei Versuchen, eine Benachrichtigung zu senden, wird die Antwort QuotaExceededException zurückgegeben. Alle weiteren Aktualisierungen der Karte können mit TEXT anstelle von TEXT_AND_NOTIFY festgelegt werden, wie in den Integrationsschritten beschrieben.

Nearby-Benachrichtigungen

Nutzer, die Benachrichtigungen aktiviert und der Google Wallet App den genauen Standortzugriff „Immer“ gewährt haben, erhalten eine Push-Benachrichtigung, die sie daran erinnert, dass sie eine Karte oder ein Ticket gespeichert haben, das für ihren aktuellen Standort relevant ist.

Integrationsschritte

Verwendung

Damit Sie diese Funktion nutzen können, müssen Sie Ihren Kursen und Objekten Standorte hinzufügen. Sie können jeder Klasse und jedem Objekt bis zu 10 Standorte hinzufügen. Verwenden Sie MerchantLocations in Ihrer Klassen- oder Objektdefinition. Sie können diese Orte hinzufügen, wenn Sie die Methoden insert, patch oder update verwenden.

Nachdem Sie einer Klasse oder einem Objekt Standorte hinzugefügt haben, sendet Google Benachrichtigungen an Nutzer, wenn sie sich in der Nähe befinden. Google entscheidet, wie nah ein Nutzer sein muss und wie lange er sich in der Nähe aufhalten muss, bevor die Benachrichtigung gesendet wird. Google legt auch den Text der Benachrichtigung fest.

Beispiel für eine LoyaltyClass mit festgelegten MerchantLocations:

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

Erwartetes Verhalten

Nutzer sollten eine dauerhafte Benachrichtigung zu ihren Karten/Tickets erhalten, wenn sie sich an einem der angegebenen Händlerstandorte befinden. Wenn sie auf die Benachrichtigung klicken, wird ihre Karte bzw. ihr Ticket in Google Wallet geöffnet. Nutzer können die Benachrichtigung mit einer Wischbewegung schließen. Wenn ein Nutzer den Standort verlässt, wird die Benachrichtigung ausgeblendet.