การแจ้งเตือนของผู้ใช้

การแจ้งเตือนประสบการณ์ เป็นวิธีสำหรับผู้ใช้ที่เลือก ลงทะเบียน อายุ 13+ เพื่อติดตามประสบการณ์ที่ชื่นชอบผ่านการแจ้งเตือนอย่างทันเวลาและกำหนดเองในฐานะผู้พัฒนาคุณสามารถกำหนดได้ว่ากิจกรรมในประสบการณ์ชนิดใดที่สำคัญที่สุดที่จะแจ้งให้ผู้ใช้ของคุณทราบรวมถึงกำหนดเนื้อหาการแจ้งเตือน

หลังจากที่พวกเขาได้รับการแจ้งเตือนแล้วผู้ใช้สามารถเข้าร่วมประสบการณ์โดยตรงผ่านปุ่ม เข้าร่วม และจุดเกิดตามข้อมูลการเปิดตัวของคุณ

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับคุณลักษณะ ข้อกําหนดด้านความเหมาะสม ข้อกําหนดการใช้งาน และ Engine APIโปรดดูคู่มือประสบการณ์ Experiences guide

การดำเนินการ

ทรัพยากร การแจ้งเตือนผู้ใช้ ช่วยให้คุณสามารถส่งการแจ้งเตือนประสบการณ์ให้กับผู้ใช้ได้ก่อนที่จะใช้งานคุณต้อง สร้างคีย์ API หรือ กำหนดค่า OAuth 2.0 สำหรับแอปของคุณตัวอย่างบนหน้านี้ใช้คีย์ API

เพื่อส่งการแจ้งเตือนประสบการณ์ให้กับผู้ใช้:

1. สร้างสตริงการแจ้งเตือน ใน แดชบอร์ดของผู้สร้างขั้นตอนนี้ต้องทำในแดชบอร์ดของผู้สร้าง; ไม่มี Open Cloud API สำหรับมัน
2. สร้างคำขอ:

   1. คัดลอกคีย์ API ไปยังหัวข้อคำขอ x-api-key
   2. คัดลอก ID ของสตริงการแจ้งเตือนเป็นค่าของคุณสมบัติ payload.message_id
   3. ตั้ง payload.type เป็น "MOMENT" .
   4. ตั้ง source.universe ให้เป็น URL ทรัพยากรจักรวาล "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"
	}
}'

ตัวอย่างคำตอบที่ส่ง ID การแจ้งเตือนในฟิลด์ id:

{
  "path": "users/505306092/notifications/6ca4d981-36fa-4255-82a1-14d95c116889",
  "id": "6ca4d981-36fa-4255-82a1-14d95c116889"
}

กำหนดการแจ้งเตือนโดยใช้พารามิเตอร์

เพื่อปรับแต่งการแจ้งเตือนสำหรับผู้รับแต่ละราย ให้รวม พารามิเตอร์ ใน สตริงการแจ้งเตือนจากนั้นปรับแต่งพารามิเตอร์เมื่อเรียกใช้ APIตัวอย่างเช่น คุณสามารถกำหนดสตริงการแจ้งเตือนได้เป็น:

เพิ่มพารามิเตอร์ userId-friend และ points ในสคริปต์:

กำหนดการแจ้งเตือนโดยใช้พารามิเตอร์
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"}
		}
	}
}'

รวมข้อมูลเปิดตัวและการวิเคราะห์

เพื่อปรับปรุงประสบการณ์ผู้ใช้ต่อไป คุณสามารถรวม ข้อมูลการเปิดระบบ ในการแจ้งเตือนที่มีประโยชน์สำหรับสถานการณ์เช่นเส้นทางการส่งผู้ใช้ไปยังตำแหน่งพิกัดหรือปรับปรุงประสบการณ์การเชื่อมต่อนอกจากนี้คุณสามารถรวมข้อมูลวิเคราะห์ analytics เพื่อแยกประสิทธิภาพของหมวดหมู่ต่างๆ ของการแจ้งเตือนได้

รวมข้อมูลเปิดตัวและข้อมูลวิเคราะห์
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"
	}
}'

ขีดจํากัดอัตราและการจัดส่ง

ผู้ใช้แต่ละคนสามารถรับการแจ้งเตือน หนึ่ง ต่อวันจากประสบการณ์ที่กำหนดและคุณจะได้รับความเห็นโดยตรงเมื่อถึงขีดจํากัดการจํากัดความเร็วของผู้ใช้

มีเหตุผลอื่นๆ อีกมากมายที่การแจ้งเตือนอาจไม่ถูกส่ง สำหรับข้อมูลเพิ่มเติม โปรดดู ระบบการจัดส่ง ในคู่มือเครื่องยนต์