Entidades de dados de melhoramento de recomendações
Este artigo fornece informações sobre como configurar entidades de dados de melhoramento de recomendações no contrato de dados do Intelligent Recommendations.
Revisão de entidades de dados
Uma entidade de dados é um conjunto de um ou mais ficheiros de texto de dados, cada um com uma lista de colunas (também denominados atributos) e linhas que contêm os valores reais dos dados.
O Intelligent Recommendations define grupos lógicos de entidades de dados, cada um com o seu próprio propósito.
Nota
As entidades de dados são opcionais, a menos que tenha sido explicitamente indicado o contrário, o que significa que os respetivos dados podem estar vazios ou em falta.
Voltar à lista completa de entidades de dados
Introdução
O Intelligent Recommendations suporta o melhoramento manual de recomendações geradas, o que lhe permite adicionar ou remover manualmente itens ou variantes de itens específicos de qualquer lista de recomendações.
As ações de melhoramento suportadas são:
Incluir: adiciona o item ou a variante de itens especificado no topo da lista especificada. Estes itens adicionados manualmente são ordenados pelo respetivo atributo de Classificação.
Excluir: remove o item ou a variante de itens especificado a partir da lista especificada, independentemente da classificação do item nessa 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 é chamada não é devolvido como parte da resposta.
As seguintes entidades de dados fazem parte das entidades de dados de melhoramento de recomendações:
Voltar à lista completa de entidades de dados
Melhoramento de recomendações para um item específico
Nome da entidade de dados:Reco_SeededRecommendationsEnrichment
Descrição: resultados do melhoramento de recomendações para um Item específico utilizando ItemId conhecido como SeedItemId. Só se aplica a listas como "As pessoas também gostam", que são percebidas a partir de um item específico.
Atributos:
| Name | Tipo de dados | Obrigatório | Default value | Comportamento de valor inválido | Comentários |
|---|---|---|---|---|---|
| RecoListName | Cadeia (de carateres) | Sim | Cortar valor | Aceda à Tabela ListNames para os nomes de lista suportados. | |
| AlgoType | Cadeia (de carateres) | Não | Cortar valor | Nem todos os nomes de lista requerem que este valor seja definido. Consulte a Tabela AlgoTypes para ver os tipos de algoritmo suportados para cada nome de lista. | |
| SeedItemId | Cadeia(16) | Sim | Entrada de largada | O ItemId para o qual a lista está a recomendar. Consulte Entidades de dados obrigatórias por cenário de recomendações para ID de item. | |
| SeedItemVariantId | Cadeia(16) | Não | Entrada de largada | O ItemVariantId para o qual a lista está a recomendar. Consulte Entidades de dados obrigatórias por cenário de recomendações para ID de variante de item. | |
| ItemId | Cadeia(16) | Sim | Entrada de largada | Consulte Entidades de dados obrigatórias por cenário de recomendações para ID de item. | |
| ItemVariantId | Cadeia(16) | Não | Entrada de largada | Consulte Entidades de dados obrigatórias por cenário de recomendações para ID de variante de item. | |
| EnrichmentAction | Cadeia (de carateres) | Sim | Entrada de largada | Suporta apenas Incluir ou Excluir por agora. | |
| Classificação | Int | Não | Entrada de largada | Para a ação de melhoramento Excluir, este valor é ignorado. |
Diretrizes:
Os itens marcados como Incluir só podem ser adicionados ao topo de uma lista de recomendações gerada.
A exclusão de um item de uma lista em que o item não aparece não fará nada.
A exclusão ganha sempre. Se incluir e excluir o mesmo item da mesma lista, este é excluído da resposta de API final.
O atributo Classificação especifica apenas a ordem entre os itens adicionados ou variantes de itens. De qualquer forma, serão sempre adicionados ao topo da lista. Se existirem valores de classificação duplicados para vários itens, são adicionados em alguma ordem aleatória entre eles.
Os melhoramentos com um valor AlgoType não suportado são ignorados.
Dados de amostra:
Os cabeçalhos aparecem apenas para comodidade e não devem fazer parte dos dados reais.
| RecoListName | AlgoType | SeedItemId | SeedItemVariantId | ItemId | ItemVariantId | EnrichmentAction | Classificação |
|---|---|---|---|---|---|---|---|
| semelhantes | MF | Item1 | Item2 | Incluir | 1 | ||
| semelhantes | MF | Item1 | Item3 | Item3Var1 | Incluir | 2 | |
| semelhantes | DAS | Item3 | Item3Var1 | Item1 | Item1Var2 | Excluir | |
| Carrinho | Item3 | Item1 | Item1Var1 | Incluir | 1 |
Melhoramento de recomendações
Nome da entidade de dados:Reco_RecommendationsEnrichment
Descrição: melhoramento de resultados das recomendações
Atributos:
| Name | Tipo de dados | Obrigatório | Default value | Comportamento de valor inválido | Comentários |
|---|---|---|---|---|---|
| RecoListName | Cadeia (de carateres) | Sim | Cortar valor | Aceda à Tabela ListNames para os nomes de lista suportados. | |
| ItemId | Cadeia(16) | Sim | Entrada de largada | Aceda a Entidades de dados obrigatórias por cenário de recomendações para ID de item. | |
| ItemVariantId | Cadeia(16) | Não | Entrada de largada | Aceda a Entidades de dados obrigatórias por cenário de recomendações para ID de variante de item. | |
| EnrichmentAction | Cadeia (de carateres) | Sim | Entrada de largada | Suporta apenas Incluir ou Excluir por agora. | |
| Classificação | Int | Não | Entrada de largada | Para a ação de melhoramento Excluir, este valor é ignorado. |
Diretrizes:
- O mesmo que Reco_SeededRecommendationsEnrichment.
Voltar à lista completa de entidades de dados
ListNames, AlgoTypes e Refinamentos
Tabela de ListNames
A lista atual de ListNames disponíveis é dada na tabela:
| ListName | Faturação (Standard/Premium) | Conjunto de Caraterísticas de Modelação |
|---|---|---|
| BrowseLists | Standard | Básica |
| ExternalLists | Standard | Básica |
| PeopleAlso | Standard | Básica |
| NextBestAction (formalmente "Carrinho") | Standard | Básica |
| Seleções | Standard | Standard |
| ViewedInSession | Standard | Standard |
| VisualSimilarity | Premium | Premium |
| TextualSimilarity | Premium | Premium |
Tabela de AlgoTypes
Os AlgoTypes disponíveis e as diferentes APIs com que os pode utilizar são apresentados na tabela:
| AlgoType | Descrição | API suportada |
|---|---|---|
| RecentPurchases | As recomendações de seleções são calculadas com base nas compras mais recentes (ou outra interação) do utilizador. | Só está disponível com a API de Seleções do Utilizador. |
| RecentViews | As recomendações de seleções são calculadas com base no histórico de visualizações e preferências mais recentes do utilizador. | Só está disponível com a API de Seleções do Utilizador. |
| FullHistory | As recomendações de seleções são calculadas com base no histórico de compras completas (ou outra interação) do utilizador. | Só está disponível com a API de Seleções do Utilizador. |
| MF (Fatorização da Matriz) | A vista predefinida para a API Semelhante. | Só está disponível com a API Semelhante |
| elemento visual | As semelhanças entre itens são calculadas com base em semelhanças visuais de imagens de catálogo. | Só está disponível com a API de Semelhantes. |
| Textual | As semelhanças de itens são calculadas com base em semelhanças textuais (compreensão de linguagem) de títulos textuais de catálogo e descrições. | Só está disponível com a API de Semelhantes. |
| BringSimilarItems | Quando fornecida uma imagem composta, este AlgoType sugere itens visualmente semelhantes aos itens identificados na imagem composta. | Só está disponível com a API de Semelhantes. |
| CompleteSimilarStyles | Quando fornecido um item de propagação, este AlgoType sugere outras imagens compostas de estilos semelhantes que são semelhantes ao item de propagação. | Só está disponível com a API de Semelhantes. |
| CompleteSimilarItems | Quando fornecido um item de propagação, este AlgoType sugere itens de outras imagens compostas que são semelhantes ao item de propagação. | Só está disponível com a API de Semelhantes. |
| DAS | "DAS" significa Direct Associated Scoring (Classificação Associada Direta). Este AlgoType fornece recomendações com base em semelhanças utilizando co-ocorrências de itens na entidade de dados de interações. Este Algotype é o predefinido para a API NextBestAction. | Só disponíveis com a API de Semelhantes e a API NextBestAction (formalmente chamada de "Carrinho"). |
Tabela de Afinações
Os Refinamentos disponíveis e as diferentes APIs com que as pode utilizar são apresentados na tabela: Pode adicionar vários refinamentos separados por vírgulas, desde que não se contradigam entre si.
| Afinação | Definição | API suportada | comportamento predefinido |
|---|---|---|---|
| RemoveUserHistory | Remove itens que o utilizador já comprou para que não sejam recomendados novamente ao utilizador. | todas as API | Ativado por predefinição apenas para a API 'Obter Seleções do Utilizador'. |
| KeepUserHistory | Mantém o histórico de itens adquiridos pelo utilizador que o serviço de recomendações pode considerar novamente para o mesmo utilizador. | todas as API | Ativado por predefinição para todas as API, exceto 'Obter Seleções do Utilizador'. |
| EnableShuffling | Ligeiras alterações à ordem de itens sem afetar significativamente a relevância, para impedir que os utilizadores vejam as mesmas recomendações uma e outra vez. | todas as API | Ativado por predefinição apenas para a API 'Obter Seleções do Utilizador'. |
| DisableShuffling | Mantém a ordem dos itens recomendados sem resultados de pesquisa. | todas as API | Ativado por predefinição para todas as API, exceto 'Obter Seleções do Utilizador'. |
Consulte também
Descrição geral do contrato de dadosTabela de mapeamento de entidades de dadosEntidades de dados de catálogoEntidades de dados de interaçõesEntidades de dados de configuração de recomendaçõesEntidades de dados de utilizadores que optaram ativamente por não participarEntidades de dados de listas externasEntidades de dados de mapeamento de imagem para itemAPI do Intelligent RecommendationsGuia de Início Rápido: Configurar e executar o Intelligent Recommendations com dados de amostra