AnalyticsService
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Layanan Analitik adalah koleksi metode yang memungkinkan pengembang melacak bagaimana pengguna berinteraksi dengan pengalaman mereka, khususnya kemajuan pemain, ekonomi pengalaman, selokan, dan acara khusus.
Rangkuman
Metode
Mencatat peristiwa 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):()
Mencatat peristiwa yang digunakan untuk melacak tindakan pemain yang terkait dengan pengalaman.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):()
Mencatat peristiwa yang digunakan untuk melacak tindakan pengguna yang melalui saluran yang direncanakan sebelumnya.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):()
Mencatat peristiwa yang digunakan untuk melacak tindakan pengguna melalui saluran onboarding.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Mencatat peristiwa ketika pengguna telah menyelesaikan berupayatingkat.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):()
Mencatat peristiwa ketika pengguna telah mulai, menyelesaikan, atau gagal dalam berupayatingkat.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Mencatat peristiwa ketika pengguna gagal dalam berupayatingkat.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Mencatat peristiwa ketika pengguna telah memulai berupayatingkat.
Properti
Metode
LogCustomEvent
Mencatat peristiwa yang digunakan untuk melacak metrik khusus pengguna dalam pengalaman. Untuk informasi tambahan, lihat Peristiwa Kustom.
Parameter
Pengguna yang memicu peristiwa.
Nama acara khusus.
Nilai acara yang akan digunakan dalam agregasi.
Diksi opsional dari bidang khusus yang akan memberikan ringkasan dalam grafik yang disediakan Roblox.Hanya kunci khusus, yang disediakan oleh Enum.AnalyticsCustomFieldKeys, akan digunakan untuk ringkasan ini.Dibatasi pada 8.000 kombinasi unik nilai di tiga bidang khusus per pengalaman.
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
Mencatat peristiwa yang digunakan untuk melacak tindakan pemain yang terkait dengan pengalaman.
Parameter
Pengguna yang memicu peristiwa.
Harus menentukan arah yang mata uang mengalir menggunakan Enum.AnalyticsEconomyFlowType .
Nama mata uang yang ditambahkan atau dihapus, misalnya "gold" , "gems" , atau "energy" .Dibatasi pada 5 jenis mata uang unik per pengalaman.
Jumlah mata uang yang ditambahkan atau dihapus. Nilai ini harus selalu positif.
Saldo pengguna setelah mata uang ditambahkan atau dihapus. Nilai ini harus selalu lebih besar atau sama dengan 0.
Jenis transaksi yang terjadi.Sementara Anda bebas menggunakan ketiktransaksi apa pun, disarankan untuk menggunakan jenis yang disediakan dari Enum.AnalyticsEconomyTransactionType seperti "IAP" atau "ContextualPurchase" untuk mengaktifkan wawasan masa depan dari alat dan grafik Roblox.
Karena jenis bidang ini adalah string, Anda perlu menyampaikan nilai Name dari enum. Misalnya Enum.AnalyticsEconomyTransactionType.IAP.Name .
Dibatasi pada 20 jenis unik per pengalaman.
SKU opsional dari item atau bundel yang dibeli.Ini adalah identifikator unik untuk item yang dibeli.Dibatasi pada 100 SKU unik per pengalaman.
Diksi opsional dari bidang khusus yang akan memberikan ringkasan dalam grafik yang disediakan Roblox.Hanya kunci khusus, yang disediakan oleh Enum.AnalyticsCustomFieldKeys, akan digunakan untuk ringkasan ini.Dibatasi pada 8.000 kombinasi unik nilai di tiga bidang khusus per pengalaman.
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
Mencatat peristiwa yang digunakan untuk melacak tindakan pengguna yang melalui saluran yang direncanakan sebelumnya.Penurunan saluran hanya akan mempertimbangkan nilai pengguna dan acara dari langkah pertama dalam sesi saluran.
Parameter
Pengguna yang memicu peristiwa.
Nama saluran. Ini harus sama untuk semua langkah dalam saluran. Terbatas pada 10 funnel unik per pengalaman.
Pengenal unik opsional untuk sesi saluran. Ini harus sama untuk semua langkah dalam saluran.
Perhatikan bahwa bidang ini hanya diperlukan untuk berulang saluran, misalnya saluran aliran pembelian atau saluran peningkatan item.Jika Anda tidak memiliki identifikasi sesi saluran alami, disarankan untuk menggunakan HttpService:GenerateGUID() .
Angka langkah dalam saluran. Ini harus unik untuk setiap langkah dalam saluran. Semua saluran dimulai pada langkah 1. Terbatas pada langkah 1-100.
Langkah-langkah yang diulang oleh pengguna yang sama di sesi saluran yang sama, atau ketika funnelSessionId adalah nil akan diabaikan.
Perhatikan bahwa jika langkah apa pun diabaikan, langkah-langkah antara akan dianggap selesai.
Nama opsional dari langkah dalam saluran. Bidang ini hanya digunakan untuk tujuan tampilan di bagan yang disediakan oleh Roblox.
Diksi opsional dari bidang khusus yang akan memberikan ringkasan dalam grafik yang disediakan Roblox.Hanya kunci khusus, yang disediakan oleh Enum.AnalyticsCustomFieldKeys, akan digunakan untuk ringkasan ini.Dibatasi pada 8.000 kombinasi unik nilai di tiga bidang khusus per pengalaman.
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
Mencatat peristiwa yang digunakan untuk melacak tindakan pengguna melalui saluran onboarding.Penurunan saluran hanya akan mempertimbangkan nilai pengguna dan acara dari langkah pertama dalam sesi saluran.
Parameter
Pengguna yang memicu peristiwa.
Angka langkah dalam saluran. Ini harus unik untuk setiap langkah dalam saluran. Semua saluran dimulai pada langkah 1. Terbatas pada langkah 1-100.
Perhatikan bahwa jika langkah apa pun diabaikan, langkah-langkah antara akan dianggap selesai.
Nama opsional dari langkah dalam saluran. Bidang ini hanya digunakan untuk tujuan tampilan di bagan yang disediakan oleh Roblox.
Diksi opsional dari bidang khusus yang akan memberikan ringkasan dalam grafik yang disediakan Roblox.Hanya kunci khusus, yang disediakan oleh Enum.AnalyticsCustomFieldKeys, akan digunakan untuk ringkasan ini.Dibatasi pada 8.000 kombinasi unik nilai di tiga bidang khusus per pengalaman.
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
Mencatat peristiwa ketika pengguna telah menyelesaikan berupayatingkat. Peristiwa ini saat ini tidak ditampilkan di bagan yang disediakan oleh Roblox.
Parameter
Pemain yang memicu peristiwa.
Memberikan nilai
LogProgressionEvent
Mencatat peristiwa ketika pengguna telah mulai, menyelesaikan, atau gagal dalam berupayatingkat. Peristiwa ini saat ini tidak ditampilkan di bagan yang disediakan oleh Roblox.
Parameter
Pemain yang memicu peristiwa.
Memberikan nilai
LogProgressionFailEvent
Mencatat peristiwa ketika pengguna gagal dalam berupayatingkat. Peristiwa ini saat ini tidak ditampilkan di bagan yang disediakan oleh Roblox.
Parameter
Pengguna yang memicu peristiwa.
Memberikan nilai
LogProgressionStartEvent
Mencatat peristiwa ketika pengguna telah memulai berupayatingkat. Peristiwa ini saat ini tidak ditampilkan di bagan yang disediakan oleh Roblox.
Parameter
Pemain yang memicu peristiwa.