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, möchten Sie ihm möglicherweise eine Nachricht dazu senden und ihn darüber benachrichtigen. Wenn Sie die Add Message API Anfrage mit einem message_type gleich TEXT_AND_NOTIFY verwenden, geschieht Folgendes:

  1. Der Rückseite der Karte bzw. des Tickets (auch als Detailvorlage bezeichnet) wird ein Element vom Typ "Message" 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 der Karte bzw. 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 bzw. des Tickets weitergeleitet, wo neue ungelesene Nachrichten hervorgehoben sind.

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 auf eine Website oder App verweisen, die mit der Karte bzw. dem Ticket in Verbindung steht. Es verstößt gegen die Richtlinien zur akzeptablen Nutzung , Nutzer zu Links zu senden, die nicht mit der Karte bzw. 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 Sie Ihrer Meinung nach Spam an Ihre Nutzer senden.
  • Die Push-Benachrichtigung, die Nutzer auf ihrem 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 Nachricht des Ausstellers 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-/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-/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{//1} zum Hinzufügen einer Nachricht und zum Benachrichtigen für eine Karten-/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 eine QuotaExceededException -Antwort zurückgegeben. Weitere Aktualisierungen der Karte bzw. des Tickets 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 seine Karte bzw. 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. Wenn ein API-Aufruf zum Aktualisieren der Karte bzw. des Tickets erfolgt, geschieht Folgendes:

  1. Eine Push-Benachrichtigung wird ausgelöst und auf dem Sperrbildschirm des Nutzers angezeigt, um ihn über die Aktualisierung der Karte bzw. des Tickets zu informieren.
  2. Wenn der Nutzer auf die Benachrichtigung tippt, wird Google Wallet mit der Vorderseite der Karte bzw. des Tickets (auch als Kartenansicht bezeichnet) geöffnet. Oben auf dem Bildschirm wird ein Callout mit der Schaltfläche „Update ansehen“ angezeigt.
  3. Wenn der Nutzer auf die Schaltfläche klickt, wird er zu einem Bildschirm weitergeleitet, auf dem die Felder zu sehen sind, die durch das Update 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.
  • Eine Benachrichtigung wird nur ausgelöst, wenn die Startzeit der Veranstaltung oder des Fluges in drei Stunden oder weniger liegt, um Spam zu vermeiden.
  • 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 Sie Ihrer Meinung nach Spam an Ihre Nutzer senden.
  • 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. Für zukünftige Anfragen, bei denen Sie 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

FlightObject
  • boardingAndSeatingInfo.seatNumber
  • boardingAndSeatingInfo.seatAssignment

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 gesendet, die sie daran erinnert, dass sie eine Karte bzw. ein Ticket gespeichert haben, die bzw. 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 zehn 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 angepinnte Benachrichtigung zu ihren Karten/Tickets erhalten, wenn sie sich an einem der angegebenen MerchantLocations befinden. Wenn sie auf die Benachrichtigung klicken, wird ihre Karte bzw. 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.

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 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, und die folgende 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 drei Stunden bis zum vor 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.