Wallet-Pass-Kampagnen erstellen

Eine Wallet-Pass-Kampagne ermöglicht es Ihnen, eine einzige Apple-Wallet- oder Google-Wallet-Pass-Vorlage zu entwerfen, diese an mehrere Benutzer auszugeben und Aktualisierungen zentral zu verwalten.

Sie wählen aus, welche Felder Gemeinsam sind (Änderungen werden gleichzeitig mit allen Geräten der Benutzer synchronisiert) und welche Persönlich sind (einzigartige Werte wie Namen, Barcodes oder Guthaben für jeden Benutzer bleiben erhalten).

Hinweis

Eine Wallet-Pass-Kampagne steht in keinem Zusammenhang mit einer Customer-Journey-Kampagne oder einer Push-Benachrichtigung. Es ist ein Werkzeug zur Verwaltung von Pass-Vorlagen, deren Ausgabe und Echtzeit-Aktualisierungen von Pässen.

Was Sie mit Wallet-Pass-Kampagnen tun können

• Entwerfen Sie einen Pass in einer Kampagne, anstatt jeden Pass manuell im Pass-Builder für Apple Wallet oder Google Wallet einzurichten.
• Wählen Sie aus, welche Felder überall aktualisiert werden (gemeinsam) und welche pro Pass erhalten bleiben (persönlich).
• Sehen Sie, wie viele ausgegebene Pässe eine Feldänderung betrifft, bevor Sie sie speichern.
• Überschreiben Sie ein gemeinsames Feld bei einem Pass und geben Sie die Kontrolle später wieder an die Kampagne zurück.
• Hängen Sie Pässe an, die außerhalb einer Kampagne ausgegeben wurden, damit sie deren gemeinsamen Feldern folgen.
• Verfolgen Sie Kampagnenrevisionen und den Zustellstatus jeder Aktualisierung.

Voraussetzungen

Eine Kampagne verwendet dieselbe einmalige Einrichtung wie ein eigenständiger Pass:

Apple Wallet:

• Aktive Mitgliedschaft im Apple Developer Program
• iOS-Plattform, die mit der Anwendung verbunden ist
• Pass-Signaturzertifikat, das in Pushwoosh hochgeladen wurde

Google Wallet:

• Aktives Ausstellerkonto in der Google Pay & Wallet Console
• Google Wallet für die Anwendung konfiguriert (Aussteller-ID und Google Cloud-Dienstkontoschlüssel)

Eine Kampagne erstellen

Um mit der Erstellung einer Kampagne zu beginnen, gehen Sie zu Kampagnen → Wallet Passes → Kampagnen und klicken Sie auf Kampagne erstellen.

Kampagnendetails und Plattform festlegen

• Plattform: Wählen Sie oben auf der Seite Apple Wallet oder Google Wallet aus. Diese Wahl ist für die Kampagne endgültig.
• Kampagne: Geben Sie einen Namen und eine optionale Beschreibung für Ihre interne Referenz ein. Beides erscheint nicht auf dem Pass.
• Pass-Format: Wählen Sie unter Pass-Stil (Apple) oder Pass-Typ (Google) das Layout für Ihren Pass:
  • Apple Wallet: Boarding Pass, Coupon, Event Ticket, Store Card, Generic. Siehe Einen Pass-Stil auswählen.
  • Google Wallet: Generic, Offer, Loyalty card, Event ticket, Gift card, Flight, Transit. Dies kann nach der Erstellung nicht mehr geändert werden. Siehe Einen Pass-Typ auswählen.

Pass-Design und Branding konfigurieren

Konfigurieren Sie die Standardabschnitte des Passes:

• Grundlegende Informationen, Farben und Barcode: Legen Sie den Titel des Passes, die Hintergrund- und Textfarben sowie den Barcode-Typ fest. Detaillierte Anleitungen zu jedem Abschnitt finden Sie unter Pässe im Apple-Wallet-Pass-Builder entwerfen oder Google-Wallet-Pässe im Pass-Builder entwerfen.
• Pass-Felder: Fügen Sie die Felder hinzu, die auf der Karte erscheinen sollen (siehe Apple-Wallet-Pass-Felder oder Google-Wallet-Felder und -Details).
• Ablauf: Legen Sie relevante Daten und Ablaufregeln fest (siehe Apple-Wallet-Ablauf oder Google-Wallet-Ablauf).
• Standorte: Legen Sie standortbasierte Relevanz fest (siehe Apple-Wallet-Standorte oder Google-Wallet-Standorte).

