Bagikan melalui

Perutean dan Ekspresi Tag

  • Artikel

Ekspresi tag memungkinkan Anda menargetkan kumpulan perangkat tertentu, atau pendaftaran khusus, saat mengirim pemberitahuan push melalui Notification Hubs.

Menargetkan Pendaftaran Tertentu

Satu-satunya cara untuk menargetkan pendaftaran tertentu adalah dengan mengaitkannya dengan tag, lalu menargetkan tag tersebut. Seperti yang dibahas dalam Manajemen Pendaftaran, untuk menerima pemberitahuan push, aplikasi harus mendaftarkan handel perangkat di hub pemberitahuan. Setelah pendaftaran dibuat di hub pemberitahuan, backend aplikasi dapat mengirim pemberitahuan push ke hub tersebut.

Ujung belakang aplikasi dapat memilih pendaftaran yang ditargetkan dengan pemberitahuan khusus dengan cara berikut:

  1. Siaran: semua pendaftaran di notification hub akan menerima pemberitahuan.

  2. Tag: semua pendaftaran yang berisi tag yang ditentukan akan menerima pemberitahuan.

  3. Ekspresi tag: semua pendaftaran yang kumpulan tagnya cocok dengan ekspresi yang ditentukan akan menerima pemberitahuan.

Catatan

Saat mengirim payload khusus platform (misalnya, pemberitahuan spesifik Windows Store), hanya pendaftaran untuk platform tertentu yang akan menerima pemberitahuan. Saat mengirim pemberitahuan templat, hanya pendaftaran yang menentukan templat yang ditargetkan. Untuk informasi selengkapnya, lihat Manajemen Pendaftaran.

Tag

Tag dapat berupa string apa pun, hingga 120 karakter, yang berisi alfanumerik dan karakter non-alfanumerik berikut: '_', '@', '#', '.', ':', '-'. Contoh berikut menunjukkan aplikasi tempat Anda dapat menerima notifikasi toast tentang grup musik tertentu. Dalam skenario ini, cara sederhana untuk merutekan pemberitahuan adalah dengan memberi label pendaftaran dengan tag yang mewakili pita yang berbeda, seperti pada gambar berikut.

Tag Expressions

Dalam gambar ini, pesan yang ditandai Beatles hanya mencapai tablet yang terdaftar dengan tag Beatles.

Untuk informasi selengkapnya tentang membuat pendaftaran untuk tag, lihat Manajemen Pendaftaran.

Anda dapat mengirim pemberitahuan ke tag menggunakan metode kirim pemberitahuan dari kelas Microsoft.ServiceBus.Notifications.NotificationHubClient di SDK. Anda juga dapat menggunakan Node.js, atau REST API Pemberitahuan Push.

Perhatikan contoh berikut:

await hub.SendWindowsNativeNotificationAsync(wnsToast, "tag");

notificationHubService.wns.sendToastText01('tag', {
            text1: 'Hello World!'
        }, callback);

Tag tidak harus disediakan sebelumnya dan dapat merujuk ke beberapa konsep khusus aplikasi. Misalnya, pengguna aplikasi contoh ini dapat mengomentari band dan ingin menerima toast, tidak hanya untuk komentar di band favorit mereka, tetapi juga untuk semua komentar dari teman-teman mereka, terlepas dari band tempat mereka berkomentar. Gambar berikut ini memperlihatkan contoh skenario ini:

Tag Expressions

Dalam gambar ini, Alice tertarik pada pembaruan untuk The Beatles, dan Bob tertarik pada pembaruan untuk Wailers. Bob juga tertarik dengan komentar Charlie, dan Charlie tertarik dengan Wailers. Ketika pemberitahuan dikirim untuk komentar Charlie di The Beatles, baik Alice dan Bob menerimanya.

Penting

Meskipun Anda dapat mengodekan beberapa masalah dalam tag (misalnya, "band_Beatles" atau "follows_Chanrlie"), tag adalah string sederhana dan bukan properti dengan nilai. Pendaftaran hanya dicocokkan dengan ada atau tidak adanya tag tertentu.

Untuk tutorial langkah demi langkah penuh tentang cara menggunakan tag untuk mengirim ke grup minat, lihat Breaking News.

Catatan

Dalam contoh sebelumnya, Anda harus mengirim satu pemberitahuan ke dua tag (menyediakan array tag, atau menggunakan ekspresi tag dengan OR), bukan dua pemberitahuan. Mengirim dua pemberitahuan ke tag individual menghasilkan duplikat untuk pendaftaran yang memiliki kedua tag, sementara menggunakan ekspresi tag tidak akan.

Menggunakan Tag untuk Menargetkan Pengguna

Cara lain untuk menggunakan tag adalah dengan mengidentifikasi semua perangkat pengguna tertentu. Pendaftaran dapat ditandai dengan tag yang berisi id pengguna, seperti pada gambar berikut:

Tag Expressions

Dalam gambar ini, pesan yang ditandai uid:Alice mencapai semua pendaftaran yang ditandai uid:Alice; oleh karena itu, semua perangkat Alice.

Ekspresi Tag

Ada beberapa kasus di mana pemberitahuan harus menargetkan serangkaian pendaftaran yang diidentifikasi bukan oleh satu tag, tetapi oleh ekspresi Boolean pada tag.

Bayangkan misalnya aplikasi olahraga yang mengirimkan pengingat kepada semua orang di Boston tentang permainan antara Red Sox dan Kardinal. Jika aplikasi klien mendaftarkan tag tentang minat dalam tim dan lokasi, maka pemberitahuan harus ditargetkan untuk semua orang di Boston yang tertarik pada Red Sox atau Kardinal. Kondisi ini dapat diungkapkan dengan ekspresi Boolean berikut:

(follows_RedSox || follows_Cardinals) && location_Boston

Tag Expressions

Ekspresi tag dapat berisi semua operator Boolean, seperti AND (&&), OR (||), dan NOT (!). Mereka juga dapat berisi tanda kurung. Ekspresi tag dibatasi hingga 20 tag jika hanya berisi OU; jika tidak, mereka dibatasi hingga 6 tag.

Anda dapat mengirim pemberitahuan ke ekspresi tag menggunakan metode kirim pemberitahuan dari kelas Microsoft.ServiceBus.Notifications.NotificationHubClient di SDK. Anda juga dapat menggunakan Node.js, atau REST API Pemberitahuan Push. Perhatikan contoh berikut:

await hub.SendWindowsNativeNotificationAsync(wnsToast, "(tagA && !tagB)");

notificationHubService.wns.sendToastText01('(tagA && !tagB)', {
            text1: 'Hello World!'
        }, callback);

Lihat juga

Sumber Daya Lain

Referensi API
Tutorial Breaking News
Mengirim pemberitahuan ke tutorial pengguna