AnalyticsService
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
Usługa analityczna to zbiór metod, które umożliwiają programistom śledzenie sposobu interakcji użytkowników z ich doświadczeniami, w szczególności postępu gracza, ekonomii doświadczenia, kanałów i niestandardowych wydarzeń.
Podsumowanie
Metody
Rejestruje wydarzenie używane do śledzenia niestandardowych metryk użytkownika w doświadczeniu.
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):()
Rejestruje wydarzenie używane do śledzenia działań gracza związanych z doświadczeniem.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):()
Rejestruje wydarzenie używane do śledzenia działań użytkownika, które przechodzą przez wcześniej zaplanowany funnel.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):()
Rejestruje wydarzenie używane do śledzenia działań użytkownika, które przechodzą przez funnel wdrożeniowy.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Rejestruje wydarzenie, gdy użytkownik zakończył podejmować próbępoziomu.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):()
Rejestruje wydarzenie, gdy użytkownik rozpoczął, zakończył lub nie powiódł podejmować próbępoziomu.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Rejestruje wydarzenie, gdy użytkownik nie powiódł podejmować próbępoziomu.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Rejestruje wydarzenie, gdy użytkownik rozpoczął podejmować próbępoziomu.
Właściwości
Metody
LogCustomEvent
Rejestruje wydarzenie używane do śledzenia niestandardowych metryk użytkownika w doświadczeniu. Dla dodatkowych informacji, zobacz Wydarzenia niestandardowe.
Parametry
Użytkownik, który uruchomił wydarzenie.
Nazwa niestandardowego wydarzenia.
Wartość wydarzenia, które zostanie wykorzystane w agregacji.
Opcjonalny słownik niestandardowych pól, które zapewnią rozbiórki w tabelach dostarczonych przez Roblox.Tylko specyficzne klucze, dostarczone przez Enum.AnalyticsCustomFieldKeys, zostaną użyte do tych rozbitek.Ograniczone do 8,000 unikalnych kombinacji wartości w każdym z trzech niestandardowych pól na doświadczenie.
Zwroty
Przykłady kodu
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
Rejestruje wydarzenie używane do śledzenia działań gracza związanych z doświadczeniem.
Parametry
Użytkownik, który uruchomił wydarzenie.
Powinien określić kierunek, w którym waluta przepływa za pomocą Enum.AnalyticsEconomyFlowType .
Nazwa waluty dodawana lub usuwana, na przykład "gold" , "gems" lub "energy" .Ograniczony do 5 unikalnych rodzajów walut na doświadczenie.
Ilość waluty dodawana lub usuwana. Ta wartość zawsze powinna być pozytywna.
Bilans użytkownika po dodaniu lub usunięciu waluty. Ta wartość zawsze powinna być większa lub równa 0.
Typ transakcji, który się wydarzył.Chociaż możesz swobodnie korzystać z dowolnego wpisywaćtransakcji, zaleca się używanie dostarczonych typów z Enum.AnalyticsEconomyTransactionType takich jak "IAP" lub "ContextualPurchase" do włączenia przyszłych wglądów z narzędziami i wykresami Roblox.
Ponieważ ten typ pola jest ciągiem, musisz przekazać wartość Name z listy wartości. Na przykład Enum.AnalyticsEconomyTransactionType.IAP.Name.
Ograniczony do 20 unikalnych rodzajów na doświadczenie.
Opcjonalny SKU przedmiotu lub pakietu, który jest kupowany.Jest to unikalny identyfikator przedmiotu, który jest kupowany.Ograniczony do 100 unikalnych SKU na doświadczenie.
Opcjonalny słownik niestandardowych pól, które zapewnią rozbiórki w tabelach dostarczonych przez Roblox.Tylko specyficzne klucze, dostarczone przez Enum.AnalyticsCustomFieldKeys, zostaną użyte do tych rozbitek.Ograniczone do 8,000 unikalnych kombinacji wartości w każdym z trzech niestandardowych pól na doświadczenie.
Zwroty
Przykłady kodu
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
Rejestruje wydarzenie używane do śledzenia działań użytkownika, które przechodzą przez wcześniej zaplanowany funnel.Rozbiórki przepływów będą rozważać tylko wartości użytkownika i wydarzenia z pierwszego kroku w sesjaprzepływu.
Parametry
Użytkownik, który uruchomił wydarzenie.
Nazwa kanału. Powinna być taka sama dla wszystkich kroków w kanałach. Ograniczona do 10 unikalnych kanałów na doświadczenie.
Opcjonalny unikalny identyfikator dla sesji przepustki. Powinien być taki sam dla wszystkich kroków w przepustce.
Zauważ, że to pole jest niezbędne tylko dla powtarzalnych przepływów, na przykład przepływów płatności lub przepływów ulepszeń przedmiotów.Jeśli nie masz naturalnego identyfikatora sesji w kanałach, zaleca się użycie HttpService:GenerateGUID().
Numer kroku w ścieku. Powinien być unikalny dla każdego kroku w ścieku. Wszystkie ścieki zaczynają się od kroku 1. Ograniczony do kroków 1-100.
Powtarzane kroki przez tego samego użytkownika w tej samej sesjakanału lub gdy funnelSessionId będzie ignorowany, gdy nil będzie ignorowany.
Zauważ, że jeśli któreś kroki zostaną pominięte, kroki pośrednie zostaną uznane za ukończone.
Opcjonalna nazwa kroku w funkcji. To pole jest używane wyłącznie do celów wyświetlania w dostarczonych przez Roblox wykresach.
Opcjonalny słownik niestandardowych pól, które zapewnią rozbiórki w tabelach dostarczonych przez Roblox.Tylko specyficzne klucze, dostarczone przez Enum.AnalyticsCustomFieldKeys, zostaną użyte do tych rozbitek.Ograniczone do 8,000 unikalnych kombinacji wartości w każdym z trzech niestandardowych pól na doświadczenie.
Zwroty
Przykłady kodu
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
Rejestruje wydarzenie używane do śledzenia działań użytkownika, które przechodzą przez funnel wdrożeniowy.Rozbiórki przepływów będą rozważać tylko wartości użytkownika i wydarzenia z pierwszego kroku w sesjaprzepływu.
Parametry
Użytkownik, który uruchomił wydarzenie.
Numer kroku w ścieku. Powinien być unikalny dla każdego kroku w ścieku. Wszystkie ścieki zaczynają się od kroku 1. Ograniczony do kroków 1-100.
Zauważ, że jeśli któreś kroki zostaną pominięte, kroki pośrednie zostaną uznane za ukończone.
Opcjonalna nazwa kroku w funkcji. To pole jest używane wyłącznie do celów wyświetlania w dostarczonych przez Roblox wykresach.
Opcjonalny słownik niestandardowych pól, które zapewnią rozbiórki w tabelach dostarczonych przez Roblox.Tylko specyficzne klucze, dostarczone przez Enum.AnalyticsCustomFieldKeys, zostaną użyte do tych rozbitek.Ograniczone do 8,000 unikalnych kombinacji wartości w każdym z trzech niestandardowych pól na doświadczenie.
Zwroty
Przykłady kodu
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
Rejestruje wydarzenie, gdy użytkownik zakończył podejmować próbępoziomu. To wydarzenie nie jest obecnie wyświetlane w żadnych dostarczonych przez Roblox wykresach.
Parametry
Gracz, który uruchomił wydarzenie.
Zwroty
LogProgressionEvent
Rejestruje wydarzenie, gdy użytkownik rozpoczął, zakończył lub nie powiódł podejmować próbępoziomu. To wydarzenie nie wyświetla się obecnie w żadnych dostarczonych przez Roblox wykresach.
Parametry
Gracz, który uruchomił wydarzenie.
Zwroty
LogProgressionFailEvent
Rejestruje wydarzenie, gdy użytkownik nie powiódł podejmować próbępoziomu. To wydarzenie nie jest obecnie wyświetlane w żadnych dostarczonych przez Roblox wykresach.
Parametry
Użytkownik, który uruchomił wydarzenie.
Zwroty
LogProgressionStartEvent
Rejestruje wydarzenie, gdy użytkownik rozpoczął podejmować próbępoziomu. To wydarzenie nie jest obecnie wyświetlane w żadnych dostarczonych przez Roblox wykresach.
Parametry
Gracz, który uruchomił wydarzenie.