AnalyticsService

แสดงที่เลิกใช้งานแล้ว

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

ไม่สามารถสร้าง
บริการ
ไม่ซ้ำ

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

สรุป

วิธีการ

  • LogCustomEvent(player : Player,eventName : string,value : number,customFields : Dictionary):()

    บันทึกเหตุการณ์ที่ใช้ติดตามเมตริกที่กำหนดเองของผู้ใช้ในประสบการณ์

  • LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):()

    บันทึกกิจกรรมที่ใช้ติดตามการดำเนินการของผู้เล่นที่เกี่ยวข้องกับประสบการณ์

  • LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):()

    บันทึกกิจกรรมที่ใช้ติดตามการดำเนินการของผู้ใช้ผ่านทางช่องทางที่วางแผนไว้ล่วงหน้า

  • LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):()

    บันทึกกิจกรรมที่ใช้ติดตามการดำเนินการของผู้ใช้ที่เดินผ่านช่องทางออนบอร์ด

  • LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()

    บันทึกเหตุการณ์เมื่อผู้ใช้เสร็จสิ้นการลองระดับ

  • LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):()

    บันทึกเหตุการณ์เมื่อผู้ใช้เริ่ม สําเร็จ หรือล้มเหลวในการพยายามระดับ

  • LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()

    บันทึกเหตุการณ์เมื่อผู้ใช้ล้มเหลวในการลองระดับ

  • LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()

    บันทึกเหตุการณ์เมื่อผู้ใช้เริ่มต้นการพยายามระดับ

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

คุณสมบัติ

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

วิธีการ

LogCustomEvent

()

บันทึกเหตุการณ์ที่ใช้ติดตามเมตริกที่กำหนดเองของผู้ใช้ในประสบการณ์ สำหรับข้อมูลเพิ่มเติม โปรดดู กิจกรรมที่กำหนดเอง

พารามิเตอร์

player: Player

ผู้ใช้ที่กระตุ้นเหตุการณ์

ค่าเริ่มต้น: ""
eventName: string

ชื่อของอีเวนต์ที่กําหนดเอง

ค่าเริ่มต้น: ""
value: number

มูลค่าของอีเวนต์ที่จะใช้ในการรวม

ค่าเริ่มต้น: 1
customFields: Dictionary

สารานุกรมทางเลือกของฟิลด์กำหนดเองที่จะให้ภาพรวมในแผนภูมิที่ Roblox จัดให้เฉพาะกุญแจที่เฉพาะเจาะจงเท่านั้นที่ให้โดย Enum.AnalyticsCustomFieldKeys จะถูกใช้สำหรับการแยกทำลายเหล่านี้จํากัดไว้ที่ 8,000 การรวมค่าที่ไม่ซ้ํากันในสามฟิลด์ที่กําหนดเองต่อประสบการณ์

ค่าเริ่มต้น: "nil"

ส่งค่ากลับ

()

ตัวอย่างโค้ด

This example uses AnalyticsService:LogCustomEvent() to log two custom events: MissionStarted and MissionCompletedDuration.

Log Custom Event
local AnalyticsService = game:GetService("AnalyticsService")



-- Log when the mission starts

AnalyticsService:LogCustomEvent(

	player,

	"MissionStarted" -- Custom event name

)



-- Log when the mission is completed with the time it took

AnalyticsService:LogCustomEvent(

	player,

	"MissionCompletedDuration", -- Custom event name

	120 -- Event value used in aggregation

)

LogEconomyEvent

()

บันทึกกิจกรรมที่ใช้ติดตามการดำเนินการของผู้เล่นที่เกี่ยวข้องกับประสบการณ์

พารามิเตอร์

player: Player

ผู้ใช้ที่กระตุ้นเหตุการณ์

ค่าเริ่มต้น: ""
flowType: Enum.AnalyticsEconomyFlowType

ควรระบุทิศทางที่เงินไหลโดยใช้ Enum.AnalyticsEconomyFlowType

ค่าเริ่มต้น: ""
currencyType: string

