Partilhar via


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:

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 dados
Tabela de 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 utilizadores que optaram ativamente por não participar
Entidades de dados de listas externas
Entidades de dados de mapeamento de imagem para item
API do Intelligent Recommendations
Guia de Início Rápido: Configurar e executar o Intelligent Recommendations com dados de amostra