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

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

Właściwości

Metody

LogCustomEvent

void

Zapisuje wydarzenie używane do śledzenia niestandardowych metryk użytkownika w doświadczeniu. Dla dodatkowych informacji, see niestandardowe wydarzenia .

Parametry

player: Player

Użytkownik, który wywołał wydarzenie.

eventName: string

Nazwa niestandardowego wydarzenia.

value: number

Wartość wydarzenia, która zostanie użyta do agregacji.

Wartość domyślna: 1
customFields: Dictionary

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.

Wartość domyślna: "nil"

Zwroty

void

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

void

Zapisuje wydarzenie używane do śledzenia działań związanych z doświadczeniem.

Parametry

player: Player

Użytkownik, który wywołał wydarzenie.

Należy określić kierunek, w którym waluta płynie, używając Enum.AnalyticsEconomyFlowType .

currencyType: string

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.

amount: number

Ilość waluty, która jest dodawana lub usuwana. Ta wartość powinna zawsze być pozytywna.

endingBalance: number

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

transactionType: string

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.

itemSku: string

Opcjonalny identyfikator SKU przedmiotu lub zestawu. Jest to unikalny identyfikator dla przedmiotu, który jest kupowany. Limitowany do 100 unikalnych SKU za doświadczenie.

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

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.

Wartość domyślna: "nil"

Zwroty

void

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

void

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

player: Player

Użytkownik, który wywołał wydarzenie.

funnelName: string

Nazwa komina. To powinno być to samo dla wszystkich kroków w kominie. Ograniczonych do 10 unikalnych kominów na doświadczenie.

funnelSessionId: string

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

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

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.

Wartość domyślna: 1
stepName: string

Opcjonalna nazwa kroku w funnelu. To pole jest używane tylko do celów wyświetlania w dostarczonych przez Roblox rysunkach.

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

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.

Wartość domyślna: "nil"

Zwroty

void

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

void

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

player: Player

Użytkownik, który wywołał wydarzenie.

step: number

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.

stepName: string

Opcjonalna nazwa kroku w funnelu. To pole jest używane tylko do celów wyświetlania w dostarczonych przez Roblox rysunkach.

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

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.

Wartość domyślna: "nil"

Zwroty

void

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

void

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

player: Player

Gracz, który wywołał wydarzenie.

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

Zwroty

void

LogProgressionEvent

void

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

player: Player

Gracz, który wywołał wydarzenie.

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

Zwroty

void

LogProgressionFailEvent

void

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

player: Player

Użytkownik, który wywołał wydarzenie.

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

Zwroty

void

LogProgressionStartEvent

void

Zapisuje wydarzenie, gdy użytkownik rozpoczął podejmować próbępoziomu. To wydarzenie obecnie nie jest wyświetlane na żadnych dostarczonych przez Roblox rysunkach.

Parametry

player: Player

Gracz, który wywołał wydarzenie.

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

Zwroty

void

Zdarzenia