Attiva notifiche push

Notifiche attivate dal partner

Aggiungi messaggio e Avvisa

Sfondo

Dopo che un utente ha aggiunto una tessera, potresti volergli inviare un messaggio relativo alla tessera e assicurarti che riceva una notifica. Se utilizzi la richiesta dell' API Add Message con un valore message_type uguale a TEXT_AND_NOTIFY, si verifica quanto segue:

  1. Un elemento "Messaggio" viene aggiunto al "retro della tessera" (noto anche come Modello dettagli) e viene inviata una notifica push agli utenti con la tessera salvata.
  2. Quando l'utente tocca la notifica, Google Wallet si apre sulla parte anteriore della tessera (ovvero nella visualizzazione Scheda) e l'utente vedrà un callout nella parte superiore della schermata con un pulsante "Visualizza messaggio".
  3. Se fanno clic sul callout, gli utenti vengono indirizzati al retro della tessera, dove sono evidenziati i nuovi messaggi non letti.

Alcune considerazioni sull'invio di messaggi con notifiche agli utenti

  • Per ricevere le notifiche push relative ai messaggi, gli utenti devono aver attivato le notifiche per le tessere.
  • I messaggi possono contenere URI che rimandano al tuo sito web o alla tua app. I link ipertestuali devono rimandare a un sito web o un'app correlati alla tessera. È una violazione delle Norme relative all'utilizzo accettabile inviare gli utenti a link non correlati alla tessera.
  • Puoi inviare un massimo di 3 messaggi che attivano una notifica push nell'arco di 24 ore. Google potrebbe limitare la quota di invio delle notifiche push se ritiene che tu stia inviando spam ai tuoi utenti.
  • La notifica push visualizzata dagli utenti nella schermata di blocco è controllata da Google Wallet.
  • Puoi utilizzare i metodi UPDATE o PATCH per modificare o rimuovere i dati dei messaggi utilizzando l'endpoint di classe o oggetto normale.

Passaggi per l'integrazione

Quando vuoi notificare agli utenti un nuovo messaggio del gestore aggiunto utilizzando l'API AddMessage, devi aggiornare AddMessageRequest in modo che il Message contenente il nuovo testo abbia MessageType TEXT_AND_NOTIFY anziché TEXT.

Esempio di richiesta JSON per aggiungere un messaggio e inviare una notifica in una classe di documenti di viaggio

  …
  "id": ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Class message header",
        "body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

Esempio di richiesta JSON per aggiungere un messaggio e una notifica in un oggetto Passes

  …
  "id": OBJECT_ID",
  "classId": "ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Object message header",
        "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

Esempio di risposta per aggiungere un messaggio e inviare una notifica per un corso superato

  // The updated resource
  …
    {
      "kind": "walletobjects#walletObjectMessage",
      "header": "My Object message header",
      "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
      "id": "message_id",
      "messageType": "textAndNotify"
    },
  …

Gestione delle eccezioni

Qualsiasi tentativo di invio di notifiche per più di 3 volte restituirà una risposta QuotaExceededException . Eventuali aggiornamenti successivi alla pass possono essere impostati utilizzando "TEXT" anziché "TEXT_AND_NOTIFY", come descritto nella sezione Passaggi di integrazione.

Aggiorna campo e invia una notifica

Sfondo

Dopo che un utente ha aggiunto una tessera, ti consigliamo di attivare una notifica push quando aggiorni determinati campi. La notifica verrà visualizzata nella schermata di blocco dell'utente e lo informerà che c'è un aggiornamento della sua tessera. Questa notifica verrà attivata solo per un sottoinsieme specifico di campi definito di seguito utilizzando i metodi dell'API UPDATE e PATCH. Una volta effettuata una chiamata API per aggiornare la tessera, si verifica quanto segue:

  1. Viene attivata e visualizzata una notifica push nella schermata di blocco dell'utente per informarlo di un aggiornamento della tessera.
  2. Quando l'utente tocca la notifica, Google Wallet si apre sulla parte anteriore della tessera (ovvero nella visualizzazione Scheda) e l'utente vedrà un callout nella parte superiore dello schermo con il pulsante "Esamina aggiornamenti".
  3. Se fa clic sul pulsante, l'utente viene indirizzato a una schermata in cui può vedere i campi modificati dall'aggiornamento.

