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 denemesini bitirdiğ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 başarısız olduğunda bir olay kaydedilir.
- LogProgressionFailEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Kullanıcı bir seviye denemesini başarısızladığında bir olayı kaydeder.
- LogProgressionStartEvent(player : Player,progressionPathName : string,level : number,levelName : string,customFields : Dictionary):()
Kullanıcı bir seviye denemesi baş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 türünü kullanmakta ö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 dize olduğ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
Aşağıdaki örnek, 1000 paralık bir paketin Robux satın alımını takip eder ve IAP (uyygulama içi satın alma) işlem türünü kullanır.Önceki örnek ile karşılaştırıldığında zorunlu olmayan bir parametre olarak verilen öğe adını not edin.
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogEconomyEvent(
player,
Enum.AnalyticsEconomyFlowType.Source,
"Coins",
1000, -- Pakette kaç tane para var
1020, -- işlemden sonra denge
Enum.AnalyticsEconomyTransactionType.IAP.Name,
"1000CoinBundle" -- Para paketinin benzersiz tanımlayıcısı
)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 sessizinden ilk 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
Aşağıdaki örnek, bir "zırh" dükkanından bir öğe satın alma sürecine başlayan her kullanıcı için bazı temel olayları izler.Mağazayı açan aynı kullanıcının farklı oturumlarını ayırt etmek için kullanılan funnelSessionId'yi not edin.
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
funnelSessionId = HttpService:GenerateGUID()
-- Kullanıcı mağazayı açtığında günlük açılması
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Adımları bir araya getirmek için kullanılan tünel adı
funnelSessionId, -- Bu benzersiz ödeme seansı için funnel oturum kimliği
1, -- Adım numarası
"Opened Store" -- Adım adı
)
-- Kullanıcı bir öğeyi görüntülediğinde günlük kaydedin
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Adımları bir araya getirmek için kullanılan tünel adı
funnelSessionId, -- Bu benzersiz ödeme seansı için funnel oturum kimliği
2, -- Adım numarası
"Viewed Item" -- Adım adı
)
-- Kullanıcı görüşleri sepete eklendiğinde kaydet
AnalyticsService:LogFunnelStepEvent(
player,
"ArmoryCheckout", -- Adımları bir araya getirmek için kullanılan tünel adı
funnelSessionId, -- Bu benzersiz ödeme seansı için funnel oturum kimliği
3, -- Adım numarası
"Added to Cart" -- Adım adı
)LogOnboardingFunnelStepEvent
Kullanıcı eylemlerini takip eden bir entegrasyon kanalından geçen bir olayı kaydeder.Funnel kırılımları sadece bir funnel sessizinden ilk 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
Aşağıdaki örnek, bir onboarding funnel'ın iki adımını nasıl kaydedeceğinizi gösterir.Bir onboarding funnel genellikle oyuncuları oyunun çekirdek döngüsüne tanıtır.
local AnalyticsService = game:GetService("AnalyticsService")
-- FTUE'nun ilk adımını kaydet
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
1, -- Adım numarası
"Joined Game" -- Adım adı
)
-- FTUE'nin ikinci adımını kaydet
AnalyticsService:LogOnboardingFunnelStepEvent(
player,
2, -- Adım numarası
"Choose Class" -- Adım adı
)LogProgressionCompleteEvent
Bir kullanıcı bir seviye denemesini bitirdiğ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 denemesini baş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 denemesini baş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 denemesi baş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.