Pässe im Pass-Builder entwerfen

Der Apple Wallet Pass-Builder ist ein visueller Designer im Control Panel. Sie wählen einen Pass-Stil, füllen Branding, Felder und einen Barcode aus, sehen sich eine Live-Vorschau an und generieren eine signierte .pkpass-Datei – ohne pass.json manuell schreiben zu müssen.

Einen Pass erstellen

Gehen Sie im Control Panel zu Campaigns → Apple Wallet und klicken Sie auf Pass erstellen.

Den Pass konfigurieren

• Von Grund auf: Beginnen Sie mit einem leeren Pass. Wählen Sie einen Pass-Stil und legen Sie dann Farben, Bilder, Felder, Barcode und andere Optionen in den folgenden Abschnitten selbst fest.

• Aus einer Vorlage: Klicken Sie auf Vorlage laden, wählen Sie eine integrierte Vorlage unter Vorlage auswählen aus (Bordkarte, Coupon, Veranstaltungsticket, Generisch oder Kundenkarte) und bestätigen Sie. Das Formular füllt den Pass-Stil, Farben, Bilder, Pass-Felder, Barcode und grundlegende Informationen vorab aus. Bearbeiten Sie beliebige Werte oder ändern Sie den Stil nach Bedarf. Pushwoosh ersetzt die Team- und Pass-Typ-IDs der Vorlage durch die Werte Ihrer Anwendung.

Einen Pass-Stil wählen

Wählen Sie unter PASS-STIL einen der fünf Apple Wallet Pass-Stile aus. Der Stil steuert das Layout und welche Feldbereiche und Bilder verfügbar sind:

• Bordkarte
• Coupon
• Veranstaltungsticket
• Kundenkarte
• Generisch

Wenn Sie von Grund auf neu beginnen, wählen Sie den Stil aus, bevor Sie Felder und Bilder hinzufügen. Ein Wechsel des Stils setzt stilspezifische Felder zurück.

Passnamen und Beschreibung hinzufügen

Füllen Sie unter GRUNDLEGENDE INFORMATIONEN Folgendes aus:

Passname	Der Titel des Passes und der Quellenname, der bei Update-Benachrichtigungen angezeigt wird.
Beschreibung	Eine kurze Beschreibung des Passes.
Logotext	Text, der neben dem Logo angezeigt wird (wird verwendet, wenn kein Logobild hochgeladen wurde).

Farben und Bilder festlegen

Farben

Legen Sie unter FARBEN Folgendes fest:

• Hintergrundfarbe: der Hintergrund des Passes.
• Vordergrundfarbe: Haupttext und Symbole auf dem Pass.
• Etikettenfarbe: Farbe der Feldbezeichnungen (z. B. VON, GATE).

Um eine Farbe festzulegen oder zu ändern, klicken Sie auf das entsprechende Feld und wählen Sie eine Farbe im Farbwähler aus.

Hinweis

Farben werden im Format rgb(r, g, b) gespeichert.

Bilder

Laden Sie unter BILDER das Symbol und das Logo hoch (beide erforderlich). Optionale Bilder hängen vom Pass-Stil ab.

Klicken Sie neben jedem Bild-Slot auf Datei auswählen. Laden Sie PNG- oder JPEG-Dateien hoch. Pushwoosh verarbeitet jedes Bild in die von Apple geforderten Auflösungen (@1x, @2x, @3x), wenn der Pass generiert wird.

Pass-Felder ausfüllen

Fügen Sie unter PASS-FELDER den Text und die Werte hinzu, die auf dem Pass erscheinen. Welche Gruppen Sie sehen, hängt vom Pass-Stil ab:

• Kopffelder (oben auf dem Pass): Bordkarte, Veranstaltungsticket
• Primärfelder (Hauptinhalt): alle Stile
• Sekundärfelder (unterstützende Informationen): alle Stile
• Hilfsfelder (zusätzliche Details): alle Stile
• Rückseitenfelder (Rückseite des Passes): alle Stile

Klicken Sie in jeder benötigten Gruppe auf + Feld hinzufügen.

Legen Sie für jedes Feld Folgendes fest:

Schlüssel (ID)	Eindeutiger Feldidentifikator (wird automatisch generiert).
Etikett	Kurze Bezeichnung auf dem Pass (z. B. VON).
Wert	Wert, der auf dem Pass angezeigt wird (z. B. SFO).
Änderungsnachricht	Text in der Update-Benachrichtigung, wenn sich dieser Wert ändert. Wird nur angezeigt, wenn sich der Wert ändert. Verwenden Sie %@ für den neuen Wert (z. B. Gate geändert zu %@).

Klicken Sie auf der Feldkarte auf Format, um Formatierungsoptionen anzuzeigen. Klicken Sie auf X, um das Feld zu entfernen.

Formatierungsoptionen

• Wertformat: Text, Datum & Uhrzeit oder Zahl/Währung.
• Textausrichtung: Standard (Natürlich), links, zentriert oder rechts.
• Datendetektoren (nur Rückseitenfelder): Verwandeln Sie Telefonnummern, Links, Adressen und Kalenderereignisse in antippbare Inhalte auf den Rückseitenfeldern.

Einen Barcode hinzufügen

Wählen Sie unter BARCODE ein Format und geben Sie die zu kodierenden Daten ein:

1. Barcode-Format: Wählen Sie aus, wie der Barcode aussieht und welche Art von Scanner ihn lesen kann.
   • QR-Code (empfohlen): quadratischer Code, den die meisten Telefone und Scanner leicht lesen können. Am besten für Coupons, Kundenkarten und die meisten Pässe.
   • PDF417: breiter Barcode, der aus mehreren Zeilen besteht. Oft für Flug- oder Transitbordkarten erforderlich.
   • Aztec: kompakter quadratischer Code, ähnlich wie QR. Häufig bei Veranstaltungs- und Transittickets.
   • Code 128: klassischer vertikaler Strichcode. Wählen Sie diesen nur, wenn Ihr Scanner oder POS-System einen 1D-Barcode erfordert.
2. Barcode-Nachricht: der im Barcode kodierte Wert (z. B. eine Ticket- oder Mitgliedsnummer).
3. Alternativtext (optional): Text, der unter dem Barcode auf dem Pass angezeigt wird.

Ablauf und Status festlegen

Steuern Sie unter ABLAUF & STATUS, wann der Pass angezeigt wird, wann er abläuft und ob er noch gültig ist:

• Relevantes Datum (wann der Pass angezeigt wird): Datum und Uhrzeit, zu der der Pass auf dem Sperrbildschirm erscheinen kann.
• Ablaufdatum (wann der Pass abläuft): Datum und Uhrzeit, nach der der Pass in Wallet ausgegraut wird.
• Als ungültig markieren (diesen Pass entwerten): Kontrollkästchen, um den Pass zu entwerten, sodass er nicht mehr verwendbar ist.

Stilspezifische und erweiterte Optionen

• Transittyp (nur Bordkarte): Flugzeug, Zug, Bus, Schiff oder Generisch.
• Gruppierungsidentifikator: Gruppieren Sie zusammengehörige Pässe in Wallet.

Standortbasierte Relevanz (optional)

Unter STANDORTBASIERTE RELEVANZ erscheint der Pass, wenn sich der Benutzer in der Nähe der von Ihnen hinzugefügten Standorte befindet. Legen Sie für jeden Standort den Text fest, der auf dem Sperrbildschirm angezeigt wird, wenn sich der Benutzer in der Nähe befindet. Sie können bis zu 10 Standorte hinzufügen.

Klicken Sie auf die Karte, suchen Sie eine Adresse, fügen Sie Koordinaten ein oder importieren Sie eine Geozone, um einen Punkt hinzuzufügen. Ziehen Sie den Marker, um die Position fein abzustimmen.

Eine maximale Entfernung (in Metern) steuert, wie nah der Benutzer sein muss, damit der Pass relevant bleibt.

Standorte vs. Beacons

Der Abschnitt STANDORTBASIERTE RELEVANZ konfiguriert nur kartenbasierte Standorte. Sie definieren einen Ort und eine maximale Entfernung in Metern. Das Gerät verwendet Ortungsdienste, um zu entscheiden, wann der Benutzer nahe genug ist. Wallet kann dann Ihren Sperrbildschirmtext für diesen Standort anzeigen.

PassKit kann einen Pass auch an iBeacon-Hardware in Innenräumen binden. Diese Option ist im Pass-Builder nicht verfügbar. Konfigurieren Sie Beacons in der PassKit API, wenn Ihr Team Beacon-Sender verwendet.

Anwendungsbeispiele

• Einzelhandel: Eine Kundenkarte oder ein Coupon wird angezeigt, wenn sich der Kunde in der Nähe Ihres Geschäfts befindet. Der Text auf dem Sperrbildschirm könnte darauf hinweisen, dass er sich in der Nähe des Geschäfts befindet und ihn daran erinnern, den Pass zu verwenden.
• Veranstaltungen: Ein Veranstaltungsticket erscheint, wenn sich der Benutzer in der Nähe des Veranstaltungsortes (Stadion, Theater oder Festivalgelände) befindet, damit er den Pass an der Tür schnell finden kann.
• Reisen: Eine Bordkarte wird in der Nähe des Abflughafens oder Terminals prominent angezeigt, sodass der Passagier Gate- oder Flugdetails auf dem Sperrbildschirm sieht, bevor er Wallet öffnet.
• Gastgewerbe: Ein Coupon oder Mitgliedspass kann in der Nähe eines von Ihnen definierten Café- oder Hotelstandorts angezeigt werden.

Eine User ID eingeben

Geben Sie die Pushwoosh User ID für die Person ein, die diesen Pass erhalten soll. Pushwoosh stellt den Pass für diesen Benutzer aus und listet ihn unter BENUTZER auf Alle Pässe.

Vorschau und Validierung

Eine Live-Vorschau wird während der Bearbeitung aktualisiert, sodass Sie ungefähr sehen können, wie der Pass in Wallet aussehen wird.

Vorschau kann auf einem Gerät abweichen

Die Vorschau ist eine Annäherung. Der Pass kann auf einem echten Gerät anders aussehen. Der angezeigte Barcode ist ein Platzhalter. Der echte Barcode wird in der endgültigen .pkpass-Datei generiert.

Um den Pass anhand der Apple-Spezifikationen zu überprüfen, ohne ihn zu erstellen, klicken Sie auf Pass validieren. Der Builder meldet fehlende erforderliche Bilder und andere Probleme.

Den Pass generieren

Wählen Sie Generieren. Pushwoosh validiert den Pass, verarbeitet die Bilder und signiert das Paket. Die Generierung dauert einige Sekunden, danach erscheint der Pass in Ihrer Passliste.

Informationen zum Bearbeiten (einschließlich Aktualisierung nach Seriennummer), Herunterladen, Teilen und Löschen von Pässen nach der Generierung finden Sie unter Bestehende Pässe verwalten.

Pässe über API verwalten

Alles, was der Pass-Builder tut, ist auch über die PassKit Designer API verfügbar: Pässe erstellen, aktualisieren, auflisten, herunterladen und löschen.

Apple Wallet PassKit API