Google Wallet-Pässe im Pass-Builder entwerfen

Der Google Wallet Pass-Builder ist ein visueller Designer im Control Panel. Sie wählen einen Passtyp aus, füllen Branding, Felder und einen Barcode aus, sehen sich eine Live-Vorschau an und erstellen den Pass. Wenn Sie den Pass generieren, erstellt Pushwoosh das Pass-Objekt in Google Wallet und gibt einen „Zu Google Wallet hinzufügen“-Speicherlink zurück.

Einen Pass erstellen

Zuerst Konfiguration erforderlich

Der Builder ist erst verfügbar, nachdem Google Wallet für die Anwendung konfiguriert wurde (Issuer ID und Dienstkontoschlüssel). Wenn es noch nicht konfiguriert ist, richten Sie es zuerst ein: Google Wallet Pass-Konfiguration für Android.

Gehen Sie im Control Panel zu Campaigns → Wallet Passes, öffnen Sie den Tab Google Wallet und klicken Sie auf Pass erstellen.

Den Pass konfigurieren

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

• Aus einer Vorlage: Klicken Sie auf Vorlage laden, wählen Sie eine integrierte Vorlage in Vorlage auswählen (Allgemein, Angebot, Treue, Veranstaltungsticket, Geschenkkarte, Flug oder Fahrkarte) und bestätigen Sie. Das Formular füllt den Passtyp, die Felder, Farben und den Barcode vorab aus. Bearbeiten Sie bei Bedarf einen beliebigen Wert oder ändern Sie den Typ.

Einen Passtyp auswählen

Wählen Sie unter PASSTYP einen der sieben Google Wallet-Passtypen aus. Der Typ steuert das Kartenlayout und welche Felder verfügbar sind. Typisierte Pässe verwenden das native Layout von Google. Der allgemeine Pass ist frei gestaltbar.

• Allgemein: frei gestaltbare Karte aus Ihren eigenen Feldern.
• Angebot: Gutscheine und Rabatte.
• Treuekarte: Treue- und Mitgliedskarten.
• Veranstaltungsticket: Tickets für Veranstaltungen.
• Geschenkkarte: Geschenk- und Prepaid-Karten.
• Flug: Bordkarten.
• Fahrkarte: Tickets für Bahn, Bus, Straßenbahn und Fähre.

Passfelder ausfüllen

Die Felder, die Sie sehen, hängen vom Passtyp ab. Erforderliche Felder sind markiert. Gängige Felder pro Typ:

Passtyp	Schlüsselfelder
Allgemein	Kartentitel*, Kopfzeile*, Unterkopfzeile, Kartenfelder
Angebot	Titel*, Anbieter*, Details, Kleingedrucktes, Einlösekanal (im Geschäft / online / beides), Ausstellername
Treue	Programmname*, Mitgliedsname, Mitglieds-ID, Punktestand, Punktebezeichnung, Prämienstufe, Stufenbezeichnung, Ausstellername
Veranstaltungsticket	Veranstaltungsname*, Veranstaltungsort, Adresse, Start-/Enddatum & -zeit, Ticketinhaber, Ticketnummer, Typ, Abschnitt, Reihe, Sitz, Gate
Geschenkkarte	Händlername*, Kartennummer*, PIN, Guthaben + Währung
Flug	IATA-Code der Fluggesellschaft*, Flugnummer*, Herkunft*, Ziel*, Abflug*, Passagiername*, Boardingzeit, Sitz, Klasse, Boardinggruppe, Bestätigungscode
Fahrkarte	Fahrkartentyp* (Bus / Bahn / Straßenbahn / Fähre / Sonstiges), Betreiber*, Passagier*, Reisetyp, Reiseabschnitte (Herkunft*, Ziel*, Zeiten, Bahnsteig, Wagen, Sitz)

* Von Google gefordert.

Daten und Zeiten

Die meisten Passtypen verwenden ISO 8601 mit einem UTC-Offset (zum Beispiel 2026-07-01T19:30:00+02:00). Flugpässe sind eine Ausnahme: Google verlangt Abflug-, Boarding- und Ankunftszeiten in der lokalen Zeit des Flughafens ohne einen Offset (zum Beispiel 2026-09-01T06:30:00).

Passinhalte personalisieren

Jeder Pass ist mit einer User ID verknüpft. Verwenden Sie Tag-Platzhalter, um für diesen Benutzer eindeutige Daten anzuzeigen, zum Beispiel einen Punktestand auf einer Treuekarte oder den Empfängernamen auf einer Geschenkkarte. Geben Sie einen Pass pro User ID aus, damit jeder Empfänger seine eigenen Werte erhält.

