Push-Benachrichtigungen auslösen

Von Partnern ausgelöste Benachrichtigungen

Nachricht hinzufügen und benachrichtigen

Hintergrund

Nachdem ein Nutzer eine Karte bzw. ein Ticket hinzugefügt hat, kannst du ihm eine Nachricht dazu senden und dafür sorgen, dass er benachrichtigt wird. Wenn Sie die Add Message API-Anfrage mit einer message_type von TEXT_AND_NOTIFY verwenden, geschieht Folgendes:

  1. Dem „Rückseite der Karte/des Tickets“ (Details-Vorlage) wird der Artikel „Nachricht“ hinzugefügt und eine Push-Benachrichtigung wird an Nutzer gesendet, die die Karte bzw. das Ticket gespeichert haben.
  2. Wenn der Nutzer auf die Benachrichtigung tippt, wird Google Wallet mit der Vorderseite der Karte/des Tickets (Kartenansicht) geöffnet. Oben auf dem Bildschirm wird ein Zusatzhinweis mit der Schaltfläche „Nachricht ansehen“ angezeigt.
  3. Wenn Nutzer auf die Zusatzinformation klicken, gelangen sie zur Rückseite der Karte/des Tickets, auf der neue ungelesene Nachrichten hervorgehoben werden.

Hinweise zum Senden von Nachrichten mit Benachrichtigungen an Nutzer

  • Nutzer müssen Benachrichtigungen für ihre Karten/Tickets 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 sich auf die Karte/das Ticket beziehen. Es verstößt gegen die Richtlinien zur Fairen Nutzung, Nutzer zu Links zu leiten, die keinen Bezug zum Ticket haben.
  • 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-Benachrichtigungen, die Nutzer auf ihrem Sperrbildschirm sehen, werden von Google Wallet gesteuert.
  • Mit den Methoden UPDATE oder PATCH können Sie Nachrichtendaten über den regulären Klassen- oder Objektendpunkt bearbeiten oder entfernen.

Integrationsschritte

Wenn Sie Nutzer über eine neue Mitteilung des Ausstellers benachrichtigen möchten, die mit der AddMessage API hinzugefügt wurde, müssen Sie die AddMessageRequest so aktualisieren, dass die Message, die Ihren neuen Text enthält, die 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 Karten-/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 Benachrichtigung in einem Karten-/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, um eine Nachricht hinzuzufügen und für eine Karten-/Ticketklasse zu benachrichtigen

  // 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 Benachrichtigungsversuchen wird die Antwort QuotaExceededException zurückgegeben. Alle weiteren Aktualisierungen des Tickets können mit „TEXT“ anstelle von „TEXT_AND_NOTIFY“ festgelegt werden, wie in den Schritten zur Integration beschrieben.

Feld aktualisieren und benachrichtigen

Hintergrund

Nachdem ein Nutzer eine Karte bzw. ein Ticket hinzugefügt hat, kannst du eine Push-Benachrichtigung auslösen, wenn du bestimmte Felder aktualisierst. Die Benachrichtigung wird auf dem Sperrbildschirm des Nutzers angezeigt und informiert ihn darüber, dass es eine Aktualisierung für seine Karte/sein Ticket gibt. Diese Benachrichtigung wird nur für eine bestimmte Teilmenge der unten definierten Felder ausgelöst, die mit den API-Methoden UPDATE und PATCH aktualisiert werden. Nach einem API-Aufruf zum Aktualisieren der Karte/des Tickets passiert Folgendes:

  1. Eine Push-Benachrichtigung wird ausgelöst und auf dem Sperrbildschirm des Nutzers angezeigt, um ihn über eine Karten-/Ticketaktualisierung zu informieren.
  2. Wenn der Nutzer auf die Benachrichtigung tippt, wird Google Wallet mit der Karte bzw. dem Ticket geöffnet. Oben auf dem Bildschirm wird ein Zusatz mit der Schaltfläche „Aktualisierung prüfen“ angezeigt.
  3. Wenn der Nutzer auf die Schaltfläche klickt, wird ein Bildschirm mit den Feldern angezeigt, die durch die Aktualisierung geändert wurden.

Hinweise zum Senden von Benachrichtigungen zu Feldaktualisierungen

  • Nutzer müssen Benachrichtigungen für ihre Karten/Tickets aktiviert haben, um Push-Benachrichtigungen zu Aktualisierungen zu erhalten.
  • Sie können innerhalb von 24 Stunden maximal drei Updates senden, die eine Push-Benachrichtigung auslösen. Google kann das Kontingent für die Zustellung von Push-Benachrichtigungen begrenzen, wenn Ihre Nutzer Ihrer Meinung nach zu viel Spam erhalten.
  • Die Push-Benachrichtigung, die Nutzer auf ihrem Sperrbildschirm sehen, wird von Google Wallet gesteuert.
  • Das Feld notifyPreference ist ein temporäres Feld, das nur für diese Anfrage verwendet wird. Wenn Sie bei 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 Anfrage für die Klasse oder das Objekt 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 festlegen, wird eine Benachrichtigung ausgelöst, sofern das aktualisierte Feld derzeit unterstützt wird.

Unterstützte Felder

FlightObject
  • boardingAndSeatingInfo.seatNumber
  • boardingAndSeatingInfo.seatAssignment

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 Flugaktualisierungen

Wenn bestimmte Felder eines Fluges geändert werden, erhalten Nutzer mit einer oder mehreren hinzugefügten 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: „Beispielflughafen 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.