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

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

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

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

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

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

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

1. สร้างข้อความการแจ้งเตือน ใน Creator Dashboard (ขั้นตอนนี้ต้องทำใน Creator Dashboard; ไม่มี Open Cloud API สำหรับมัน)
2. จัดรูปแบบคำขอ:

   1. คัดลอกคีย์ API ไปยังส่วนหัวคำขอ x-api-key
   2. คัดลอก Asset 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"}
		}
	}
}'

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

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

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

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

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

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