Bordkarten automatisch hinzufügen

Hintergrund

Mit dieser Funktion können Fluggesellschaften Bordkarten automatisch an die Google Wallet eines Nutzers senden. Das ist besonders für Vielflieger von Vorteil, da sie ihre Bordkarten aufgrund ihrer häufigen Reisen einfacher und bequemer in Wallet hinzufügen können.

Das geschieht automatisch, unabhängig vom Check-in-Kanal (z.B. Web, App oder Flughafen-Kiosk). Partnerfluggesellschaften können die Kontonummer des Treuekontos des Nutzers verwenden, um den Pass zu verknüpfen und in sein Wallet zu übertragen.

Funktionsweise

Schritt 1: Aktivieren Sie die Option, dass der Vielflieger seine Vielfliegerkarte zu Wallet hinzufügen kann.

Schritt 2: Neue Bordkarten für den Vielflieger automatisch hinzufügen, indem Sie sie mit seiner Kundenkarte in Wallet verknüpfen.

Best Practices

• Wenn Sie Vielfliegern eine reibungslose Registrierung für das Treuepunkteprogramm ermöglichen möchten, sollten Sie den Ablauf Über Google anmelden aktivieren. Nutzer können dann den Registrierungsprozess für das Treuepunkteprogramm Ihrer Fluggesellschaft über verschiedene Einstiegspunkte in Google Wallet aufrufen, z. B. über Bordkarten.
• Erwägen Sie, die 1-Klick-Registrierung für bestehende Mitglieder des Treuepunkteprogramms in Ihrer Android-App und auf Ihrer Website zu aktivieren.

Hinweis: Diese Funktion ist eine spezielle Implementierung der Funktion „Automatisch verknüpfte Karten/Tickets“. In diesem Zusammenhang bezieht sich die primäre Karte auf eine Kundenkarte und die verknüpfte Karte auf eine Bordkarte. Im Rest dieses Dokuments wird die allgemeinere Terminologie verwendet: automatisch verknüpfte Karten/Tickets, primäre Karte/primäres Ticket und verknüpfte Karte/verknüpftes Ticket.

Hinweise zur Verwendung von automatisch verknüpften Karten/Tickets

• Für das primäre Objekt und das verknüpfte Objekt muss dieselbe issuerId verwendet werden.
• Das automatische Pushen verknüpfter Karten ist nicht garantiert und wird als Best-Effort-Vorgang betrachtet. Nutzer können den Erhalt automatisch verknüpfter Karten/Tickets deaktivieren. Wenn der Anwendungsfall kritisch ist und der Nutzer den verknüpften Ausweis erhalten muss, empfehlen wir, über einen anderen Kanal zu kommunizieren, damit der Nutzer den Ausweis hinzufügt.
• Die Nutzungsrichtlinien für Google Wallet wurden aktualisiert und enthalten nun Richtlinien zur Verwendung von automatisch verknüpften Karten/Tickets, die eingehalten werden müssen.

Integrationsschritte

Wenn Sie bereits ein primary-Objekt erstellt haben, können Sie Schritt 1 überspringen.

1. Erstellen Sie ein Objekt für einen beliebigen Kartentyp, der mit den erforderlichen Parametern aufgeführt ist. Dies ist das primäre Objekt.
2. Erstellen Sie ein weiteres Objekt eines beliebigen aufgeführten Karten-/Ticketyps. Dies ist das verknüpfte Objekt.
3. Aktualisieren Sie das primäre Objekt entweder vor oder nach dem Speichern mit der ID des verknüpften Objekts im Parameter „linkedObjectIds“ .

Es ist eine Mindestnutzlast erforderlich, um die linkedObjectIds für eine primäre Karte festzulegen. Die drei erforderlichen Parameter sind:

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

Beispiel für eine JSON-Anfrage zum Hinzufügen eines verknüpften Objekts zu einem Pass-Objekt

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

Beispiel für eine JSON-Antwort nach dem Verknüpfen eines Objekts mit einem Pass-Objekt

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

Umgang mit Ausnahmen

Bei einer falschen Verwendung der API können potenzielle Fehler auftreten, z. B.:

Botschaft	Grund
Das primäre Objekt und das verknüpfte Objekt haben nicht dieselbe Aussteller-ID.	Sie können ein verknüpftes Objekt nicht an das Objekt eines anderen Ausstellers anhängen.
Das primäre Objekt und das verknüpfte Objekt verweisen auf dasselbe Objekt.	Sie können nicht dasselbe Objekt als „linkedObject“ anhängen.
Das verknüpfte Objekt ist nicht vorhanden.	Das verknüpfte Objekt sollte bereits in die Wallet API eingefügt worden sein.
Das verknüpfte Objekt hat bereits ein anderes verknüpftes Objekt. Es können keine verschachtelten verknüpften Objekte hinzugefügt werden.	Verknüpfte Objekte können nicht mit einem anderen Objekt verknüpft werden.
Das Objekt ist bereits mit einem anderen Objekt verknüpft. Verschachtelte verknüpfte Objekte können nicht hinzugefügt werden.	Das primäre Objekt kann nicht allein ein verknüpftes Objekt sein.