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ł 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ł próby poziomu.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Rejestruje wydarzenie, gdy użytkownik nie powiódł próby poziomu.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Rejestruje wydarzenie, gdy użytkownik rozpoczął 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 typu 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
Poniższy przykład śledzi zakup Robuxa pakietu 1000 monet za pomocą typu transakcji IAP (zakup w aplikacji).Zauważ nazwę elementu podaną jako opcjonalny parametr w porównaniu do poprzedniego przykładu.
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- Ile monet jest w pakiecie
1020, -- równowaga po transakcji
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- Unikalny identyfikator paczki monet
)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 sesji przepł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 sesji kanał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
Poniższy przykład śledzi niektóre podstawowe wydarzenia dla każdego użytkownika rozpoczynające proces kupowania przedmiotu z sklepu "armory".Zauważ funnelSessionId używany do rozróżniania różnych sesji tego samego użytkownika otwierającego sklep.
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- Loguj, gdy użytkownik otwiera sklep
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nazwa kanału używana do grupowania kroków razem
funnelSessionId, -- ID sesji przepustki dla tej unikalnej sesji płatniczej
1, -- Numer kroku
"Opened Store" -- Nazwa kroku
)
-- Loguj, gdy użytkownik ogląda przedmiot
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nazwa kanału używana do grupowania kroków razem
funnelSessionId, -- ID sesji przepustki dla tej unikalnej sesji płatniczej
2, -- Numer kroku
"Viewed Item" -- Nazwa kroku
)
-- Rejestruj, gdy użytkownik dodaje przedmiot do koszyka
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nazwa kanału używana do grupowania kroków razem
funnelSessionId, -- ID sesji przepustki dla tej unikalnej sesji płatniczej
3, -- Numer kroku
"Added to Cart" -- Nazwa kroku
)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 sesji przepł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
Poniższy przykład pokazuje, jak zarejestrować dwa kroki funkcji onboardingu.Funkcja wdrożenia zwykle wprowadza graczy do głównego cyklu gry.
local AnalyticsService = game:GetService("AnalyticsService")
-- Zapisz pierwszy krok FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- Numer kroku
"Joined Game" -- Nazwa kroku
)
-- Zarejestruj drugi krok FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- Numer kroku
"Choose Class" -- Nazwa kroku
)LogProgressionCompleteEvent
Rejestruje wydarzenie, gdy użytkownik zakończył 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ł próby 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ł próby 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ął próbę poziomu. To wydarzenie nie jest obecnie wyświetlane w żadnych dostarczonych przez Roblox wykresach.
Parametry
Gracz, który uruchomił wydarzenie.