# Erste Schritte mit Apple Wallet-Pässen

Apple Wallet-Pässe sind digitale Karten wie Treuekarten, Gutscheine, Veranstaltungstickets, Bordkarten und Kundenkarten, die Ihre Benutzer in der Wallet-App auf dem iPhone und der Apple Watch aufbewahren. Mit Pushwoosh können Sie einen Pass visuell im Control Panel entwerfen, ihn teilen und dann jederzeit Updates pushen, ohne dass die Benutzer etwas neu installieren müssen.

Wenn Sie einen Pass ändern, benachrichtigt Pushwoosh jedes Gerät, das ihn hinzugefügt hat, und iOS ruft die neue Version unbemerkt ab. Der Barcode, das Guthaben, die Gate-Nummer oder das Ablaufdatum auf dem Telefon des Benutzers wird von selbst aktualisiert.

## Was Sie mit Apple Wallet-Pässen tun können

Mit Apple Wallet-Pässen in Pushwoosh können Sie:

* Pässe visuell mit Farben, Feldern, Logo, Streifenbild und Barcode entwerfen, ohne `pass.json` manuell schreiben zu müssen.
* Treuekarten, Gutscheine, Veranstaltungstickets, Bordkarten und allgemeine Kundenkarten erstellen.
* Pässe als `.pkpass`-Datei, Installationslink oder QR-Code an Benutzer verteilen.
* Pass-Inhalte aktualisieren und Änderungen an Geräte liefern, die den Pass hinzugefügt haben.
* Pass-Inhaber mit einer einmaligen Push-Benachrichtigung, einem Pass-Update oder einer Customer Journey erreichen. Siehe [Pass-Inhaber von Apple Wallet benachrichtigen](/de/product/messaging-channels/apple-wallet-passes/message-pass-holders/).

## Voraussetzungen

<Aside type="caution" icon="setting" title="Hilfe von Entwicklern erforderlich">
Die Ausstellung von Apple Wallet-Pässen erfordert ein Apple-Entwicklerkonto und Signaturzertifikate. Teilen Sie diesen Abschnitt mit Ihrem Entwicklerteam, um die einmalige Einrichtung abzuschließen.
</Aside>

Bevor Sie Ihren ersten Pass entwerfen, bestätigen Sie Folgendes:

* **Apple Developer Program:** Sie benötigen eine aktive Mitgliedschaft, um Pass-Typ-IDs zu registrieren und Signaturzertifikate zu erstellen. [Registrieren oder verwalten Sie Ihr Konto](https://developer.apple.com/programs/)
* **iOS-Plattform:** Ihre Anwendung muss in Pushwoosh mit iOS verbunden sein, bevor Sie ein Pass-Signaturzertifikat hinzufügen können. [iOS einrichten](/de/developer/first-steps/connect-messaging-services/ios-configuration/)

## Mit Apple Wallet-Pässen arbeiten

Nachdem die [Voraussetzungen](#prerequisites) erfüllt sind, arbeiten Sie diesen Ablauf durch:

<Steps>

1. **Wallet-Pässe in Pushwoosh konfigurieren**

   Bevor Sie Pässe entwerfen können, muss Pushwoosh Ihr Apple-Signaturzertifikat für die Anwendung haben. Ihr Entwicklerteam erstellt es in Apple Developer und lädt es in Pushwoosh hoch. Dies ist eine einmalige Einrichtung pro Anwendung.

   [So richten Sie das Signaturzertifikat ein](/de/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

2. **Den Pass entwerfen**

   Wählen Sie im [Pass-Builder](/de/product/messaging-channels/apple-wallet-passes/pass-builder/) einen Pass-Stil, legen Sie Felder und Branding fest und überprüfen Sie die Live-Vorschau.

3. **Eine signierte `.pkpass`-Datei generieren**

   Sobald Sie den Pass erstellt und validiert haben, wählen Sie im [Pass-Builder](/de/product/messaging-channels/apple-wallet-passes/pass-builder/#generate-the-pass) **Generieren**. Pushwoosh bereitet Bilder in den erforderlichen Auflösungen vor und signiert die Datei mit Ihrem Zertifikat.

4. **Den Pass verteilen**

   Senden Sie Benutzern die `.pkpass`-Datei, den Installationslink oder den QR-Code. Siehe [Den Pass über Pushwoosh-Kanäle mit Benutzern teilen](#share-the-pass-with-users-via-pushwoosh-channels). Wenn Benutzer den Pass zur Wallet hinzufügen, registriert sich ihr Gerät für zukünftige Updates.

5. **Pass-Inhalte aktualisieren**

   Bearbeiten Sie den Pass im Pass-Builder oder über die API und speichern Sie ihn. Pushwoosh benachrichtigt registrierte Geräte, und iOS lädt die neue Version im Hintergrund herunter. Benutzer müssen den Pass nicht neu installieren.

6. **Pass-Inhaber benachrichtigen**

   Sobald Benutzer den Pass zur Wallet hinzufügen, können Sie sie mit einer einmaligen Push-Benachrichtigung, einem Pass-Update oder einer automatisierten Customer Journey erreichen.

   [Pass-Inhaber von Apple Wallet benachrichtigen](/de/product/messaging-channels/apple-wallet-passes/message-pass-holders/)

</Steps>

## Vorhandene Pässe anzeigen und verwalten

Gehen Sie im Control Panel zu **Campaigns → Wallet Passes** und öffnen Sie den Tab **Apple Wallet**. Die Tabelle **Alle Pässe** listet jeden Pass für die Anwendung auf, einschließlich seines Namens, Stils, der [User ID](/de/product/pushwoosh-knowledge-hub/users-userids/), mit der er verknüpft ist, sowie Datum und Uhrzeit der letzten Aktualisierung.

Öffnen Sie in der Pass-Liste das Aktionsmenü (⋮), um:

* **Bearbeiten:** Passnamen und -beschreibung, Feldwerte und -bezeichnungen, Nachrichten, Farben, Barcode-Nachricht, Ablauf und Status sowie Standorte ändern. Pass-Stil und Bilder bleiben nach der Erstellung gesperrt. Wenn Sie speichern, erhält jedes Gerät, das den Pass hinzugefügt hat, das Update.

<Aside type="note" title="Updates werden als stille Push-Benachrichtigungen zugestellt">
Wenn Sie eine Änderung speichern, signiert Pushwoosh den Pass erneut und benachrichtigt jedes registrierte Gerät mit einer inhaltslosen Push-Benachrichtigung. iOS ruft die neue Version von selbst ab – keine Neuinstallation erforderlich.
</Aside> 

* **Herunterladen:** die signierte `.pkpass`-Datei herunterladen.
* **QR-Code:** einen Installations-QR-Code anzeigen, den Benutzer scannen können, um den Pass zur Wallet hinzuzufügen und ihr Gerät für Updates zu registrieren. In diesem Fenster können Sie auch **Installationslink kopieren** unter dem QR-Code verwenden.
* **Installationslink kopieren:** die Installations-URL kopieren, um den Pass in Ihren Nachrichtenkanälen zu teilen. [Mehr erfahren](#share-the-pass-with-users-via-pushwoosh-channels).
* **Nachricht senden:** den Composer für einmalige Push-Benachrichtigungen öffnen, um Pass-Inhaber zu benachrichtigen. Wenn Sie ihn aus der Liste öffnen, zielt er auf den Pass-Besitzer über die [User ID](/de/product/pushwoosh-knowledge-hub/users-userids/). Siehe [Pass-Inhaber von Apple Wallet benachrichtigen](/de/product/messaging-channels/apple-wallet-passes/message-pass-holders/) für alle Möglichkeiten, sie zu erreichen.
* **Löschen:** den Pass entfernen. Kopien, die bereits auf Geräten installiert sind, erhalten keine Updates mehr und werden bei der nächsten Aktualisierung ungültig.

## Den Pass über Pushwoosh-Kanäle mit Benutzern teilen

Der Installationslink, den Sie im Builder kopieren (**Installationslink kopieren**), ist eine normale URL. Wenn Sie ihn auf einem iPhone öffnen, wird der Pass zur Apple Wallet hinzugefügt. Sie können diesen Link in denselben Pushwoosh-Kanälen verwenden, die Sie bereits nutzen, um Ihr Publikum zu erreichen:

* **E-Mail:** den Link zu einer Schaltfläche oder einem Textlink im [E-Mail-Editor](/de/product/content/email-content/drag-and-drop-email-editor/) hinzufügen, zum Beispiel zu einem Call-to-Action „Zur Apple Wallet hinzufügen“.
* **Push-Benachrichtigungen:** den Link als [Öffnen-Aktion](/de/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#define-what-happens-when-the-push-is-clicked) der Benachrichtigung festlegen, sodass ein Tippen den Pass öffnet.
* **SMS:** den Link in den [SMS-Inhalt](/de/product/messaging-channels/sms/send-sms/send-sms-via-customer-journey/#configure-sms-content) einfügen.

<Aside type="note" title="Ein Link pro Pass">
Jeder Installationslink ist an einen einzelnen Pass gebunden (er enthält die Seriennummer und das Token dieses Passes), sodass ein Link für einen gemeinsam genutzten Pass funktioniert, was für einen allgemeinen Gutschein oder ein Veranstaltungsticket praktisch ist. Um jedem Empfänger einen eigenen Pass zu geben, generieren Sie pro Benutzer einen Pass mit der [PassKit API](/de/developer/api-reference/apple-wallet-passkit-api/) und senden Sie jedem Benutzer seinen eigenen Link. Wallet-Pässe können nur auf Apple-Geräten installiert werden – iPhone und Apple Watch.
</Aside>

## Pässe über API verwalten

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

<LinkCard title="Apple Wallet PassKit API" href="/developer/api-reference/apple-wallet-passkit-api/" />

## Pass-Inhaber im User Explorer anzeigen

Wenn ein Benutzer Ihren Pass zur Wallet hinzufügt, listet Pushwoosh ihn auf dem Tab **Geräte und Plattformen** im [User Explorer](/de/product/audience-data-and-segmentation/user-explorer/) auf.

1. Gehen Sie zu **Audience → User Explorer** und öffnen Sie das Benutzerprofil.
2. Öffnen Sie den Tab **Geräte und Plattformen**.
3. Wählen Sie **Apple Wallet** in der Seitenleiste aus.

Im Plattformprofil können Sie Folgendes überprüfen:

* **Abonnementstatus:** zum Beispiel **ABONNIERT**
* **Plattform-Identifikator:** der Pass-Identifikator, der unter dem Plattformnamen angezeigt wird
* **Metadaten:** **Erstes Abonnement**, **Zeitzone** und andere Felder, falls verfügbar
* **Tags:** Plattform-Tags, einschließlich derer, die Sie bei der Ausstellung des Passes festgelegt haben

[Mehr erfahren](/de/product/audience-data-and-segmentation/user-explorer/#devices-and-platforms-tab)