Tipp

Verwenden Sie bei Google Wallet Wer den Pass speichern kann, um zu steuern, ob der Pass an ein einzelnes Google-Konto, ein einzelnes Gerät gebunden ist oder für jeden mit dem Link zugänglich ist.

Gemeinsame und persönliche Felder festlegen

Konfigurieren Sie im Abschnitt Gemeinsame und persönliche Felder, welche Felder global über alle Pässe hinweg aktualisiert werden und welche einzigartige Werte pro Benutzer behalten. Dies steuert, was passiert, wenn Sie die Kampagne später bearbeiten: Gemeinsame Felder werden auf jedem ausgegebenen Pass aktualisiert, während persönliche Felder unverändert bleiben.

Aktivieren Sie den Schalter Persönlich für jedes Feld, das einzigartige Werte pro Benutzer enthalten soll.

Feldtyp	Verhalten	Beispiele
Gemeinsam	Von der Kampagne gesteuert. Die Aktualisierung dieses Feldes synchronisiert den neuen Wert mit jedem Pass auf den Geräten der Benutzer.	Veranstaltungsdatum, Gate-Nummer, Geschäftsadresse, Rabattprozentsatz
Persönlich	Einzigartig pro Benutzer. Die Kampagne überschreibt diese Werte bei einer Aktualisierung nicht.	Benutzername, Sitzplatznummer, Mitglieds-ID, Punktestand

Der Wert eines persönlichen Feldes kann einen Tag-Platzhalter enthalten, {tag} oder {tag|format|fallback} (zum Beispiel {Seat}). Pushwoosh füllt diesen aus dem Tag des Empfängers, wenn der Pass bereitgestellt wird. Wenn der Empfänger keinen Wert für diesen Tag hat, verwendet Pushwoosh den Fallback-Wert aus dem Platzhalter oder lässt das Feld leer, wenn der Platzhalter keinen hat.

• Nur der Tag, sonst nichts, wie {Seat}: Das Feld erscheint nicht im Dialog Pass ausgeben.
• Der Tag gemischt mit anderem Text, wie Sitz {Seat}, oder gar kein Tag: Das Feld erscheint als bearbeitbares Eingabefeld im Dialog Pass ausgeben, vorausgefüllt mit diesem Wert. Jeder Tag darin wird weiterhin pro Empfänger aufgelöst, wenn Pushwoosh den Pass bereitstellt.

Tipp

Der Barcode eines Passes wird im Abschnitt Barcode konfiguriert und personalisiert. Details finden Sie unter Apple-Wallet-Barcode oder Google-Wallet-Barcode.

Kampagnenbilder hochladen

1. Klicken Sie im Abschnitt Kampagnenbilder neben einem Bild-Slot auf Bild auswählen.
2. Wählen Sie ein vorhandenes Bild aus Ihrer Mediathek aus oder ziehen Sie eine neue Datei per Drag-and-Drop, um sie hochzuladen.
3. Wiederholen Sie dies für jeden verfügbaren Bild-Slot:
   • Apple Wallet: Icon, Logo, Background, Footer, Strip und Thumbnail (siehe Apple-Wallet-Bilder).
   • Google Wallet: Logo und Hero-Bild.

Hinweis

• Bilder müssen unter 10 MB und 25 Megapixel groß sein.
• Apple Wallet: Im Gegensatz zu einem eigenständigen Pass, bei dem Bilder nach der Erstellung gesperrt sind, erreicht eine Aktualisierung eines Kampagnenbildes jeden ausgegebenen Pass.
• Google Wallet: Bei einem eigenständigen Pass können Sie das Logo und das Hero-Bild bereits jederzeit über Bearbeiten ändern. Ein Kampagnenbild funktioniert auf die gleiche Weise, nur dass eine Bearbeitung jeden ausgegebenen Pass auf einmal erreicht anstatt nur einen.

