Google Wallet-Pass-Builder

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 ist eine Konfiguration erforderlich

Der Builder ist erst verfügbar, nachdem Google Wallet für die Anwendung konfiguriert wurde (Issuer ID, wobei das Pushwoosh-Dienstkonto zu Ihrem Issuer eingeladen wurde). Wenn es noch nicht konfiguriert ist, richten Sie es zuerst ein: Google Wallet-Pass-Konfiguration für Android.

Gehen Sie im Control Panel zu Kampagnen → Wallet Passes, öffnen Sie den Tab Alle Pässe, wählen Sie Google Wallet aus und klicken Sie auf Pass erstellen.

Den Pass konfigurieren

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

• Aus einer Vorlage: Klicken Sie auf Vorlage laden, wählen Sie einen integrierten Pass unter Vorlage auswählen (Allgemein, Angebot, Kundenkarte, Veranstaltungsticket, Geschenkkarte, Flug oder Fahrschein). Die Vorlage wird angewendet, sobald Sie darauf klicken. Das Formular füllt den Passtyp, die Felder, Farben und den Barcode vorab aus und setzt ein Platzhalter-Logo. Ersetzen Sie das Logo durch Ihr eigenes, bevor Sie den Pass generieren, sonst wird der Platzhalter mit dem Pass ausgeliefert. Bearbeiten Sie bei Bedarf jeden 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. Nach dem Erstellen des Passes können Sie den Typ nicht mehr ändern.

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

Pass-Felder ausfüllen

Die angezeigten Felder hängen vom Passtyp ab. Der Builder markiert erforderliche Felder nicht, aber Pass validieren und Generieren melden alle leeren. Gängige Felder pro Typ:

Passtyp	Wichtige Felder
Allgemein	Kartentitel*, Kopfzeile*, Unterkopfzeile, bis zu 6 Felder auf der Karte
Angebot	Titel*, Anbieter*, Details, Kleingedrucktes, Einlösekanal (BOTH, INSTORE, ONLINE oder TEMPORARY_PRICE_REDUCTION), Name des Ausstellers
Kundenkarte	Programmname*, Name des Mitglieds, Mitglieds-ID, Punktestand, Punktebezeichnung, Prämienstufe, Stufenbezeichnung, Name des Ausstellers
Veranstaltungsticket	Veranstaltungsname*, Veranstaltungsort, Adresse, Beginnt, Endet, Ticketinhaber, Ticketnummer, Tickettyp, Sektion, Reihe, Sitzplatz, Gate
Geschenkkarte	Händler*, Kartennummer*, PIN, Guthaben + Währung
Flug	Fluggesellschaft (IATA-Code), Flugnummer, Von*, Nach*, Abflug*, Passagiername*, Boarding-Zeit, Sitzplatz, Klasse, Boarding-Gruppe, Bestätigungscode
Fahrschein	Typ* (Bus / Bahn / Straßenbahn / Fähre / Sonstiges), Betreiber* (sofern kein Herausgebername festgelegt ist), Passagier*, Reisetyp, Reiseabschnitte (Herkunft*, Ziel*, Zeiten, Bahnsteig, Wagen, Sitzplatz), Herausgebername

* Von Google gefordert.

Datum und Uhrzeit

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 Offset (zum Beispiel 2026-09-01T06:30:00).

Pass-Inhalte 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 Kundenkarte oder den Namen des Empfängers auf einer Geschenkkarte. Geben Sie einen Pass pro User ID aus, damit jeder Empfänger seine eigenen Werte erhält.

Um einen Tag-Platzhalter einzufügen:

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 an), Ersten Buchstaben großschreiben, Datum (5 Aug 1980), Datum und Uhrzeit (5 Aug 1980 14:30) oder Uhrzeit (14:30).
4. Geben Sie unter Fallback (wenn leer) optional einen 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 beim Erstellen des Passes aus und aktualisiert sie bei jeder Aktualisierung.

Erscheinungsbild festlegen

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

Farben

Klicken Sie auf Hintergrundfarbe und wählen Sie im Farbwähler eine Farbe aus.

