AnalyticsService
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
AnalyticsService bir geliştiricinin deneyimleriyle nasıl etkileşime geçtiğini, özellikle oyun ilerlemesini, deneyim ekonomisindeki işlemleri ve özelleştirilmiş etkinlikleri takip etmesine izin veren bir koleksiyonuktur metodu.
Özet
Özellikler
Yöntemler
Kullanıcının deneyimdeki özel metriklerini izlemek için kullanılan bir etkinliği günlüğe kaydeder.
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):void
Oyunun deneyimde ilgili oyun eylemlerini takip etmek için kullanılan bir etkinliği kaydeder.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):void
Kullanıcının bir önceden planlanmış bir funelle katılırken adımlarını izleyen etkinliği günlüğe kaydeder.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):void
Bir kullanıcının bir onboarding funnelinden geçmesi için kullanılan bir etkinliği günlüğe kaydeder.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Bir kullanıcının bir seviye girişimtamamladığında bir etkinliği günlüğe kaydeder.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):void
Bir kullanıcının bir seviye girişimini başlatırken, tamamladığında veya başarısız olduğunda bir etkinliği günlüğe kaydeder.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Bir kullunun bir seviye girişimini başarısız olduğunda bir etkinliği günlüyor.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):void
Bir kullanıcının bir seviye girişimbaşladığında bir etkinliği günlüyor.
Özellikler
Yöntemler
LogCustomEvent
Kullanıcının deneyimdeki özel metriklerini izlemek için kullanılan bir etkinliği günlüğe kaydeder. Ayrıntılar, Özel Etkinlikler bölümünde görüntülenir.
Parametreler
Etkinliği başlatan kullanıcı.
Özel etkinliğin adı.
Kullanılan toplama içinde kullanılan etkinliğin değeri.
Roblox'un sağladığı grafiklerde ayrıntıları sağlayacak özel alanların özlük kitabı. Sadece Enum.AnalyticsCustomFieldKeys tarafından sağlanan özel anahtarlar bu ayrıntılar için kullanılacaktır. Üç özel alanın her biri için 8.000'e kadar benzersiz kombinasyonlara sınırlıdır.
Dönüşler
Kod Örnekleri
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
Oyunun deneyimde ilgili oyun eylemlerini takip etmek için kullanılan bir etkinliği kaydeder.
Parametreler
Etkinliği başlatan kullanıcı.
Envanter.Kaynaklar.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.Hizmetler.
Eklenen veya kaldırılan para biriminin adı, örneğin "gold" , "gems" veya "energy" . Her deneyim için 5 benzersiz para türüne sınırlıdır.
Eklenen veya kaldırılan para birimi miktarı. Bu değer her zaman olumlu olmalıdır.
Para eklenmiş veya kaldırılmış olduğunda kullanıcının solde oranıdır. Bu değer her zaman 0'den büyük veya eşit olmalıdır.
Oluşan transaksiyon türü. Tüm transaksiyon yazkullanımı özgürken, Roblox araçları ve grafikleri için gelecekteki görünümleri etkinleştirmek için sunulan türlerden tavsiye edilir Enum.AnalyticsEconomyTransactionType . örneğin, "IAP" veya "ContextualPurchase" gibi.
Bu alan türü bir dizi, bu nedenle numen'in sayısının Name değerini geçmeniz gerekir. Örneğin Enum.AnalyticsEconomyTransactionType.IAP.Name .
Her deneyim için 20 benzersiz türlere sınırlı.
Satın alınan öğenin veya paketin opzional SKU'su. Bu, satın alınan öğenin benzersiz bir kimliğidir. Her deneyim için 100'e kadar benzersiz SKU'lar sınırlıdır.
Roblox'un sağladığı grafiklerde ayrıntıları sağlayacak özel alanların özlük kitabı. Sadece Enum.AnalyticsCustomFieldKeys tarafından sağlanan özel anahtarlar bu ayrıntılar için kullanılacaktır. Üç özel alanın her biri için 8.000'e kadar benzersiz kombinasyonlara sınırlıdır.
Dönüşler
Kod Örnekleri
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
Kullanıcının bir önceden planlanmış bir funilden geçmesi için kullanılan bir etkinliği günlüğe kaydeder. Funnel breakdown'ları sadece bir funil oturumilk adımdan itibaren kullanıcı ve etkinliği değerlerini göz önünde bulundurur.
Parametreler
Etkinliği başlatan kullanıcı.
Funnel'in adı. Bu, tüm adımlar için aynı olmalıdır. Her deneyim için 10 benzersiz funel olmalıdır.
Funnel oturum için opzional benzersiz tanımlayıcı. Bu, funnel'in tüm adımları için aynı olmalıdır.
Not that this field is only necessary for tekrar eden funeller, örneğin bir satın alma funeri veya bir öğe yükseltme funeri için. Eğer doğal bir funel seans kimliğiniz yoksa, HttpService:GenerateGUID() kullanılması önerilir.
Kanalın içindeki adım numarası. Bu, her adımda kanaalarda benzersiz olmalıdır. Tüm kanallar 1. adımdan başlar. 1-100 arasında sınırlıdır.
Aynı kullanıcı tarafından aynı eğlence oturumunda tekrarlanan adımlar veya funnelSessionId``nil olarak yeniden yazılacak.
Aşamaların atlanması durumunda, orta aşamalar tamamlanmış olarak kabul edilir.
Kanallardaki adımın opzional adı. Bu alan sadece Roblox sağlayan grafiklerde görüntüleme amaçlıdır.
Roblox'un sağladığı grafiklerde ayrıntıları sağlayacak özel alanların özlük kitabı. Sadece Enum.AnalyticsCustomFieldKeys tarafından sağlanan özel anahtarlar bu ayrıntılar için kullanılacaktır. Üç özel alanın her biri için 8.000'e kadar benzersiz kombinasyonlara sınırlıdır.
Dönüşler
Kod Örnekleri
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
Bir kullanıcının bir onboarding funnel'ından geçmesi işlemi takibi için kullanılan bir etkinliği kaydeder. Funnel breakdown'ları sadece bir funnel oturumkullanıcı ve etkinliği değerlerini göz önünde bulundurur.
Parametreler
Etkinliği başlatan kullanıcı.
Kanalın içindeki adım numarası. Bu, her adımda kanaalarda benzersiz olmalıdır. Tüm kanallar 1. adımdan başlar. 1-100 arasında sınırlıdır.
Aşamaların atlanması durumunda, orta aşamalar tamamlanmış olarak kabul edilir.
Kanallardaki adımın opzional adı. Bu alan sadece Roblox sağlayan grafiklerde görüntüleme amaçlıdır.
Roblox'un sağladığı grafiklerde ayrıntıları sağlayacak özel alanların özlük kitabı. Sadece Enum.AnalyticsCustomFieldKeys tarafından sağlanan özel anahtarlar bu ayrıntılar için kullanılacaktır. Üç özel alanın her biri için 8.000'e kadar benzersiz kombinasyonlara sınırlıdır.
Dönüşler
Kod Örnekleri
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
Bir kullanıcının bir seviye girişimtamamladığında olay bir günlük gösterir. Bu günlük hiện Roblox'un sağladığı herhangi bir grafikte görüntülenmez.
Parametreler
Etkinliği başlatan oyuncu.
Dönüşler
LogProgressionEvent
Bir kullanıcının bir seviye girişimbaşlatması, tamamlaması veya başarısız olması için bir etkinliği günlüğe kaydeder. Bu etkinlik Roblox'un sağladığı grafiklerde hiệnlenmez.
Parametreler
Etkinliği başlatan oyuncu.
Dönüşler
LogProgressionFailEvent
Bir kullunun bir seviye girişimini başarısız olduğunda bir etkinliği günlüğe kaydeder. Bu etkinlik Roblox'un sağladığı grafiklerde şu anda görüntülenmez.
Parametreler
Etkinliği başlatan kullanıcı.
Dönüşler
LogProgressionStartEvent
Bir kullunun bir seviye girişimbaşladığında bir etkinlik günlüğü oluşturur. Bu etkinlik Roblox'un sağladığı grafiklerde şu anda görüntülenmez.
Parametreler
Etkinliği başlatan oyuncu.