แจ้งเตือนประสบการณ์

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

กำลังติดตาม:

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

  Your gold goose egg has hatched!

  Allie @LaterSk8er1 just beat your record on the Tokyo Tour track!

• เปิดเผยข้อมูล — รวมข้อมูลเปิดตัวที่ไม่บังคับ ข้อมูลเปิดตัว ที่สามารถอ่านได้ผ่าน Player:GetJoinData() เมื่อผู้รับการแจ้งเตือนเข้าร่วมอาจรวมถึงการเรียกเส้นทางผู้ใช้ไปยังตำแหน่งพิกัดหรือปรับแต่งประสบการณ์การเข้าร่วมของพวกเขา

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

ข้อกําหนดความเหมาะสม

เพื่อใช้ API เพื่อส่งการแจ้งเตือน ประสบการณ์จะต้องตอบสนองเกณฑ์พื้นฐานต่อไปนี้:

• การเยี่ยมชมขั้นต่ำ 100 เปิดใช้
• ประสบการณ์ไม่ควรอยู่ภายใต้การควบคุม
• คุณในฐานะผู้พัฒนาต้องมีสิทธิ์ในการจัดการประสบการณ์

คำแนะนำการใช้งาน

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

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

หรือคุณสามารถใช้ เปิด API เมฆ เพื่อเรียกการแจ้งเตือนผ่านคำขอ API แบบฟรีได้

สร้างสตริงการแจ้งเตือน

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

1. นําทางไปยัง แดชบอร์ดผู้สร้าง

2. คล้ายกับตรา แย่ สตริงการแจ้งเตือนถูกผูกกับประสบการณ์ เฉพาะ ค้นหาภาพรวมของประสบการณ์นั้นและคลิกที่มัน

3. ในคอลัมน์ด้านซ้ายภายใต้ การมีส่วนร่วม คลิก การแจ้งเตือน

4. ในภูมิภาคกลาง, คลิกปุ่ม สร้างสตริงการแจ้งเตือน

5. กรอกชื่อระบุตัวตน (สามารถมองเห็นได้เฉพาะคุณ) และสตริงการแจ้งเตือนที่กำหนดเอง; จำกัดเวลาไว้ที่ 99 ตัวอักษรและสามารถรวมถึงพารามิเตอร์ที่กำหนดเองไม่จำกัด ได้การแจ้งเตือนจะใช้ชื่อประสบการณ์ของคุณเป็นชื่อการแจ้งเตือนโดยอัตโนมัติ แต่คุณสามารถใช้ experienceName เพื่ออ้างอิงถึงประสบการณ์ในข้อความการแจ้งเตือนได้

   ตัวอย่างสตริงการแจ้งเตือน:

   You're {numQuests} quests away from completing the weekly challenge!

   Your {eggName} hatched! Come meet your new pet.

   You won {numRaces} races this week and unlocked the {racetrackName} track!

   {userId-friend} just beat your record on the Tokyo Tour track! Time for revenge?

   ก่อนที่จะเขียนสตริงการแจ้งเตือนโปรดตรวจสอบ แนวทาง สำหรับการใช้ระบบ

6. เมื่อพร้อมแล้ว คลิกที่ปุ่ม สร้างสตริงการแจ้งเตือน

7. บนหน้าการแจ้งเตือนในตารางการแจ้งเตือน คลิกปุ่ม ⋯ ในคอลัมน์ การดำเนินการ และเลือก คัดลอก ID ทรัพยากร

8. ใช้รหัสที่คัดลอกสำหรับค่ากุญแจ messageId ในตาราง payload ตามที่แสดงใน สคริปต์ตัวอย่าง

รวมแพคเกจ

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

1. จากแท็บ ดู เปิด กล่องเครื่องมือ และเลือกแท็บ ร้านค้าผู้สร้าง

   

2. ตรวจสอบให้แน่ใจว่าการจัดเรียง รูปแบบ ถูกเลือกแล้วคลิกที่ปุ่ม ดูทั้งหมด สำหรับ หมวดหมู่

   

3. ค้นหาและคลิกที่แท็บ โมดูลพัฒนา

   

4. ค้นหาโมดูล เปิดคลาวด์ และคลิกหรือลากลงไปในมุมมอง 3D

   

5. ในหน้าต่าง สํารวจ ย้ายรูปแบบ OpenCloud ทั้งหมดไปยัง ServerScriptService

   