Vorschau anzeigen und Kampagne erstellen

1. Überprüfen Sie das Panel Vorschau als Benutzer auf der rechten Seite, um zu sehen, wie die Karte aussieht. Sie können eine Test-User-ID eingeben, um personalisierte Felder in der Vorschau anzuzeigen.

Tipp

Klicken Sie auf Pass validieren, um das Design vor dem Speichern mit den Anforderungen von Apple oder Google zu überprüfen, ohne die Kampagne bereits zu erstellen.

2. Klicken Sie unten auf der Seite auf Kampagne erstellen.

Pushwoosh erstellt die Kampagne im Status Entwurf und öffnet ihren Arbeitsbereich mit den Registerkarten Design, Pässe und Verlauf.

Hinweis

Das Erstellen einer Kampagne speichert nur das Pass-Design und sendet keine Pässe an Benutzer. Um Pässe an Ihr Publikum zu verteilen, fahren Sie mit Pässe an Benutzer ausgeben fort.

Pässe an Benutzer ausgeben

Einen Pass aus der Kampagne ausgeben

1. Klicken Sie auf der Registerkarte Pässe auf Pass ausgeben.
2. Geben Sie die Pushwoosh-User ID des Empfängers ein.

3. Klicken Sie zur Bestätigung auf Pass ausgeben.

Je nachdem, wie Sie Persönliche Felder konfiguriert haben, behandelt der Dialog diese wie folgt:

• Bearbeitbare Felder: erscheinen mit Standardwerten, die Sie für diesen Benutzer ändern können.
• Tag-Platzhalter (wie {Seat}): erscheinen nicht im Dialog. Pushwoosh füllt sie automatisch aus den Tags des Benutzers.

Sie können auch jedes persönliche Feld bei einem einzelnen Pass jederzeit nach der Ausgabe bearbeiten.

Pushwoosh generiert den Pass aus dem aktuellen Design der Kampagne und listet ihn auf der Registerkarte Pässe und in der Tabelle Alle Pässe der Anwendung auf (Apple Wallet oder Google Wallet).

Den Pass an den Empfänger zustellen

Das Ausgeben eines Passes erstellt den Pass-Datensatz in Pushwoosh. Um ihn an das Gerät des Benutzers zu liefern, teilen Sie den Installationslink:

1. Öffnen Sie das Aktionsmenü des Passes auf der Registerkarte Pässe oder in Alle Pässe.
2. Wählen Sie Installationslink kopieren oder QR-Code. Apple-Wallet-Pässe bieten auch Herunterladen für die signierte .pkpass-Datei an.
3. Senden Sie den Link oder die Datei über Push, E-Mail, SMS oder eine Customer Journey an den Empfänger. Um einen Pass auszugeben und seinen Link automatisch zu liefern, während Reisende eine Journey durchlaufen, verwenden Sie das Element Wallet Pass ausgeben, anstatt ihn hier auszugeben.

Weitere Möglichkeiten zur Verteilung von Pässen finden Sie unter Apple-Wallet-Pässe teilen oder Google-Wallet-Pässe teilen.

Einen vorhandenen Pass an eine Kampagne anhängen

Sie können eigenständige Pässe (die außerhalb einer Kampagne erstellt wurden) an eine Kampagne anhängen, damit sie gemeinsame Aktualisierungen erhalten.

1. Klicken Sie auf der Registerkarte Pässe auf Pässe anhängen.
2. Suchen Sie nach Pässen über die User ID, Seriennummer oder den Barcode.
3. Wählen Sie die Pässe aus und bestätigen Sie.

Einmal angehängt:

• Gemeinsame Felder folgen der Kampagne und werden aktualisiert, wann immer Sie die Pass-Vorlage ändern.
• Persönliche Werte, die bereits auf dem Pass vorhanden sind (wie Benutzerdetails oder einzigartige Guthaben), bleiben erhalten.

