Buduj niestandardowe systemy rekomendacji w swojej grze, aby prezentować starannie dobieraną zawartość, taką jak zasoby 2D i 3D, minigry, inne gry i nie tylko. API Recommendation Service API pozwala na rejestrowanie aktywności użytkowników, zbieranie wrażeń i dostarczanie spersonalizowanych wyników dla praktycznie każdego typu zaangażowania.
Niektóre typowe przypadki użycia systemów rekomendacji obejmują przedstawianie użytkownikom interfejsu z sugestiami na koniec rundy, menu z nałożonymi, spersonalizowanymi akcjami lub inne implementacje, które przedstawiają unikalny zestaw wyborów, zasobów, lokalizacji lub gier dla użytkownika.
Użyj poniższych uniwersalnych kroków i najlepszych praktyk, aby skonfigurować swój system rekomendacji:
Niniejszy przewodnik dotyczy procesu implementacji RecommendationService w Twojej grze. Ta treść nie obejmuje procesu tworzenia UI, dodawania zasobów ani teleportacji użytkowników. Zobacz dodatkową dokumentację dotyczącą tych tematów.
Zarejestruj swoją zawartość
Istnieje wiele sposobów implementacji rekomendacji w Twojej grze. Przykładowe ustawienia w tym przewodniku mają na celu rekomendowanie użytkownikom różnych minigier w ramach jednej gry, priorytetowo traktując rekomendacje, które najbardziej prawdopodobnie maksymalizują jakość sesji grania.
Tego rodzaju system rekomendacji często jest wbudowany w menu UI typu carousel, umożliwiając użytkownikom przewijanie, wybieranie i znajdowanie więcej szczegółów na temat aktywności, w którą zamierzają się zaangażować. Uwagi dotyczące tego typu interfejsu zawarte są w poniższych ustawieniach.
Jeśli tworzysz własny system, może być konieczne użycie nieco innych ustawień i konfiguracji, ale postępuj zgodnie z tymi samymi podstawowymi krokami.
Aby wypełnić zawartość, którą Twój system rekomendacji może dostarczyć użytkownikom, użyj RegisterItemAsync. Rejestrując element, podaj referenceId, ciąg zdefiniowany przez dewelopera, który unikalnie identyfikuje element w Twojej własnej bazie danych. Ten referenceId jest zazwyczaj używany do wyszukiwania metadanych elementu, takich jak nazwa, opis lub ID zasobu, z Twojego magazynu danych, aby wyświetlić go w UI.
Zaleca się rejestrację elementów tak szybko, jak to możliwe, aby zapewnić, że pula rekomendacji jest zawsze świeża.
Zarejestruj wrażenia użytkowników
Gdy serwis zna już Twoje elementy i zaczyna je sugerować, powiedz serwisowi, kiedy użytkownik faktycznie widzi rekomendacje, używając LogImpressionEvent.
Kiedy rejestrować
Interfejs typu carousel to powszechny sposób wyświetlania wielu opcji do grania dla użytkownika. Użyj poniższych najlepszych praktyk, aby upewnić się, że Twoje logowanie dostarcza czystych, wykonalnych danych:
- Pojedyncze logowanie: Rejestruj wrażenie tylko raz na sesję dla konkretnego elementu.
- Nie rejestruj za każdym razem, gdy element się pojawia, ponieważ tworzy to hałaśliwe informacje, które mogą zakłócać Twoje logowanie.
- Wyzwalacz: Możesz zdecydować się na rejestrację, gdy element stanie się w menu w pełni widoczny lub gdy użytkownik interakcyjnie z elementem, na przykład otwierając stronę szczegółów.
Bądź niezwykle ostrożny, jakie ID przekazujesz do RecommendationService.LogImpressionEvent. Serwis musi ściśle powiązać zdarzenie z konkretna instancją rekomendacji, którą wygenerował.
- Nie używaj surowego ciągu lub ID referencyjnego.
Czas trwania
Czas trwania śledzi czas wrażenia. Możesz to traktować jako to, jak długo użytkownik patrzył na obraz lub rekomendację.
Jeśli nie używasz wideo, możesz ustawić wartość Czas trwania na 1. To zapewnia, że otrzymasz czyste, spójne dane, że "użytkownik widział ten element", co jest zazwyczaj jedynym logowaniem, którego potrzebujesz dla statycznej karty.
Zarejestruj akcje jakościowe
Gdy użytkownik zdecyduje się interaktować z rekomendacją, użyj LogActionEvent. W tym przykładzie samo kliknięcie "Graj" na rekomendacji nie jest wystarczającym sygnałem dla systemu rekomendacji wysokiej jakości. Ważne jest, aby odróżnić przypadkowe kliknięcie od rzeczywistej sesji.
Wymagany typ akcji
Kiedy wywołujesz LogActionEvent, musisz określić rodzaj zachodzącej akcji. Aby śledzić zdarzenia akcji, które prowadzą do sesji grania, użyj Enum.RecommendationActionType.Play. Ważne jest użycie poprawnej enumeracji, aby powiadomić backend, że aktywowano konkretnego rodzaju akcję. W przypadku rekomendacji związanych z czasem gry, Enum.RecommendationActionType.Play jest ściśle wymagane, aby pasować do wzorca konfiguracji MaximizePlays używanego w następnym kroku do pobierania rekomendacji. Jeśli użyjesz innej enumeracji, model nie zarejestruje zdarzenia poprawnie dla akcji związanych z grą.
Strategia "jakościowej gry"
W zależności od Twojej gry, możesz mieć różne definicje tego, co stanowi "jakościową grę". Użyj poniższych kroków, aby pomóc w wyspecyfikowaniu, co odróżnia jakość gry w Twoim przypadku.
- Śledzenie wewnętrzne: Kiedy użytkownik wejdzie do minigry, śledź czas jego sesji lokalnie w swoim skrypcie.
- Filtry: Zdefiniuj próg satysfakcji, na przykład granie przez więcej niż 60 sekund.
- Logowanie: Uruchamiaj LogActionEvent tylko, jeśli użytkownik przekroczy ten próg.
Rejestruj akcje tylko dla elementów, które rzeczywiście były dostarczane przez RecommendationService.
- Nie rejestruj gier, które pochodziły z wyszukiwania, losowego doboru czy wcześniejszych gier.
- Nie używaj "Dummy Tracing IDs", aby wymusić ich wprowadzenie do systemu.
Model oczekuje realistycznego współczynnika. Jeśli dostarczasz 1 wrażenie, ale logujesz 10 gier z ruchu zewnętrznego, mylisz dane treningowe i psujesz dokładność swoich metryk.
Pobierz rekomendacje
Aby pobrać rekomendacje, użyj GenerateItemListAsync. GenerateItemListAsync akceptuje słownik, który zawiera różne opcje dla zapytania listy rekomendacji. Choć wiele z tych ustawień jest proste, ważne jest, aby zrozumieć wspierane parametry ConfigName, aby zapewnić sukces rekomendacji.
ConfigName
Masz kilka konfiguracji do wyboru podczas pobierania rekomendacji. W aktualnym przykładzie zaprojektowanym w celu maksymalizacji rekomendacji w oparciu o liczbę jakościowych gier, użyj konfiguracji MaximizePlays. W zależności od przypadku użycia, konfiguracja MaximizePlays jest lepsza niż MaximizeTimeSpent, ponieważ dodatkowo indeksuje na satysfakcji użytkownika, a nie tylko na czasie spędzonym. To mówi systemowi, aby zwracał elementy, które najprawdopodobniej przyniosą wysoką jakość gry.
Aby uzyskać więcej informacji na temat każdej obsługiwanej konfiguracji, zapoznaj się z GenerateItemListAsync.
Monitoruj analitykę
Gdy zintegrowałeś serwis, możesz monitorować jego wydajność bezpośrednio w Creator Hub. Aby uzyskać dostęp do swojej analityki rekomendacji:
- W Creator Hub przejdź do strony swojej gry.
- W pasku bocznym przejdź do Zaangażowanie > Usługa rekomendacji.
Kluczowe metryki do obserwacji:
- Łączna liczba działań w czasie: Czy użytkownicy rzeczywiście angażują się w rekomendacje?
- Łączna liczba unikalnych użytkowników: Ile osób korzysta z funkcji odkrywania?
- Średnia liczba wyświetleń na użytkownika: Czy użytkownicy przewijają przez carousel?
- Średni czas spędzony na użytkownika: Czy jakość rekomendacji utrzymuje ich w grze dłużej?
- W podanym przykładzie Czas trwania ustawiono na 1, więc ta konkretna metryka nie jest szczególnie wartościowa w tym przypadku. Jednak w innych zastosowaniach, takich jak filmy, może to być silny wskaźnik dla Twoich wrażeń.
Pamiętaj o ustawieniach i procesach używanych w tym systemie rekomendacji, które mają na celu maksymalizację jakości gier, zwłaszcza przy użyciu 1 sekundy czasu trwania dla miniatur, logowaniu tylko jakościowych gier i ściśle zarządzaniu swoimi ID. Utrzymując swoje dane logowania i wrażenia w czystości, możesz rekomendować i dostosowywać zawartość, która najlepiej odpowiada unikalnym doświadczeniom Twoich użytkowników.
Chociaż ten przepływ obejmuje proces dla systemu rekomendacji, który maksymalizuje czas grania, możesz użyć podobnej kolejności działań i podstawowych koncepcji do zbudowania usługi rekomendacji, która spełni potrzeby Twojej gry.