Aggiungere automaticamente le carte d'imbarco

Sfondo

La funzionalità consente alle compagnie aeree di inviare automaticamente le carte d'imbarco al Google Wallet di un utente. Ciò avvantaggerà in particolare i viaggiatori frequenti, che potranno usufruire di un metodo più semplice e con meno attriti per aggiungere le carte d'imbarco a Wallet, data la loro maggiore frequenza di viaggio.

Ciò avviene automaticamente indipendentemente dal canale di check-in (ad es. web, app o chiosco dell'aeroporto). Le compagnie aeree partner possono utilizzare il numero di conto fedeltà dell'utente per correlare e inviare la tessera a Wallet.

Come funziona

Passaggio 1: consenti al viaggiatore abituale di aggiungere la sua tessera fedeltà per viaggiatori frequenti a Wallet.

Passaggio 2: aggiungi automaticamente le nuove carte d'imbarco per il viaggiatore abituale collegandole alla sua tessera fedeltà in Wallet.

Best practice

• Per consentire la registrazione al programma fedeltà senza problemi per i viaggiatori frequenti, valuta la possibilità di attivare un flusso di Registrazione / Accesso con Google. Gli utenti potranno quindi scoprire il flusso di registrazione al programma fedeltà della tua compagnia aerea in vari punti di accesso di Google Wallet, tra cui le carte d'imbarco.
• Valuta la possibilità di attivare la registrazione con un clic per i membri esistenti del programma fedeltà sulla tua app e sul tuo sito web Android.

Nota: questa funzionalità è un'implementazione specifica della funzionalità di collegamento automatico delle tessere. In questo contesto, la tessera principale si riferisce a una carta fedeltà e la tessera collegata si riferisce a una carta d'imbarco. Il resto di questo documento utilizza una terminologia più ampia (tessere collegate automaticamente, tessera principale e tessera collegata) per descrivere questa funzionalità.

Alcune considerazioni sull'utilizzo delle tessere collegate automaticamente

• L'oggetto principale e l'oggetto collegato devono utilizzare lo stesso issuerId.
• Il push automatico delle tessere collegate non è garantito ed è considerato il massimo sforzo. Gli utenti possono disattivare la ricezione delle tessere collegate automaticamente. Se il caso d'uso è critico e l'utente deve ricevere la tessera collegata, ti consigliamo di comunicare tramite un altro canale per assicurarti che l'utente aggiunga la tessera.
• Gli aggiornamenti alle Norme di utilizzo accettabile di Google Wallet includono indicazioni sull'utilizzo delle tessere collegate automaticamente, che devono essere rispettate.

Passaggi per l'integrazione

Se hai già creato un oggetto primario, puoi saltare il passaggio 1.

1. Crea un oggetto di qualsiasi tipo di tessera elencato con i parametri richiesti. Questo è l'oggetto principale.
2. Crea un altro oggetto di qualsiasi tipo di tessera elencato. Questo sarà l'oggetto collegato.
3. Prima o dopo il salvataggio dell'oggetto principale, aggiorna l'oggetto principale con l'ID dell'oggetto collegato nel parametro linkedObjectIds.

È richiesto un payload minimo per impostare linkedObjectIds su una tessera principale. I tre parametri obbligatori includono:

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

Esempio di richiesta JSON per aggiungere un oggetto collegato a un oggetto tessera

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

Esempio di risposta JSON dopo il collegamento di un oggetto a un oggetto tessera

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

Gestione delle eccezioni

Potrebbero verificarsi potenziali errori con l'utilizzo errato dell'API, che può includere:

Messaggio	Motivo
L'oggetto principale e l'oggetto collegato non condividono lo stesso ID emittente.	Non puoi collegare un oggetto collegato all'oggetto di un altro emittente.
L'oggetto principale e l'oggetto collegato si riferiscono allo stesso oggetto.	Non puoi allegare lo stesso oggetto di linkedObject.
L'oggetto collegato non esiste.	L'oggetto collegato deve essere già inserito nell'API Wallet.
L'oggetto collegato ha già un altro oggetto collegato. Impossibile aggiungere oggetti collegati nidificati.	Gli oggetti collegati non possono avere un altro oggetto collegato.
L'oggetto è già collegato a un altro oggetto. Impossibile aggiungere oggetti collegati nidificati.	L'oggetto principale non può essere un oggetto collegato.