ส่งการแจ้งเตือนประสบการณ์

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

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

ส่งการแจ้งเตือนประสบการณ์
local ServerScriptService = game:GetService("ServerScriptService")

local OCUserNotification = require(ServerScriptService.OpenCloud.V2.UserNotification)
local recipientPlayerID = 505306092

-- ในส่วนที่เป็นข้อมูล "messageId" คือมูลค่าของรหัสทรัพยากรการแจ้งเตือน
local userNotification = {
	payload = {
		messageId = "5dd7024b-68e3-ac4d-8232-4217f86ca244",
		type = "MOMENT"
	}
}

local result = OCUserNotification.createUserNotification(recipientPlayerID, userNotification)

if result.statusCode ~= 200 then
	print(result.statusCode)
	print(result.error.code)
	print(result.error.message)
end

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

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

จากนั้นตั้งพารามิเตอร์ userId-friend และ points ในสคริปต์:

กำหนดการแจ้งเตือนโดยใช้พารามิเตอร์
local ServerScriptService = game:GetService("ServerScriptService")

local OCUserNotification = require(ServerScriptService.OpenCloud.V2.UserNotification)
local recipientPlayerID = 505306092

local userIdFriendParam = {int64Value = 3702832553}
local pointsParam = {stringValue = "5"}

-- ในส่วนที่เป็นข้อมูล "messageId" คือมูลค่าของรหัสทรัพยากรการแจ้งเตือน
-- ในตัวอย่างนี้ สตริงการแจ้งเตือนคือ "{userId-friend} เอาชนะคะแนนสูงสุดของคุณโดย {points} จุด! ถึงเวลาเพิ่มเลเวลแล้วหรือยัง?"
local userNotification = {
	payload = {
		messageId = "ef0e0790-e2e8-4441-9a32-93f3a5783bf1",
		type = "MOMENT",
		parameters = {
			["userId-friend"] = userIdFriendParam,
			["points"] = pointsParam
		}
	}
}

local result = OCUserNotification.createUserNotification(recipientPlayerID, userNotification)

if result.statusCode ~= 200 then
	print(result.statusCode)
	print(result.error.code)
	print(result.error.message)
end

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

เพื่อส่งเสริมให้ผู้ใช้เปิดใช้งานการแจ้งเตือนสำหรับประสบการณ์ของคุณ คุณสามารถแสดงคำขออนุญาตในประสบการณ์ให้กับผู้ใช้อายุ 13+ โดยใช้วิธี ExperienceNotificationService:PromptOptIn() ได้

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

โมดัลจะไม่ ปรากฏ หากผู้ใช้:

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

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

1. โทร ExperienceNotificationService:CanPromptOptInAsync() , ห่อหุ้มด้วย pcall() เนื่องจากเป็นการโทรเครือข่ายแบบไม่สynchronous ที่อาจล้มเหลวได้เป็นครั้งคราว
2. หากผู้ใช้สามารถถูกขอได้ โทร ExperienceNotificationService:PromptOptIn()

LocalScript - การดําเนินการตามคําขอสิทธิการแจ้งเตือน
local ExperienceNotificationService = game:GetService("ExperienceNotificationService")

-- ฟังก์ชันเพื่อตรวจสอบว่าผู้เล่นสามารถถูกขอให้เปิดใช้งานการแจ้งเตือนได้หรือไม่
local function canPromptOptIn()
	local success, canPrompt = pcall(function()
		return ExperienceNotificationService:CanPromptOptInAsync()
	end)
	return success and canPrompt
end

local canPrompt = canPromptOptIn()
if canPrompt then
	local success, errorMessage = pcall(function()
		ExperienceNotificationService:PromptOptIn()
	end)
end

-- ฟังการแจ้งเตือนเพื่อเลือกเหตุการณ์ที่ปิดแล้ว
ExperienceNotificationService.OptInPromptClosed:Connect(function()
	print("Opt-in prompt closed")
end)

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

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

รวมข้อมูลเปิดตัวและข้อมูลวิเคราะห์
local ServerScriptService = game:GetService("ServerScriptService")

local OCUserNotification = require(ServerScriptService.OpenCloud.V2.UserNotification)
local recipientPlayerID = 505306092

