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.
Dịch vụ phân tích 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ọ, đặc biệt là tiến trình của người chơi, kinh tế trong trải nghiệm, ống truyền và sự kiện tùy chỉnh.
Tóm Tắt
Phương Pháp
Ghi lại một sự kiện được sử dụng để theo dõi các métrik tùy chỉnh của một 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):()
Ghi lại một sự kiện được sử dụng để theo dõi các hành động liên quan của người chơi trong trải nghiệm.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):()
Ghi lại một sự kiện được sử dụng để theo dõi hành động người dùng bước qua một ống dẫn trước định trước.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):()
Ghi lại một sự kiện được sử dụng để theo dõi hành động người dùng bước qua một ống dẫn onboarding.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Ghi lại một sự kiện khi người dùng đã 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):()
Ghi lại một sự kiện khi người dùng đã bắt đầu, hoàn thành hoặc thất bại một lần thử cấp độ.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Ghi lại một sự kiện khi người dùng đã thất bại một lần thử cấp độ.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Ghi lại một sự kiện khi người dùng đã bắt đầu một lần thử cấp độ.
Thuộc Tính
Phương Pháp
LogCustomEvent
Ghi lại một sự kiện được sử dụng để theo dõi các métrik tùy chỉnh của một người dùng trong trải nghiệm. Đối với 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ọn của các trường tùy chỉnh sẽ cung cấp các bản phân tích trong các biểu đồ được cung cấp bởi Roblox.Chỉ có chìa khóa cụ thể, được cung cấp bởi Enum.AnalyticsCustomFieldKeys, sẽ được sử dụng cho các phân tích này.Giới hạn ở 8.000 kết hợp duy nhất của các giá trị trên ba lĩnh vực tùy chỉnh mỗi trải nghiệm.
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
Ghi lại một sự kiện được sử dụng để theo dõi các hành động liên quan của người chơi trong trải nghiệm.
Tham Số
Người dùng kích hoạt sự kiện.
Nên xác định hướng mà tiền tệ đang chảy theo dùng Enum.AnalyticsEconomyFlowType .
Tên của tiền tệ được thêm hoặc bỏ, ví dụ "gold" , "gems" , hoặc "energy" .Giới hạn 5 loại tiền tệ duy nhất mỗi trải nghiệm.
Số tiền tệ được thêm hoặc bỏ. Giá trị này luôn phải là dương.
Sự cân bằng của người dùng sau khi tiền tệ được thêm hoặc bỏ. Giá trị này nên luôn lớn hơn hoặc bằng 0.
Loại giao dịch đã xảy ra.Trong khi bạn có thể tự do sử dụng bất kỳ đánh máygiao dịch nào, được khuyến khích sử dụng các loại cung cấp từ Enum.AnalyticsEconomyTransactionType như "IAP" hoặc "ContextualPurchase" để bật các cái nhìn sắp tới từ các công cụ và bảng biểu của Roblox.
Bởi vì loại trường này là một chuỗi, bạn sẽ cần phải truyền giá trị Name của enum. Ví dụ Enum.AnalyticsEconomyTransactionType.IAP.Name .
Giới hạn 20 loại duy nhất mỗi trải nghiệm.
SKU tùy chọn của mặt hàng hoặc gói đang được mua.Đây là một nhận dạng duy nhất cho mặt hàng đang được mua.Giới hạn 100 SKU duy nhất cho mỗi trải nghiệm.
Từ điển tùy chọn của các trường tùy chỉnh sẽ cung cấp các bản phân tích trong các biểu đồ được cung cấp bởi Roblox.Chỉ có chìa khóa cụ thể, được cung cấp bởi Enum.AnalyticsCustomFieldKeys, sẽ được sử dụng cho các phân tích này.Giới hạn ở 8.000 kết hợp duy nhất của các giá trị trên ba lĩnh vực tùy chỉnh mỗi trải nghiệm.
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
Ghi lại một sự kiện được sử dụng để theo dõi hành động người dùng bước qua một ống dẫn trước định trước.Phân tích đường ống chỉ xem xét các giá trị người dùng và sự kiện từ bước đầu tiên trong phiên lưu truyền.
Tham Số
Người dùng kích hoạt sự kiện.
Tên của ống dẫn. Điều này nên giống nhau cho tất cả các bước trong ống dẫn. Giới hạn 10 ống dẫn duy nhất cho mỗi trải nghiệm.
Nhận dạng duy nhất tùy chọn cho phiên lưu trình. Điều này nên giống nhau cho tất cả các bước trong lưu trình.
Lưu ý rằng trường này chỉ cần thiết cho lặp lại ống dẫn, ví dụ như một ống dẫn dòng mua hàng hoặc một ống dẫn nâng cấp vật phẩm.Nếu bạn không có một nhận xét phễu tự nhiên, nó được khuyến khích sử dụng HttpService:GenerateGUID() .
Số bước trong ống nối. Điều này nên duy nhất cho mỗi bước trong ống nối. Tất cả các ống nối bắt đầu tại bước 1. Giới hạn ở các bước 1-100.
Các bước lặp lại của cùng một người dùng trong cùng một phiên đường ống, hoặc khi funnelSessionId được bỏ qua khi nil sẽ bị bỏ qua.
Lưu ý rằng nếu bỏ qua bất kỳ bước nào, các bước giữa sẽ được coi là hoàn thành.
Tên tùy chọn của bước trong ống dẫn. Trường này chỉ được sử dụng cho mục đích hiển thị trong các biểu đồ được cung cấp bởi Roblox.
Từ điển tùy chọn của các trường tùy chỉnh sẽ cung cấp các bản phân tích trong các biểu đồ được cung cấp bởi Roblox.Chỉ có chìa khóa cụ thể, được cung cấp bởi Enum.AnalyticsCustomFieldKeys, sẽ được sử dụng cho các phân tích này.Giới hạn ở 8.000 kết hợp duy nhất của các giá trị trên ba lĩnh vực tùy chỉnh mỗi trải nghiệm.
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
Ghi lại một sự kiện được sử dụng để theo dõi hành động người dùng bước qua một ống dẫn onboarding.Phân tích đường ống chỉ xem xét các giá trị người dùng và sự kiện từ bước đầu tiên trong phiên lưu truyền.
Tham Số
Người dùng kích hoạt sự kiện.
Số bước trong ống nối. Điều này nên duy nhất cho mỗi bước trong ống nối. Tất cả các ống nối bắt đầu tại bước 1. Giới hạn ở 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 giữa sẽ được coi là hoàn thành.
Tên tùy chọn của bước trong ống dẫn. Trường này chỉ được sử dụng cho mục đích hiển thị trong các biểu đồ được cung cấp bởi Roblox.
Từ điển tùy chọn của các trường tùy chỉnh sẽ cung cấp các bản phân tích trong các biểu đồ được cung cấp bởi Roblox.Chỉ có chìa khóa cụ thể, được cung cấp bởi Enum.AnalyticsCustomFieldKeys, sẽ được sử dụng cho các phân tích này.Giới hạn ở 8.000 kết hợp duy nhất của các giá trị trên ba lĩnh vực tùy chỉnh mỗi trải nghiệm.
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
Ghi lại một sự kiện khi người dùng đã hoàn thành một lần thử nghiệm cấp độ. Sự kiện này hiện không hiển thị trong bất kỳ biểu đồ được cung cấp bởi Roblox nào.
Tham Số
Người chơi gây ra sự kiện.
Lợi Nhuận
LogProgressionEvent
Ghi lại một sự kiện khi người dùng đã 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ỳ biểu đồ được cung cấp bởi Roblox nào.
Tham Số
Người chơi gây ra sự kiện.
Lợi Nhuận
LogProgressionFailEvent
Ghi lại một sự kiện khi người dùng đã 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 do Roblox cung cấp.
Tham Số
Người dùng kích hoạt sự kiện.
Lợi Nhuận
LogProgressionStartEvent
Ghi lại một sự kiện khi người dùng đã bắt đầu một lần thử cấp độ. Sự kiện này hiện không hiển thị trong bất kỳ biểu đồ được cung cấp bởi Roblox.
Tham Số
Người chơi gây ra sự kiện.