AnalyticsService

Pokaż przestarzałe

*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.

Brak możliwości tworzenia
Usługa
Bez replikacji

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

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

player: Player

Użytkownik, który uruchomił wydarzenie.

Wartość domyślna: ""
eventName: string

Nazwa niestandardowego wydarzenia.

Wartość domyślna: ""
value: number

Wartość wydarzenia, które zostanie wykorzystane w agregacji.

Wartość domyślna: 1
customFields: Dictionary

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.

Wartość domyślna: "nil"

Zwroty

()

Przykłady kodu

This example uses AnalyticsService:LogCustomEvent() to log two custom events: MissionStarted and MissionCompletedDuration.

Log Custom Event

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

player: Player

Użytkownik, który uruchomił wydarzenie.

Wartość domyślna: ""

Powinien określić kierunek, w którym waluta przepływa za pomocą Enum.AnalyticsEconomyFlowType .

Wartość domyślna: ""
currencyType: string

Nazwa waluty dodawana lub usuwana, na przykład "gold" , "gems" lub "energy" .Ograniczony do 5 unikalnych rodzajów walut na doświadczenie.

Wartość domyślna: ""
amount: number

Ilość waluty dodawana lub usuwana. Ta wartość zawsze powinna być pozytywna.

Wartość domyślna: ""
endingBalance: number

Bilans użytkownika po dodaniu lub usunięciu waluty. Ta wartość zawsze powinna być większa lub równa 0.

Wartość domyślna: ""
transactionType: string

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.

Wartość domyślna: ""
itemSku: string

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.

Wartość domyślna: ""
customFields: Dictionary

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.

Wartość domyślna: "nil"

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.

Tracking an in-app purchase

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

player: Player

Użytkownik, który uruchomił wydarzenie.

Wartość domyślna: ""
funnelName: string

Nazwa kanału. Powinna być taka sama dla wszystkich kroków w kanałach. Ograniczona do 10 unikalnych kanałów na doświadczenie.

Wartość domyślna: ""
funnelSessionId: string

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().

Wartość domyślna: ""
step: number

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.

Wartość domyślna: 1
stepName: string

Opcjonalna nazwa kroku w funkcji. To pole jest używane wyłącznie do celów wyświetlania w dostarczonych przez Roblox wykresach.

Wartość domyślna: ""
customFields: Dictionary

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.

Wartość domyślna: "nil"

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.

Tracking Shop steps

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

player: Player

Użytkownik, który uruchomił wydarzenie.

Wartość domyślna: ""
step: number

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.

Wartość domyślna: ""
stepName: string

Opcjonalna nazwa kroku w funkcji. To pole jest używane wyłącznie do celów wyświetlania w dostarczonych przez Roblox wykresach.

Wartość domyślna: ""
customFields: Dictionary

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.

Wartość domyślna: "nil"

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.

Tracking onboarding steps

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

player: Player

Gracz, który uruchomił wydarzenie.

Wartość domyślna: ""
progressionPathName: string
Wartość domyślna: ""
level: number
Wartość domyślna: ""
levelName: string
Wartość domyślna: ""
customFields: Dictionary
Wartość domyślna: "nil"

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

player: Player

Gracz, który uruchomił wydarzenie.

Wartość domyślna: ""
progressionPathName: string
Wartość domyślna: ""
Wartość domyślna: ""
level: number
Wartość domyślna: ""
levelName: string
Wartość domyślna: ""
customFields: Dictionary
Wartość domyślna: "nil"

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

player: Player

Użytkownik, który uruchomił wydarzenie.

Wartość domyślna: ""
progressionPathName: string
Wartość domyślna: ""
level: number
Wartość domyślna: ""
levelName: string
Wartość domyślna: ""
customFields: Dictionary
Wartość domyślna: "nil"

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

player: Player

Gracz, który uruchomił wydarzenie.

Wartość domyślna: ""
progressionPathName: string
Wartość domyślna: ""
level: number
Wartość domyślna: ""
levelName: string
Wartość domyślna: ""
customFields: Dictionary
Wartość domyślna: "nil"

Zwroty

()

Zdarzenia