Crie sistemas de recomendação personalizados em seu jogo para apresentar conteúdo curado, como ativos 2D e 3D, minigames, outros jogos e muito mais. A API do Serviço de Recomendação permite que você registre a atividade do usuário, capture impressões e ofereça resultados personalizados para praticamente qualquer tipo de engajamento.
Alguns casos de uso comuns para sistemas de recomendação incluem apresentar aos usuários uma interface de sugestão ao final da rodada, uma sobreposição de menu apresentando ações personalizadas ou outras implementações que apresentam um conjunto único de escolhas, ativos, locais ou jogos ao usuário.
Use os seguintes passos universais e melhores práticas para configurar seu sistema de recomendação:
Este guia cobre o processo de implementação do RecommendationService em seu jogo. Este conteúdo não cobre o processo de criação da UI, adição de ativos ou teleportação de usuários. Veja a documentação adicional para esses tópicos.
Registre seu conteúdo
Existem várias maneiras de implementar recomendações em seu jogo. As configurações de exemplo neste guia têm como objetivo recomendar aos usuários vários minigames dentro de um jogo, priorizando recomendações mais propensas a maximizar sessões de jogo de qualidade.
Esse tipo de sistema de recomendação é frequentemente incorporado em um menu de UI em carrossel, permitindo que os usuários deslizem, selecionem e encontrem mais detalhes sobre a atividade na qual estão prestes a entrar. As considerações para esse tipo de interface estão incluídas nas configurações abaixo.
Se você criar seu próprio sistema, pode precisar usar configurações e configurações ligeiramente diferentes, mas siga os mesmos passos básicos.
Para preencher o conteúdo que seu sistema de recomendação pode oferecer aos usuários, use RegisterItemAsync. Ao registrar um item, forneça um referenceId, uma string definida pelo desenvolvedor que identifica exclusivamente o item em seu próprio banco de dados. Este referenceId é tipicamente utilizado para buscar os metadados de um item, como nome, descrição ou ID do ativo, de seu armazenamento de dados para exibir na UI.
Como melhor prática, registre os itens assim que forem criados para garantir que o pool de recomendações esteja sempre atualizado.
Registre impressões dos usuários
Uma vez que o serviço saiba sobre seus itens e comece a sugeri-los, informe ao serviço quando um usuário realmente visualizar as recomendações com LogImpressionEvent.
Quando registrar
Uma UI em estilo carrossel é uma interface comum para exibir várias opções jogáveis para um usuário. Use as seguintes melhores práticas para garantir que seu registro forneça dados acionáveis limpos:
- Registro Único: Registre a impressão apenas uma vez por sessão para um item específico.
- Não registre toda vez que o item aparecer, pois isso cria informações imprecisas que podem interferir no seu registro.
- Gatilho: Você pode optar por registrar quando o item se torna totalmente visível no menu ou quando o usuário interage com o item, como ao abrir uma Página de Detalhes.
Tenha extrema cautela sobre qual ID você passa para RecommendationService.LogImpressionEvent. O serviço precisa vincular o evento estritamente à instância específica da recomendação que ele gerou.
- Não use uma string bruta ou ID de referência.
Duração
A duração rastreia o tempo da impressão. Você pode pensar nisso como quanto tempo um usuário olhou para a imagem ou recomendação.
Se você não estiver usando vídeo, pode definir o valor de Duração como 1. Isso garante que você tenha dados consistentes e limpos de que "o usuário viu este item", que é tipicamente o único registro necessário para um cartão estático.
Registre ações de qualidade
Quando um usuário decide interagir com uma recomendação, use LogActionEvent. Neste exemplo, simplesmente clicar em "Jogar" na recomendação não é um indicador suficiente para um sistema de recomendação de alta qualidade. É importante distinguir entre um clique acidental e uma sessão genuína.
Tipo de ação obrigatória
Ao chamar LogActionEvent, você deve especificar o tipo de ação que está ocorrendo. Para rastrear eventos de ação que resultam em sessões de jogo, use Enum.RecommendationActionType.Play. É importante usar o enum correto para informar ao backend que um tipo específico de ação foi ativado. Para recomendações relacionadas ao tempo de jogo, Enum.RecommendationActionType.Play é estritamente necessário para corresponder ao modelo de configuração MaximizePlays usado na próxima etapa para buscar recomendações. Se você usar um enum diferente, o modelo não registrará o evento corretamente para ações relacionadas a jogos.
A estratégia de "jogo de qualidade"
Dependendo do seu jogo, você pode ter diferentes definições sobre o que constitui "jogo de qualidade". Use os seguintes passos para ajudar a ajustar o que difere o jogo de qualidade em sua situação.
- Rastreie Internamente: Quando um usuário entra no minigame, rastreie o tempo de sessão localmente em seu script.
- Filtre: Defina um limite para a satisfação, como jogar por mais de 60 segundos.
- Registre: Apenas acione LogActionEvent se o usuário ultrapassar esse limite.
Registre ações apenas para itens que foram realmente servidos pelo RecommendationService.
- Não registre jogadas que vieram de Busca, Picks Aleatórios ou Jogadas Passadas.
- Não use "IDs de Rastreamento Falsos" para forçar isso no sistema.
O modelo espera uma proporção realista. Se você servir 1 impressão, mas registrar 10 jogadas de tráfego externo, você confunde os dados de treinamento e prejudica a precisão de suas métricas.
Busque recomendações
Para buscar recomendações, use GenerateItemListAsync. GenerateItemListAsync aceita um dicionário que inclui várias opções para a consulta da lista de recomendações. Embora muitas dessas configurações sejam diretas, é importante entender os parâmetros suportados pelo ConfigName para garantir que você forneça recomendações bem-sucedidas.
ConfigName
Você tem várias configurações disponíveis ao buscar recomendações. No exemplo atual, projetado para maximizar recomendações com base no número de jogadas de qualidade, use a configuração MaximizePlays. Dependendo do caso de uso, a configuração MaximizePlays é melhor do que MaximizeTimeSpent, pois também indexa a satisfação do usuário, em vez de apenas o tempo gasto. Isso informa ao sistema para retornar itens que provavelmente gerarão jogadas de qualidade.
Para mais informações sobre cada configuração suportada, consulte GenerateItemListAsync.
Monitore análises
Uma vez que você tenha integrado o serviço, pode monitorar seu desempenho diretamente no Creator Hub. Para acessar suas análises de recomendação:
- No Creator Hub, navegue até a página do seu jogo.
- Na barra lateral, navegue até Engajamento > Serviço de Recomendação.
Principais métricas a serem observadas:
- Ações totais ao longo do tempo: Os usuários realmente estão interagindo com as recomendações?
- Usuários únicos totais: Quantas pessoas estão usando o recurso de descoberta?
- Itens médios impressionados por usuário: Os usuários estão rolando pelo carrossel?
- Tempo médio gasto por usuário: A qualidade das recomendações está mantendo-os no jogo por mais tempo?
- No exemplo fornecido, a Duração está definida como 1, então essa métrica específica não é particularmente valiosa nesse caso. No entanto, em outras aplicações, como vídeos, isso pode ser um forte indicador para suas impressões.
Tenha em mente as configurações e processos usados neste sistema de recomendação destinado a maximizar jogadas de qualidade, particularmente usando 1 segundo de duração para miniaturas, registrando apenas jogadas de qualidade e gerenciando rigorosamente seus IDs. Ao manter seus dados de registro e impressão limpos, você pode recomendar e ajustar o conteúdo que melhor se adequa às experiências únicas de seus usuários.
Embora este fluxo cubra o processo para um sistema de recomendação que maximiza o tempo de jogo, você pode usar uma ordem de operações e conceitos fundamentais semelhantes para desenvolver um serviço de recomendação que atenda às necessidades do seu jogo.