Push-Benachrichtigungen auslösen

Benachrichtigungen, die von Partnern ausgelöst werden

Nachricht hinzufügen und benachrichtigen

Hintergrund

Nachdem ein Nutzer eine Karte oder ein Ticket hinzugefügt hat, möchten Sie ihm möglicherweise eine Nachricht dazu senden und ihn darüber informieren. Wenn Sie die Add Message API Anfrage mit einem message_type gleich TEXT_AND_NOTIFY verwenden, passiert Folgendes:

  1. Der Rückseite der Karte oder des Tickets (auch als Detailvorlage bezeichnet) wird ein Element vom Typ "Nachricht" hinzugefügt und Nutzer, die die Karte oder das Ticket gespeichert haben, erhalten eine Push-Benachrichtigung.
  2. Wenn der Nutzer auf die Benachrichtigung tippt, wird Google Wallet mit der Vorderseite der Karte oder des Tickets (auch als Kartenansicht bezeichnet) geöffnet. Oben auf dem Bildschirm wird ein Callout mit der Schaltfläche „Nachricht ansehen“ angezeigt.
  3. Wenn der Nutzer auf das Callout klickt, wird er zur Rückseite der Karte oder des Tickets weitergeleitet. Dort werden neue ungelesene Nachrichten hervorgehoben.

Hinweise zum Senden von Nachrichten mit Benachrichtigungen an Nutzer

  • Nutzer müssen Benachrichtigungen für ihre Karten oder Tickets aktiviert haben, um Push-Benachrichtigungen zu Nachrichten zu erhalten.
  • Nachrichten können URIs zu Ihrer Website oder App enthalten. Hyperlinks müssen sich auf eine Website oder App beziehen, die mit der Karte oder dem Ticket in Verbindung steht. Es verstößt gegen die Richtlinien zur akzeptablen Nutzung , Nutzer zu Links zu senden, die nicht mit der Karte oder dem Ticket 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 das Unternehmen der Ansicht ist, dass Sie Ihre Nutzer mit Spam belästigen.
  • Die Push-Benachrichtigung, die Nutzer auf dem Sperrbildschirm sehen, wird von Google Wallet gesteuert.
  • Sie können die UPDATE oder PATCH Methoden verwenden, um Nachrichtendaten über den regulären Klassen- oder Objekt Endpunkt zu bearbeiten oder zu entfernen.

Integrationsschritte

Wenn Sie Nutzer über eine neue Ausstellernachricht informieren möchten, die mit der AddMessage API hinzugefügt wurde, müssen Sie die AddMessageRequest so aktualisieren, dass die Nachricht , 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 Benachrichtigen in einer Karten- oder Ticketklasse

  …
  "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 Benachrichtigen in einem Karten- oder Ticketobjekt

  …
  "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 eine Antwort zum Hinzufügen einer Nachricht und zum Benachrichtigen für eine Karten- oder Ticketklasse

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

Umgang mit Ausnahmen

Bei mehr als drei Benachrichtigungsversuchen wird die Antwort QuotaExceededException zurückgegeben. Weitere Aktualisierungen der Karte oder des Tickets können mit "TEXT" anstelle von "TEXT_AND_NOTIFY" festgelegt werden, wie in den Integrations schritten beschrieben.

Feld aktualisieren und benachrichtigen

Hintergrund

