Skip to content
Hilfecenter-Anleitung · Wallet-Updates & BenachrichtigungenOnboarding-Phase 6
3 Min. LesezeitGeprüft 2026-11-16

Geplante Updates & Kampagnen

Planen Sie terminierte Benachrichtigungsserien, segmentieren Sie Zielgruppen vor Events oder Abläufen und prüfen Sie Versandlogs.

In dieser Anleitung

Prüfen Sie passende Dashboard-Bereiche, Steuerelemente und Zoom-Hinweise zu diesem Thema.

Vergrößerter UI-Fokus
Wichtige UI-Elemente

Template-Aktivitätsprotokoll — Updates & Pushs (Zoom)

Bestätigen Sie, dass Template-Updates und Push-Benachrichtigungen fehlerfrei auf alle aktiven Apple- & Google-Wallet-Pässe laufen.

Überblick: Geplante Kampagnen & automatisiertes Messaging

Mit Passinstance können Teams zeitkritische Pass-Updates, Aktions-Broadcasts, CSV-gestützte Massenbenachrichtigungen sowie automatische Ablauferinnerungen im Voraus einplanen. Geplante Jobs werden in database gespeichert und über verzögerte background job queue-Worker-Queues abgearbeitet — so erfolgt der Versand über Apple APNs und die Google Wallet REST-Endpunkte zuverlässig exakt zum festgelegten Zielzeitpunkt.

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
GEPLANTE & BATCH-BENACHRICHTIGUNGS-ENGINE
STUFE 01 KAMPAGNENPLANUNG & JOB-ERFASSUNG
Geplanter Vorlagen-Push (POST/api/v1/push-notifications/templates/:id)
Gespeicherte-Suche-Kampagne (POST/api/v1/push-notifications/segmentation)
Batch- / CSV-Mitteilung (POST/api/v1/batch-notifications & /csv)
Automatisierter Lebenszyklus-Cron (Ablauf- & Verlängerungserinnerungen)
STUFE 02 ZEITZONEN-AUFLÖSUNG & VERZÖGERTE ASYNC-QUEUE
1
Zielausführungszeit über resolveCustomerTimeZone (IANA-Zeitzone) auflösen
2
Batch speichern (batch notification status: SCHEDULED)
3
Verzögerten background job queue-Job einreihen (delay = scheduledAt - now())
Zum publicationDate-Zeitpunkt
STUFE 03 WORKER-VERTEILUNG & WALLET-PROPAGATIONS-PIPELINE
1
Berechtigte ACTIVE-Pässe mit aktiven APNs-/Google-Registrierungen abfragen
2
Benachrichtigungsfeld aktualisieren & Pass-Revision hochzählen
3
Stille APNs-HTTP/2-Pushs & Google-Wallet-walletobjects-Patches versenden
4
Einzelergebnisse erfassen (SUCCESSFUL, FAILED, CANCELLED-Status)

Kampagnen im Voraus planen

Nutzen Sie Stapelbenachrichtigungen (Batch Notifications) (/batch-notifications unter Stapelverarbeitung in der Dashboard-Seitenleiste) oder die REST-API, um künftige Pass-Updates sauber einzuplanen:

  1. 1
    Zielgruppe auswählen (mode): Adressieren Sie in request payload ausgewählte Pässe (manual), gespeicherte Segmente/Suchen (filter / segment), alle berechtigten Pässe (all) oder laden Sie eine CSV-Datei mit serialNumber-/externalId-Datensätzen hoch (csv über /api/v1/batch-notifications/csv).
  2. 2
    Nachricht verfassen: Übergeben Sie message (<=200 Zeichen bei Stapelbenachrichtigungen inklusive {attributeKey}-Platzhaltern bzw. <=85 Zeichen im Push Notifications API).
  3. 3
    Datum, Uhrzeit & Zeitzone festlegen: Geben Sie publicationDate (YYYY-MM-DD HH:mm oder ISO 8601) an, aufgelöst in der IANA-Zeitzone Ihres Workspaces. Solange der Batch im Status SCHEDULED verbleibt (batch notification status: SCHEDULED, PROCESSING, SUCCESSFUL, FAILED, CANCELLED), können Sie ihn bearbeiten (PATCH), sofort auslösen (POST /:batchId/send-now), erneut versuchen (POST /:batchId/retry) oder abbrechen (DELETE).
  4. 4
    Ausführung & Audit-Protokolle prüfen: Verfolgen Sie den Fortschritt und exportieren Sie zeilenweise Fehler über GET /api/v1/batch-notifications/:batchId/errors.csv.