ชื่อของสกุลเงินที่ถูกเพิ่มหรือลบออก เช่น "gold" , "gems" หรือ "energy"จํากัดไว้ที่ 5 ประเภทเงินที่ไม่ซ้ํากันต่อประสบการณ์

ค่าเริ่มต้น: ""
amount: number

จำนวนเงินที่ถูกเพิ่มหรือลบออก ค่านี้ควรเป็นบวกเสมอ

ค่าเริ่มต้น: ""
endingBalance: number

ความสมดุลของผู้ใช้หลังจากเพิ่มหรือลบสกุลเงินแล้ว ค่านี้ควรเป็นมากกว่าหรือเท่ากับ 0 เสมอ

ค่าเริ่มต้น: ""
transactionType: string

ประเภทของธุรกรรมที่เกิดขึ้นในขณะที่คุณสามารถใช้ประเภทธุรกรรมใดก็ได้โดยไม่ต้องจ่ายเงิน แต่แนะนำให้ใช้ประเภทที่ให้ไว้จาก Enum.AnalyticsEconomyTransactionType เช่น "IAP" หรือ "ContextualPurchase" เพื่อเปิดใช้งานมุมมองในอนาคตจากเครื่องมือและกราฟของ Roblox

เนื่องจากชนิดฟิลด์นี้เป็นข้อความคุณจะต้องส่งค่า Name ของ enum เช่น Enum.AnalyticsEconomyTransactionType.IAP.Name

จํากัดเฉพาะ 20 ประเภทที่ไม่ซ้ํากันต่อประสบการณ์

ค่าเริ่มต้น: ""
itemSku: string

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

ค่าเริ่มต้น: ""
customFields: Dictionary

สารานุกรมทางเลือกของฟิลด์กำหนดเองที่จะให้ภาพรวมในแผนภูมิที่ Roblox จัดให้เฉพาะกุญแจที่เฉพาะเจาะจงเท่านั้นที่ให้โดย Enum.AnalyticsCustomFieldKeys จะถูกใช้สำหรับการแยกทำลายเหล่านี้จํากัดไว้ที่ 8,000 การรวมค่าที่ไม่ซ้ํากันในสามฟิลด์ที่กําหนดเองต่อประสบการณ์

ค่าเริ่มต้น: "nil"

ส่งค่ากลับ

()

ตัวอย่างโค้ด

ตัวอย่างต่อไปนี้จะบันทึกการซื้อ Robux ของแพ็คเกจ 1000 เหรียญโดยใช้ประเภทการซื้อในแอป (ในแอป)สังเกตชื่อรายการที่ให้เป็นพารามิเตอร์เลือกเมื่อเปรียบเทียบกับตัวอย่างก่อนหน้า

ติดตามการซื้อในแอป
local AnalyticsService = game:GetService("AnalyticsService")



AnalyticsService:LogEconomyEvent(

	player,

	Enum.AnalyticsEconomyFlowType.Source,

	"Coins",

	1000, -- มีเหรียญกี่อันในแพ็คเกจ

	1020, -- ความสมดุลหลังการทำธุรกรรม

	Enum.AnalyticsEconomyTransactionType.IAP.Name,

	"1000CoinBundle" -- รหัสประจำตัวที่ไม่ซ้ำกันของชุดเหรียญ

)

LogFunnelStepEvent

()

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

พารามิเตอร์

player: Player

ผู้ใช้ที่กระตุ้นเหตุการณ์

ค่าเริ่มต้น: ""
funnelName: string

ชื่อของสนามแรงดัน ชื่อนี้ควรเป็นเช่นเดียวกับขั้นตอนทั้งหมดในสนามแรงดัน จํากัดเวลา 10 สนามแรงดันที่ไม่ซ้ํากันต่อประสบการณ์

ค่าเริ่มต้น: ""
funnelSessionId: string

ตัวระบุเฉพาะที่ไม่ซ้ำกันสำหรับเซสชันฟันเนล ควรเป็นเช่นเดียวกับขั้นตอนทั้งหมดในฟันเนล

