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.

Dies geschieht automatisch, unabhängig vom Check-in-Kanal (z.B. Web, App oder Flughafen-Kiosk). Airline-Partner können die Treuekonto-Nummer 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 der 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 Mit Google registrieren / anmelden aktivieren. Nutzer können dann den Registrierungsvorgang für das Treuepunkteprogramm Ihrer Fluggesellschaft über verschiedene Einstiegspunkte in Google Wallet aufrufen, z. B. über Bordkarten.
• Aktivieren Sie die 1-Klick-Registrierung für bestehende Mitglieder des Treuepunkteprogramms in Ihrer Android-App und auf Ihrer Website.

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 weiteren Verlauf 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 automatisch verknüpfter Karten

• Für das primäre Objekt und das verknüpfte Objekt muss dieselbe issuerId verwendet werden.
• Das automatische Pushen verknüpfter Karten und Tickets ist nicht garantiert und wird nach dem Best-Effort-Prinzip durchgeführt. Nutzer können den Empfang automatisch verknüpfter Karten/Tickets deaktivieren. Wenn der Anwendungsfall kritisch ist und der Nutzer die verknüpfte Karte erhalten muss, empfehlen wir, über einen anderen Kanal zu kommunizieren, um sicherzustellen, dass der Nutzer die Karte 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 Passobjekt

  …
  {
    "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"
  }
  …

Ausnahmebehandlung

Bei einer falschen Verwendung der API können folgende Fehler auftreten:

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 wie das 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 verknüpften 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.