Notifikasi pengalaman adalah cara bagi pengguna yang berpartisipasi berusia 13 tahun ke atas untuk tetap terhubung dengan game favorit mereka melalui notifikasi yang cepat dan dipersonalisasi. Sebagai pengembang, Anda dapat menentukan jenis aktivitas dalam permainan yang paling penting untuk diberitahukan kepada pengguna Anda, serta mendefinisikan konten notifikasi.


Setelah mereka menerima notifikasi, pengguna dapat bergabung dengan pengalaman langsung melalui tombol Bergabung dan muncul sesuai dengan data peluncuran Anda.
Untuk informasi lebih lanjut tentang fitur, persyaratan kelayakan, pedoman penggunaan, dan API Engine yang sesuai, lihat Panduan Pengalaman.
Implementasi
Sumber daya UserNotification memungkinkan Anda mengirim notifikasi pengalaman kepada pengguna. Sebelum menggunakannya, Anda harus menghasilkan kunci API atau mengonfigurasi OAuth 2.0 untuk aplikasi Anda. Contoh di halaman ini menggunakan kunci API.
Untuk mengirim notifikasi pengalaman kepada pengguna:
- Buat string notifikasi di Dasbor Pembuat (langkah ini harus dilakukan di Dasbor Pembuat; tidak ada API Open Cloud untuk itu).
- Bentuk permintaan:
- Salin kunci API ke header permintaan x-api-key.
- Salin ID aset string notifikasi sebagai nilai dari properti payload.message_id.
- Atur payload.type ke "MOMENT".
- Atur source.universe menjadi URL sumber daya universe "universes/${UniverseID}".
curl --location 'https://apis.roblox.com/cloud/v2/users/${UserId}/notifications' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"source": {
"universe": "universes/${UniverseID}"
},
"payload": {
"message_id": "${AssetID}",
"type": "MOMENT"
}
}'Contoh respons yang mengembalikan ID notifikasi di bidang id:
{
"path": "users/505306092/notifications/6ca4d981-36fa-4255-82a1-14d95c116889",
"id": "6ca4d981-36fa-4255-82a1-14d95c116889"
}Sesuaikan notifikasi menggunakan parameter
Untuk menyesuaikan notifikasi untuk setiap penerima, sertakan parameter dalam string notifikasi. Kemudian sesuaikan parameter saat memanggil API. Misalnya, Anda dapat mendefinisikan string notifikasi sebagai:
Tambahkan parameter userId-friend dan points dalam skrip:
curl --location 'https://apis.roblox.com/cloud/v2/users/${UserId}/notifications' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"source": {
"universe": "universes/${UniverseID}"
},
"payload": {
"message_id": "${AssetID}",
"type": "MOMENT",
"parameters": {
"userId-friend": {"int64_value": 3702832553},
"points": {"string_value": "5"}
}
}
}'Sertakan data peluncuran dan analitik
Untuk lebih meningkatkan pengalaman pengguna, Anda dapat menyertakan data peluncuran dalam notifikasi, berguna untuk skenario seperti mengarahkan pengguna ke lokasi koordinat atau mempersonalisasi pengalaman bergabung. Selain itu, Anda dapat menyertakan data analitik untuk mengelompokkan kinerja berbagai kategori notifikasi.
curl --location 'https://apis.roblox.com/cloud/v2/users/${UserId}/notifications' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
"source": {
"universe": "universes/${UniverseID}"
},
"payload": {
"message_id": "${AssetID}",
"type": "MOMENT",
"join_experience": {
"launch_data": "Test_Launch_Data"
},
"analytics_data": {
"category": "Test_Analytics_Category"
}
}
}'Batasan dan pengiriman
Setiap pengguna dapat menerima satu notifikasi per hari dari pengalaman tertentu, dan Anda akan menerima umpan balik yang transparan ketika batas throttle pengguna tercapai.
Ada banyak alasan lain mengapa notifikasi mungkin tidak terkirim. Untuk informasi lebih lanjut, lihat Sistem Pengiriman dalam panduan Engine.