AnalyticsService

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Tidak Dapat Dibuat
Layanan
Tidak Direplikasi

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

Properti

Metode

LogCustomEvent

()

Mencatat peristiwa yang digunakan untuk melacak metrik khusus pengguna dalam pengalaman. Untuk informasi tambahan, lihat Peristiwa Kustom.

Parameter

player: Player

Pengguna yang memicu peristiwa.

Nilai Default: ""
eventName: string

Nama acara khusus.

Nilai Default: ""
value: number

Nilai acara yang akan digunakan dalam agregasi.

Nilai Default: 1
customFields: Dictionary

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.

Nilai Default: "nil"

Memberikan nilai

()

Contoh Kode

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

()

Mencatat peristiwa yang digunakan untuk melacak tindakan pemain yang terkait dengan pengalaman.

Parameter

player: Player

Pengguna yang memicu peristiwa.

Nilai Default: ""

Harus menentukan arah yang mata uang mengalir menggunakan Enum.AnalyticsEconomyFlowType .

Nilai Default: ""
currencyType: string

Nama mata uang yang ditambahkan atau dihapus, misalnya "gold" , "gems" , atau "energy" .Dibatasi pada 5 jenis mata uang unik per pengalaman.

Nilai Default: ""
amount: number

Jumlah mata uang yang ditambahkan atau dihapus. Nilai ini harus selalu positif.

Nilai Default: ""
endingBalance: number

Saldo pengguna setelah mata uang ditambahkan atau dihapus. Nilai ini harus selalu lebih besar atau sama dengan 0.

Nilai Default: ""
transactionType: string

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.

Nilai Default: ""
itemSku: string

SKU opsional dari item atau bundel yang dibeli.Ini adalah identifikator unik untuk item yang dibeli.Dibatasi pada 100 SKU unik per pengalaman.

Nilai Default: ""
customFields: Dictionary

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.

Nilai Default: "nil"

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.

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

()

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

player: Player

Pengguna yang memicu peristiwa.

Nilai Default: ""
funnelName: string

Nama saluran. Ini harus sama untuk semua langkah dalam saluran. Terbatas pada 10 funnel unik per pengalaman.

Nilai Default: ""
funnelSessionId: string

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

Nilai Default: ""
step: number

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.

Nilai Default: 1
stepName: string

Nama opsional dari langkah dalam saluran. Bidang ini hanya digunakan untuk tujuan tampilan di bagan yang disediakan oleh Roblox.

Nilai Default: ""
customFields: Dictionary

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.

Nilai Default: "nil"

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.

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

()

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

player: Player

Pengguna yang memicu peristiwa.

Nilai Default: ""
step: number

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.

Nilai Default: ""
stepName: string

Nama opsional dari langkah dalam saluran. Bidang ini hanya digunakan untuk tujuan tampilan di bagan yang disediakan oleh Roblox.

Nilai Default: ""
customFields: Dictionary

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.

Nilai Default: "nil"

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.

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

()

Mencatat peristiwa ketika pengguna telah menyelesaikan berupayatingkat. Peristiwa ini saat ini tidak ditampilkan di bagan yang disediakan oleh Roblox.

Parameter

player: Player

Pemain yang memicu peristiwa.

Nilai Default: ""
progressionPathName: string
Nilai Default: ""
level: number
Nilai Default: ""
levelName: string
Nilai Default: ""
customFields: Dictionary
Nilai Default: "nil"

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

player: Player

Pemain yang memicu peristiwa.

Nilai Default: ""
progressionPathName: string
Nilai Default: ""
Nilai Default: ""
level: number
Nilai Default: ""
levelName: string
Nilai Default: ""
customFields: Dictionary
Nilai Default: "nil"

Memberikan nilai

()

LogProgressionFailEvent

()

Mencatat peristiwa ketika pengguna gagal dalam berupayatingkat. Peristiwa ini saat ini tidak ditampilkan di bagan yang disediakan oleh Roblox.

Parameter

player: Player

Pengguna yang memicu peristiwa.

Nilai Default: ""
progressionPathName: string
Nilai Default: ""
level: number
Nilai Default: ""
levelName: string
Nilai Default: ""
customFields: Dictionary
Nilai Default: "nil"

Memberikan nilai

()

LogProgressionStartEvent

()

Mencatat peristiwa ketika pengguna telah memulai berupayatingkat. Peristiwa ini saat ini tidak ditampilkan di bagan yang disediakan oleh Roblox.

Parameter

player: Player

Pemain yang memicu peristiwa.

Nilai Default: ""
progressionPathName: string
Nilai Default: ""
level: number
Nilai Default: ""
levelName: string
Nilai Default: ""
customFields: Dictionary
Nilai Default: "nil"

Memberikan nilai

()

Acara