Attiva notifiche push

Notifiche attivate dai partner

Aggiungere un messaggio e inviare una notifica

Sfondo

Dopo che un utente ha aggiunto un pass, potresti voler inviargli un messaggio correlato al pass e assicurarti che riceva una notifica. Se utilizzi la richiesta dell'API Add Message con un message_type uguale a TEXT_AND_NOTIFY , si verifica quanto segue:

  1. Viene aggiunto un elemento "Messaggio" al "retro del pass" (ovvero al modello di dettagli) e viene inviata una notifica push agli utenti che hanno salvato il pass.
  2. Quando l'utente tocca la notifica, si apre Google Wallet sul fronte del pass (ovvero la visualizzazione schede) e l'utente vedrà un callout nella parte superiore dello schermo con un pulsante "Visualizza messaggio".
  3. Se fai clic sul callout, gli utenti vengono indirizzati al retro del pass, dove i nuovi messaggi non letti sono evidenziati.

Alcune considerazioni sull'invio di messaggi con notifiche agli utenti

  • Gli utenti devono aver attivato le notifiche per i pass per ricevere le notifiche push relative ai messaggi.
  • I messaggi possono contenere URI al tuo sito web o alla tua app. I link ipertestuali devono essere a un sito web o a un'app correlati al pass. L'invio di link agli utenti non correlati al pass costituisce una violazione delle Norme di utilizzo accettabile.
  • Puoi inviare un massimo di tre messaggi che attivano una notifica push in un periodo 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.
  • Puoi utilizzare i metodi UPDATE o PATCH per modificare o rimuovere i dati dei messaggi utilizzando l'endpoint regolare della classe o dell'oggetto.

Passaggi per l'integrazione

Quando vuoi inviare una notifica agli utenti in merito a un nuovo messaggio dell'emittente aggiunto utilizzando l' API AddMessage, devi aggiornare AddMessageRequest in modo che il messaggio 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 pass

  …
  "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 inviare una notifica in un oggetto pass

  …
  "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 una classe di pass

  // 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 inviare una notifica più di tre volte genererà una risposta QuotaExceededException . Eventuali ulteriori aggiornamenti al pass possono essere impostati utilizzando "TEXT" anziché "TEXT_AND_NOTIFY" come descritto nei passaggi per l'integrazione.

Aggiornare un campo e inviare una notifica

Sfondo

Dopo che un utente ha aggiunto un pass, potresti voler attivare una notifica push quando aggiorni determinati campi. La notifica verrà visualizzata nella schermata di blocco dell'utente e lo informerà che è disponibile un aggiornamento per il suo pass. Questa notifica verrà attivata solo per un sottoinsieme specifico di campi definiti di seguito utilizzando i metodi API UPDATE e PATCH. Una volta effettuata una chiamata API per aggiornare il pass, si verifica quanto segue:

  1. Viene attivata e visualizzata una notifica push nella schermata di blocco dell'utente, che lo informa di un aggiornamento del pass.
  2. Quando l'utente tocca la notifica, si apre Google Wallet sul fronte di del pass (ovvero la visualizzazione schede) e l'utente vedrà un callout nella parte superiore dello schermo con un pulsante "Esamina aggiornamento".
  3. Se fai clic sul pulsante, l'utente viene indirizzato a una schermata in cui può visualizzare i campi modificati dall'aggiornamento.

Alcune considerazioni sull'invio di notifiche di aggiornamento dei campi

  • Gli utenti devono aver attivato le notifiche per i pass per ricevere le notifiche push relative agli aggiornamenti.
  • Una notifica viene attivata solo se l'ora di inizio dell'evento o del volo è entro 3 ore per evitare di inviare spam agli utenti.
  • Puoi inviare un massimo di tre aggiornamenti che attivano una notifica push in un periodo 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 temporaneo che esiste solo in questa richiesta. Per le richieste future in cui vuoi attivare una notifica, tu dovrai reimpostare questo campo nella richiesta di classe o oggetto.

Passaggi per l'integrazione

Per attivare queste notifiche, devi utilizzare le chiamate UPDATE o PATCH esistenti e specificare notifyPreference. Quando aggiorni un campo in una classe o in un oggetto, puoi aggiungere un nuovo campo, notifyPreference, alla richiesta di classe o oggetto per attivare la notifica.

Esempio di richiesta JSON per aggiornare e inviare una notifica in una classe

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

Se imposti notifyPreference su notifyOnUpdate, verrà attivata una notifica, a condizione che il campo aggiornato sia attualmente supportato.

Campi supportati

LoyaltyClass
  • rewardsTier
  • secondaryRewardsTier
  • programName
LoyaltyObject
  • loyaltyPoints.balance
  • secondaryLoyaltyPoints.balance

Notifiche Qui vicino

Questa funzionalità mostrerà agli utenti che hanno attivato le notifiche e concesso l'accesso alla posizione precisa e sempre attiva all'app Google Wallet una notifica push che ricorda loro che hanno salvato un pass pertinente alla loro posizione attuale.

Passaggi per l'integrazione

Modalità di utilizzo

Per utilizzare questa funzionalità, devi aggiungere le località alle classi e agli oggetti. Puoi aggiungere fino a 10 località per classe e 10 per oggetto. Utilizza MerchantLocations nella definizione della classe o dell'oggetto. Puoi aggiungere queste località quando utilizzi i metodi insert, patch o update.

Dopo aver aggiunto le località a una classe o a un oggetto, Google invierà notifiche agli utenti quando si trovano nelle vicinanze. Google decide quanto vicino deve trovarsi un utente e per quanto tempo deve rimanere nell'area prima che venga inviata la notifica. Google controlla anche il testo della notifica.

Esempio di LoyaltyClass con MerchantLocations impostato: 
{
  "kind": "walletobjects#loyaltyClass",
  "programLogo": {
  "kind": "walletobjects#image",
  "sourceUri": {
    "uri":
    ...
  }
  },
  "localizedProgramName": {
    "kind": "walletobjects#localizedString",
    "defaultValue": {
      "kind": "walletobjects#translatedString",
      "language": "en",
      "value": "Program Name",
    }
  },
  "id": Id1234,
  "version": "1",
  "allowMultipleUsersPerObject": true,
  "reviewStatus": "underReview",
  "enableSmartTap": false,
  "localizedIssuerName": {
    "kind": "walletobjects#localizedString",
    "defaultValue": {
      "kind": "walletobjects#translatedString",
      "language": "en",
      "value": "Issuer Name"
    }
  },
  "multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
  "merchantLocations": [
    {
      "latitude": 37.79020867928078,
      "longitude": -122.39004
    },
    {
      "latitude": 37.42587,
      "longitude": -122.08620
    },
  ]
}

Comportamento previsto

Gli utenti dovrebbero ricevere notifiche permanenti sui loro pass quando si trovano in una delle MerchantLocations specificate. Se fanno clic sulla notifica, il pass si aprirà in Google Wallet. Gli utenti possono ignorare la notifica con il gesto di scorrimento. Quando un utente lascia la località, la notifica scompare.