-- ในส่วนที่เป็นข้อมูล "messageId" คือมูลค่าของรหัสทรัพยากรการแจ้งเตือน
local userNotification = {
	payload = {
		messageId = "5dd7024b-68e3-ac4d-8232-4217f86ca244",
		type = "MOMENT",
		joinExperience = {
			launchData = "Test_Launch_Data"
		},
		analyticsData = {
			category = "Test_Analytics_Category"
		}
	}
}

local result = OCUserNotification.createUserNotification(recipientPlayerID, userNotification)

if result.statusCode ~= 200 then
	print(result.statusCode)
	print(result.error.code)
	print(result.error.message)
end

ระบบจัดส่ง

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

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

นอกจากนี้รายการต่อไปนี้อธิบายเกี่ยวกับบางกรณีพิเศษที่อาจทำให้เกิด การไม่ส่ง การแจ้งเตือน:

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

  • ผู้รับและผู้ใช้ที่กล่าวถึงไม่ใช่เพื่อน
  • ผู้ใช้ที่กล่าวถึงมี ไม่มี ถูกเลือกสำหรับ "อัปเดตเพื่อนเกี่ยวกับกิจกรรมของฉัน?" ภายใต้ ความเป็นส่วนตัว → การตั้งค่าอื่นๆ ในการตั้งค่าบัญชี Roblox ของพวกเขา

การวิเคราะห์

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

1. นําทางไปที่ แดชบอร์ดผู้สร้าง
2. คล้ายกับตรา แย่ สตริงการแจ้งเตือนถูกผูกกับประสบการณ์ เฉพาะ ค้นหาภาพรวมของประสบการณ์นั้นและคลิกที่มัน
3. ในคอลัมน์ด้านซ้ายภายใต้ การมีส่วนร่วม คลิก การแจ้งเตือน 4. บนหน้าเป้าหมาย คลิกที่แท็บ วิเคราะห์ เพื่อสลับไปยังแดชบอร์ดวิเคราะห์

ข้อมูลสรุป

ส่วนสรุปใช้เป็นจุดสะท้อนถึงประสิทธิภาพรวมของการแจ้งเตือนของคุณจำเป็นต้องมีการแสดงผลสถิติประสิทธิภาพอย่างน้อย 100 รวมของการแสดงผลที่จำเป็น

สถิติแยกรายการ

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

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

หากคุณต้องการทดสอบประสิทธิภาพของสตริงที่แตกต่างกัน A/B แนะนำให้คุณสร้างสตริงการแจ้งเตือนใหม่ทั้งหมดด้วยชื่อที่คล้ายกัน เช่น:

• EggHatchA — "ไข่ทองของคุณได้ฟักแล้ว! มาพบกับสัตว์เลี้ยงใหม่ของคุณ"
• EggHatchB — "ถึงเวลาฟักไข่แล้ว! มาพบกับสัตว์เลี้ยงใหม่ของคุณ"

การอ้างอิง API

ฟังก์ชัน

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

ส่งการแจ้งเตือนจากสคริปต์ด้านเซิร์ฟเวอร์ต้องการ Player.UserId และ การแจ้งเตือนผู้ใช้ส่งคืน ผลการแจ้งเตือนผู้ใช้

ส่งการแจ้งเตือนประสบการณ์
local ServerScriptService = game:GetService("ServerScriptService")

local OCUserNotification = require(ServerScriptService.OpenCloud.V2.UserNotification)
local recipientPlayerID = 505306092

-- ในส่วนที่เป็นข้อมูล "messageId" คือมูลค่าของรหัสทรัพยากรการแจ้งเตือน
local userNotification = {
	payload = {
		messageId = "5dd7024b-68e3-ac4d-8232-4217f86ca244",
		type = "MOMENT"
	}
}

local result = OCUserNotification.createUserNotification(recipientPlayerID, userNotification)

if result.statusCode ~= 200 then
	print(result.statusCode)
	print(result.error.code)
	print(result.error.message)
end

ประเภท

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

ตารางที่มีรายละเอียดเกี่ยวกับการแจ้งเตือนที่จะส่งให้กับผู้ใช้ต้องมีตาราง payload ที่มีสตริงที่จําเป็น messageId และ type และตาราง parameters และ joinExperience และ analyticsData ที่เลือกได้

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

วัตถุห่อที่บรรจุคำตอบจากการแจ้งเตือนที่ส่ง ประกอบด้วยคู่คีย์-ค่าต่อไปนี้: