Wallet-Pass-Kampagnen erstellen

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

Sie wählen aus, welche Felder Gemeinsam sind (Änderungen werden gleichzeitig auf alle Benutzergeräte 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-Pass-Aktualisierungen.

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

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

Voraussetzungen

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

Apple Wallet:

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

Google Wallet:

• Aktives Google Pay & Wallet Console-Ausstellerkonto
• Google Wallet für die Anwendung konfiguriert (Issuer ID und Google Cloud Service Account Key)

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 dauerhaft.
• Kampagne: Geben Sie einen Namen und eine optionale Beschreibung für Ihre interne Referenz ein. Keines von beiden erscheint 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 wä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 wählen.

Pass-Design und Branding konfigurieren

Konfigurieren Sie die Standardbereiche des Passes:

• Grundlegende Informationen, Farben und Barcode: Legen Sie den Pass-Titel, 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 für Google Wallet die Option 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

Im Abschnitt Gemeinsame und persönliche Felder konfigurieren Sie, 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	Gesteuert durch die Kampagne. Die Aktualisierung dieses Feldes synchronisiert den neuen Wert auf jeden 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 aus, wenn der Pass bereitgestellt wird. Wenn der Empfänger keinen Wert für diesen Tag hat, verwendet Pushwoosh den Fallback 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. Siehe Apple Wallet-Barcode oder Google Wallet-Barcode für Details.

Kampagnenbilder hochladen

1. Klicken Sie im Abschnitt Kampagnenbilder neben einem Bild-Slot auf Bild auswählen.
2. Wählen Sie ein vorhandenes Bild aus Ihrem Media Store aus oder ziehen Sie eine neue Datei per Drag & 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 groß und 25 Megapixel 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: Ein eigenständiger Pass ermöglicht es Ihnen bereits, sein Logo und Hero-Bild jederzeit über Bearbeiten zu ändern. Ein Kampagnenbild funktioniert auf die gleiche Weise, außer 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-Benutzer-ID eingeben, um personalisierte Felder in der Vorschau anzuzeigen.

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

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

Hinweis

Das Erstellen einer Kampagne speichert nur das Pass-Design und sendet keine Pässe an die 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 dem Tab Pässe auf Pass ausgeben.
2. Geben Sie die Pushwoosh-Benutzer-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 auf einem einzelnen Pass jederzeit nach der Ausgabe bearbeiten.

Pushwoosh generiert den Pass aus dem aktuellen Design der Kampagne und listet ihn auf dem Pässe-Tab 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 dem Pässe-Tab 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 an den Empfänger per Push, E-Mail, SMS oder über eine Customer Journey.

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 (außerhalb einer Kampagne erstellt) an eine Kampagne anhängen, damit sie gemeinsame Aktualisierungen erhalten.

1. Klicken Sie auf dem Tab Pässe auf Pässe anhängen.
2. Suchen Sie nach Pässen nach Benutzer-ID, Seriennummer oder 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 AttachPasses-API-Methode 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 zugeordnet.
• 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 Haupt-Tabs angezeigt: Design, Pässe und Verlauf.

Den Kampagnenstatus ändern

Verwenden Sie den Status, um zu verfolgen, wo jede Kampagne steht: noch im Entwurf, aktiv Pässe ausgebend oder abgeschlossen 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-Updates 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 Updates.

Design-Tab

Auf dem Design-Tab 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 ein gemeinsames Feld bearbeiten oder ein Kampagnenbild ersetzen und auf Änderungen speichern klicken, zeigt Pushwoosh einen Bestätigungsdialog an, der anzeigt, wie viele ausgegebene Pässe aktualisiert werden.

• 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 Standardpä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

Änderungen an grundlegenden Pass-Informationen, wie Farben oder dem Barcode-Typ, und Änderungen, die vorgenommen werden, wenn noch keine Pässe ausgegeben wurden, werden sofort ohne Bestätigungsdialog gespeichert. Eine Änderung der grundlegenden Informationen gilt für Pässe, die von nun an ausgegeben werden. Um sie an bereits bei Benutzern befindliche Pässe zu pushen, bearbeiten Sie ein gemeinsames Feld oder ein Bild und bestätigen Sie die Aktualisierung.

Ein gemeinsames Feld auf 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 (vom Pässe-Tab oder Alle Pässe):

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

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

Pässe-Tab

Der Pässe-Tab listet jeden von der Kampagne ausgegebenen Pass auf, einschließlich seiner Seriennummer, der Empfänger-Benutzer-ID, 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: 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.

Verlauf-Tab

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

Der Lieferstatus des letzten Updates erscheint unter den Tabs:

• 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 Update 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 auf jedem Pass einzeln vorgenommen werden.