Wichtig: Nur installierte Pässe mit mindestens einer aktiven Apple-Wallet-Geräteregistrierung (deviceLibraryIdentifier) oder einem aktiven Google-Wallet-Objekt können Sperrbildschirm-Push-Benachrichtigungen anzeigen. Prüfen Sie vor der Planung die Aktiven Geräteregistrierungen in den Analysen.

API-Endpunkte für geplante & Stapelbenachrichtigungen

MethodeEndpunkt-PfadControllerBeschreibung
POST/api/v1/push-notifications/templates/:idPush Notifications APIPlant eine Push-Benachrichtigung (request payload) über eine Vorlage (optional mit segmentIds / savedSearchIds).
POST/api/v1/push-notifications/templates/:id/sendPush Notifications APISendet sofort eine Vorlagen-Push-Benachrichtigung (request payload).
POST/api/v1/push-notifications/segmentationPush Notifications APISendet sofort eine Benachrichtigung an eine gespeicherte Suche (request payload).
POST/api/v1/batch-notificationsBatch Notifications APIErstellt eine geplante Stapelbenachrichtigung (request payload: `manual \filter \csv \all \segment`).
GET/api/v1/batch-notifications/:batchIdBatch Notifications APIRuft den Ausführungsfortschritt (SCHEDULED, PROCESSING, SUCCESSFUL, CANCELLED, FAILED) und Telemetriedaten ab.
DELETE/api/v1/batch-notifications/:batchIdBatch Notifications APIBricht einen noch ausstehenden SCHEDULED-Stapelbenachrichtigungsjob vor dem Versand ab.

Beispiel: Geplante Stapelbenachrichtigung anlegen (request payload)

JSON
POST /api/v1/batch-notifications
{
  "name": "Winter Flash Sale Push",
  "message": "Hi {firstName}, enjoy 25% off today with your {memberTier} card!",
  "publicationDate": "2026-11-20 17:00",
  "mode": "filter",
  "filters": {
    "templateId": "7b9e4c12-3f81-4a90-b8d2-19c48a70e112",
    "segmentIds": ["seg_vip_tier_01"]
  }
}

Antwort (201 Created):

JSON
{
  "id": "bn_8831a9c0",
  "status": "SCHEDULED",
  "publicationDate": "2026-11-20T16:00:00.000Z"
}

Automatisierte Ablauf- & Event-Countdown-Erinnerungen

Zusätzlich zu manuellen und CSV-geplanten Kampagnen lassen sich unter Workflows & Automation zeitbasierte Auslöser einrichten:

  • Vor-Ablauf-Erinnerungen: Aktualisieren Sie automatisch ein Hinweisfeld (z. B. "Ihr Pass läuft in 3 Tagen ab — tippen zum Verlängern"), N Tage vor dem expirationDate eines Passes.
  • Event-Check-in-Countdowns: Kombinieren Sie das automatische Einblenden über RelevantDate mit einem 24 Stunden vor Veranstaltungsbeginn geplanten Push zur Bestätigung von Eingang, Sitzplatz oder Parkhinweisen.

Erfahren Sie mehr unter Push-Benachrichtigungen, Workflow-Konfiguration und Verteilungs- & Interaktionsanalysen.

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.