Engine Class
AnalyticsService
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
สรุป
วิธีการ
FireCustomEvent(player: Instance,eventCategory: string,customData: Variant):() |
FireInGameEconomyEvent(player: Instance,itemName: string,economyAction: Enum.AnalyticsEconomyAction,itemCategory: string,amount: number,currency: string,location: Variant,customData: Variant):() |
FireLogEvent(player: Instance,logLevel: Enum.AnalyticsLogLevel,message: string,debugInfo: Variant,customData: Variant):() |
FirePlayerProgressionEvent(player: Instance,category: string,progressionStatus: Enum.AnalyticsProgressionStatus,location: Variant,statistics: Variant,customData: Variant):() |
GetPlayerSegmentsAsync(player: Player):Dictionary |
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):() |
เอกสารอ้างอิงเกี่ยวกับ API
คุณสมบัติ
ApiKey
วิธีการ
FireCustomEvent
FireEvent
FireInGameEconomyEvent
FireLogEvent
FirePlayerProgressionEvent
GetPlayerSegmentsAsync
พารามิเตอร์
ส่งค่ากลับ
ตัวอย่างโค้ด
ปรับแต่งประสบการณ์ฝั่งเซิร์ฟเวอร์ด้วยส่วนผู้เล่น
local Players = game:GetService("Players")
local AnalyticsService = game:GetService("AnalyticsService")
local function configurePlayerExperience(player)
local segments = AnalyticsService:GetPlayerSegmentsAsync(player)
if not segments.HasData then
return
end
if segments.WhenUserFirstPlayed == Enum.WhenUserFirstPlayed.Days0To30 then
print("แสดงการแนะนำเพิ่มเติมสำหรับ", player.Name)
end
if segments.ActivePayerStatus == Enum.ActivePayerStatus.Top15Percent then
print("แสดงข้อเสนอที่มีมูลค่าสูงให้กับ", player.Name)
end
end
Players.PlayerAdded:Connect(configurePlayerExperience)LogCustomEvent
AnalyticsService:LogCustomEvent(
):()
พารามิเตอร์
| ค่าเริ่มต้น: 1 |
| ค่าเริ่มต้น: "nil" |
ส่งค่ากลับ
()
ตัวอย่างโค้ด
บันทึกเหตุการณ์ที่กำหนดเอง
local AnalyticsService = game:GetService("AnalyticsService")
-- บันทึกเมื่อภารกิจเริ่มต้น
AnalyticsService:LogCustomEvent(
player,
"MissionStarted" -- ชื่อเหตุการณ์ที่กำหนดเอง
)
-- บันทึกเมื่อภารกิจเสร็จสิ้นพร้อมกับเวลาที่ใช้
AnalyticsService:LogCustomEvent(
player,
"MissionCompletedDuration", -- ชื่อเหตุการณ์ที่กำหนดเอง
120 -- ค่าของเหตุการณ์ที่ใช้ในการรวม
)LogEconomyEvent
AnalyticsService:LogEconomyEvent(
player:Player, flowType:Enum.AnalyticsEconomyFlowType, currencyType:string, amount:number, endingBalance:number, transactionType:string, itemSku:string, customFields:Dictionary
):()
พารามิเตอร์
| ค่าเริ่มต้น: "nil" |
ส่งค่ากลับ
()
ตัวอย่างโค้ด
ติดตามการซื้อภายในแอป
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- จำนวนเหรียญในชุด
1020, -- ยอดคงเหลือหลังจากทำธุรกรรม
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- รหัสประจำเฉพาะของชุดเหรียญ
)LogFunnelStepEvent
ส่งค่ากลับ
()
ตัวอย่างโค้ด
ติดตามขั้นตอนร้านค้า
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- บันทึกเมื่อผู้ใช้เปิดร้าน
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- ชื่อฟunnel ที่ใช้ในการจัดกลุ่มขั้นตอน
funnelSessionId, -- ID เซสชัน funnel สำหรับเซสชันการชำระเงินเฉพาะนี้
1, -- หมายเลขขั้นตอน
"เปิดร้าน" -- ชื่อขั้นตอน
)
-- บันทึกเมื่อผู้ใช้ดูรายการ
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- ชื่อฟunnel ที่ใช้ในการจัดกลุ่มขั้นตอน
funnelSessionId, -- ID เซสชัน funnel สำหรับเซสชันการชำระเงินเฉพาะนี้
2, -- หมายเลขขั้นตอน
"ดูรายการ" -- ชื่อขั้นตอน
)
-- บันทึกเมื่อผู้ใช้เพิ่มรายการในตะกร้า
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- ชื่อฟunnel ที่ใช้ในการจัดกลุ่มขั้นตอน
funnelSessionId, -- ID เซสชัน funnel สำหรับเซสชันการชำระเงินเฉพาะนี้
3, -- หมายเลขขั้นตอน
"เพิ่มลงในตะกร้า" -- ชื่อขั้นตอน
)LogOnboardingFunnelStepEvent
AnalyticsService:LogOnboardingFunnelStepEvent(
):()
พารามิเตอร์
| ค่าเริ่มต้น: "nil" |
ส่งค่ากลับ
()
ตัวอย่างโค้ด
การติดตามขั้นตอนการเริ่มต้น
local AnalyticsService = game:GetService("AnalyticsService")
-- บันทึกขั้นตอนแรกของ FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- หมายเลขขั้นตอน
"เข้าร่วมเกม" -- ชื่อขั้นตอน
)
-- บันทึกขั้นตอนที่สองของ FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- หมายเลขขั้นตอน
"เลือกคลาส" -- ชื่อขั้นตอน
)LogProgressionCompleteEvent
AnalyticsService:LogProgressionCompleteEvent(
):()
พารามิเตอร์
| ค่าเริ่มต้น: "nil" |
ส่งค่ากลับ
()
LogProgressionEvent
AnalyticsService:LogProgressionEvent(
player:Player, progressionPathName:string, status:Enum.AnalyticsProgressionType, level:number, levelName:string, customFields:Dictionary
):()
พารามิเตอร์
| ค่าเริ่มต้น: "nil" |
ส่งค่ากลับ
()
LogProgressionFailEvent
AnalyticsService:LogProgressionFailEvent(
):()
พารามิเตอร์
| ค่าเริ่มต้น: "nil" |
ส่งค่ากลับ
()
LogProgressionStartEvent
AnalyticsService:LogProgressionStartEvent(
):()
พารามิเตอร์
| ค่าเริ่มต้น: "nil" |
ส่งค่ากลับ
()