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 upaya tingkat.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):()
Mencatat peristiwa ketika pengguna telah mulai, menyelesaikan, atau gagal dalam upaya tingkat.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Mencatat peristiwa ketika pengguna gagal dalam upaya tingkat.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Mencatat peristiwa ketika pengguna telah memulai upaya tingkat.
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 jenis transaksi 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
Contoh berikut melacak pembelian Robux dari bundel 1000 koin, menggunakan jenis transaksi IAP (pembelian dalam aplikasi).Perhatikan nama item yang disediakan sebagai parameter opsional saat dibandingkan dengan sampel sebelumnya.
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- Berapa banyak koin yang ada di bundel
1020, -- saldo setelah transaksi
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- Pengenal unik dari bundel koin
)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
Contoh berikut menunjukkan beberapa peristiwa dasar untuk setiap pengguna yang memulai proses untuk membeli barang dari toko "armory".Perhatikan funnelSessionId yang digunakan untuk membedakan antara sesi berbeda dari pengguna yang sama yang membuka toko.
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- Catat saat pengguna membuka toko
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nama saluran digunakan untuk mengumpulkan langkah bersama
funnelSessionId, -- ID sesi saluran untuk sesi pembayaran unik ini
1, -- Nomor langkah
"Opened Store" -- Nama langkah
)
-- Catat saat pengguna melihat item
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nama saluran digunakan untuk mengumpulkan langkah bersama
funnelSessionId, -- ID sesi saluran untuk sesi pembayaran unik ini
2, -- Nomor langkah
"Viewed Item" -- Nama langkah
)
-- Catat saat pengguna melihat menambahkan ke keranjang
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Nama saluran digunakan untuk mengumpulkan langkah bersama
funnelSessionId, -- ID sesi saluran untuk sesi pembayaran unik ini
3, -- Nomor langkah
"Added to Cart" -- Nama langkah
)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
Contoh berikut menunjukkan cara melogging dua langkah dari funnel onboarding.Sebuah saluran onboarding biasanya memperkenalkan pemain ke loop inti permainan.
local AnalyticsService = game:GetService("AnalyticsService")
-- Catat langkah pertama dari FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- Nomor langkah
"Joined Game" -- Nama langkah
)
-- Catat langkah kedua dari FTUE
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- Nomor langkah
"Choose Class" -- Nama langkah
)LogProgressionCompleteEvent
Mencatat peristiwa ketika pengguna telah menyelesaikan upaya tingkat. 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 upaya tingkat. 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 upaya tingkat. 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 upaya tingkat. Peristiwa ini saat ini tidak ditampilkan di bagan yang disediakan oleh Roblox.
Parameter
Pemain yang memicu peristiwa.