Partilhar via

Entidades de dados de listas externas

  • Artigo

O Intelligent Recommendations permite-lhe organizar listas de itens criadas manualmente. Esta lista é útil, por exemplo, num cenário de início sem acesso, no qual não tem dados suficientes de interações do utilizador para gerar recomendações significativas. Outro cenário é a criação de listas promocionais, tais como uma venda de "regresso à escola" ou "Sugestões do editor".

Em qualquer caso, as disponibilidades de itens são sempre respeitadas. Qualquer item que seja considerado indisponível quando 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 listas externas:

Listas de recomendações externas

Nome da entidade de dados:Reco_ExternalRecommendationsLists

Descrição: Listas externas de recomendações

Atributos:

Name Tipo de dados Obrigatório Default value Comportamento de valor inválido Comentários
ListName Cadeia(64) Sim Cortar Valor Identificador de lista exclusivo, também utilizado quando consulta a lista. Comprimento limitado a 64 carateres.
Title Cadeia(256) Sim Cortar Valor Comprimento limitado a 256 carateres.
ListAvailabilityStartDate DateTime Não 0001-01-01T00:00:00.000Z Entrada de largada Consulte Entidades de dados obrigatórias por cenário de recomendações para valores de DateTime.
ListAvailabilityEndDate DateTime Não 9999-12-31T23:59:59.999Z Entrada de largada Consulte Entidades de dados obrigatórias por cenário de recomendações para valores de DateTime.

Diretrizes:

  • Esta entidade de dados destina-se a utilização futura.

  • O atributo ListName tem as seguintes restrições:

    • Conjunto de carateres permitidos: A-Z, a-z, 0-9, _, -, ., ..
    • Não é sensível às maiúsculas e minúsculas.
    • Os valores RecoListName existentes estão reservados e não podem ser utilizados como valores ListName. Consulte a lista completa de nomes reservados na página Entidades de dados de melhoramento.
    • Utilizando as datas de início e fim da disponibilidade da lista, é possível determinar a disponibilidade da lista, que o Intelligent Recommendations pode entregar apenas entre estas datas especificadas.

Dados de amostra:

Os cabeçalhos aparecem apenas para comodidade e não devem fazer parte dos dados reais.

ListName Title ListAvailabilityStartDate ListAvailabilityEndDate
SummerSale2020 Melhores itens de verão para 2020 2020-07-01T00:00:00.000Z 2020-08-31T23:59:59.999Z

Itens de recomendações externas

Nome da entidade de dados:Reco_ExternalRecommendationsItems

Descrição: itens para as listas externas de recomendações

Atributos:

Name Tipo de dados Obrigatório Default value Comportamento de valor inválido Comentários
ListName Cadeia(64) Sim Cortar Valor Identificador de lista exclusivo, que também utilizado quando consulta a lista. Comprimento limitado a 64 carateres. Pode ver a tabela de ListNames aqui.
ItemId Cadeia(16) Sim Entrada de largada Consulte Entidades de dados obrigatórias por cenário de recomendações para itemId.
ItemVariantId Cadeia(16) Não Entrada de largada Consulte Entidades de dados obrigatórias por cenário de recomendações para itemVariantId.
Classificação Int Sim Entrada de largada A ordem de posição em que pretende que cada item apareça.

Diretrizes:

  • Esta entidade de dados destina-se a utilização futura.

  • Consulte as diretrizes ListName nas entidades de dados Reco_ExternalRecommendationsLists.

  • O Intelligent Recommendations não garante a ordenação interna entre vários itens atribuídos com a mesma classificação na mesma lista.

  • No caso em que o mesmo item ou variante de item apareça numa lista mais de uma vez, é utilizada a classificação mais alta e todas as outras entradas são ignoradas.

  • Para cada valor de ListName nesta entidade de dados, tem de haver uma entrada correspondente com o mesmo valor de ListName na entidade de dados Reco_ExternalRecommendationsLists; caso contrário, a entrada é ignorada.

Dados de amostra:

Os cabeçalhos aparecem apenas para comodidade e não devem fazer parte dos dados reais.

ListName ItemId ItemVariantId Classificação
SummerSale2020 Item2 1
SummerSale2020 Item3 Item3Var1 2
SummerSale2020 Item1 Item1Var2 3

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 mapeamento de imagem para item
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 melhoramento de recomendações
API do Intelligent Recommendations
Guia de Início Rápido: Configurar e executar o Intelligent Recommendations com dados de amostra