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 geliştiricilerin kullanıcıların deneyimleriyle nasıl etkileşime geçtiğini izlemesine izin veren bir dizi yöntemdir, özellikle oyuncu ilerlemesi, deneyim ekonomisi, borular ve özel etkinlikler.
Özet
Özellikler
Yöntemler
Deneyimdeki bir kullanıcının özel metriklerini izlemek için kullanılan bir olayı günlüğe kaydeder.
- LogEconomyEvent(player : Player,flowType : Enum.AnalyticsEconomyFlowType,currencyType : string,amount : number,endingBalance : number,transactionType : string,itemSku : string,customFields : Dictionary):()
Deneyimle ilgili oyuncu eylemlerini izlemek için kullanılan bir olayı kaydeder.
- LogFunnelStepEvent(player : Player,funnelName : string,funnelSessionId : string,step : number,stepName : string,customFields : Dictionary):()
Önceden planlanmış bir funnelden geçen kullanıcı eylemlerini izlemek için kullanılan bir olayı kaydeder.
- LogOnboardingFunnelStepEvent(player : Player,step : number,stepName : string,customFields : Dictionary):()
Kullanıcı eylemlerini takip eden bir entegrasyon kanalından geçen bir olayı kaydeder.
- LogProgressionCompleteEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Bir kullanıcı bir seviye girişimbitirdiğinde bir olayı kaydeder.
- LogProgressionEvent(player : Player,progressionPathName : string,status : Enum.AnalyticsProgressionType,level : number,levelName : string,customFields : Dictionary):()
Bir kullanıcı bir seviye denemesini başlattığında, bitirdiğinde veya girişimolduğunda bir olay kaydedilir.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Kullanıcı bir seviye girişimbaşarısızladığında bir olayı kaydeder.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Kullanıcı bir seviye girişimbaşlattığında bir olayı kaydeder.
Özellikler
Yöntemler
LogCustomEvent
Deneyimdeki bir kullanıcının özel metriklerini izlemek için kullanılan bir olayı günlüğe kaydeder. Ek bilgi için Özel Etkinlikler bakın.
Parametreler
Etkinliği tetikleyen kullanıcı.
Özel etkinin adı.
Saldırganlıkta kullanılacak olayın değeri.
Roblox tarafından sağlanan grafiklerde kırılımlar sağlayacak isteğe bağlı özel alanlar sözlüğü.Sadece Enum.AnalyticsCustomFieldKeys tarafından sağlanan özel anahtarlar bu ayrıştırmalar için kullanılacaktır.Deney başına üç özel alan üzerindeki 8,000 benzersiz değer kombinasyonuna sınırlı.
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
Deneyimle ilgili oyuncu eylemlerini izlemek için kullanılan bir olayı kaydeder.
Parametreler
Etkinliği tetikleyen kullanıcı.
Para biriminin Enum.AnalyticsEconomyFlowType kullanarak akış yönünü belirtmelidir.
Örneğin, eklenen veya kaldırılan para biriminin adı, örneğin "gold" , "gems" veya "energy" .Deney başına 5 benzersiz para türü ile sınırlı.
Ekleme veya kaldırma miktarı para birimi. Bu değer daima pozitif olmalıdır.
Değer para eklenir veya kaldırıldıktan sonra kullanıcının bakiyesi. Bu değer daima 0'dan büyük veya eşit olmalıdır.
Oluşan işlem türü.Herhangi bir işlem yazkullanmakta özgürken, Roblox araçlarından ve grafiklerinden gelecekteki görünümleri etkinleştirmek için sağlanan türlerden Enum.AnalyticsEconomyTransactionType veya "IAP" veya "ContextualPurchase" gibi kullanmak önerilir.
Bu alan türü bir diziolduğundan, enum'in Name değerini geçmeniz gerekecek. Örneğin Enum.AnalyticsEconomyTransactionType.IAP.Name.
Deney başına 20 benzersiz tipe sınırlı.
Satın alınan öğenin veya paketin opcional SKU'su.Bu, satın alınan öğe için benzersiz bir tanımlayıcıdır.Deney başına 100 benzersiz SKU ile sınırlı.
Roblox tarafından sağlanan grafiklerde kırılımlar sağlayacak isteğe bağlı özel alanlar sözlüğü.Sadece Enum.AnalyticsCustomFieldKeys tarafından sağlanan özel anahtarlar bu ayrıştırmalar için kullanılacaktır.Deney başına üç özel alan üzerindeki 8,000 benzersiz değer kombinasyonuna sınırlı.
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
Önceden planlanmış bir funnelden geçen kullanıcı eylemlerini izlemek için kullanılan bir olayı kaydeder.Funnel kırılımları sadece bir funnel oturumilk adımdaki kullanıcı ve etkinlik değerlerini dikkate alacaktır.
Parametreler
Etkinliği tetikleyen kullanıcı.
Funnel'ın adı. Bu, tüm funnel adımları için aynı olmalıdır. Deney başına 10 eşsiz funnel sınırı.
Funnel oturumu için opcional benzersiz tanımlayıcı. Bu, tüm funnel adımları için aynı olmalıdır.
Bu alanın sadece tekrarlayan boru türleri için gerekli olduğunu unutmayın, örneğin bir satın alma akışı boru veya bir öğe yükseltme boru.Doğal bir funnel oturum tanımlayıcınız yoksa, HttpService:GenerateGUID() kullanmanız önerilir.
Funnel'daki adım sayısı. Bu, funnel'daki her adım için benzersiz olmalıdır. Tüm funneller 1. adımdan başlar. 1-100 adıma kadar sınırlı.
Aynı kullanıcının aynı eğilim oturumunda tekrarlanan adımlar veya 5>
Herhangi bir adım atlanırsa, orta adımların tamamlandığı düşünülür.
Funnel'daki adımın isteğe bağlı adı. Bu alan sadece Roblox tarafından sağlanan grafiklerde görüntüleme amaçlı kullanılır.
Roblox tarafından sağlanan grafiklerde kırılımlar sağlayacak isteğe bağlı özel alanlar sözlüğü.Sadece Enum.AnalyticsCustomFieldKeys tarafından sağlanan özel anahtarlar bu ayrıştırmalar için kullanılacaktır.Deney başına üç özel alan üzerindeki 8,000 benzersiz değer kombinasyonuna sınırlı.
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
Kullanıcı eylemlerini takip eden bir entegrasyon kanalından geçen bir olayı kaydeder.Funnel kırılımları sadece bir funnel oturumilk adımdaki kullanıcı ve etkinlik değerlerini dikkate alacaktır.
Parametreler
Etkinliği tetikleyen kullanıcı.
Funnel'daki adım sayısı. Bu, funnel'daki her adım için benzersiz olmalıdır. Tüm funneller 1. adımdan başlar. 1-100 adıma kadar sınırlı.
Herhangi bir adım atlanırsa, orta adımların tamamlandığı düşünülür.
Funnel'daki adımın isteğe bağlı adı. Bu alan sadece Roblox tarafından sağlanan grafiklerde görüntüleme amaçlı kullanılır.
Roblox tarafından sağlanan grafiklerde kırılımlar sağlayacak isteğe bağlı özel alanlar sözlüğü.Sadece Enum.AnalyticsCustomFieldKeys tarafından sağlanan özel anahtarlar bu ayrıştırmalar için kullanılacaktır.Deney başına üç özel alan üzerindeki 8,000 benzersiz değer kombinasyonuna sınırlı.
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ı bir seviye girişimbitirdiğinde bir olay kaydedilir. Bu olay şu anda herhangi bir Roblox tarafından sağlanan grafikte görünmez.
Parametreler
Etkinliği tetikleyen oyuncu.
Dönüşler
LogProgressionEvent
Bir kullanıcı bir seviye girişimbaşlattığında, bitirdiğinde veya başarısız olduğunda bir olay kaydedilir. Bu olay şu anda herhangi bir Roblox tarafından sağlanan grafikte görünmez.
Parametreler
Etkinliği tetikleyen oyuncu.
Dönüşler
LogProgressionFailEvent
Bir kullanıcı bir seviye girişimbaşarısızladığında bir olay kaydedilir. Bu olay şu anda herhangi bir Roblox tarafından sağlanan grafikte görünmez.
Parametreler
Etkinliği tetikleyen kullanıcı.
Dönüşler
LogProgressionStartEvent
Bir kullanıcı bir seviye girişimbaşlattığında bir olay kaydedilir. Bu olay şu anda herhangi bir Roblox tarafından sağlanan grafikte görünmez.
Parametreler
Etkinliği tetikleyen oyuncu.