Entidades de dados de enriquecimento de recomendações
Este artigo oferece orientações sobre como configurar entidades de dados de enriquecimento de recomendações no contrato de dados do Recomendações Inteligentes.
Revisão de entidades de dados
Uma entidade de dados é um conjunto de um ou mais arquivos de texto de dados, cada um com uma lista de colunas (também chamadas de atributos) e linhas contendo os valores de dados reais.
O Recomendações Inteligentes define grupos lógicos de entidades de dados, cada um com sua própria finalidade.
Observação
As entidades de dados são opcionais (a menos que explicitamente indicado de outra forma), o que significa que seus dados podem estar vazios ou totalmente ausentes.
Ir para a lista completa das entidades de dados
Introdução
O Recomendações Inteligentes oferece suporte ao enriquecimento manual de recomendações geradas, que permite adicionar ou remover manualmente itens específicos ou variantes de itens de qualquer lista de recomendações.
As ações de enriquecimento com suporte são:
Incluir: adiciona o item ou variante de item especificado no topo da lista especificada. Esses itens adicionados manualmente são classificados pelo seu atributo Classificação.
Excluir: remove o item ou variante de item especificado da lista especificada, qualquer que seja a classificação do item na referida lista.
As disponibilidades de itens são sempre respeitadas. Qualquer item não considerado disponível no momento em que a API de recomendação for chamada não será retornado como parte da resposta.
As seguintes entidades de dados fazem parte das entidades de dados de enriquecimento de recomendações:
Ir para a lista completa das entidades de dados
Enriquecimento de recomendações para um item específico
Nome da entidade de dados:Reco_SeededRecommendationsEnrichment
Descrição: enriquecimento de resultados de recomendação para um item específico usando ItemId conhecido como SeedItemId. Aplica-se apenas a listas como "As pessoas também gostam", que são codificadas para um item específico.
Atributos:
| Nome | Tipo de dados | Obrigatório | Valor padrão | Comportamento de valor inválido | Comentários |
|---|---|---|---|---|---|
| RecoListName | Cadeia de caracteres | Sim | Cortar valor | Vá para Tabela ListNames para os nomes de lista permitidos. | |
| AlgoType | Cadeia de caracteres | Não | Cortar valor | Nem todos os nomes de listas exigem que esse valor seja definido. Confira a Tabela AlgoTypes para ver os tipos de algoritmo compatíveis para cada nome de lista. | |
| SeedItemId | String(16) | Sim | Soltar entrada | A ItemId para a qual a lista está recomendando. Consulte Entidades de dados necessárias por cenário de recomendações para obter a ID do item. | |
| SeedItemVariantId | String(16) | Não | Soltar entrada | A ItemVariantId para a qual a lista está recomendando. Consulte Entidades de dados necessárias por cenário de recomendações para obter a ID da variante do item. | |
| ItemId | String(16) | Sim | Soltar entrada | Consulte Entidades de dados necessárias por cenário de recomendações para obter a ID do item. | |
| ItemVariantId | String(16) | Não | Soltar entrada | Consulte Entidades de dados necessárias por cenário de recomendações para obter a ID da variante do item. | |
| EnrichmentAction | Cadeia de caracteres | Sim | Soltar entrada | Por enquanto, só há suporte para Incluir ou Excluir. | |
| Classificar | Int | Não | Soltar entrada | Para a ação de enriquecimento Excluir, este valor será ignorado. |
Diretrizes:
Itens marcados incluir podem ser adicionados apenas ao topo de uma lista de recomendações gerada.
Excluir um item de uma lista na qual o item não aparece não fará nada.
A exclusão sempre vence. Se você incluir e excluir o mesmo item da mesma lista, ele será excluído da resposta final da API.
O atributo Classificação especifica apenas a ordem entre os itens ou variantes de itens adicionados. De qualquer forma, eles sempre serão adicionados ao topo da lista. Se houver valores de classificação duplicados para vários itens, eles serão adicionados em alguma ordem aleatória entre eles.
Enriquecimentos com um valor AlgoType incompatível são ignorados.
Dados de exemplo:
Os cabeçalhos aparecem apenas por conveniência e não devem fazer parte dos dados reais.
| RecoListName | AlgoType | SeedItemId | SeedItemVariantId | ItemId | ItemVariantId | EnrichmentAction | Classificar |
|---|---|---|---|---|---|---|---|
| semelhantes | MF | Item1 | Item2 | Incluem | 1 | ||
| semelhantes | MF | Item1 | Item3 | Item3Var1 | Incluem | 2 | |
| semelhantes | DAS | Item3 | Item3Var1 | Item1 | Item1Var2 | Excluir | |
| Carrinho | Item3 | Item1 | Item1Var1 | Incluem | 1 |
Enriquecimento de recomendações
Nome da entidade de dados:Reco_RecommendationsEnrichment
Descrição: enriquecimento dos resultados de recomendações
Atributos:
| Nome | Tipo de dados | Obrigatório | Valor padrão | Comportamento de valor inválido | Comentários |
|---|---|---|---|---|---|
| RecoListName | Cadeia de caracteres | Sim | Cortar valor | Vá para Tabela ListNames para os nomes de lista permitidos. | |
| ItemId | String(16) | Sim | Soltar entrada | Acesse Entidades de dados necessárias por cenário de recomendações para obter a ID do item. | |
| ItemVariantId | String(16) | Não | Soltar entrada | Acesse Entidades de dados necessárias por cenário de recomendações para obter a ID da variante do item. | |
| EnrichmentAction | Cadeia de caracteres | Sim | Soltar entrada | Por enquanto, só há suporte para Incluir ou Excluir. | |
| Classificar | Int | Não | Soltar entrada | Para a ação de enriquecimento Excluir, este valor será ignorado. |
Diretrizes:
- Igual ao Reco_SeededRecommendationsEnrichment.
Ir para a lista completa das entidades de dados
ListNames, AlgoTypes e Refinements
Tabela de ListNames
A lista atual de ListNames disponíveis é fornecida na tabela:
| ListName | Cobrança (Padrão/Premium) | Conjunto de Recursos de Modelagem |
|---|---|---|
| BrowseLists | Standard | Básica |
| ExternalLists | Standard | Básica |
| PeopleAlso | Standard | Básica |
| NextBestAction (formalmente "Cart") | Standard | Básica |
| Separações | Standard | Standard |
| ViewedInSession | Standard | Standard |
| VisualSimilarity | Premium | Premium |
| TextualSimilarity | Premium | Premium |
Tabelas de AlgoTypes
Os AlgoTypes disponíveis e as diferentes APIs com as quais você pode usá-los são fornecidos na tabela:
| AlgoType | Descrição | API compatível |
|---|---|---|
| RecentPurchases | As recomendações de sugestões são calculadas com base nas compras (ou outra interação) mais recentes do usuário. | Disponível apenas com a API de escolhas do usuário.. |
| RecentViews | As recomendações de sugestões são calculadas com base no histórico de visualização e preferências mais recentes do usuário. | Disponível apenas com a API de escolhas do usuário.. |
| FullHistory | As recomendações de sugestões são calculadas com base no histórico de compra (ou outra interação) completo. | Disponível apenas com a API de escolhas do usuário.. |
| MF (Fatoração de Matriz) | A visualização padrão da API semelhante. | Disponível somente com a API semelhante |
| Elemento visual | As semelhanças dos itens são calculadas com base nas semelhanças visuais das imagens do catálogo. | Disponível apenas com a API semelhante. |
| Textual | As semelhanças dos itens são calculadas com base nas semelhanças textuais (reconhecimento de linguagem) dos títulos textuais e descrições do catálogo. | Disponível apenas com a API semelhante. |
| BringSimilarItems | Ao receber uma imagem composta, este AlgoType sugere itens visualmente semelhantes aos itens identificados na imagem composta. | Disponível apenas com a API semelhante. |
| CompleteSimilarStyles | Ao receber um item de propagação, este AlgoType sugere outras imagens compostas de estilos semelhantes que sejam semelhantes ao item de propagação. | Disponível apenas com a API semelhante. |
| CompleteSimilarItems | Ao receber um item de propagação, este AlgoType sugere itens de outras imagens compostas que sejam semelhantes ao item de propagação. | Disponível apenas com a API semelhante. |
| DAS | "DAS" significa Pontuação Associada Direta. Este AlgoType fornece recomendações com base em semelhanças usando co-ocorrências de itens dentro da entidade de dados de interações. Este Algotype é o padrão para toda a API NextBestAction. | Disponível apenas com a API semelhante e a API NextBestAction (formalmente chamado de "Carrinho"). |
Tabela de Refinements
Os Refinamentos disponíveis e as diferentes APIs com as quais você pode usá-los são fornecidos na tabela: É possível adicionar vários refinamentos separados por vírgula, desde que não sejam contraditórios.
| Refinement | Definição | API compatível | comportamento padrão |
|---|---|---|---|
| RemoveUserHistory | Remove itens que o usuário já comprou, de maneira que eles não sejam recomendados para esse usuário novamente. | todas as APIs | Habilitado por padrão apenas para a API "Get User Picks". |
| KeepUserHistory | Mantém o histórico dos itens comprados pelo usuário que o serviço de recomendação pode considerar para o mesmo usuário novamente. | todas as APIs | Habilitado por padrão para todas as APIs, exceto "Get User Picks". |
| EnableShuffling | Altera levemente a ordem dos itens sem afetar de maneira significativa a relevância, evitando assim que os usuários vejam as mesmas recomendações vez após vez. | todas as APIs | Habilitado por padrão apenas para a API "Get User Picks". |
| DisableShuffling | Mantém a ordem dos itens recomendados sem embaralhar os resultados. | todas as APIs | Habilitado por padrão para todas as APIs, exceto "Get User Picks". |
Confira também
Visão geral do contrato de dados
Tabela Mapeamento de entidades de dados
Entidades de dados de catálogo
Entidades de dados de interações
Entidades de dados de configuração de recomendações
Entidades de dados de usuários recusados
Entidades de dados de listas externas
Entidades de dados de mapeamentos de imagem para item
API do Recomendações Inteligentes
Guia de Início Rápido: configurar e executar o Recomendações Inteligentes com dados de exemplo