โปรดทราบว่าฟิลด์นี้จำเป็นเฉพาะสำหรับฟันเนลที่เกิดซ้ำเท่านั้น เช่น ฟันเนลการซื้อหรือฟันเนลอัพเกรดรายการหากคุณไม่มีตัวระบุเซสชั่นสนุกสนานตามธรรมชาติ, แนะนำให้ใช้ HttpService:GenerateGUID()

ค่าเริ่มต้น: ""
step: number

หมายเลขขั้นตอนในสนามแข่ง ควรเป็นเอกลักษณ์สำหรับแต่ละขั้นตอนในสนามแข่ง ทุกสนามแข่งเริ่มต้นที่ขั้นตอนที่ 1 จํากัดเฉพาะขั้นตอน 1-100

ขั้นตอนซ้ำโดยผู้ใช้รายเดียวในเซสชันสนุกเดียวกันหรือเมื่อ funnelSessionId ไม่ได้รับการจัดลำดับความสำคัญ nil จะถูกเพิกเฉย

โปรดทราบว่าหากขั้นตอนใดถูกข้ามไป ขั้นตอนกลางจะถือว่าสําเร็จ

ค่าเริ่มต้น: 1
stepName: string

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

ค่าเริ่มต้น: ""
customFields: Dictionary

สารานุกรมทางเลือกของฟิลด์กำหนดเองที่จะให้ภาพรวมในแผนภูมิที่ Roblox จัดให้เฉพาะกุญแจที่เฉพาะเจาะจงเท่านั้นที่ให้โดย Enum.AnalyticsCustomFieldKeys จะถูกใช้สำหรับการแยกทำลายเหล่านี้จํากัดไว้ที่ 8,000 การรวมค่าที่ไม่ซ้ํากันในสามฟิลด์ที่กําหนดเองต่อประสบการณ์

ค่าเริ่มต้น: "nil"

ส่งค่ากลับ

()

ตัวอย่างโค้ด

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

ติดตามขั้นตอนร้านค้า
local AnalyticsService = game:GetService("AnalyticsService")

local HttpService = game:GetService("HttpService")



funnelSessionId = HttpService:GenerateGUID()



-- บันทึกเมื่อผู้ใช้เปิดร้าน

AnalyticsService:LogFunnelStepEvent(

	player,

	"ArmoryCheckout", -- ชื่อช่องทางที่ใช้เพื่อรวมขั้นตอนร่วมกัน

	funnelSessionId, -- รหัสเซสชันฟันเนลสำหรับเซสชันการชำระเงินที่ไม่ซ้ำกันนี้

	1, -- หมายเลขขั้นตอน

	"Opened Store" -- ชื่อขั้นตอน

)



-- บันทึกเมื่อผู้ใช้ดูรายการ

AnalyticsService:LogFunnelStepEvent(

	player,

	"ArmoryCheckout", -- ชื่อช่องทางที่ใช้เพื่อรวมขั้นตอนร่วมกัน

	funnelSessionId, -- รหัสเซสชันฟันเนลสำหรับเซสชันการชำระเงินที่ไม่ซ้ำกันนี้

	2, -- หมายเลขขั้นตอน

	"Viewed Item" -- ชื่อขั้นตอน

)



-- บันทึกเมื่อผู้ใช้ดูเพิ่มในตะกร้า

AnalyticsService:LogFunnelStepEvent(

	player,

	"ArmoryCheckout", -- ชื่อช่องทางที่ใช้เพื่อรวมขั้นตอนร่วมกัน

	funnelSessionId, -- รหัสเซสชันฟันเนลสำหรับเซสชันการชำระเงินที่ไม่ซ้ำกันนี้

	3, -- หมายเลขขั้นตอน

	"Added to Cart" -- ชื่อขั้นตอน

)

LogOnboardingFunnelStepEvent

()

บันทึกกิจกรรมที่ใช้ติดตามการดำเนินการของผู้ใช้ที่เดินผ่านช่องทางออนบอร์ดการแยกทางเดียวจะพิจารณาค่าผู้ใช้และอีเวนต์จากขั้นตอนแรกในเซสชันฟันเนลเท่านั้น

พารามิเตอร์

player: Player

ผู้ใช้ที่กระตุ้นเหตุการณ์

