Erstellen Sie benutzerdefinierte Empfehlungssysteme in Ihrem Spiel, um kuratierte Inhalte wie 2D- und 3D-Assets, Minispiele, andere Spiele und mehr bereitzustellen. Die Recommendation Service API ermöglicht es Ihnen, Benutzeraktivitäten zu protokollieren, Impressionen zu erfassen und personalisierte Ergebnisse für nahezu jede Art von Engagement zu liefern.
Einige häufige Anwendungsfälle für Empfehlungssysteme umfassen die Darstellung eines Vorschlagsinterfaces für das Ende der Runde, ein Menüoverlay, das personalisierte Aktionen präsentiert, oder andere Implementierungen, die dem Benutzer ein einzigartiges Set von Optionen, Assets, Standorten oder Spielen anbieten.
Verwenden Sie die folgenden universellen Schritte und Best Practices, um Ihr Empfehlungssystem einzurichten:
Diese Anleitung behandelt den Prozess der Implementierung von RecommendationService in Ihrem Spiel. Dieser Inhalt deckt den Prozess der Erstellung der UI, das Hinzufügen von Assets oder das Teleportieren von Benutzern nicht ab. Weitere Dokumentation zu diesen Themen finden Sie in zusätzlichen Unterlagen.
Registrieren Sie Ihre Inhalte
Es gibt viele Möglichkeiten, wie Sie Empfehlungen in Ihrem Spiel implementieren können. Die Beispielkonfigurationen in dieser Anleitung sind darauf ausgelegt, Benutzern verschiedene Minispiele innerhalb eines Spiels zu empfehlen, wobei Empfehlungen priorisiert werden, die am wahrscheinlichsten hochwertige Spielsitzungen maximieren.
Diese Art von Empfehlungssystem wird häufig in einem Karussell-UI-Menü integriert, das es Benutzern ermöglicht, zu scrollen, auszuwählen und weitere Details zu der Aktivität zu finden, in die sie springen möchten. Überlegungen zu dieser Art von Benutzeroberfläche sind in den folgenden Einstellungen enthalten.
Wenn Sie Ihr eigenes System erstellen, müssen Sie möglicherweise leicht unterschiedliche Einstellungen und Konfigurationen verwenden, folgen jedoch denselben grundlegenden Schritten.
Um Inhalte zu befüllen, die Ihr Empfehlungssystem den Benutzern bereitstellen kann, verwenden Sie RegisterItemAsync. Geben Sie beim Registrieren eines Elements eine referenceId an, eine vom Entwickler definierte Zeichenfolge, die das Element in Ihrer eigenen Datenbank eindeutig identifiziert. Diese referenceId wird typischerweise verwendet, um die Metadaten eines Elements wie Name, Beschreibung oder Asset-ID aus Ihrem Datenspeicher abzurufen, um sie in der Benutzeroberfläche anzuzeigen.
Als Best Practice sollten Sie Elemente registrieren, sobald sie erstellt werden, um sicherzustellen, dass der Empfehlungs-Pool immer frisch ist.
Protokollieren Sie Nutzerimpressionen
Sobald der Dienst über Ihre Elemente informiert ist und anfängt, sie vorzuschlagen, teilen Sie dem Dienst mit, wenn ein Benutzer tatsächlich die Empfehlungen sieht, indem Sie LogImpressionEvent verwenden.
Wann zu protokollieren
Eine Karussell-Benutzeroberfläche ist eine gängige Schnittstelle zur Anzeige mehrerer spielbarer Optionen für einen Benutzer. Verwenden Sie die folgenden Best Practices, um sicherzustellen, dass Ihr Protokollieren saubere umsetzbare Daten liefert:
- Einzelnes Protokoll: Protokollieren Sie die Impression nur einmal pro Session für ein bestimmtes Element.
- Protokollieren Sie nicht jedes Mal, wenn das Element erscheint, da dies störende Informationen erzeugt, die Ihr Protokollieren beeinträchtigen können.
- Auslöser: Sie können sich entscheiden, zu protokollieren, wenn das Element im Menü vollständig sichtbar wird oder wenn der Benutzer mit dem Element interagiert, z. B. indem er eine Detailseite öffnet.
Seien Sie äußerst vorsichtig, welche ID Sie an RecommendationService.LogImpressionEvent übergeben. Der Dienst muss das Ereignis strikt mit der spezifischen Empfehlungsinstanz verknüpfen, die er generiert hat.
- Verwenden Sie nicht eine rohe Zeichenfolge oder Referenz-ID.
- Verwenden Sie die itemId, die Ihnen von RegisterItemAsync oder GenerateItemListAsync zurückgegeben wurde.
Dauer
Die Dauer verfolgt die Zeit der Impression. Sie können dies im Sinne von verstehen, wie lange ein Benutzer auf das Bild oder die Empfehlung geschaut hat.
Wenn Sie kein Video verwenden, können Sie den Dauer-Wert auf 1 setzen. Dies stellt sicher, dass Sie saubere, konsistente Daten erhalten, dass der "Benutzer dieses Element angesehen hat", was in der Regel das einzige Protokoll ist, das Sie für eine statische Karte benötigen.
Protokollieren Sie Qualitätsaktionen
Wenn ein Benutzer beschließt, mit einer Empfehlung zu interagieren, verwenden Sie LogActionEvent. In diesem Beispiel reicht es nicht aus, einfach auf "Spielen" auf der Empfehlung zu klicken, um ein qualitativ hochwertiges Empfehlungssystem zu signalisierten. Es ist wichtig, zwischen einem versehentlichen Klick und einer echten Sitzung zu unterscheiden.
Erforderlicher Aktionstyp
Wenn Sie LogActionEvent aufrufen, müssen Sie den Typ der Aktion angeben, die stattfindet. Um Aktionsereignisse zu verfolgen, die zu Spielsitzungen führen, verwenden Sie Enum.RecommendationActionType.Play. Es ist wichtig, das richtige Enum zu verwenden, um dem Backend mitzuteilen, dass ein bestimmter Aktionstyp aktiviert wurde. Für spielzeitbezogene Empfehlungen ist Enum.RecommendationActionType.Play strikt erforderlich, um der Konfiguration MaximizePlays zu entsprechen, die im nächsten Schritt verwendet wird, um Empfehlungen abzurufen. Wenn Sie ein anderes Enum verwenden, wird das Ereignis für spielbezogene Aktionen nicht korrekt registriert.
Die "Qualitäts-Spiel"-Strategie
Je nach Ihrem Spiel haben Sie möglicherweise unterschiedliche Definitionen dafür, was "Qualitätsspiel" ausmacht. Verwenden Sie die folgenden Schritte, um zu helfen, was qualitativ hochwertiges Spielen in Ihrer Situation unterscheidet, zu verfeinern.
- Intern verfolgen: Wenn ein Benutzer das Minispiel betritt, verfolgen Sie seine Sitzungszeit lokal in Ihrem Skript.
- Filtern: Definieren Sie einen Schwellenwert für die Zufriedenheit, z. B. das Spielen von mehr als 60 Sekunden.
- Protokollieren: Feuern Sie LogActionEvent nur ab, wenn der Benutzer diesen Schwellenwert überschreitet.
Protokollieren Sie nur Aktionen für Elemente, die tatsächlich vom RecommendationService bereitgestellt wurden.
- Protokollieren Sie keine Spiele, die aus Suche, Zufallswähler oder vergangenen Spielen kamen.
- Verwenden Sie keine "Dummy-Tracing-IDs", um diese ins System zu erzwingen.
Das Modell erwartet ein realistisches Verhältnis. Wenn Sie 1 Impression bereitstellen, aber 10 Spiele von externem Verkehr protokollieren, verwirren Sie die Trainingsdaten und ruinieren die Genauigkeit Ihrer Metriken.
Empfehlungen abrufen
Um Empfehlungen abzurufen, verwenden Sie GenerateItemListAsync. GenerateItemListAsync akzeptiert ein Wörterbuch, das verschiedene Optionen für die Abfrage der Empfehlungslist enthält. Während viele dieser Einstellungen einfach sind, ist es wichtig, die unterstützten ConfigName-Parameter zu verstehen, um sicherzustellen, dass Sie erfolgreiche Empfehlungen bereitstellen.
ConfigName
Sie haben mehrere Konfigurationen zur Verfügung, wenn Sie Empfehlungen abrufen. In dem aktuellen Beispiel, das auf die Maximierung der Empfehlungen basierend auf der Anzahl der qualitativ hochwertigen Spiele abzielt, verwenden Sie die Konfiguration MaximizePlays. Abhängig vom Anwendungsfall ist die Konfiguration MaximizePlays besser als MaximizeTimeSpent, da sie zusätzlich auf Benutzersatisfaction indiziert, anstatt nur auf der verbrachten Zeit. Dies sagt dem System, dass es Elemente zurückgeben soll, die wahrscheinlich zu qualitativ hochwertigen Spielen führen.
Für weitere Informationen zu jeder unterstützten Konfiguration lesen Sie GenerateItemListAsync.
Analyse überwachen
Sobald Sie den Dienst integriert haben, können Sie seine Leistung direkt im Creator Hub überwachen. Um auf Ihre Empfehlungsanalysen zuzugreifen:
- Navigieren Sie im Creator Hub zu Ihrer Spieleseite.
- Navigieren Sie in der Seitenleiste zu Engagement > Empfehlungsdienst.
Wichtige Metriken, die Sie beobachten sollten:
- Gesamtaktionen über die Zeit: Engagieren sich Benutzer tatsächlich mit den Empfehlungen?
- Gesamtanzahl einzigartiger Benutzer: Wie viele Personen nutzen die Entdeckungsfunktion?
- Durchschnittliche Elemente, die pro Benutzer beeindruckt wurden: Scrollen die Benutzer durch das Karussell?
- Durchschnittliche Zeit, die pro Benutzer verbracht wurde: Hält die Qualität der Empfehlungen sie länger im Spiel?
- In dem bereitgestellten Beispiel ist die Dauer auf 1 gesetzt, sodass diese spezielle Metrik in diesem Anwendungsfall nicht besonders wertvoll ist. In anderen Anwendungen, wie z. B. Videos, kann dies jedoch ein starker Indikator für Ihre Impressionen sein.
Behalten Sie die Einstellungen und Prozesse im Hinterkopf, die in diesem Empfehlungssystem verwendet werden, um qualitativ hochwertige Spiele zu maximieren, insbesondere die Verwendung von 1 Sekunde Dauer für Thumbnails, das Protokollieren nur hochwertiger Spiele und die strikte Verwaltung Ihrer IDs. Indem Sie Ihr Protokoll- und Impressionen-Daten sauber halten, können Sie Inhalte empfehlen und verfeinern, die am besten zu den einzigartigen Erfahrungen Ihrer Benutzer passen.
Während dieser Ablauf den Prozess für ein Empfehlungssystem behandelt, das die Spielzeit maximiert, können Sie eine ähnliche Reihenfolge von Operationen und grundlegenden Konzepten verwenden, um einen Empfehlungsdienst zu erstellen, der zu den Bedürfnissen Ihres Spiels passt.