Lớp công cụ
AnalyticsService
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
Tóm Tắt
Phương Pháp
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):() |
Tài Liệu Tham Khảo API
Thuộc Tính
ApiKey
Phương Pháp
FireCustomEvent
FireEvent
FireInGameEconomyEvent
FireLogEvent
FirePlayerProgressionEvent
GetPlayerSegmentsAsync
Tham Số
Lợi Nhuận
Mẫu mã
Cấu hình trải nghiệm phía máy chủ với các phân đoạn người chơi
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("Hiển thị giới thiệu bổ sung cho", player.Name)
end
if segments.ActivePayerStatus == Enum.ActivePayerStatus.Top15Percent then
print("Hiển thị ưu đãi giá trị cao cho", player.Name)
end
end
Players.PlayerAdded:Connect(configurePlayerExperience)LogCustomEvent
AnalyticsService:LogCustomEvent(
):()
Tham Số
| Giá Trị Mặc Định: 1 |
| Giá Trị Mặc Định: "nil" |
Lợi Nhuận
()
Mẫu mã
Ghi Nhận Sự Kiện Tùy Chỉnh
local AnalyticsService = game:GetService("AnalyticsService")
-- Ghi lại khi nhiệm vụ bắt đầu
AnalyticsService:LogCustomEvent(
player,
"MissionStarted" -- Tên sự kiện tùy chỉnh
)
-- Ghi lại khi nhiệm vụ đã hoàn thành với thời gian đã tiêu tốn
AnalyticsService:LogCustomEvent(
player,
"MissionCompletedDuration", -- Tên sự kiện tùy chỉnh
120 -- Giá trị sự kiện được sử dụng trong tổng hợp
)LogEconomyEvent
AnalyticsService:LogEconomyEvent(
player:Player, flowType:Enum.AnalyticsEconomyFlowType, currencyType:string, amount:number, endingBalance:number, transactionType:string, itemSku:string, customFields:Dictionary
):()
Tham Số
| Giá Trị Mặc Định: "nil" |
Lợi Nhuận
()
Mẫu mã
Theo dõi giao dịch mua trong ứng dụng
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- Có bao nhiêu đồng xu trong gói
1020, -- số dư sau giao dịch
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- Định danh duy nhất của gói đồng xu
)LogFunnelStepEvent
Lợi Nhuận
()
Mẫu mã
Theo dõi bước gian hàng
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- Ghi lại khi người dùng mở gian hàng
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Tên funnel được sử dụng để nhóm các bước lại với nhau
funnelSessionId, -- ID phiên funnel cho phiên thanh toán độc nhất này
1, -- Số bước
"Đã mở Gian hàng" -- Tên bước
)
-- Ghi lại khi người dùng xem một món đồ
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Tên funnel được sử dụng để nhóm các bước lại với nhau
funnelSessionId, -- ID phiên funnel cho phiên thanh toán độc nhất này
2, -- Số bước
"Đã xem Món đồ" -- Tên bước
)
-- Ghi lại khi người dùng thêm vào giỏ hàng
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Tên funnel được sử dụng để nhóm các bước lại với nhau
funnelSessionId, -- ID phiên funnel cho phiên thanh toán độc nhất này
3, -- Số bước
"Đã thêm vào Giỏ hàng" -- Tên bước
)LogOnboardingFunnelStepEvent
AnalyticsService:LogOnboardingFunnelStepEvent(
):()
Tham Số
| Giá Trị Mặc Định: "nil" |
Lợi Nhuận
()
Mẫu mã
Theo dõi các bước hướng dẫn
local AnalyticsService = game:GetService("AnalyticsService")
-- Ghi lại bước đầu tiên của FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- Số bước
"Gia nhập trò chơi" -- Tên bước
)
-- Ghi lại bước thứ hai của FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- Số bước
"Chọn lớp" -- Tên bước
)LogProgressionCompleteEvent
AnalyticsService:LogProgressionCompleteEvent(
):()
Tham Số
| Giá Trị Mặc Định: "nil" |
Lợi Nhuận
()
LogProgressionEvent
AnalyticsService:LogProgressionEvent(
player:Player, progressionPathName:string, status:Enum.AnalyticsProgressionType, level:number, levelName:string, customFields:Dictionary
):()
Tham Số
| Giá Trị Mặc Định: "nil" |
Lợi Nhuận
()
LogProgressionFailEvent
AnalyticsService:LogProgressionFailEvent(
):()
Tham Số
| Giá Trị Mặc Định: "nil" |
Lợi Nhuận
()
LogProgressionStartEvent
AnalyticsService:LogProgressionStartEvent(
):()
Tham Số
| Giá Trị Mặc Định: "nil" |
Lợi Nhuận
()