So fügen Sie einen Tag-Platzhalter ein:

1. Klicken Sie neben einem unterstützten Textfeld (zum Beispiel Händler, Kartentitel oder Kopfzeile) auf {}, um ein Tag einzufügen.
2. Wählen Sie unter TAG das Tag aus, das in das Feld eingefügt werden soll.
3. Wählen Sie unter FORMAT, wie der Tag-Wert angezeigt werden soll: Wie besehen (verwendet den gespeicherten Wert), Ganzzahl (rundet auf eine ganze Zahl), Preis (0,00) (zeigt zwei Dezimalstellen) oder Ersten Buchstaben großschreiben (schreibt den ersten Buchstaben groß).
4. Geben Sie unter FALLBACK optional Text ein, der angezeigt wird, wenn der Empfänger keinen Wert für das Tag hat.
5. Klicken Sie auf Einfügen.

Pushwoosh füllt die Tag-Werte aus, wenn Sie den Pass erstellen, und aktualisiert sie bei jeder Aktualisierung.

Erscheinungsbild festlegen

Konfigurieren Sie unter ERSCHEINUNGSBILD Farben, Bilder, wer den Pass speichern kann und das Ablaufdatum.

Farben

Geben Sie einen Hex-Code in Hintergrundfarbe ein, zum Beispiel #FFFFFF für Weiß. Fügen Sie das führende # und sechs Zeichen ein.

Bilder

Bilder unter einer öffentlichen HTTPS-URL hosten

Google Wallet speichert Ihr Logo oder Hero-Bild nicht. Hosten Sie jede Datei unter einer öffentlichen HTTPS-URL, die online und erreichbar bleibt, und fügen Sie den Link dann in den Pass-Builder ein. Wenn die URL nicht mehr funktioniert oder die Datei entfernt wird, wird das Bild auf dem Pass nicht mehr geladen.

Fügen Sie einen öffentlichen HTTPS-Link in Logo-URL ein. Erforderlich für Treue- und Fahrkartenpässe.

Fügen Sie optional einen Link in Hero-Bild-URL für ein breites Banner unter den Kartendetails auf der Vorderseite des Passes ein. Die empfohlene Größe beträgt 1032×336 px.

Medienspeicher-URLs

Sie können eine öffentliche Bild-URL aus dem Medienspeicher einfügen, einschließlich einer für die Platzierung dimensionierten Variante.

Hinweis: Wenn Sie das Bild im Medienspeicher löschen, wird es auf dem Pass nicht mehr geladen.

Wer den Pass speichern kann

Wählen Sie unter Wer den Pass speichern kann aus, wer den Pass zu Google Wallet hinzufügen kann:

• Ein Benutzer, alle seine Geräte (Standard): Der Pass ist mit einem Google-Konto verknüpft und wird über die Geräte dieses Kontos synchronisiert.
• Ein Benutzer, ein Gerät: Der Pass wird nur auf einem einzigen Gerät gespeichert.
• Jeder mit dem Link: Jedes Google-Konto, das den Speicherlink öffnet, erhält dasselbe freigegebene Pass-Objekt. Wenn Sie den Pass aktualisieren, liefert Google die Änderung automatisch an alle Inhaber.

Jeder mit dem Link

Verwenden Sie dies für Pässe, bei denen alle Inhaber denselben Inhalt sehen, zum Beispiel ein geschäftsweites Angebot oder ein öffentliches Veranstaltungsticket ohne zugewiesenen Sitzplatz. Vermeiden Sie es für Treuekarten, Geschenkkarten oder jeden Pass, bei dem der Inhalt pro Benutzer personalisiert werden muss. Pushwoosh verfolgt nur ein Gerät für das freigegebene Objekt, sodass einzelne Inhaber nicht sichtbar sind und nicht separat angesprochen werden können.

Ablauf

Legen Sie das Ablaufdatum fest, an dem Google den Pass ablaufen lassen soll, oder lassen Sie es für kein Ablaufdatum leer.

Einen Barcode hinzufügen

Wählen Sie unter BARCODE ein Format und geben Sie den zu kodierenden Wert ein:

