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.
AnalyticsService to zbiór metod, które umożliwiają rozwój developerów, śledząc sposób, w jaki użytkownicy wchodzą w interakcję ze swoimi doświadczeniami, w szczególności postępy gracza, ekonomię w grze, kanały i niestandardowe wydarzenia.
Podsumowanie
Metody
Zapisuje 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):void
Zapisuje wydarzenie używane do śledzenia działań związanych z doświadczeniem.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):void
Zapisuje wydarzenie używane do śledzenia działań użytkownika, które kroczą poprzez zaplanowany wcześniej funel.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):void
Zapisuje wydarzenie używane do śledzenia działań użytkownika krocząc poprzez funnel onboardingowy.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Zapisuje wydarzenie, gdy użytkownik ukończył podejmować próbępoziomu.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):void
Zapisuje 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):void
Zapisuje wydarzenie, gdy użytkownik nie zdał poziomowego podejmować próbę.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Zapisuje wydarzenie, gdy użytkownik rozpoczął podejmować próbępoziomu.
Właściwości
Metody
LogCustomEvent
Zapisuje wydarzenie używane do śledzenia niestandardowych metryk użytkownika w doświadczeniu. Dla dodatkowych informacji, see niestandardowe wydarzenia .
Parametry
Użytkownik, który wywołał wydarzenie.
Nazwa niestandardowego wydarzenia.
Wartość wydarzenia, która zostanie użyta do agregacji.
Opcjonalny słownik niestandardowych pola, które zapewnią rozkłady w dostarczonych przez Roblox rysunkach. Tylko klucze specyficzne, dostarczone przez Enum.AnalyticsCustomFieldKeys, będą używane do tych rozkładów. Ograniczone do 8 000 unikalnych kombinacji wartości na trzech polach niestandardowych za każdym doświadczeniem.
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
Zapisuje wydarzenie używane do śledzenia działań związanych z doświadczeniem.
Parametry
Użytkownik, który wywołał wydarzenie.
Należy określić kierunek, w którym waluta płynie, używając Enum.AnalyticsEconomyFlowType .
Nazwa waluty, która zostanie dodaна lub usunięta, na przykład "gold", "gems" lub "energy". Ograniczony do 5 unikalnych typów walut za doświadczenie.
Ilość waluty, która jest dodawana lub usuwana. Ta wartość powinna zawsze być pozytywna.
Saldo użytkownika po dodaniu lub usunięciu waluty. Ta wartość powinna zawsze być większa lub równa 0.
Typ transakcji, który się pojawił. Meskie jest wolne od używania dowolnego wpisywaćtransakcji, ale zaleca się używać zapewnionych typów z Enum.AnalyticsEconomyTransactionType takich jak "IAP" lub "ContextualPurchase", aby włączyć przyszłe wglądy z narzędzi i raportów Roblox.
Ponieważ ten typ pola jest ciągiem znaków, będziesz musiał przekazać wartość Name pola w zapisie. Na przykład Enum.AnalyticsEconomyTransactionType.IAP.Name .
Limitowane do 20 unikalnych typów na doświadczenie.
Opcjonalny identyfikator SKU przedmiotu lub zestawu. Jest to unikalny identyfikator dla przedmiotu, który jest kupowany. Limitowany do 100 unikalnych SKU za doświadczenie.
Opcjonalny słownik niestandardowych pola, które zapewnią rozkłady w dostarczonych przez Roblox rysunkach. Tylko klucze specyficzne, dostarczone przez Enum.AnalyticsCustomFieldKeys, będą używane do tych rozkładów. Ograniczone do 8 000 unikalnych kombinacji wartości na trzech polach niestandardowych za każdym doświadczeniem.
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
Zapisuje wydarzenie używane do śledzenia działań użytkownika krocząc poprzez zaplanowany wcześniej funel. Złamania funelu będą rozważać tylko wartości użytkownika i wydarzenia z pierwszego kroku w sesjafunelu.
Parametry
Użytkownik, który wywołał wydarzenie.
Nazwa komina. To powinno być to samo dla wszystkich kroków w kominie. Ograniczonych do 10 unikalnych kominów na doświadczenie.
Opcjonalny unikalny identyfikator sesjakanału. To powinno być tyle samo dla wszystkich kroków w kanałach.
Uwaga, że ten pol jest wymagany tylko dla funkcji powtarzającej się kanały, na przykład kanał kupowania lub kanał ulepszenia przedmiotu. Jeśli nie masz naturalnego identyfikatora kanału, zalecamy użyć HttpService:GenerateGUID() .
Liczby kroku w funnelu. To powinno być unikalne dla każdego kroku w funnelu. Wszystkie funele zaczynają się od kroku 1. Ograniczone do kroków 1-100.
Powtarzające się kroki przez tego samego użytkownika w tej samej sesjafunela lub gdy funnelSessionId jest nil będzie ignorowane.
Uwaga, że jeśli kroki zostaną pominięte, kroki pośrednie będą uważane za zakończone.
Opcjonalna nazwa kroku w funnelu. To pole jest używane tylko do celów wyświetlania w dostarczonych przez Roblox rysunkach.
Opcjonalny słownik niestandardowych pola, które zapewnią rozkłady w dostarczonych przez Roblox rysunkach. Tylko klucze specyficzne, dostarczone przez Enum.AnalyticsCustomFieldKeys, będą używane do tych rozkładów. Ograniczone do 8 000 unikalnych kombinacji wartości na trzech polach niestandardowych za każdym doświadczeniem.
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
Zapisuje wydarzenie używane do śledzenia działań użytkownika krocząc poprzez funnel onboardingowy. Złamania funnelu będą rozważać tylko wartości użytkownika i wydarzenia z pierwszego kroku w sesjafunnel.
Parametry
Użytkownik, który wywołał wydarzenie.
Liczby kroku w funnelu. To powinno być unikalne dla każdego kroku w funnelu. Wszystkie funele zaczynają się od kroku 1. Ograniczone do kroków 1-100.
Uwaga, że jeśli kroki zostaną pominięte, kroki pośrednie będą uważane za zakończone.
Opcjonalna nazwa kroku w funnelu. To pole jest używane tylko do celów wyświetlania w dostarczonych przez Roblox rysunkach.
Opcjonalny słownik niestandardowych pola, które zapewnią rozkłady w dostarczonych przez Roblox rysunkach. Tylko klucze specyficzne, dostarczone przez Enum.AnalyticsCustomFieldKeys, będą używane do tych rozkładów. Ograniczone do 8 000 unikalnych kombinacji wartości na trzech polach niestandardowych za każdym doświadczeniem.
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
Zapisuje wydarzenie, gdy użytkownik ukończył podejmować próbępoziomu. Ten zapis nie jest obecnie wyświetlany w żadnych dostarczonych przez Roblox rysunkach.
Parametry
Gracz, który wywołał wydarzenie.
Zwroty
LogProgressionEvent
Zapisuje wydarzenie, gdy użytkownik rozpoczął, zakończył lub nie powiódł podejmować próbępoziomu. Ten zapis wyswietlany jest obecnie w żadnych dostępnych przez Roblox rysunkach.
Parametry
Gracz, który wywołał wydarzenie.
Zwroty
LogProgressionFailEvent
Zapisuje wydarzenie, gdy użytkownik nie zdał podejmować próbępoziomu. Ten zapis nie jest obecnie wyświetlany w żadnych dostarczonych przez Roblox rysunkach.
Parametry
Użytkownik, który wywołał wydarzenie.
Zwroty
LogProgressionStartEvent
Zapisuje wydarzenie, gdy użytkownik rozpoczął podejmować próbępoziomu. To wydarzenie obecnie nie jest wyświetlane na żadnych dostarczonych przez Roblox rysunkach.
Parametry
Gracz, który wywołał wydarzenie.