Nachdem ein Nutzer eine Karte oder ein Ticket hinzugefügt hat, möchten Sie möglicherweise eine Push-Benachrichtigung auslösen, wenn Sie bestimmte Felder aktualisieren. Die Benachrichtigung wird auf dem Sperrbildschirm des Nutzers angezeigt und informiert ihn darüber, dass seine Karte oder sein Ticket aktualisiert wurde. Diese Benachrichtigung wird nur für eine bestimmte Teilmenge von Feldern ausgelöst, die unten mit den API-Methoden UPDATE und PATCH definiert sind. Sobald ein API-Aufruf zum Aktualisieren der Karte oder des Tickets erfolgt, passiert Folgendes:

  1. Eine Push-Benachrichtigung wird ausgelöst und auf dem Sperrbildschirm des Nutzers angezeigt, um ihn über die Aktualisierung der Karte oder des Tickets zu informieren.
  2. Wenn der Nutzer auf die Benachrichtigung tippt, wird Google Wallet mit der Vorderseite der Karte oder des Tickets (auch als Kartenansicht bezeichnet) geöffnet. Oben auf dem Bildschirm wird ein Callout mit der Schaltfläche „Aktualisierung ansehen“ angezeigt.
  3. Wenn der Nutzer auf die Schaltfläche klickt, wird er zu einem Bildschirm weitergeleitet, auf dem er die Felder sehen kann, die durch die Aktualisierung geändert wurden.

Hinweise zum Senden von Benachrichtigungen zu Feldaktualisierungen

  • Nutzer müssen Benachrichtigungen für ihre Karten oder Tickets aktiviert haben, um Push-Benachrichtigungen zu Aktualisierungen zu erhalten.
  • Eine Benachrichtigung wird nur ausgelöst, wenn die Startzeit des Ereignisses oder Flugs in maximal drei Stunden liegt, um Nutzer nicht mit Spam zu belästigen.
  • Sie können innerhalb von 24 Stunden maximal drei Aktualisierungen senden, die eine Push-Benachrichtigung auslösen. Google kann Ihr Kontingent für die Zustellung von Push-Benachrichtigungen drosseln, wenn das Unternehmen der Ansicht ist, dass Sie Ihre Nutzer mit Spam belästigen.
  • Die Push-Benachrichtigung, die Nutzer auf dem Sperrbildschirm sehen, wird von Google Wallet gesteuert.
  • Das Feld notifyPreference ist ein temporäres Feld das nur in dieser Anfrage vorhanden ist. Wenn Sie in zukünftigen Anfragen eine Benachrichtigung auslösen möchten, müssen Sie dieses Feld in der Klassen- oder Objektanfrage zurücksetzen.

Integrationsschritte

Um diese Benachrichtigungen auszulösen, müssen Sie die vorhandenen UPDATE- oder PATCH Aufrufe verwenden und die notifyPreference angeben. Wenn Sie ein Feld in einer Klasse oder einem Objekt aktualisieren, können Sie der Klassen- oder Objektanfrage ein neues Feld, notifyPreference, hinzufügen, um die Benachrichtigung auszulösen.

Beispiel für eine JSON-Anfrage zum Aktualisieren und Benachrichtigen in einer Klasse

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

Wenn Sie notifyPreference auf notifyOnUpdate setzen, wird eine Benachrichtigung ausgelöst, sofern das aktualisierte Feld derzeit unterstützt wird.

Unterstützte Felder

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

Benachrichtigungen für Angebote in der Nähe

Mit dieser Funktion wird Nutzern, die Benachrichtigungen aktiviert und der Google Wallet App einen genauen, dauerhaften Standortzugriff gewährt haben, eine Push-Benachrichtigung angezeigt, die sie daran erinnert, dass sie eine Karte oder ein Ticket gespeichert haben, das für ihren aktuellen Standort relevant ist.

Integrationsschritte

Verwendung

Um diese Funktion zu verwenden, müssen Sie Ihren Klassen und Objekten Standorte hinzufügen. Sie können pro Klasse und pro Objekt bis zu 10 Standorte hinzufügen. Verwenden Sie MerchantLocations in Ihrer Klassen- oder Objektdefinition. Sie können diese Standorte mit den Methoden insert, patch oder update hinzufügen.

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 steuert auch den Text der Benachrichtigung.

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 oder Tickets erhalten, wenn sie sich an einem der angegebenen MerchantLocations befinden. Wenn sie auf die Benachrichtigung klicken, wird ihre Karte oder ihr Ticket in Google Wallet geöffnet. Nutzer können die Benachrichtigung durch Wischen schließen. Wenn ein Nutzer den Standort verlässt, wird die Benachrichtigung ausgeblendet.