Oyununuza, 2D ve 3D varlıklar, mini oyunlar, diğer oyunlar ve daha fazlası gibi özenle seçilmiş içerikleri sunmak için özel öneri sistemleri oluşturun. Öneri Servisi API'si, kullanıcı etkinliklerini kaydetmenizi, izlenimleri yakalamanızı ve hemen hemen her tür etkileşim için kişiselleştirilmiş sonuçlar sunmanızı sağlar.
Öneri sistemleri için bazı yaygın kullanım senaryoları, kullanıcılara bir oyun sonunda öneri arayüzü sunmak, kişiselleştirilmiş eylemleri gösteren bir menü örtüsü sağlamak veya kullanıcıya benzersiz bir seçim, varlıklar, konumlar veya oyunlar seti sunan diğer uygulamalardır.
Öneri sisteminizi kurmak için aşağıdaki evrensel adımları ve en iyi uygulamaları kullanın:
Bu kılavuz, oyununuzda RecommendationService'ın uygulanma sürecini kapsar. Bu içerik, Kullanıcı Arayüzü, varlık ekleme veya kullanıcıları teleport etme sürecini kapsamaz. Bu konular için ek belgelere bakın.
İçeriğinizi kaydedin
Oyununuza önerileri uygulamanın birçok yolu vardır. Bu kılavuzdaki örnek ayarlar, kullanıcılara oyun içinde çeşitli mini oyunları önermeyi amaçlamakta ve kaliteli oyun oturumlarını maksimize etmeyi önceliklendirmektedir.
Bu tür bir öneri sistemi genellikle bir carousel kullanıcı arayüzü menüsü içinde yer almakta olup, kullanıcıların kaydırmasına, seçmesine ve atlayacakları etkinlik hakkında daha fazla bilgi bulmasına olanak tanır. Bu tür bir arayüz için dikkate alınması gerekenler aşağıdaki ayarlarda yer almaktadır.
Kendi sisteminizi oluşturuyorsanız, biraz farklı ayarlar ve yapılandırmalar kullanmanız gerekebilir ama aynı temel adımları takip edin.
Öneri sisteminizin kullanıcılara sunabileceği içerikleri doldurmak için RegisterItemAsync kullanın. Bir öğe kaydederken, öğeyi kendi veritabanınızda benzersiz bir şekilde tanımlayan bir referenceId sağlayın. Bu referenceId genellikle bir öğenin adı, açıklaması veya varlık kimliği gibi meta verilerine erişmek için kullanılır.
En iyi uygulama olarak, öğeleri oluşturur oluşturmaz kaydedin, böylece öneri havuzunuz her zaman güncel kalsın.
Kullanıcı izlenimlerini kaydedin
Hizmet, öğelerinizi öğrendiğinde ve bunları önermeye başladığında, bir kullanıcının önerileri gerçekten görüntülediği zaman LogImpressionEvent ile hizmete bildirin.
Ne zaman kaydedilmeli
Bir carousel türü kullanıcı arayüzü, kullanıcılara birden fazla oynanabilir seçenek sunmak için yaygın bir arayüzdür. Kaydınızın temiz, uygulanabilir veriler sunmasını sağlamak için aşağıdaki en iyi uygulamaları kullanın:
- Tek Kaydettirme: Bir oturumda belirli bir öğe için izlenimi yalnızca bir kez kaydedin.
- Öğenin her göründüğünde kaydedilmemesi gerekir, çünkü bu kayıtlara gürültüli bilgiler ekler ve loglamanızı bozabilir.
- Tetikleyici: Öğenin menüde tamamen görünür hale geldiğinde veya kullanıcı öğeyle etkileşimde bulunduğunda, örneğin bir Ayrıntı Sayfasını açtığında kaydetmeyi tercih edebilirsiniz.
RecommendationService.LogImpressionEvent ile hangi ID'yi geçtiğinize çok dikkat edin. Hizmet, olayı, oluşturduğu belirli öneri örneği ile kesinlikle ilişkilendirmek zorundadır.
- Ham bir dize veya referans ID kullanmayın.
- RegisterItemAsync veya GenerateItemListAsync tarafından size döndürülen itemId'yi kullanın.
Süre
Süre, izlenim zamanını takip eder. Bunu, kullanıcının görüntüye veya öneriye ne kadar süre baktığı olarak düşünebilirsiniz.
Eğer video kullanmıyorsanız, Süre değerini 1 olarak ayarlayabilirsiniz. Bu, "kullanıcı bu öğeyi görüntüledi" şeklinde temiz, tutarlı veriler almanızı sağlar; genellikle statik bir kart için gereksinim duyduğunuz tek kayıt türüdür.
Kalite eylemlerini kaydedin
Bir kullanıcı bir öneri ile etkileşime karar verdiğinde, LogActionEvent kullanın. Bu örnekte, öneride "Oyna" butonuna tıklamak yüksek kaliteli bir öneri sistemi için yeterli bir sinyal değildir. Kazara bir tıklama ile gerçek bir oturum arasında ayrım yapmak önemlidir.
Gerekli eylem türü
LogActionEvent çağrısı yaptığınızda, gerçekleşen eylem türünü belirtmelisiniz. Oynama oturumlarına yol açan eylem olaylarını takip etmek için Enum.RecommendationActionType.Play kullanın. Belirli bir eylem türünün etkinleştirildiğini arka planda belirtmek için doğru enum'u kullanmak önemlidir. Oynama süresi ile ilgili öneriler için, Enum.RecommendationActionType.Play, önerileri almak için kullanılan MaximizePlays yapılandırma şablonuyla eşleşmek için katı bir gerekliliktir. Farklı bir enum kullanırsanız, model, oyunla ilgili eylemler için olayı doğru bir şekilde kaydetmeyecektir.
"Kalite oyun" stratejisi
Oyununuza bağlı olarak, "kalite oyun" tanımınız farklı olabilir. Durumunuza özgü kalite oyunu farklılıklarını ayarlamanıza yardımcı olmak için aşağıdaki adımları kullanın.
- İçsel Takip: Bir kullanıcı mini oyuna girdiğinde, oturum zamanını yerel olarak scriptinizde takip edin.
- Filtrele: Rahatlık için, örneğin 60 saniyeden fazla oynama süresi tanımlayın.
- Kaydet: Kullanıcı bu eşiği geçtiğinde yalnızca LogActionEvent'i tetikleyin.
Yalnızca RecommendationService tarafından gerçekten sunulan öğeler için eylemleri kaydedin.
- Arama, Rastgele seçimler veya Önceki Oynatmadan gelen oyunları kaydetmeyin.
- Bu öğeleri sisteme zorlamak için "Sahte İzleme ID'leri" kullanmayın.
Model gerçekçi bir oran bekler. Eğer 1 izlenim sunarsanız ama dış trafikten 10 oynama kaydederseniz, eğitim verilerini karıştırır ve metriklerinizin doğruluğunu bozar.
Önerileri alın
Önerileri almak için GenerateItemListAsync kullanın. GenerateItemListAsync, öneri listesi sorgusu için çeşitli seçenekler içeren bir sözlük kabul eder. Bu ayarların birçoğu basit olsa da, başarılı öneriler sağlamak için desteklenen ConfigName parametrelerini anlamak önemlidir.
ConfigName
Önerileri alırken birkaç yapılandırmanız mevcuttur. Kaliteli oynamalara dayalı önerileri maksimize etmek için tasarlanan mevcut örnekte MaximizePlays yapılandırmasını kullanın. Kullanım senaryosuna bağlı olarak, MaximizeTimeSpent yerine MaximizePlays yapılandırması, kullanıcı memnuniyetini ek olarak yönlendirdiği için daha avantajlıdır, sadece harcanan zaman için değil. Bu, sisteme kaliteli oyun sağlayacak öğeleri döndürmesini söyler.
Her bir desteklenen yapılandırma hakkında daha fazla bilgi için GenerateItemListAsync'e göz atın.
Analitikleri izleyin
Hizmeti entegre ettikten sonra, performansını doğrudan Creator Hub içinde izleyebilirsiniz. Öneri analitiklerinize erişmek için:
- Creator Hub içinde, oyun sayfanıza gidin.
- Kenar çubuğunda Etkileşim > Öneri Servisi kısmına gidin.
İzlemeniz gereken temel metrikler:
- Zaman içindeki Toplam Eylemler: Kullanıcılar önerilerle gerçekten etkileşime geçiyor mu?
- Toplam Benzersiz Kullanıcılar: Kaç kişi keşif özelliğini kullanıyor?
- Kullanıcı Başına Ortalama Etkilenmiş Öğeler: Kullanıcılar carousel'de kaydırıyor mu?
- Kullanıcı Başına Ortalama Harcanan Süre: Önerilerin kalitesi, onları oyunda daha uzun süre tutabiliyor mu?
- Verilen örnekte, Süre 1 olarak ayarlanmıştır, bu nedenle bu belirli metrik o kullanım durumu için çok değerli değildir. Ancak, videolar gibi diğer uygulamalarda, bu, izlenimleriniz için güçlü bir gösterge olabilir.
Bu öneri sisteminde kullanılan ayarları ve süreçleri, özellikle küçük resimler için 1 saniye süresi, yalnızca kaliteli oyunları kaydetme ve kimliklerinizi katı bir şekilde yönetme göz önünde bulundurularak maximize edilmiş kalitede oyunlar sağlamak için dikkat edin. Kayıt ve izlenim verilerinizi temiz tutarak, kullanıcılarınızın benzersiz deneyimlerine en iyi uyan içerikleri önerip ince ayar yapabilirsiniz.
Bu akış, oynama süresini maksimize eden bir öneri sistemi sürecini kapsasa da, oyununuzun ihtiyaçlarına uygun bir öneri servisini oluşturmak için benzer bir işlem sırası ve temel kavramları kullanabilirsiniz.