AnalyticsService
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
บริการวิเคราะห์ เป็นคอลเลกชันของวิธีการที่ช่วยให้นักพัฒนาสามารถติดตามวิธีที่ผู้ใช้โต้ตอบกับประสบการณ์ของพวกเขา, เศรษฐกิจในประสบการณ์, ทางเดินและกิจกรรมที่กำหนดเองได้
สรุป
วิธีการ
บันทึกเหตุการณ์ที่ใช้ติดตามเมตริกที่กำหนดเองของผู้ใช้ในประสบการณ์
- 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):()
บันทึกเหตุการณ์เมื่อผู้ใช้เริ่มต้นการพยายามระดับ
คุณสมบัติ
วิธีการ
LogCustomEvent
บันทึกเหตุการณ์ที่ใช้ติดตามเมตริกที่กำหนดเองของผู้ใช้ในประสบการณ์ สำหรับข้อมูลเพิ่มเติม โปรดดู กิจกรรมที่กำหนดเอง
พารามิเตอร์
ผู้ใช้ที่กระตุ้นเหตุการณ์
ชื่อของอีเวนต์ที่กําหนดเอง
มูลค่าของอีเวนต์ที่จะใช้ในการรวม
สารานุกรมทางเลือกของฟิลด์กำหนดเองที่จะให้ภาพรวมในแผนภูมิที่ Roblox จัดให้เฉพาะกุญแจที่เฉพาะเจาะจงเท่านั้นที่ให้โดย Enum.AnalyticsCustomFieldKeys จะถูกใช้สำหรับการแยกทำลายเหล่านี้จํากัดไว้ที่ 8,000 การรวมค่าที่ไม่ซ้ํากันในสามฟิลด์ที่กําหนดเองต่อประสบการณ์
ส่งค่ากลับ
ตัวอย่างโค้ด
This example uses AnalyticsService:LogCustomEvent() to log two custom events: MissionStarted and MissionCompletedDuration.
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
บันทึกกิจกรรมที่ใช้ติดตามการดำเนินการของผู้เล่นที่เกี่ยวข้องกับประสบการณ์
พารามิเตอร์
ผู้ใช้ที่กระตุ้นเหตุการณ์
ควรระบุทิศทางที่เงินไหลโดยใช้ Enum.AnalyticsEconomyFlowType
ชื่อของสกุลเงินที่ถูกเพิ่มหรือลบออก เช่น "gold" , "gems" หรือ "energy"จํากัดไว้ที่ 5 ประเภทเงินที่ไม่ซ้ํากันต่อประสบการณ์
จำนวนเงินที่ถูกเพิ่มหรือลบออก ค่านี้ควรเป็นบวกเสมอ
ความสมดุลของผู้ใช้หลังจากเพิ่มหรือลบสกุลเงินแล้ว ค่านี้ควรเป็นมากกว่าหรือเท่ากับ 0 เสมอ
พิมพ์แต่แนะนำให้ใช้ประเภทที่ให้ไว้จาก Enum.AnalyticsEconomyTransactionType เช่น "IAP" หรือ "ContextualPurchase" เพื่อเปิดใช้งานมุมมองในอนาคตจากเครื่องมือและกราฟของ Roblox
เนื่องจากชนิดฟิลด์นี้เป็นข้อความคุณจะต้องส่งค่า Name ของ enum เช่น Enum.AnalyticsEconomyTransactionType.IAP.Name
จํากัดเฉพาะ 20 ประเภทที่ไม่ซ้ํากันต่อประสบการณ์
SKU ทางเลือกของรายการหรือบันเดิลที่ซื้อนี่คือตัวระบุที่ไม่ซ้ำกันสำหรับรายการที่ซื้อจำกัดไว้ที่ 100 SKU ที่ไม่ซ้ำกันต่อประสบการณ์
สารานุกรมทางเลือกของฟิลด์กำหนดเองที่จะให้ภาพรวมในแผนภูมิที่ Roblox จัดให้เฉพาะกุญแจที่เฉพาะเจาะจงเท่านั้นที่ให้โดย Enum.AnalyticsCustomFieldKeys จะถูกใช้สำหรับการแยกทำลายเหล่านี้จํากัดไว้ที่ 8,000 การรวมค่าที่ไม่ซ้ํากันในสามฟิลด์ที่กําหนดเองต่อประสบการณ์
ส่งค่ากลับ
ตัวอย่างโค้ด
The following sample tracks a Robux purchase of a 1000-coin bundle, using the IAP (in-app purchase) transaction type. Note the item name provided as an optional parameter when compared to the previous sample.
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- How many coins are in the bundle
1020, -- balance after transaction
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- Unique identifier of the coin bundle
)LogFunnelStepEvent
บันทึกกิจกรรมที่ใช้ติดตามการดำเนินการของผู้ใช้ผ่านทางช่องทางที่วางแผนไว้ล่วงหน้าการแยกทางเดียวจะพิจารณาค่าผู้ใช้และอีเวนต์จากขั้นตอนแรกในเซสชันฟันเนลเท่านั้น
พารามิเตอร์
ผู้ใช้ที่กระตุ้นเหตุการณ์
ชื่อของสนามแรงดัน ชื่อนี้ควรเป็นเช่นเดียวกับขั้นตอนทั้งหมดในสนามแรงดัน จํากัดเวลา 10 สนามแรงดันที่ไม่ซ้ํากันต่อประสบการณ์
ตัวระบุเฉพาะที่ไม่ซ้ำกันสำหรับเซสชันฟันเนล ควรเป็นเช่นเดียวกับขั้นตอนทั้งหมดในฟันเนล
โปรดทราบว่าฟิลด์นี้จำเป็นเฉพาะสำหรับฟันเนลที่เกิดซ้ำเท่านั้น เช่น ฟันเนลการซื้อหรือฟันเนลอัพเกรดรายการหากคุณไม่มีตัวระบุเซสชั่นสนุกสนานตามธรรมชาติ, แนะนำให้ใช้ HttpService:GenerateGUID()
หมายเลขขั้นตอนในสนามแข่ง ควรเป็นเอกลักษณ์สำหรับแต่ละขั้นตอนในสนามแข่ง ทุกสนามแข่งเริ่มต้นที่ขั้นตอนที่ 1 จํากัดเฉพาะขั้นตอน 1-100
ขั้นตอนซ้ำโดยผู้ใช้รายเดียวในเซสชันสนุกเดียวกันหรือเมื่อ funnelSessionId ไม่ได้รับการจัดลำดับความสำคัญ nil จะถูกเพิกเฉย
โปรดทราบว่าหากขั้นตอนใดถูกข้ามไป ขั้นตอนกลางจะถือว่าสําเร็จ
ชื่อทางเลือกของขั้นตอนในสนามแม่เหล็ก ฟิลด์นี้ใช้เพื่อจุดประสงค์ในการแสดงผลเท่านั้นในแผนภูมิที่ Roblox จัดเตรียมไว้
สารานุกรมทางเลือกของฟิลด์กำหนดเองที่จะให้ภาพรวมในแผนภูมิที่ Roblox จัดให้เฉพาะกุญแจที่เฉพาะเจาะจงเท่านั้นที่ให้โดย Enum.AnalyticsCustomFieldKeys จะถูกใช้สำหรับการแยกทำลายเหล่านี้จํากัดไว้ที่ 8,000 การรวมค่าที่ไม่ซ้ํากันในสามฟิลด์ที่กําหนดเองต่อประสบการณ์
ส่งค่ากลับ
ตัวอย่างโค้ด
The following sample tracks some basic events for each user beginning the process to buy an item from an "armory" shop. Note the funnelSessionId used to distinguish between different sessions of the same user opening the shop.
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- Log when the user opens the store
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel name used to group steps together
funnelSessionId, -- Funnel session id for this unique checkout session
1, -- Step number
"Opened Store" -- Step name
)
-- Log when the user views an item
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel name used to group steps together
funnelSessionId, -- Funnel session id for this unique checkout session
2, -- Step number
"Viewed Item" -- Step name
)
-- Log when the user views adds to cart
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Funnel name used to group steps together
funnelSessionId, -- Funnel session id for this unique checkout session
3, -- Step number
"Added to Cart" -- Step name
)LogOnboardingFunnelStepEvent
บันทึกกิจกรรมที่ใช้ติดตามการดำเนินการของผู้ใช้ที่เดินผ่านช่องทางออนบอร์ดการแยกทางเดียวจะพิจารณาค่าผู้ใช้และอีเวนต์จากขั้นตอนแรกในเซสชันฟันเนลเท่านั้น
พารามิเตอร์
ผู้ใช้ที่กระตุ้นเหตุการณ์
หมายเลขขั้นตอนในสนามแข่ง ควรเป็นเอกลักษณ์สำหรับแต่ละขั้นตอนในสนามแข่ง ทุกสนามแข่งเริ่มต้นที่ขั้นตอนที่ 1 จํากัดเฉพาะขั้นตอน 1-100
โปรดทราบว่าหากขั้นตอนใดถูกข้ามไป ขั้นตอนกลางจะถือว่าสําเร็จ
ชื่อทางเลือกของขั้นตอนในสนามแม่เหล็ก ฟิลด์นี้ใช้เพื่อจุดประสงค์ในการแสดงผลเท่านั้นในแผนภูมิที่ Roblox จัดเตรียมไว้
สารานุกรมทางเลือกของฟิลด์กำหนดเองที่จะให้ภาพรวมในแผนภูมิที่ Roblox จัดให้เฉพาะกุญแจที่เฉพาะเจาะจงเท่านั้นที่ให้โดย Enum.AnalyticsCustomFieldKeys จะถูกใช้สำหรับการแยกทำลายเหล่านี้จํากัดไว้ที่ 8,000 การรวมค่าที่ไม่ซ้ํากันในสามฟิลด์ที่กําหนดเองต่อประสบการณ์
ส่งค่ากลับ
ตัวอย่างโค้ด
The following sample demonstrates how to log two steps of an onboarding funnel. An onboarding funnel typically introduces players to the game's core loop.
local AnalyticsService = game:GetService("AnalyticsService")
-- Log the first step of the FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- Step number
"Joined Game" -- Step name
)
-- Log the second step of the FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- Step number
"Choose Class" -- Step name
)LogProgressionCompleteEvent
บันทึกเหตุการณ์เมื่อผู้ใช้เสร็จสิ้นการลองระดับ อีเวนต์นี้ไม่แสดงในตารางที่ Roblox จัดเตรียมไว้ในปัจจุบัน
พารามิเตอร์
ผู้เล่นที่กระตุ้นเหตุการณ์
ส่งค่ากลับ
LogProgressionEvent
บันทึกเหตุการณ์เมื่อผู้ใช้เริ่ม เสร็จสิ้น หรือล้มเหลวในการลองระดับ อีเวนต์นี้ไม่แสดงในตารางที่ Roblox จัดให้ในปัจจุบัน
พารามิเตอร์
ผู้เล่นที่กระตุ้นเหตุการณ์
ส่งค่ากลับ
LogProgressionFailEvent
พยายามอีเวนต์นี้ไม่แสดงในตารางที่ Roblox จัดเตรียมไว้ในปัจจุบัน
พารามิเตอร์
ผู้ใช้ที่กระตุ้นเหตุการณ์
ส่งค่ากลับ
LogProgressionStartEvent
บันทึกเหตุการณ์เมื่อผู้ใช้เริ่มต้นการพยายามระดับ เหตุการณ์นี้ไม่แสดงในตารางที่ Roblox จัดให้ในปัจจุบัน
พารามิเตอร์
ผู้เล่นที่กระตุ้นเหตุการณ์