Inhaber von Apple Wallet-Pässen benachrichtigen

Sobald ein Benutzer Ihren Apple Wallet-Pass hinzufügt, registriert Pushwoosh diesen als ein Apple Wallet-Plattform-Abonnement, das mit dieser User ID verknüpft ist. Pässe befinden sich auf dem iPhone und der Apple Watch.

Sie können Inhaber auf verschiedene Weisen erreichen: Senden Sie eine einmalige Push-Benachrichtigung, senden Sie ein Pass-Update, automatisieren Sie Nachrichten aus einer Customer Journey oder benachrichtigen Sie Inhaber eines bestimmten Passes per API.

Senden Sie eine einmalige Push-Benachrichtigung an Pass-Inhaber

Senden Sie eine eigenständige Push-Benachrichtigung an einen Pass-Inhaber oder an ein breiteres Publikum. Sie erscheint als Nachricht auf dem Sperrbildschirm des Passes.

1. Öffnen Sie den Composer für einmalige Push-Benachrichtigungen. Klicken Sie entweder auf Send message in Campaigns → Wallet Passes → Apple Wallet, oder gehen Sie zu Campaigns → One-Time Messages und klicken Sie auf Send message → One-time push.

2. Im Schritt Content schreiben Sie die Nachricht oder wählen Sie ein Preset aus.

3. Im Schritt Audience legen Sie fest, wer die Nachricht erhält. Die Standardeinstellung hängt davon ab, wo Sie den Composer geöffnet haben:

   • Von „Send message“ auf einem Pass: Send to specific users ist ausgewählt, und Recipients (User IDs) listet bereits die User ID dieses Pass-Inhabers auf. Senden Sie die Nachricht wie sie ist, um diesen einen Inhaber zu erreichen, oder ändern Sie die Zielgruppe:
     • Fügen Sie weitere User IDs in Recipients (User IDs) hinzu
     • Wechseln Sie zu Send to segment
     • Wählen Sie Send to all subscribers
   • Von „One-Time Messages“: Legen Sie die Zielgruppe wie bei einer regulären einmaligen Push-Benachrichtigung fest: Send to specific users, Send to segment oder Send to all subscribers.

4. Wählen Sie unter Target platforms die Option Apple Wallet.
5. Senden oder planen Sie die Nachricht.

Hinweis

Wenn Sie ein Segment ansprechen, erfolgt die Zustellung an Benutzer in diesem Segment, die die Apple Wallet-Plattform registriert haben, nicht an jeden, der einen bestimmten Pass gespeichert hat.

Senden eines Pass-Updates

Das Bearbeiten und Speichern eines Passes signiert ihn erneut und benachrichtigt jedes Gerät, das ihn hinzugefügt hat. iOS ruft die neue Version im Hintergrund ab. Um Inhaber über eine bestimmte Änderung zu informieren, legen Sie eine Änderungsnachricht für das Feld fest, damit iOS sie auf dem Sperrbildschirm anzeigt.

1. Suchen Sie in Campaigns → Wallet Passes → Apple Wallet den Pass und klicken Sie im Aktionsmenü auf Edit.
2. Ändern Sie die benötigten Felder und fügen Sie eine Änderungsnachricht zu jedem Feld hinzu, über das die Inhaber benachrichtigt werden sollen.
3. Klicken Sie auf Save.

Jedes Gerät, das den Pass hinzugefügt hat, erhält das Update. Felder ohne Änderungsnachricht werden stillschweigend aktualisiert.

Automatisieren von Nachrichten aus einer Customer Journey

Senden Sie Nachrichten automatisch basierend auf Events oder Segmenten.

Trigger-basierter Journey-Einstieg

Hilfe von Entwicklern erforderlich

Das Senden von benutzerdefinierten Events erfordert, dass Ihr Entwicklerteam den postEvent API-Aufruf in Ihr Backend oder CRM integriert. Teilen Sie diesen Abschnitt mit ihnen.

1. Erstellen Sie eine Customer Journey und fügen Sie einen Trigger-based entry hinzu.
2. Wählen Sie das Event aus, das die Journey starten soll. Erstellen Sie zuerst ein benutzerdefiniertes Event im Control Panel, falls Sie dies noch nicht getan haben, zum Beispiel RewardAvailable.
3. Fügen Sie ein Push-Element hinzu und konfigurieren Sie es. Aktivieren Sie Send by User ID, damit die Push-Benachrichtigung jedes mit dem Benutzer verknüpfte Gerät erreicht, einschließlich des gespeicherten Passes.
4. Schließen Sie die Konfiguration ab und aktivieren Sie die Journey.

Wenn das Einstiegs-Event ausgelöst wird, sendet Pushwoosh die Push-Benachrichtigung an jedes mit dem Benutzer verknüpfte Gerät. Pass-Inhaber erhalten sie als Nachricht auf dem Sperrbildschirm des Passes. Benutzer ohne Apple Wallet-Pass erhalten sie auf ihren anderen Geräten.

Pass-Inhalt

Die Push-Benachrichtigung ändert keine Pass-Felder. Um den Pass-Inhalt zusammen mit der Nachricht zu aktualisieren, zum Beispiel einen Punktestand, aktualisieren Sie den Pass separat über Edit in Alle Pässe oder über die PassKit-API.

Beispiel: Einen Benutzer benachrichtigen, dass eine Belohnung verfügbar ist

POST https://api.pushwoosh.com/json/1.3/postEvent

{
  "request": {
    "application": "XXXXX-XXXXX",
    "userId": "u12345",
    "event": "RewardAvailable",
    "attributes": {
      "reward": "Free coffee",
      "expires": "2026-07-01"
    }
  }
}

Der event-Name muss mit einem in Ihrem Control Panel erstellten Event übereinstimmen.

Andere Möglichkeiten, die Journey zu erstellen

Der oben beschriebene trigger-basierte Ablauf ist eine Option. Je nachdem, was die Journey starten soll, wählen Sie ein anderes Einstiegselement:

• Audience-based entry: Starten Sie die Journey für ein ganzes Segment anstelle eines einzelnen Events. Führen Sie sie einmalig, nach einem Zeitplan oder periodisch aus (zum Beispiel jede Woche für alle, die einen aktiven Pass besitzen), wobei neue Benutzer eintreten, sobald sie dem Segment beitreten.
• API-based entry: Starten Sie die Journey von einem Geschäftsereignis aus, das außerhalb der App stattfindet, wie z. B. eine Flugverspätung oder eine Gate-Änderung. Ihr externes System ruft die Anfragevorlage des Einstiegselements auf und übergibt einen Filter, um die richtigen Benutzer anzusprechen, zum Beispiel alle, die bei der Ausstellung des Passes ein Tag flightNumber = SU1234 gesetzt haben. Eine gute Lösung für Bordkarten und Veranstaltungstickets.

Benachrichtigen von Inhabern eines bestimmten Passes per API

Um jeden zu benachrichtigen, der einen bestimmten Pass gespeichert hat, rufen Sie Einen Pass aktualisieren auf. Dadurch wird der Pass aktualisiert und die Geräte werden benachrichtigt.

Einen Pass aktualisieren