Bilder

Klicken Sie auf Bild auswählen neben Logo, um ein Bild aus dem Medienspeicher der Anwendung auszuwählen, ein neues hochzuladen oder eines aus Stockfotos oder per KI-Generierung zu beziehen. Die Auswahl akzeptiert PNG- und JPEG-Dateien. Das Logo ist für Kundenkarten und Fahrscheine erforderlich.

Klicken Sie optional auf Bild auswählen neben Hero-Bild für ein breites Banner, das unter den Kartendetails auf der Vorderseite des Passes angezeigt wird. Die empfohlene Größe beträgt 1032×336 px.

Wenn der Medienspeicher der Anwendung einen Zuschnitt hat, der bereits für die Platzierung dimensioniert ist, wählen Sie diesen Zuschnitt.

Löschen des Bildes im Medienspeicher

Der Medienspeicher verhindert das Löschen eines Bildes nur, solange eine Wallet-Pass-Kampagne es verwendet. Ein für einen einzelnen Pass ausgewähltes Bild ist nicht geschützt. Behalten Sie es daher im Medienspeicher, solange der Pass verwendet wird.

Wer kann den Pass speichern

Wählen Sie unter Wer den Pass speichern kann aus, wer den Pass zu Google Wallet hinzufügen kann. Nach dem Erstellen des Passes können Sie diese Einstellung nicht mehr ändern.

• Ein Benutzer, alle seine Geräte (Standard): Der Pass ist mit einem Google-Konto verknüpft und wird auf allen Geräten 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, übermittelt 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 Ticket für eine öffentliche Veranstaltung ohne zugewiesenen Sitzplatz. Vermeiden Sie es für Kundenkarten, 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 geeignet.
   • PDF_417: Breiter Barcode aus mehreren Zeilenreihen. Oft für Bordkarten erforderlich.
   • AZTEC: Kompakter quadratischer Code, ähnlich wie QR. Häufig bei Veranstaltungs- und Fahrscheinen.
   • 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.

• Felder in den Details: Zusätzlicher Text auf der Rückseite des Passes. Klicken Sie auf + Feld hinzufügen und legen Sie ein Label und einen Wert fest. Verwenden Sie sie für Bedingungen, Anweisungen oder andere Informationen, die nicht auf die Vorderseite passen.
• Links: Tippbare Links auf der Rückseite des Passes. Klicken Sie auf + Link hinzufügen und legen Sie dann eine URL und ein kurzes Link-Label 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. Die URL muss mit https:// beginnen.

Nach dem Erstellen des Passes können Sie den App-Link ändern, aber nicht entfernen.

Standorte hinzufügen (optional)

Fügen Sie unter Standortbasierte Relevanz Points of Interest hinzu. Google zeigt eine Geofence-Benachrichtigung an, wenn sich der Benutzer in der Nähe eines von Ihnen hinzugefügten Standorts befindet. Zeigen Sie zum Beispiel eine Kundenkarte 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. Um einen hinzuzufügen, klicken Sie auf die Karte, suchen Sie nach einer Adresse, fügen Sie Koordinaten ein oder importieren Sie eine Geozone.

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, sodass der Pass auf einem echten Gerät anders aussehen kann. Ein QR-Code in der Vorschau kodiert den echten Wert, während andere Barcode-Formate als Platzhalter angezeigt werden.

Um den Pass mit den Anforderungen von Google abzugleichen, ohne ihn zu erstellen, klicken Sie auf Pass validieren. Der Builder kennzeichnet fehlende erforderliche Felder und andere Probleme.

Den Pass generieren

Klicken Sie auf Generieren. Pushwoosh prü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. Wie Sie den Pass an Benutzer senden, erfahren Sie unter Wallet-Pässe teilen.

Um ein Design an viele Benutzer auszugeben und gemeinsame Felder auf allen ausgegebenen Pässen gleichzeitig zu aktualisieren, erstellen Sie stattdessen eine Wallet-Pass-Kampagne. Eine Kampagne verwendet dieselben Designabschnitte wie dieser Builder.

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