Costruisci sistemi di raccomandazione personalizzati nel tuo gioco per mettere in evidenza contenuti curati come asset 2D e 3D, minigiochi, altri giochi e altro ancora. L'API Class.RecommendationService|Recommendation Service ti consente di registrare l'attività degli utenti, raccogliere impressioni e fornire risultati personalizzati per virtualmente qualsiasi tipo di coinvolgimento.
Alcuni casi d'uso comuni per i sistemi di raccomandazione includono la presentazione agli utenti di un'interfaccia di suggerimenti alla fine del round, un menu sovrapposto che presenta azioni personalizzate o altre implementazioni che forniscono un insieme unico di scelte, asset, località o giochi all'utente.
Utilizza i seguenti passaggi universali e le migliori pratiche per impostare il tuo sistema di raccomandazione:
Questa guida copre il processo di implementazione di RecommendationService nel tuo gioco. Questo contenuto non tratta il processo di creazione dell'UI, aggiunta di asset o teletrasporto degli utenti. Consulta la documentazione aggiuntiva per quegli argomenti.
Registrare i tuoi contenuti
Ci sono molti modi in cui puoi implementare raccomandazioni nel tuo gioco. Le impostazioni di esempio in questa guida sono destinate a raccomandare agli utenti vari minigiochi all'interno di un gioco, dando priorità alle raccomandazioni più inclini a massimizzare le sessioni di gioco di qualità.
Questo tipo di sistema di raccomandazione è spesso incorporato in un menu UI a carosello, che consente agli utenti di scorrere, selezionare e trovare ulteriori dettagli sull'attività in cui stanno per tuffarsi. Le considerazioni per questo tipo di interfaccia sono incluse nelle impostazioni qui sotto.
Se stai creando il tuo sistema, potresti dover utilizzare impostazioni e configurazioni leggermente diverse, ma segui gli stessi passaggi di base.
Per popolare i contenuti che il tuo sistema di raccomandazione può servire agli utenti, utilizza RegisterItemAsync. Quando registri un elemento, fornisci un referenceId, una stringa definita dallo sviluppatore che identifica univocamente l'elemento nel tuo database. Questo referenceId è tipicamente usato per cercare i dati metadata di un elemento, come il nome, la descrizione o l'ID asset, dal tuo data store da visualizzare nell'UI.
Come buona pratica, registra gli elementi non appena vengono creati per garantire che il pool di raccomandazione sia sempre fresco.
Registrare le impressioni degli utenti
Una volta che il servizio conosce i tuoi elementi e inizia a suggerirli, informa il servizio quando un utente visualizza effettivamente le raccomandazioni con LogImpressionEvent.
Quando registrare
Un'interfaccia di tipo carosello è un'interfaccia comune per visualizzare molteplici opzioni giocabili a un utente. Utilizza le seguenti migliori pratiche per garantire che la tua registrazione fornisca dati azionabili puliti:
- Registrazione Singola: Registra l'impressione solo una volta per sessione per un elemento specifico.
- Non registrare ogni volta che l'elemento appare, poiché questo crea informazioni confuse che possono interferire con la tua registrazione.
- Attivazione: Puoi scegliere di registrare quando l'elemento diventa completamente visibile nel menu o quando l'utente interagisce con l'elemento, ad esempio aprendo una Pagina di Dettaglio.
Fai molta attenzione a quale ID passi a RecommendationService.LogImpressionEvent. Il servizio deve collegare l'evento strettamente all'istanza di raccomandazione specifica che ha generato.
- Non utilizzare una stringa grezza o un ID di riferimento.
Durata
La durata tiene traccia del tempo dell'impressione. Puoi pensare a questo come a quanto tempo un utente ha fissato l'immagine o la raccomandazione.
Se non stai usando video, puoi impostare il valore Durata a 1. Questo garantisce che tu ottenga dati puliti e coerenti che indicano che "l'utente ha visualizzato questo elemento", che è tipicamente l'unica registrazione necessaria per una scheda statica.
Registrare azioni di qualità
Quando un utente decide di interagire con una raccomandazione, utilizza LogActionEvent. In questo esempio, semplicemente cliccare su "Gioca" sulla raccomandazione non è un segnale sufficiente per un sistema di raccomandazione di alta qualità. È importante distinguere un clic accidentale da una sessione genuina.
Tipo di azione richiesta
Quando chiami LogActionEvent, devi specificare il tipo di azione che si verifica. Per monitorare gli eventi di azione che portano a sessioni di gioco, utilizza Enum.RecommendationActionType.Play. È importante utilizzare l'enum corretto per comunicare al backend che un tipo specifico di azione è attivato. Per le raccomandazioni legate al tempo di gioco, Enum.RecommendationActionType.Play è strettamente necessario per corrispondere al modello di configurazione MaximizePlays utilizzato nel passaggio successivo per recuperare raccomandazioni. Se utilizzi un enum diverso, il modello non registrerà correttamente l'evento per azioni legate al gioco.
La strategia del "gioco di qualità"
A seconda del tuo gioco, potresti avere definizioni differenti su cosa costituisce un "gioco di qualità". Utilizza i seguenti passaggi per affinare ciò che distingue il gioco di qualità nella tua situazione.
- Traccia Internamente: Quando un utente entra nel minigioco, monitora il tempo della sua sessione localmente nel tuo script.
- Filtro: Definisci una soglia di soddisfazione, come giocare per più di 60 secondi.
- Registrare: Esegui LogActionEvent solo se l'utente supera questa soglia.
Registra solo azioni per elementi che sono stati effettivamente serviti da RecommendationService.
- Non registrare giocate provenienti da Ricerca, Scelte Casuali o Giocate Passate.
- Non utilizzare "ID di Tracciamento Dummy" per forzarli nel sistema.
Il modello si aspetta un rapporto realistico. Se servi 1 impressione ma registri 10 giocate da traffico esterno, confondi i dati di addestramento e rovini l'accuratezza delle tue metriche.
Recuperare raccomandazioni
Per recuperare raccomandazioni, utilizza GenerateItemListAsync. GenerateItemListAsync accetta un dizionario che include varie opzioni per la query dell'elenco delle raccomandazioni. Anche se molte di queste impostazioni sono dirette, è importante comprendere i parametri ConfigName supportati per garantire che tu fornisca raccomandazioni di successo.
ConfigName
Hai diverse configurazioni disponibili quando recuperi raccomandazioni. Nell'esempio attuale progettato per massimizzare le raccomandazioni basate sul numero di giocate di qualità, utilizza la configurazione MaximizePlays. A seconda del caso d'uso, la configurazione MaximizePlays è migliore rispetto a MaximizeTimeSpent, poiché indicizza anche la soddisfazione dell'utente, piuttosto che solo il tempo trascorso. Questo indica al sistema di restituire elementi che probabilmente porteranno a giocate di qualità.
Per ulteriori informazioni su ciascuna configurazione supportata, consulta GenerateItemListAsync.
Monitorare le analisi
Una volta integrato il servizio, puoi monitorarne le prestazioni direttamente nel Creator Hub. Per accedere alle tue analisi delle raccomandazioni:
- Nel Creator Hub, vai alla pagina del tuo gioco.
- Nella barra laterale, vai a Coinvolgimento > Servizio di Raccomandazione.
Metriche chiave da monitorare:
- Azioni Totali nel Tempo: Gli utenti stanno effettivamente interagendo con le raccomandazioni?
- Utenti Unici Totali: Quante persone stanno utilizzando la funzione di scoperta?
- Media di Elementi Impressionati per Utente: Gli utenti stanno scorrendo attraverso il carosello?
- Tempo Medio Trascorso per Utente: La qualità delle raccomandazioni li mantiene nel gioco più a lungo?
- Nell'esempio fornito, Durata è impostato su 1, quindi questa metrica specifica non è particolarmente preziosa in quel caso d'uso. Tuttavia, in altre applicazioni, come i video, questo può essere un forte indicatore per le tue impressioni.
Tieni presente le impostazioni e i processi utilizzati in questo sistema di raccomandazione destinato a massimizzare le giocate di qualità, in particolare utilizzando una durata di 1 secondo per le miniature, registrando solo giocate di qualità e gestendo rigorosamente i tuoi ID. Mantenendo puliti i tuoi dati di registrazione e di impressione, puoi raccomandare e affinare i contenuti che meglio si adattano alle esperienze uniche dei tuoi utenti.
Sebbene questo flusso copra il processo di un sistema di raccomandazione che massimizza il tempo di gioco, puoi utilizzare un ordine di operazioni simile e concetti fondamentali per costruire un servizio di raccomandazione che si adatti alle esigenze del tuo gioco.