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.

Feld aktualisieren und benachrichtigen

Hintergrund

Nachdem ein Nutzer eine Karte bzw. 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 es ein Update für seine Karte oder sein Ticket gibt. Diese Benachrichtigung wird nur für eine bestimmte Teilmenge von Feldern ausgelöst, die unten mit den API-Methoden UPDATE und PATCH definiert sind. Wenn ein API-Aufruf zum Aktualisieren der Karte erfolgt, passiert Folgendes:

  1. Eine Push-Benachrichtigung wird ausgelöst und auf dem Sperrbildschirm des Nutzers angezeigt, um ihn über eine Aktualisierung der Karte oder des Tickets zu informieren.
  2. Wenn der Nutzer auf die Benachrichtigung tippt, wird Google Wallet mit der Vorderseite der Karte / des Tickets (der Kartenansicht) geöffnet. Oben auf dem Bildschirm wird ein Hinweis mit der Schaltfläche „Aktualisierung überprüfen“ angezeigt.
  3. Durch Klicken auf die Schaltfläche gelangt der Nutzer zu einem Bildschirm, auf dem er die durch das Update geänderten Felder sehen kann.

Hinweise zum Senden von Benachrichtigungen zu Feldaktualisierungen

  • Nutzer müssen Benachrichtigungen für ihre Karten und Tickets aktiviert haben, um Push-Benachrichtigungen zu Aktualisierungen zu erhalten.
  • Du kannst innerhalb von 24 Stunden maximal drei Updates senden, die eine Push-Benachrichtigung auslösen. Google kann Ihr Kontingent für die Zustellung von Push-Benachrichtigungen drosseln, wenn Sie Nutzer mit Spam belästigen.
  • Die Push-Benachrichtigung, die Nutzer auf ihrem Sperrbildschirm sehen, wird von Google Wallet gesteuert.
  • Das Feld notifyPreference ist ein temporäres Feld, das nur in dieser Anfrage vorhanden ist. Bei zukünftigen Anfragen, bei denen Sie eine Benachrichtigung auslösen möchten, müssen Sie dieses Feld in der Klassen- oder Objektabfrage zurücksetzen.

Integrationsschritte

Damit diese Benachrichtigungen ausgelöst werden, müssen Sie die bestehenden 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 einem Kurs

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

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

Unterstützte Felder

FlightObject
  • boardingAndSeatingInfo.seatNumber
  • boardingAndSeatingInfo.seatAssignment

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.

Automatische Benachrichtigungen, die von Google Wallet ausgelöst werden

Anstehende Benachrichtigung

Google Wallet sendet dem Nutzer drei Stunden vor dem Flug eine Benachrichtigung. Die Flugzeit wird durch class.localScheduledDepartureDateTime definiert.

Um diese Benachrichtigung zu erhalten, muss der Nutzer Benachrichtigungen aktiviert haben. Unter Einstellungen > Benachrichtigungen können Nutzer prüfen, ob Benachrichtigungen zu Ihren Karten/Tickets aktiviert sind.

Die Benachrichtigung wird im Benachrichtigungsbereich und auf dem Sperrbildschirm angezeigt, wenn der Nutzer Benachrichtigungen für den Sperrbildschirm aktiviert hat.

Die Benachrichtigung hat folgendes Format, das nicht geändert werden kann: 

  Boarding pass for your flight to class.destination.airportIataCode

Wenn Nutzer auf die Benachrichtigung tippen und ihr Gerät entsperren, wird ihre Karte bzw. ihr Ticket in der Google Wallet App angezeigt.

Wenn der Nutzer mehrere Karten/Tickets hat, wird nur die Karte bzw. das Ticket angezeigt, die bzw. das am frühesten verwendet werden kann. Falls über Mehrere Bordkarten gruppieren gruppierte Karten/Tickets hinzugefügt wurden, wird in der Benachrichtigung nur eine der Karten bzw. eines der Tickets aus der Gruppe angezeigt. Wenn der Nutzer jedoch darauf tippt, kann er nach links und rechts wischen, um die anderen Karten/Tickets in dieser Gruppe zu sehen.

Die Benachrichtigung wird angepinnt und nicht automatisch geschlossen, nachdem ein Nutzer sie geöffnet hat. Das automatische Schließen erfolgt 60 Minuten nach class.localScheduledDepartureDateTime.

Benachrichtigung zu Fluginformationen

Wenn bestimmte Felder eines Fluges geändert werden, erhalten Nutzer mit einer oder mehreren Bordkarten auf ihren Geräten eine Push-Benachrichtigung. Dies geschieht nur, wenn bestimmte Bedingungen erfüllt sind.

Terminal und Gate am Abflugort

Wenn Sie class.origin.terminal oder class.origin.gate ändern und die nachstehende Bedingung erfüllt ist, wird eine Benachrichtigung gesendet, dass das Feld geändert wurde.

  • Es sind weniger als drei Stunden bis zum class.localScheduledDepartureDateTime.

Die Benachrichtigung hat das folgende Format: „Beispiel-Airlines hat Ihr Gate auf A1 aktualisiert.“ Das Format kann nicht geändert werden.

Boarding- und Abflugzeit

Wenn Sie class.localBoardingDateTime oder class.localEstimatedOrActualDepartureDateTime ändern und die nachstehenden Bedingungen erfüllt sind, wird eine Benachrichtigung gesendet, dass das Feld geändert wurde.

  • Es sind weniger als 24 Stunden bis zum class.localScheduledDepartureDateTime.
  • Die jeweilige Uhrzeit ändert sich um mindestens 10 Minuten.

Die Benachrichtigung hat das folgende Format: „Beispiel-Airlines hat Ihre Boardingzeit auf 18:00 Uhr aktualisiert.“ Das Format oder die Sprache kann nicht angepasst werden.