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.

Perbarui Kolom dan Beri Notifikasi

Latar belakang

Setelah pengguna menambahkan kartu, Anda mungkin ingin memicu notifikasi push saat memperbarui kolom tertentu. Notifikasi akan muncul di layar kunci pengguna dan memberi tahu mereka bahwa ada update pada kartu mereka. Notifikasi ini hanya akan dipicu untuk subkumpulan 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 membuka bagian depan tiket (alias tampilan Kartu) dan pengguna akan melihat balon 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 untuk kartu mereka agar dapat menerima notifikasi push terkait pembaruan.
  • Anda dapat mengirimkan maksimal 3 pembaruan yang memicu notifikasi push dalam jangka waktu 24 jam. Google dapat membatasi kuota pengiriman notifikasi push Anda jika dianggap Anda mengirim spam kepada pengguna.
  • Notifikasi push yang dilihat pengguna di layar kunci mereka dikontrol oleh Google Wallet.
  • Kolom notifyPreference adalah kolom sementara yang hanya ada dalam 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 pada class atau objek, Anda dapat menambahkan kolom baru, notifyPreference, ke permintaan class atau objek untuk memicu notifikasi.

Contoh Permintaan JSON untuk memperbarui dan mengirimkan notifikasi di Kelas

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

EventTicketClass
  • eventName
  • eventVenue.name
  • eventvenue.address
  • eventDateTime.doorsOpen
  • eventDateTime.start
EventTicketObject
  • eventSeat.seat
  • eventSeat.row
  • eventSeat.section
  • eventSeat.gate

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.

Notifikasi Otomatis yang Dipicu oleh Google Wallet

Notifikasi Mendatang

Google Wallet mengirimkan notifikasi kepada pengguna tiga jam sebelum acara. Waktu acara ditentukan oleh class.dateTime.start.

Untuk menerima notifikasi ini, pengguna harus mengaktifkan notifikasi. Untuk memeriksanya, mereka dapat membuka Setelan > Notifikasi dan melihat apakah Info terbaru tentang kartu Anda diaktifkan.

Notifikasi akan muncul di area notifikasi, dan di layar kunci, jika pengguna telah mengaktifkan notifikasi untuk layar kunci.

Notifikasi memiliki format berikut yang tidak dapat diubah: 

  class.eventName

Jika mereka mengetuk notifikasi dan membuka kunci perangkat, kartu pas mereka akan muncul di aplikasi Google Wallet.

Jika pengguna memiliki beberapa kartu, hanya kartu yang dapat digunakan paling awal yang ditampilkan. Jika mereka telah menambahkan kartu yang dikelompokkan sesuai dengan Mengelompokkan beberapa tiket Acara, notifikasi hanya menampilkan salah satu kartu dalam grup. Namun, saat mengetuknya, pengguna dapat menggeser ke kiri dan kanan untuk melihat kartu lainnya dalam grup tersebut.

Notifikasi disematkan dan tidak akan otomatis ditutup setelah pengguna membukanya. Penutupan otomatis terjadi 60 menit setelah class.dateTime.start.