Aggiungere automaticamente le carte d'imbarco

Sfondo

Questa 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 attrito per aggiungere le carte d'imbarco a Wallet grazie alla loro maggiore frequenza di viaggio.

Ciò avviene automaticamente indipendentemente dal canale di check-in (ad es. web, app o chiosco dell'aeroporto). La compagnia aerea utilizza il numero di account fedeltà dell'utente per correlare e inviare la tessera.

Nota: questa funzionalità è un'implementazione specifica della funzionalità "Tessere collegate automaticamente". Il resto del documento utilizza la terminologia più ampia "Tessere collegate automaticamente", nonché "tessera principale" e "tessera collegata" per descrivere questa funzionalità.

Come funziona

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

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

Alcune considerazioni sull'utilizzo delle tessere collegate automaticamente

• L'oggetto principale e l'oggetto collegato devono utilizzare lo stesso issuerId.
• Esiste un limite di 50 oggetti collegati per oggetto principale.
• 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"
  }
  …

Comportamento previsto

Dopo aver ricevuto una risposta positiva, i dispositivi con la tessera che hai aggiornato dovrebbero ricevere la tessera collegata. Questa tessera collegata verrà raggruppata con la tessera principale. Gli utenti possono visualizzare la tessera collegata scorrendo verso destra.

Gestione delle eccezioni

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