Memicu Notifikasi Push

Notifikasi yang Dipicu Partner

Menambahkan Pesan dan Memberi Notifikasi

Latar belakang

Setelah pengguna menambahkan kartu, Anda mungkin ingin mengirimkan pesan terkait kartu tersebut dan memastikan pengguna menerima notifikasinya. Menggunakan permintaan Add Message API dengan message_type yang sama dengan TEXT_AND_NOTIFY, maka akan terjadi hal berikut:

  1. Item "Pesan" ditambahkan ke "bagian belakang kartu" (alias Template Detail) dan notifikasi push dikirim ke pengguna yang menyimpan kartu.
  2. Setelah pengguna mengetuk notifikasi, Google Wallet akan terbuka di bagian depan kartu (alias tampilan Kartu) dan pengguna akan melihat balon di bagian atas layar dengan tombol "Lihat Pesan".
  3. Mengklik balon akan mengarahkan pengguna ke bagian belakang kartu, tempat pesan baru yang belum dibaca ditandai.

Beberapa pertimbangan saat mengirim pesan dengan notifikasi kepada pengguna

  • Pengguna harus mengaktifkan notifikasi untuk kartu mereka agar dapat menerima notifikasi push terkait pesan.
  • Pesan dapat berisi URI ke situs atau aplikasi Anda. Hyperlink harus berupa situs atau aplikasi yang terkait dengan kartu. Mengarahkan pengguna ke link yang tidak terkait dengan kartu adalah pelanggaran terhadap Kebijakan Penggunaan yang Dapat Diterima.
  • Anda dapat mengirimkan maksimum 3 pesan yang memicu notifikasi push dalam jangka waktu 24 jam. Google dapat membatasi kuota pengiriman notifikasi push Anda jika menganggap Anda mengirim spam kepada pengguna.
  • Notifikasi push yang dilihat pengguna di layar kunci mereka dikontrol oleh Google Wallet.
  • Anda dapat menggunakan metode UPDATE atau PATCH untuk mengedit atau menghapus data pesan menggunakan endpoint objek atau class reguler.

Langkah-Langkah Integrasi

Jika ingin memberi tahu pengguna tentang pesan penerbit baru yang ditambahkan menggunakan AddMessage API, Anda harus memperbarui AddMessageRequest sehingga Message yang berisi teks baru Anda memiliki MessageType TEXT_AND_NOTIFY, bukan TEXT.

Contoh Permintaan JSON untuk menambahkan pesan dan mengirim notifikasi di Class Kartu

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

Contoh Permintaan JSON untuk menambahkan pesan dan memberi tahu di Objek Kartu

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

Contoh Respons untuk menambahkan pesan dan memberi tahu tentang Lulus Kelas

  // 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"
    },
  …

Penanganan pengecualian

Setiap upaya untuk mengirimkan notifikasi lebih dari 3 kali akan menghasilkan respons QuotaExceededException . Pembaruan lebih lanjut pada kartu dapat ditetapkan menggunakan "TEXT" dan bukan "TEXT_AND_NOTIFY" seperti yang dibahas dalam Langkah-Langkah Integrasi.

Notifikasi di Sekitar

Fitur ini akan menampilkan notifikasi push kepada pengguna yang telah mengaktifkan notifikasi dan memberikan akses lokasi yang akurat dan selalu aktif ke aplikasi Google Wallet, yang mengingatkan mereka bahwa mereka telah menyimpan kartu yang relevan dengan lokasi mereka saat ini.

Langkah-Langkah Integrasi

Cara menggunakan

Untuk menggunakan fitur ini, Anda perlu menambahkan lokasi ke class dan objek. Anda dapat menambahkan hingga 10 lokasi per kelas dan 10 per objek. Gunakan MerchantLocations dalam definisi class atau objek Anda. Anda dapat menambahkan lokasi ini saat menggunakan metode insert, patch, atau update.

Setelah Anda menambahkan lokasi ke class atau objek, Google akan mengirimkan notifikasi kepada pengguna saat mereka berada di dekat lokasi tersebut. Google memutuskan seberapa dekat pengguna harus berada dan berapa lama mereka harus berada di area tersebut sebelum notifikasi dikirim. Google juga mengontrol teks notifikasi.

Contoh LoyaltyClass dengan MerchantLocations yang ditetapkan: 
{
  "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
    },
  ]
}

Perilaku yang Diharapkan

Pengguna akan mendapatkan notifikasi tetap tentang kartu mereka saat berada di salah satu MerchantLocation yang ditentukan. Jika mereka mengklik notifikasi, kartu pas mereka akan terbuka di Google Wallet. Pengguna dapat menutup notifikasi dengan gestur geser. Saat pengguna meninggalkan lokasi, notifikasi akan menghilang.