Alcune considerazioni sull'invio di notifiche di aggiornamento dei campi

  • Per ricevere le notifiche push relative agli aggiornamenti, gli utenti devono aver attivato le notifiche per le tessere.
  • Puoi inviare un massimo di 3 aggiornamenti che attivano una notifica push nell'arco di 24 ore. Google potrebbe limitare la quota di invio delle notifiche push se ritiene che tu stia inviando spam ai tuoi utenti.
  • La notifica push che gli utenti vedono nella schermata di blocco è controllata da Google Wallet.
  • Il campo notifyPreference è un campo transitorio che esiste solo in questa richiesta. Per le richieste future in cui vuoi attivare una notifica, dovrai reimpostare questo campo nella richiesta della classe o dell'oggetto.

Passaggi per l'integrazione

Per attivare queste notifiche, dovrai utilizzare le chiamate UPDATE o PATCH esistenti e specificare notifyPreference. Quando aggiorni un campo in un corso o in un oggetto, puoi aggiungere un nuovo campo, notifyPreference, alla richiesta del corso o dell'oggetto per attivare la notifica.

Esempio di richiesta JSON per aggiornare e inviare notifiche in un corso

    …
    "dateTime":
        {
            "kind": "walletobjects#eventDateTime",
            "doorsOpen": "2024-09-23T19:20:50.00"
        },
    "multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
    "notifyPreference": "notifyOnUpdate",
    …

L'impostazione di notifyPreference su notifyOnUpdate attiverà una notifica, a condizione che il campo aggiornato sia attualmente supportato.

Campi supportati

FlightObject
  • boardingAndSeatingInfo.seatNumber
  • boardingAndSeatingInfo.seatAssignment

Notifiche automatiche attivate da Google Wallet

Notifica imminente

Google Wallet invia una notifica all'utente tre ore prima del volo. La durata del volo è definita da class.localScheduledDepartureDateTime.

Per ricevere questa notifica, l'utente deve aver attivato le notifiche. Per verificare, può selezionare Impostazioni > Notifiche e controllare se l'opzione Aggiornamenti sulle tue tessere è attivata.

La notifica viene visualizzata nell'area delle notifiche e nella schermata di blocco, se l'utente ha attivato le notifiche per la schermata di blocco.

La notifica ha il seguente formato non modificabile: 

  Boarding pass for your flight to class.destination.airportIataCode

Se tocca la notifica e sblocca il dispositivo, la tessera viene visualizzata nell'app Google Wallet.

Se l'utente ha più tessere, viene mostrata solo quella utilizzabile più presto. Se ha aggiunto tessere raggruppate come descritto in Raggruppare più tessere di imbarco, la notifica mostra solo una delle tessere nel gruppo. Tuttavia, quando lo tocca, l'utente può scorrere verso sinistra e destra per vedere le altre tessere del gruppo.

La notifica viene bloccata e non viene ignorata automaticamente dopo che un utente la apre. La chiusura automatica avviene 60 minuti dopo class.localScheduledDepartureDateTime.

Notifica aggiornamento volo

Quando vengono modificati determinati campi di un volo, gli utenti con una o più carte d'imbarco aggiunte ricevono una notifica push sui loro dispositivi. Ciò si verifica solo se sono soddisfatte determinate condizioni.

Terminal e gate di partenza

Se modifichi class.origin.terminal o class.origin.gate e viene soddisfatta la seguente condizione, viene inviata una notifica che indica che il campo è stato modificato.

  • Mancano meno di tre ore prima delle ore class.localScheduledDepartureDateTime.

La notifica ha il seguente formato: "Sample Airlines ha aggiornato il tuo gate in A1". Il formato non può essere modificato.

Orari di imbarco e partenza

Se modifichi class.localBoardingDateTime o class.localEstimatedOrActualDepartureDateTime e le condizioni riportate di seguito sono soddisfatte, viene inviata una notifica che indica che il campo è stato modificato.

  • Mancano meno di 24 ore prima del giorno class.localScheduledDepartureDateTime.
  • La rispettiva ora cambia di almeno 10 minuti o più.

La notifica è nel seguente formato: "_Sample Airlines ha aggiornato l'orario di imbarco su 18:00._" Il formato o la lingua non possono essere personalizzati.