Pässe über API anhängen

Sie können Pässe auch programmgesteuert mit der API-Methode AttachPasses anhängen (bis zu 500 Seriennummern pro Anfrage).

Wenn ein Pass nicht angehängt werden kann, gibt die API den spezifischen Grund für diese Seriennummer zurück:

• Der Pass ist bereits einer anderen Kampagne zugewiesen.
• Der Pass-Stil stimmt nicht mit dem Format der Kampagne überein.
• Dem Pass fehlen erforderliche Kampagnenfelder.
• Die Seriennummer existiert nicht oder gehört zu einer anderen Plattform.

Eine bestehende Kampagne verwalten

Wenn Sie eine erstellte Kampagne unter Kampagnen → Wallet Passes → Kampagnen öffnen, werden ihr Status, der Revisionszähler, eine Live-Pass-Vorschau und drei Hauptregisterkarten angezeigt: Design, Pässe und Verlauf.

Den Kampagnenstatus ändern

Verwenden Sie den Status, um zu verfolgen, wo jede Kampagne steht: noch im Design, aktiv Pässe ausgebend oder fertig und archiviert.

Um den Status zu ändern, wählen Sie eine Option aus dem Status-Dropdown im Kampagnen-Header. Die Änderung wird sofort ohne einen separaten Bestätigungsschritt gespeichert:

• Entwurf oder Aktiv: ermöglicht es Ihnen, neue Pässe auszugeben, bestehende anzuhängen und Design-Aktualisierungen zu pushen.
• Archiviert: pausiert die Ausgabe neuer Pässe. Sie können keine Pässe ausgeben oder anhängen, während die Kampagne archiviert ist, aber bereits ausgegebene Pässe funktionieren weiterhin und erhalten gemeinsame Aktualisierungen.

Registerkarte ‘Design’

Auf der Registerkarte Design können Sie die Pass-Vorlage aktualisieren, Farben ändern, gemeinsame und persönliche Felder modifizieren oder neue Kampagnenbilder hochladen.

Design aktualisieren und Änderungen an Pässe pushen

Wenn Sie eines der folgenden Elemente bearbeiten und auf Änderungen speichern klicken, wird ein Bestätigungsdialog angezeigt, der zeigt, wie viele ausgegebene Pässe aktualisiert werden:

• Grundlegende Informationen, Farben oder Barcode-Typ
• Ablauf oder Standorte
• Ein gemeinsames Feld
• Ein Kampagnenbild

Bestätigen Sie die Aktualisierung:

• Wenn keine Pässe Überschreibungen haben: Klicken Sie auf Aktualisieren, um die Änderungen an alle ausgegebenen Pässe zu pushen.
• Wenn einige Pässe Überschreibungen haben: Wählen Sie, ob nur Standard-Pässe aktualisiert werden sollen (wobei Benutzerüberschreibungen erhalten bleiben) oder ob alle Pässe überschrieben werden sollen.

Die Bestätigung der Aktualisierung erhöht den Revisionszähler der Kampagne (zum Beispiel auf Revision 2) und synchronisiert die Änderungen automatisch mit den Geräten der Benutzer.

Hinweis

Eine Bearbeitung, die vorgenommen wird, wenn noch keine Pässe ausgegeben wurden, wird sofort ohne Bestätigungsdialog gespeichert, da es keine bestehenden Pässe gibt, die aktualisiert werden müssen.

Ein gemeinsames Feld bei einem einzelnen Pass überschreiben

Wenn Sie ein gemeinsames Feld für einen bestimmten Benutzer anpassen müssen, bearbeiten Sie dieses Feld direkt auf dessen individuellem Pass (von der Registerkarte Pässe oder Alle Pässe):

• Eine Überschreibung erstellen: Das Speichern eines benutzerdefinierten Werts auf einem einzelnen Pass entkoppelt dieses Feld von kampagnenweiten Aktualisierungen. Zukünftige Aktualisierungen der Kampagne werden diesen Pass für dieses spezifische Feld überspringen.
• Eine Überschreibung entfernen: Um die Kontrolle durch die Kampagne wiederherzustellen, bearbeiten Sie den Pass und klicken Sie neben dem überschriebenen Feld auf Kampagnenwert verwenden.

