Memicu Notifikasi Push

Jenis Pemberitahuan

Menambahkan Pesan dan Memberi Tahu

Latar belakang

Setelah pengguna menambahkan kartu, Anda dapat mengirim pesan terkait kartu tersebut kepada mereka dan memastikan mereka diberi tahu. Dengan menggunakan permintaan Add Message API dengan message_type sama dengan TEXT_AND_NOTIFY, hal berikut akan terjadi:

  1. Item "Pesan" ditambahkan ke "bagian belakang kartu" (alias Template Detail) dan notifikasi push dikirim ke pengguna dengan kartu yang disimpan.
  2. Setelah pengguna mengetuk notifikasi, Google Wallet akan terbuka di bagian depan kartu (alias Tampilan kartu) dan pengguna akan melihat info di bagian atas layar dengan tombol "Lihat Pesan".
  3. Mengklik info 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 agar kartu mereka dapat menerima notifikasi push yang terkait dengan 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 merupakan pelanggaran terhadap Kebijakan Penggunaan yang Dapat Diterima.
  • Anda dapat mengirim maksimal 3 pesan yang memicu notifikasi push dalam periode 24 jam. Google dapat membatasi kuota pengiriman notifikasi push jika menilai bahwa Anda mengirimkan 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 class atau objek reguler.

Langkah-langkah Integrasi

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

Contoh Permintaan JSON untuk menambahkan pesan dan memberi tahu 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 pemberitahuan dalam 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 untuk Class Kartu

  // 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 memberi tahu lebih dari 3 kali akan menghasilkan respons QuotaExceededException . Pembaruan lebih lanjut pada kartu dapat ditetapkan menggunakan "TEXT", bukan "TEXT_AND_NOTIFY" seperti yang dibahas dalam Langkah-langkah Integrasi.

Memperbarui Kolom dan Memberi Tahu

Latar belakang

Setelah pengguna menambahkan kartu, Anda dapat memicu notifikasi push saat memperbarui kolom tertentu. Notifikasi akan muncul di layar kunci pengguna dan memberi tahu mereka bahwa ada pembaruan pada kartu mereka. Notifikasi ini hanya akan dipicu untuk subset kolom tertentu yang ditentukan di bawah menggunakan metode API UPDATE dan PATCH. Setelah panggilan API untuk memperbarui kartu dilakukan, hal berikut akan terjadi:

  1. Notifikasi push dipicu dan ditampilkan di layar kunci pengguna, yang memberi tahu mereka tentang pembaruan kartu.
  2. Setelah pengguna mengetuk notifikasi, Google Wallet akan terbuka di bagian depan kartu (alias Tampilan kartu) dan pengguna akan melihat info di bagian atas layar dengan tombol "Tinjau pembaruan".
  3. Dengan mengklik tombol, pengguna akan diarahkan ke layar tempat mereka dapat melihat kolom yang diubah oleh update.

Beberapa pertimbangan saat mengirim notifikasi pembaruan kolom

  • Pengguna harus mengaktifkan notifikasi agar kartu mereka dapat menerima notifikasi push terkait pembaruan.
  • Anda dapat mengirim maksimal 3 pembaruan yang memicu notifikasi push dalam jangka waktu 24 jam. Google dapat membatasi kuota pengiriman notifikasi push Anda jika menganggap Anda mengirimkan spam kepada pengguna.
  • Notifikasi push yang dilihat pengguna di layar kunci mereka dikontrol oleh Google Wallet.
  • Kolom notifyPreference adalah kolom sementara yang hanya ada di permintaan ini. Untuk permintaan mendatang saat Anda ingin memicu notifikasi, Anda harus mereset kolom ini pada permintaan class atau objek.

Langkah-langkah Integrasi

Untuk memicu notifikasi ini, Anda harus menggunakan panggilan UPDATE atau PATCH yang ada dan menentukan notifyPreference. Saat memperbarui kolom di class atau objek, Anda dapat menambahkan kolom baru, notifyPreference, ke permintaan class atau objek untuk memicu notifikasi.

Contoh Permintaan JSON untuk memperbarui dan memberi tahu di Class

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

Menetapkan notifyPreference ke notifyOnUpdate akan memicu notifikasi, asalkan kolom yang diperbarui saat ini didukung.

Kolom yang didukung

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