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.
AnalyticsService là một bộ sưu tập các phương pháp cho phép các nhà phát triển theo dõi cách người dùng tương tác với trải nghiệm của họ, chủ yếu là tiến độ người chơi, kinh tế trong trải nghiệm, hào hức và sự kiện tùy chỉnh.
Tóm Tắt
Phương Pháp
Đăm nhật một sự kiện được sử dụng để theo dõi các chỉ số tùy chỉnh của người dùng trong trải nghiệm.
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):void
Đăm nhật một sự kiện được sử dụng để theo dõi hành động của người chơi liên quan trong trải nghiệm.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):void
Đăm nhật một sự kiện được sử dụng để theo dõi hành động của người dùng bước qua một đường hầm đã lên kế hoạch trước.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):void
Đăm nhật một sự kiện được sử dụng để theo dõi hành động của người dùng bước qua một hành lang onboarding.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Đăng nhận một sự kiện khi một người đã hoàn thành một lần thử cấp độ.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):void
Đăm nhật một sự kiện khi một người đã bắt đầu, hoàn thành hoặc thất bại một thửcấp độ.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Đăng nhận sự kiện cho khi một người đã thất bại trong một lần thử cấp độ.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Đăng nhận sự kiện cho khi một người bắt đầu một lần thửcông cấp.
Thuộc Tính
Phương Pháp
LogCustomEvent
Đăng nhập một sự kiện được sử dụng để theo dõi các chỉ số tùy chỉnh của người dùng trong trải nghiệm. Để biết thêm thông tin, xem Sự kiện Tùy chỉnh .
Tham Số
Người dùng đã kích hoạt sự kiện.
Tên của sự kiện tùy chỉnh.
Giá trị của sự kiện sẽ được sử dụng trong tổng hợp.
Từ điển tùy chỉnh các trường tùy chỉnh sẽ cung cấp các bản tách trong các bảng dữ liệu cung cấp bởi Roblox. Chỉ các khóa không đặc biệt, cung cấp bởi Enum.AnalyticsCustomFieldKeys, sẽ được sử dụng cho các bản tách này. Giới hạn 8.000 kết hợp tùy chỉ
Lợi Nhuận
Mẫu mã
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
Đăm nhật một sự kiện được sử dụng để theo dõi hành động của người chơi liên quan trong trải nghiệm.
Tham Số
Người dùng đã kích hoạt sự kiện.
Nên quy định hướng mà tiền tệ đang chảy qua bằng cách sử dụng Enum.AnalyticsEconomyFlowType .
Tên của tiền tệ đang được thêm hoặc xóa, ví dụ "gold" , "gems" hoặc "energy" . Giới hạn 5 loại tiền tệ độc đáo mỗi trải nghiệm.
Số tiền tệ được thêm hoặc bị xóa. Giá trị này luôn luôn phải là dương.
Số dư của người dùng sau khi đã thêm hoặc xóa tiền tệ. Giá trị này luôn luôn lớn hơn hoặc bằng 0.
Loại của giao dịch đã xảy ra. Mặc dù bạn có thể sử dụng bất kỳ đánh máygiao dịch nào, nhưng được khuyến nghị sử dụng các loại giao dịch được cung cấp từ Enum.AnalyticsEconomyTransactionType như "IAP" hoặc "ContextualPurchase"
Vì đây là kiểu trường chuỗi, bạn sẽ cần phải truyền giá trị Name của hệ thống đếm. Ví dụ Enum.AnalyticsEconomyTransactionType.IAP.Name .
Giới hạn 20 loại độc đáo mỗi kinh nghiệm.
SKU tùy chọn của món đồ hoặc gói được mua. Đây là một nhận dạng độc nhất cho món đồ đang được mua. Giới hạn 100 SKU độc nhất mỗi trải nghiệm.
Từ điển tùy chỉnh các trường tùy chỉnh sẽ cung cấp các bản tách trong các bảng dữ liệu cung cấp bởi Roblox. Chỉ các khóa không đặc biệt, cung cấp bởi Enum.AnalyticsCustomFieldKeys, sẽ được sử dụng cho các bản tách này. Giới hạn 8.000 kết hợp tùy chỉ
Lợi Nhuận
Mẫu mã
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
Đăm một sự kiện được sử dụng để theo dõi hành động của người dùng bước qua một hành lang trước kế hoạch. Sự kiện đăm sẽ chỉ xem xét giá trị người dùng và sự kiện từ bước đầu tiên trong một phiên bản hành lang.
Tham Số
Người dùng đã kích hoạt sự kiện.
Tên của hầm. Đây nên là cùng ở tất cả các bước trong hầm. Giới hạn 10 hầm độc đáo mỗi kinh nghiệm.
Định danh độc nhất vô nhị cho phiên đào. Đây nên là cùng đối với tất cả các bước trong hầm.
Lưu ý rằng trường này chỉ cần thiết cho các hào kiện phản lặp , ví dụ như một hào kiện mua hàng hoặc một hào kiện nâng cấp mục. Nếu bạn không có một người tạo hào kiện tự nhiên, nó được khuyến nghị sử dụng HttpService:GenerateGUID()
Số bước trong hầm. Điều này nên độc đáo cho mỗi bước trong hầm. Tất cả các hầm đều bắt đầu ở bước 1. Giới hạn cho các bước 1-100.
Các bước lặp lại bởi cùng một người ở cùng một phiên màn hình, hoặc khi funnelSessionId được nil sẽ bị bỏ qua.
Lưu ý rằng nếu bỏ qua bất kỳ bước nào, các bước trung gian sẽ được xem xét hoàn thành.
Tên bắt buộc của bước trong hầm. This field is only used for display purposes in Roblox-provided charts.
Từ điển tùy chỉnh các trường tùy chỉnh sẽ cung cấp các bản tách trong các bảng dữ liệu cung cấp bởi Roblox. Chỉ các khóa không đặc biệt, cung cấp bởi Enum.AnalyticsCustomFieldKeys, sẽ được sử dụng cho các bản tách này. Giới hạn 8.000 kết hợp tùy chỉ
Lợi Nhuận
Mẫu mã
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
Đăm nhật một sự kiện được sử dụng để theo dõi hành động của người dùng bước qua một hành lang onboarding. Sự kiện bị đăm nhật sẽ chỉ xem xét giá trị người dùng và sự kiện từ bước đầu tiên trong một phiên hành lang.
Tham Số
Người dùng đã kích hoạt sự kiện.
Số bước trong hầm. Điều này nên độc đáo cho mỗi bước trong hầm. Tất cả các hầm đều bắt đầu ở bước 1. Giới hạn cho các bước 1-100.
Lưu ý rằng nếu bỏ qua bất kỳ bước nào, các bước trung gian sẽ được xem xét hoàn thành.
Tên bắt buộc của bước trong hầm. This field is only used for display purposes in Roblox-provided charts.
Từ điển tùy chỉnh các trường tùy chỉnh sẽ cung cấp các bản tách trong các bảng dữ liệu cung cấp bởi Roblox. Chỉ các khóa không đặc biệt, cung cấp bởi Enum.AnalyticsCustomFieldKeys, sẽ được sử dụng cho các bản tách này. Giới hạn 8.000 kết hợp tùy chỉ
Lợi Nhuận
Mẫu mã
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
Đăng nhận một sự kiện cho khi một người đã hoàn thành một lần thử cấp độ. Sự kiện này hiện không hiển thị trong bất kỳ bảng thống kê nào của Roblox hiện tại.
Tham Số
Người chơi đã kích hoạt sự kiện.
Lợi Nhuận
LogProgressionEvent
Đăng nhận một sự kiện cho khi một người đã bắt đầu, hoàn thành hoặc thất bại một lần thử cấp độ. Sự kiện này hiện không hiển thị trong bất kỳ bảng thống kê nào của Roblox.
Tham Số
Người chơi đã kích hoạt sự kiện.
Lợi Nhuận
LogProgressionFailEvent
Đăng nhận một sự kiện cho khi một người đã thất bại trong một lần thử cấp độ. Sự kiện này hiện không hiển thị trong bất kỳ bảng thống kê nào của Roblox hiện tại.
Tham Số
Người dùng đã kích hoạt sự kiện.
Lợi Nhuận
LogProgressionStartEvent
Đăng nhận một sự kiện cho khi một người đã bắt đầu một lần tấn thửcấp. Sự kiện này hiện không hiển thị trong bất kỳ bảng thống kê nào của Roblox hiện tại.
Tham Số
Người chơi đã kích hoạt sự kiện.