1. Format: Wählen Sie aus, wie der Barcode aussieht und welche Art von Scanner ihn lesen kann.
   • QR_CODE: quadratischer Code, den die meisten Telefone und Scanner leicht lesen können. Am besten für die meisten Pässe.
   • PDF_417: breiter Barcode aus mehreren Zeilenreihen. Oft für Bordkarten erforderlich.
   • AZTEC: kompakter quadratischer Code, ähnlich wie QR. Häufig bei Veranstaltungs- und Fahrkarten.
   • CODE_128 / EAN_13: 1D-Barcodes. Wählen Sie diese nur, wenn Ihr Scanner oder POS-System sie erfordert.
2. Wert: die im Barcode kodierten Daten (zum Beispiel eine Ticket- oder Mitgliedsnummer). Um einen eindeutigen Wert pro Benutzer zu verwenden, klicken Sie auf {} neben dem Feld und fügen Sie einen Tag-Platzhalter ein.
3. Alternativtext: Text, der unter dem Barcode auf dem Pass angezeigt wird.

Detailfelder und Links hinzufügen

Auf der Vorderseite des Passes sehen die Benutzer die Hauptkarte. Wenn sie die Passdetails (die Rückseite) öffnen, können sie zusätzliche Abschnitte lesen und auf Links tippen, die Sie hier hinzufügen.

• Textmodule: zusätzliche Textblöcke auf der Rückseite des Passes. Legen Sie eine Kopfzeile (den Abschnittstitel) und einen Textkörper (den Text) fest. Verwenden Sie sie für Bedingungen, Anweisungen oder andere Informationen, die nicht auf die Vorderseite passen.
• Links: antippbare Links auf der Rückseite des Passes. Legen Sie eine URL und eine kurze Beschreibung fest (zum Beispiel „Filialfinder“ oder „Allgemeine Geschäftsbedingungen“).

Einen App-Link hinzufügen (optional)

Fügen Sie unter APP-LINK eine Schaltfläche auf der Vorderseite des Passes hinzu, die beim Antippen eine Webseite oder Ihre Android-App öffnet. Sie können eine URL, einen Android-Paketnamen oder beides festlegen.

Wenn Sie nur die URL festlegen, öffnet die Schaltfläche diese Webadresse auf jedem Gerät. Wenn Sie nur einen Paketnamen festlegen, funktioniert die Schaltfläche auf Android-Geräten, auf denen die App installiert ist, ohne Web-Fallback.

Standorte hinzufügen (optional)

Fügen Sie unter Standortbasierte Relevanz Points of Interest hinzu. Google zeigt eine geofenced Benachrichtigung an, wenn sich der Benutzer in der Nähe eines von Ihnen hinzugefügten Standorts befindet. Zeigen Sie zum Beispiel eine Treuekarte in der Nähe Ihres Geschäfts, ein Veranstaltungsticket in der Nähe des Veranstaltungsortes oder eine Bordkarte in der Nähe des Flughafens an.

Sie können bis zu 10 Standorte hinzufügen, die jeweils durch Breiten- und Längengrad festgelegt werden.

Standorte in Google Wallet

Google steuert den Geofence-Radius und entscheidet, wann die Benachrichtigung angezeigt wird. Sie können keine maximale Entfernung pro Standort festlegen.

Eine User ID eingeben

Geben Sie die Pushwoosh User ID für die Person ein, die diesen Pass erhalten wird.

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 Google Wallet aussehen wird.

Vorschau kann auf einem Gerät abweichen

Die Vorschau ist eine Annäherung. Typisierte Pässe verwenden das native Layout von Google, daher kann der Pass auf einem echten Gerät anders aussehen. Der angezeigte Barcode ist ein Platzhalter.

Um den Pass anhand der Anforderungen von Google zu überprüfen, ohne ihn zu erstellen, klicken Sie auf Validieren. Der Builder markiert fehlende erforderliche Felder und andere Probleme.

Den Pass generieren

Klicken Sie auf Generieren. Pushwoosh überprüft den Pass und erstellt ihn in Google Wallet. Sie erhalten einen Zu Google Wallet hinzufügen-Speicherlink, den Sie mit den Benutzern teilen können. Innerhalb weniger Sekunden erscheint der Pass unter Alle Pässe.

Informationen zum Bearbeiten, Abrufen des Speicherlinks, Ungültigmachen und Löschen von Pässen nach der Erstellung finden Sie unter Bestehende Pässe verwalten.

Pässe über API verwalten

Alles, was der Pass-Builder tut, ist auch über die Google Wallet API verfügbar: Pässe erstellen, aktualisieren, auflisten, einen Speicherlink abrufen, den Status festlegen und löschen.

Google Wallet API