Sie können auf der Registerkarte Pässe unter der Spalte Überschreibungen verfolgen, welche Pässe angepasste Werte haben.

Registerkarte ‘Pässe’

Die Registerkarte Pässe listet jeden von der Kampagne ausgegebenen Pass auf, einschließlich seiner Seriennummer, der User ID des Empfängers, aktiver Überschreibungen, der aktuellen Revision und des letzten Aktualisierungsdatums.

Verwenden Sie Tabellenfilter, um bestimmte Pässe zu finden:

• Mit Überschreibungen: zeigt Pässe an, die mindestens ein benutzerdefiniertes Feld haben.
• Hinter der Revision zurück: zeigt Pässe an, die das letzte Kampagnen-Update noch nicht erhalten haben.

Um neue Pässe auszugeben oder bestehende anzuhängen, siehe Pässe an Benutzer ausgeben.

Öffnen Sie das Aktionsmenü einer Zeile (⋮), um diesen Pass zu verwalten:

• Bearbeiten: Öffnen Sie den Pass auf der Bearbeitungsseite seiner Plattform, um persönliche Felder zu ändern oder ein gemeinsames zu überschreiben.
• Herunterladen: Bei Apple-Wallet-Kampagnen laden Sie die signierte .pkpass-Datei herunter. Google-Wallet-Kampagnen zeigen diese Option nicht an, da es bei Google Wallet kein herunterladbares Dateiformat gibt.
• Nachricht senden: Öffnen Sie den Composer für einmalige Push-Nachrichten, um dem Empfänger des Passes per User ID eine Nachricht zu senden. Siehe Wallet-Pass-Inhaber benachrichtigen für alle Möglichkeiten, sie zu erreichen.
• QR-Code: Zeigen Sie einen Installations-QR-Code an, den Benutzer scannen können, um den Pass hinzuzufügen und ihr Gerät für Updates zu registrieren.
• Installationslink kopieren: Kopieren Sie die Installations-URL, um den Pass in Ihren Messaging-Kanälen zu teilen.
• Löschen: Entfernen Sie den Pass. Dies kann nicht rückgängig gemacht werden. Bei Apple Wallet hören bereits installierte Kopien auf, Updates zu erhalten und werden bei ihrer nächsten Aktualisierung ungültig. Bei Google Wallet erlaubt Google nicht, einen bereits auf einem Gerät gespeicherten Pass zwangsweise zu entfernen, daher wird er ungültig und in die Abgelaufenen Pässe des Benutzers verschoben, während Pushwoosh seinen Datensatz entfernt. Das Löschen eines Passes hier löscht nicht die Kampagne oder einen anderen ausgegebenen Pass.

Registerkarte ‘Verlauf’

Die Registerkarte Verlauf listet alle Revisionen der Kampagne in chronologischer Reihenfolge auf und zeigt, welche Felder in jeder Version geändert wurden.

Der Zustellstatus des letzten Updates erscheint unter den Registerkarten:

• Abbrechen: Stoppt das Senden des Updates an Pässe, die es noch nicht erreicht hat. Diese Pässe bleiben auf ihrer vorherigen Revision.
• Fehlgeschlagene erneut versuchen: Versucht die Zustellung für Pässe, deren Aktualisierung fehlgeschlagen ist (nach 5 Versuchen als fehlgeschlagen markiert), erneut.

Sobald eine neue Revision gespeichert ist, können ältere Updates nicht mehr erneut versucht oder abgebrochen werden.

Eine Kampagne löschen

Öffnen Sie die Kampagne und klicken Sie oben rechts auf der Seite auf Kampagne löschen.

Das Löschen einer Kampagne löscht oder entwertet bereits ausgegebene Pässe nicht. Ausgegebene Pässe behalten ihren aktuellen Inhalt und ihre Bilder, erhalten aber keine gemeinsamen Updates mehr. Zukünftige Änderungen müssen bei jedem Pass einzeln vorgenommen werden.