ค่าเริ่มต้น: ""
step: number

หมายเลขขั้นตอนในสนามแข่ง ควรเป็นเอกลักษณ์สำหรับแต่ละขั้นตอนในสนามแข่ง ทุกสนามแข่งเริ่มต้นที่ขั้นตอนที่ 1 จํากัดเฉพาะขั้นตอน 1-100

โปรดทราบว่าหากขั้นตอนใดถูกข้ามไป ขั้นตอนกลางจะถือว่าสําเร็จ

ค่าเริ่มต้น: ""
stepName: string

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

ค่าเริ่มต้น: ""
customFields: Dictionary

สารานุกรมทางเลือกของฟิลด์กำหนดเองที่จะให้ภาพรวมในแผนภูมิที่ Roblox จัดให้เฉพาะกุญแจที่เฉพาะเจาะจงเท่านั้นที่ให้โดย Enum.AnalyticsCustomFieldKeys จะถูกใช้สำหรับการแยกทำลายเหล่านี้จํากัดไว้ที่ 8,000 การรวมค่าที่ไม่ซ้ํากันในสามฟิลด์ที่กําหนดเองต่อประสบการณ์

ค่าเริ่มต้น: "nil"

ส่งค่ากลับ

()

ตัวอย่างโค้ด

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

ติดตามขั้นตอนการออนบอร์ด
local AnalyticsService = game:GetService("AnalyticsService")



-- บันทึกขั้นตอนแรกของ FTUE

AnalyticsService:LogOnboardingFunnelStepEvent(

	player,

	1, -- หมายเลขขั้นตอน

	"Joined Game" -- ชื่อขั้นตอน

)



-- บันทึกขั้นตอนที่สองของ FTUE

AnalyticsService:LogOnboardingFunnelStepEvent(

	player,

	2, -- หมายเลขขั้นตอน

	"Choose Class" -- ชื่อขั้นตอน

)

LogProgressionCompleteEvent

()

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

พารามิเตอร์

player: Player

ผู้เล่นที่กระตุ้นเหตุการณ์

ค่าเริ่มต้น: ""
progressionPathName: string
ค่าเริ่มต้น: ""
level: number
ค่าเริ่มต้น: ""
levelName: string
ค่าเริ่มต้น: ""
customFields: Dictionary
ค่าเริ่มต้น: "nil"

ส่งค่ากลับ

()

LogProgressionEvent

()

บันทึกเหตุการณ์เมื่อผู้ใช้เริ่ม เสร็จสิ้น หรือล้มเหลวในการลองระดับ อีเวนต์นี้ไม่แสดงในตารางที่ Roblox จัดให้ในปัจจุบัน

พารามิเตอร์

player: Player

ผู้เล่นที่กระตุ้นเหตุการณ์

ค่าเริ่มต้น: ""
progressionPathName: string
ค่าเริ่มต้น: ""
status: Enum.AnalyticsProgressionType
ค่าเริ่มต้น: ""
level: number
ค่าเริ่มต้น: ""
levelName: string
ค่าเริ่มต้น: ""
customFields: Dictionary
ค่าเริ่มต้น: "nil"

ส่งค่ากลับ

()

LogProgressionFailEvent

()

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

พารามิเตอร์

player: Player

ผู้ใช้ที่กระตุ้นเหตุการณ์

ค่าเริ่มต้น: ""
progressionPathName: string
ค่าเริ่มต้น: ""
level: number
ค่าเริ่มต้น: ""
levelName: string
ค่าเริ่มต้น: ""
customFields: Dictionary
ค่าเริ่มต้น: "nil"

ส่งค่ากลับ

()

LogProgressionStartEvent

()

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

พารามิเตอร์

player: Player

ผู้เล่นที่กระตุ้นเหตุการณ์

ค่าเริ่มต้น: ""
progressionPathName: string
ค่าเริ่มต้น: ""
level: number
ค่าเริ่มต้น: ""
levelName: string
ค่าเริ่มต้น: ""
customFields: Dictionary
ค่าเริ่มต้น: "nil"

ส่งค่ากลับ

()
ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

อีเวนต์

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object