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

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

ระบบการแจ้งเตือนประสบการณ์มีคุณสมบัติดังต่อไปนี้:

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

  ไข่ทองคำของคุณได้ฟักออกมาแล้ว!

  Allie @LaterSk8er1 เพิ่งทำลายสถิติของคุณในเส้นทาง Tokyo Tour!

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

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

ข้อกำหนดคุณสมบัติ

In order to use the APIs to send notifications, the game must meet the following base criteria:

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

แนวทางการใช้งาน

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

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

ในทางเลือก คุณสามารถใช้ Open Cloud API เพื่อกระตุ้นการแจ้งเตือนผ่านการร้องขอ API ที่เป็นอิสระ

สร้างข้อความการแจ้งเตือน

As with Player Invite Prompts, you must create and edit your notification strings in the Creator Dashboard. ไม่มีสตริงการแจ้งเตือนเกมเริ่มต้น ดังนั้นขั้นตอนนี้จึงจำเป็น

1. Navigate to the Creator Dashboard.

2. Similar to badges, notification strings are tied to a specific game. Locate that game's thumbnail and click on it.

3. In the left column, under Engagement, click Notifications.

4. In the center region, click the Create a Notification String button.

5. Fill in an identifier name (only visible to you) and the custom notification string; this is limited to 99 characters and can include unlimited custom parameters. Notifications will automatically use the title of your game as the notification title, but you can additionally use {experienceName} to reference your game in the notification body text.

   Example notification strings:

   คุณอยู่ห่างจากการทำภารกิจประจำสัปดาห์ {numQuests} ภารกิจ!

   {eggName} ของคุณฟักออกมาแล้ว! มาพบกับสัตว์เลี้ยงใหม่ของคุณ.

   คุณชนะ {numRaces} การแข่งขันในสัปดาห์นี้และปลดล็อคสนามแข่ง {racetrackName}!

   {userId-friend} เพิ่งทำลายสถิติของคุณในสนามแข่ง Tokyo Tour! ถึงเวลาล้างแค้นหรือยัง?

   Before writing notification strings, please review the guidelines for using the system.

6. When ready, click the Create Notification String button.

7. On the notifications page, in the table of notifications, click the ⋯ button in the Actions column and select Copy Asset ID.

8. Use the copied ID for the messageId key value in the payload table as demonstrated in the example script.

รวมแพ็คเกจ

ในการดำเนินการแจ้งเตือนประสบการณ์ คุณจำเป็นต้องได้รับแพ็คเกจ Luau จาก Creator Store

1. จากเมนู Window ของ Studio หรือแถบเครื่องมือ Home เปิด Toolbox และเลือกแถบ Creator Store

   

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

   

3. หาตำแหน่งและคลิกที่ป้าย Packages

4. หโมดูล Open Cloud และคลิกที่มันหรือทำการลากและวางมันลงในมุมมอง 3D

   

5. ในหน้าต่าง Explorer ให้ย้ายโมเดล OpenCloud ทั้งหมดไปยัง ServerScriptService

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

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

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

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

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

-- ใน payload, "messageId" คือค่าของ ID ทรัพย์สินการแจ้งเตือน
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"}

-- ใน payload, "messageId" คือค่าของ ID ทรัพย์สินการแจ้งเตือน
-- ในตัวอย่างนี้ ข้อความการแจ้งเตือนคือ "{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() เนื่องจากเป็นการเรียกแบบอะซิงโครนัสที่อาจล้มเหลวบ้างในบางครั้ง
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("ปิดการชักชวนเปิด")
end)

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

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

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

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

-- ใน payload, "messageId" คือค่าของ ID ทรัพย์สินการแจ้งเตือน
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

ระบบการส่ง

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

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

นอกจากนี้ รายการต่อไปนี้จะชี้ให้เห็นถึงกรณีพิเศษบางประการที่อาจส่งผลให้เกิด การไม่ส่ง การแจ้งเตือน:

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

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

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

Performance of your notifications and notifiable audience are displayed in the Analytics tab of the Notifications page where you configure notification strings (simply tab from Creations to Analytics).

1. Navigate to the Creator Dashboard.
2. Similar to badges, notification strings are tied to a specific game. Locate that game's thumbnail and click on it.
3. In the left column, under Engagement, click Notifications.
4. On the target page, click the Analytics tab to switch to the analytics dashboard.

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

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

สถิติเสียงแหลก

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

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

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

• ไข่ฟักA — "ไข่ทองของคุณได้ฟักออกมาแล้ว! มาเจอสัตว์เลี้ยงใหม่ของคุณกันเถอะ"
• ไข่ฟักB — "ถึงเวลาฟักไข่แล้ว! มาเจอสัตว์เลี้ยงใหม่ของคุณกันเถอะ"

อ้างอิง API

ฟังก์ชัน

createUserNotification

ส่งการแจ้งเตือนจากสคริปต์ฝั่งเซิร์ฟเวอร์ ต้องการ Player.UserId ของผู้รับและ UserNotification คืนค่า UserNotificationResult

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

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

-- ใน payload, "messageId" คือค่าของ ID ทรัพย์สินการแจ้งเตือน
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

ประเภท

UserNotification

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

UserNotificationResult

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