Wallet-Pass-Kampagnen erstellen

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

Sie wählen, welche Felder Geteilt 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 hat nichts mit einer Customer-Journey-Kampagne oder einer Push-Benachrichtigung zu tun. 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 (geteilt) 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 geteiltes 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 geteilten Feldern der Kampagne folgen.
• Verfolgen Sie Kampagnenrevisionen und den Zustellstatus jeder Aktualisierung.
• Aktualisieren Sie einen Pass automatisch, wann immer sich der Tag hinter einem seiner Felder ändert, ohne die Kampagne zu bearbeiten.

Voraussetzungen

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

Apple Wallet:

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

Google Wallet:

• Aktives Ausstellerkonto in der Google Pay & Wallet Console
• 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 Campaigns → Wallet Passes → Campaigns und klicken Sie auf Create campaign.

Kampagnendetails und Plattform festlegen

• Plattform: Wählen Sie oben auf der Seite Apple Wallet oder Google Wallet. 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 Style (Apple) oder Pass Type (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 Standardabschnitte des Passes:

• Grundlegende Informationen, Farben und Barcode: Legen Sie den Titel des Passes, 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).
• Ablaufdatum: Legen Sie relevante Daten und Ablaufregeln fest (siehe Apple Wallet Ablaufdatum oder Google Wallet Ablaufdatum).
• Standorte: Legen Sie standortbasierte Relevanz fest (siehe Apple Wallet Standorte oder Google Wallet Standorte).

Tipp

Verwenden Sie bei Google Wallet Who can save the pass, um zu steuern, ob der Pass an ein einzelnes Google-Konto, ein einzelnes Gerät gebunden oder für jeden mit dem Link zugänglich ist.

Geteilte und persönliche Felder festlegen

Im Abschnitt Shared and personal fields 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: geteilte Felder werden auf jedem ausgegebenen Pass aktualisiert, während persönliche Felder unverändert bleiben.

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

Feldtyp	Verhalten	Beispiele
Geteilt	Wird von der Kampagne gesteuert. Eine 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 Issue pass.
• Der Tag gemischt mit anderem Text, wie Seat {Seat}, oder gar kein Tag: Das Feld erscheint als bearbeitbares Eingabefeld im Dialog Issue pass, vorausgefüllt mit diesem Wert. Jeder Tag darin wird beim Bereitstellen des Passes durch Pushwoosh immer noch pro Empfänger aufgelöst.

Tipp

Der Barcode eines Passes wird im Abschnitt Barcode konfiguriert und personalisiert. Siehe Apple Wallet Barcode oder Google Wallet Barcode für Details.

Tag-Synchronisierung aktivieren

Aktivieren Sie im Abschnitt Tag sync die Option Update pass fields from tags, damit Pushwoosh regelmäßig die in den Feldern der Kampagne verwendeten Tag-Platzhalter erneut überprüft und einen neuen Wert an jeden Pass pusht, dessen Tag sich geändert hat.

• Interval (minutes): Wie oft Pushwoosh die Tags erneut liest. Standard ist 60 und kann nicht unter 5 liegen. Ein Pass erhält höchstens eine Aktualisierung pro Intervall, egal wie oft sich sein Tag dazwischen ändert.
• Notification (nur Google Wallet): Wählen Sie, wie der Inhaber über die Aktualisierung informiert wird: Silently, Own message (füllen Sie Message text aus, wird mit der Aktualisierung gesendet) oder Google field notification (Googles eigene Feld-Update-Benachrichtigung). Google begrenzt diese auf 3 pro Pass pro 24 Stunden. Danach erreichen die neuen Werte den Pass weiterhin, nur ohne Benachrichtigung.

Hinweis

Apple Wallet hat keine kampagnenweite Benachrichtigung, daher erscheint diese Auswahl bei Apple-Kampagnen nicht. Der Benachrichtigungstext befindet sich auf dem Feld selbst. Füllen Sie Change message bei jedem Feld im Apple Wallet Pass-Builder aus.

Vorsicht

Die Tag-Synchronisierung wird nur ausgeführt, während der Status der Kampagne Active ist. Setzen Sie ihn auf Draft oder Archived, um geplante Überprüfungen zu pausieren, ohne den Schalter auszuschalten.

Wenn Sie die Tag-Synchronisierung für eine Kampagne aktivieren, die bereits ausgegebene Pässe hat, wird das erste Intervall nicht abgewartet. Die nächste geplante Überprüfung behandelt eine Kampagne, die noch nie synchronisiert wurde, als sofort fällig. Im Modus Own message oder Google field notification kann dies jeden Inhaber auf einmal benachrichtigen und das 3-pro-24-Stunden-Limit des Passes in einem einzigen Durchlauf aufbrauchen.

Kampagnenbilder hochladen

1. Klicken Sie im Abschnitt Campaign images neben einem Bild-Slot auf Choose an image.
2. Wählen Sie ein vorhandenes Bild aus Ihrem Medienspeicher 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 image.

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: Ein eigenständiger Pass ermöglicht es Ihnen bereits, sein Logo und Hero-Image jederzeit über Edit 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 Preview as user 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 Validate pass, um das Design vor dem Speichern mit den Anforderungen von Apple oder Google abzugleichen, ohne die Kampagne bereits zu erstellen.

2. Klicken Sie unten auf der Seite auf Create campaign.

Pushwoosh erstellt die Kampagne im Status Draft und öffnet ihren Arbeitsbereich mit den Tabs Design, Passes und History.

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 Passes auf Issue pass.
2. Geben Sie die Pushwoosh User ID des Empfängers ein.

3. Klicken Sie zur Bestätigung auf Issue pass.

Je nachdem, wie Sie Personal fields 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 Tab ‘Passes’ und in der Tabelle All passes 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 Tab Passes oder in All passes.
2. Wählen Sie Copy install link oder QR code. Apple Wallet-Pässe bieten auch Download für die signierte .pkpass-Datei an.
3. Senden Sie den Link oder die Datei per Push, E-Mail, SMS oder über 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 Issue Wallet Pass, 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 (außerhalb einer Kampagne erstellt) an eine Kampagne anhängen, damit sie geteilte Aktualisierungen erhalten.

1. Klicken Sie auf dem Tab Passes auf Attach passes.
2. Suchen Sie nach Pässen nach User ID, Seriennummer oder Barcode.
3. Wählen Sie die Pässe aus und bestätigen Sie.

Einmal angehängt:

• Geteilte 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 die API anhängen

Sie können Pässe auch programmatisch 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 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 Campaigns → Wallet Passes → Campaigns öffnen, werden ihr Status, der Revisionszähler, eine Live-Vorschau des Passes und die drei Haupt-Tabs angezeigt: Design, Passes und History.

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:

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

Tab ‘Design’

Auf dem Tab Design können Sie die Pass-Vorlage aktualisieren, Farben ändern, geteilte und persönliche Felder modifizieren, neue Kampagnenbilder hochladen oder die Einstellungen für die Tag-Synchronisierung ändern.

Design aktualisieren und Änderungen an Pässe pushen

1. Bearbeiten Sie auf dem Tab Design grundlegende Informationen, Farben, Barcode-Typ, Ablaufdatum, Standorte, ein geteiltes Feld oder ein Kampagnenbild.
2. Klicken Sie auf Save changes.
3. Bestätigen Sie im Dialog Apply the campaign edit die Aktualisierung:
   • Kein Pass überschreibt das geänderte Feld: Klicken Sie auf Update N, keep hand edits, um die Änderung an alle N Pässe zu pushen.
   • Einige Pässe überschreiben das geänderte Feld: Der Dialog nennt das Feld und wie viele Pässe es überschreiben. Klicken Sie auf Update N, keep hand edits, um die Änderung an alle Pässe außer diesen zu pushen, oder auf Overwrite all N, um sie an alle N Pässe zu pushen, einschließlich der überschriebenen. Das Überschreiben löscht die Überschreibung.

Welchen Button Sie auch klicken, die Aktualisierung wird als neue Revision gespeichert (zum Beispiel Revision 2), sodass Sie auf dem Tab ‘History’ überprüfen können, was sich wann geändert hat.

Hinweis

Eine Bearbeitung, die vorgenommen wird, wenn noch keine Pässe ausgegeben wurden, wird sofort ohne Bestätigungsdialog gespeichert, da es keine vorhandenen Pässe zum Aktualisieren gibt.

Ein geteiltes Feld auf einem einzelnen Pass überschreiben

Wenn Sie ein geteiltes Feld für einen bestimmten Benutzer anpassen müssen, bearbeiten Sie dieses Feld direkt auf dessen individuellem Pass (vom Tab Passes oder All passes):

• Eine Überschreibung erstellen: Das Speichern eines benutzerdefinierten Werts auf einem einzelnen Pass entkoppelt dieses Feld von kampagnenweiten Aktualisierungen. Zukünftige Aktualisierungen der Kampagne, einschließlich einer geplanten Tag-Synchronisierungs-Aktualisierung, überspringen diesen Pass für dieses spezifische Feld.
• Eine Überschreibung entfernen: Um die Kontrolle durch die Kampagne wiederherzustellen, bearbeiten Sie den Pass und klicken Sie neben dem überschriebenen Feld auf Use the campaign value.

Sie können auf dem Tab ‘Passes’ in der Spalte Pinned fields nachverfolgen, welche Pässe angepasste Werte haben.

Tab ‘Passes’

Der Tab Passes listet jeden von der Kampagne ausgegebenen Pass auf, einschließlich seiner Seriennummer, der Empfänger-User-ID, aktiver gepinnter Felder, der aktuellen Revision und des letzten Aktualisierungsdatums.

Wenn die Tag-Synchronisierung aktiviert ist, zeigt der Tab auch eine Zeile Tags synced über der Tabelle mit Datum und Uhrzeit des letzten geplanten Laufs an, oder not yet vor dem ersten.

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

• With pinned fields: Zeigt Pässe an, die mindestens ein benutzerdefiniertes Feld haben.
• Behind the 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.

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

• Edit: Öffnen Sie den Pass auf der Bearbeitungsseite seiner Plattform, um persönliche Felder zu ändern oder ein geteiltes zu überschreiben.
• Download: Bei Apple Wallet-Kampagnen laden Sie die signierte .pkpass-Datei herunter. Google Wallet-Kampagnen zeigen diese Option nicht an, da Google Wallet kein herunterladbares Dateiformat hat.
• Send message: Öffnen Sie den einmaligen Push-Composer, um dem Empfänger des Passes per User ID eine Nachricht zu senden. Siehe Inhaber von Wallet-Pässen 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.
• Copy install link: Kopieren Sie die Installations-URL, um den Pass in Ihren Messaging-Kanälen zu teilen.
• Delete: 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 Expired passes 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.

Tab ‘History’

Der Tab History 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 Tabs:

• Cancel: Stoppt das Senden des Updates an Pässe, die es noch nicht erreicht hat. Diese Pässe bleiben auf ihrer vorherigen Revision.
• Retry failed: Versucht die Zustellung für Pässe, bei denen die 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 Delete campaign.

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 geteilten Updates mehr. Zukünftige Änderungen müssen an jedem Pass einzeln vorgenommen werden.