Perutean dan Ekspresi Tag

Ekspresi tag memungkinkan Anda menargetkan set perangkat tertentu, atau pendaftaran yang lebih 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 Registration Management, 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 dalamnya.

Backend aplikasi dapat memilih pendaftaran yang akan ditargetkan dengan pemberitahuan tertentu dengan cara berikut:

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

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

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

Nota

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.

Tags

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 pemberitahuan 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.

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 mengirim pemberitahuan metode 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 diprovisikan sebelumnya dan dapat merujuk ke beberapa konsep khusus aplikasi. Misalnya, pengguna aplikasi contoh ini dapat mengomentari band dan ingin menerima roti panggang, 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:

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 maupun Bob menerimanya.

Penting

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

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

Nota

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:

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

Ekspresi Tag

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

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

(follows_RedSox || follows_Cardinals) && location_Boston

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 mengirim pemberitahuan metode 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 Lainnya

Referensi API
tutorial Breaking News
Tutorial mengirim pemberitahuan ke pengguna