AnalyticsService
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
AnalyticsService adalah koleksi metode yang memungkinkan pengembang untuk melacak bagaimana pengguna berinteraksi dengan pengalaman mereka, khususnya perkembangan pengguna, ekonomi dalam pengalaman, fungsi, dan acara khusus.
Rangkuman
Metode
Menyimpan acara yang digunakan untuk melacak metrik khusus pengguna dalam pengalaman.
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):void
Menyimpan acara yang digunakan untuk melacak tindakan pemain yang terkait dalam pengalaman.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):void
Menyimpan acara yang digunakan untuk melacak tindakan pengguna melalui funnel pra-rencana.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):void
Menyimpan acara yang digunakan untuk melacak tindakan pengguna melalui funnel onboarding.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Menyimpan acara ketika seorang pengguna telah menyelesaikan berupayatingkat.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):void
Menyimpan acara ketika seorang pengguna telah memulai, menyelesaikan, atau gagal berupayatingkat.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Menyimpan acara ketika seorang pengguna telah gagal berupayatingkat.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Menyimpan acara ketika seorang pengguna telah memulai berupayatingkat.
Properti
Metode
LogCustomEvent
Menyimpan acara yang digunakan untuk melacak metrik khusus pengguna dalam pengalaman. Untuk informasi tambahan, see Acara Kustom .
Parameter
Pengguna yang memicu acara.
Nama acara khusus.
Nilai acara yang akan digunakan dalam aggregation.
Diksiopterdiksiopterdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiper
Memberikan nilai
Contoh Kode
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
Menyimpan acara yang digunakan untuk melacak tindakan pemain yang terkait dalam pengalaman.
Parameter
Pengguna yang memicu acara.
Harus menentukan arah yang mata uang mengalir menggunakan Enum.AnalyticsEconomyFlowType .
Nama mata uang yang ditambahkan atau dihapus, misalnya "gold", "gems", atau "energy". Terbatas untuk 5 jenis mata uang per pengalaman.
Jumlah mata uang yang ditambahkan atau dihapus. Anggapan ini seharusnya selalu positif.
Saldo pengguna setelah mata uang telah ditambahkan atau dihapus.Nilai ini seharusnya selalu lebih besar dari atau sama dengan 0.
Jenis transaksi yang terjadi. Sementara Anda bebas menggunakan ketiktransaksi apa pun, disarankan untuk menggunakan jenis tersedia dari Enum.AnalyticsEconomyTransactionType seperti "IAP" atau "ContextualPurchase" untuk mengaktifkan masa depan insight dari alat dan grafik Roblox.
Karena jenis lapangan ini adalah string, Anda akan perlu menghasilkan nilai Name dari enum. Misalnya Enum.AnalyticsEconomyTransactionType.IAP.Name .
Terbatas untuk 20 jenis unik per pengalaman.
SKU Opsional item atau bundel yang dibeli. Ini adalah identifikator unik untuk item yang dibeli. Terbatas hingga 100 SKU unik per pengalaman.
Diksiopterdiksiopterdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiper
Memberikan nilai
Contoh Kode
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
Menyimpan acara yang digunakan untuk melacak tindakan pengguna melalui funnel yang direncanakan sebelumnya. Penjelasan funnel hanya akan mempertimbangkan nilai pengguna dan acara dari langkah pertama dalam sesi funnel.
Parameter
Pengguna yang memicu acara.
Nama funnel. Ini seharusnya sama untuk semua langkah dalam funnel. Terbatas untuk 10 funnel unik per pengalaman.
Pengenal identitas unik untuk sesi funnel. Ini seharusnya sama untuk semua langkah dalam funnel.
Catat bahwa field ini hanya diperlukan untuk funnel repetitif , misalnya funnel pembelian atau funnel peningkatan item. Jika Anda tidak memiliki identifikasi sesi funnel alami, disarankan untuk menggunakan HttpService:GenerateGUID().
Nomor langkah di funnel. Ini seharusnya unik untuk setiap langkah dalam funnel. Semua funnel dimulai dengan langkah 1. Terbatas untuk langkah 1-100.
Langkah yang diulangi oleh pengguna yang sama dalam sesi funnel yang sama, atau ketika funnelSessionId adalah nil akan diabaikan.
Catat bahwa jika langkah apa pun dilewatkan, langkah tengah akan dianggap selesai.
Nama opsi dari langkah dalam funnel. Feld ini hanya digunakan untuk tujuan tampilan di grafik yang disediakan Roblox.
Diksiopterdiksiopterdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiper
Memberikan nilai
Contoh Kode
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
Menyimpan acara yang digunakan untuk melacak tindakan pengguna melalui funnel onboarding. Penghancuran funnel hanya akan mempertimbangkan nilai pengguna dan acara dari langkah pertama dalam sesi funnel.
Parameter
Pengguna yang memicu acara.
Nomor langkah di funnel. Ini seharusnya unik untuk setiap langkah dalam funnel. Semua funnel dimulai dengan langkah 1. Terbatas untuk langkah 1-100.
Catat bahwa jika langkah apa pun dilewatkan, langkah tengah akan dianggap selesai.
Nama opsi dari langkah dalam funnel. Feld ini hanya digunakan untuk tujuan tampilan di grafik yang disediakan Roblox.
Diksiopterdiksiopterdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiperdiksiper
Memberikan nilai
Contoh Kode
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
Menyimpan acara untuk saat pengguna telah menyelesaikan berupayatingkat. Acara ini saat ini tidak ditampilkan di grafik mana pun yang disediakan Roblox.
Parameter
Pemain yang memicu acara.
Memberikan nilai
LogProgressionEvent
Menyimpan acara ketika seorang pengguna telah memulai, menyelesaikan, atau gagal berupayatingkat. Acara ini tidak saat ini ditampilkan di grafik mana pun yang disediakan Roblox.
Parameter
Pemain yang memicu acara.
Memberikan nilai
LogProgressionFailEvent
Menyimpan acara untuk ketika seorang pengguna telah gagal berupayatingkat. Acara ini saat ini tidak ditampilkan di grafik mana pun yang disediakan Roblox.
Parameter
Pengguna yang memicu acara.
Memberikan nilai
LogProgressionStartEvent
Menyimpan acara untuk ketika seorang pengguna telah memulai berupayatingkat. Acara ini saat ini tidak ditampilkan di grafik mana pun yang disediakan Roblox.
Parameter
Pemain yang memicu acara.