Entidades de dados de listas externas
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 não seja 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 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 | No | 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 | No | 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) | No | 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 | 5 | |
SummerSale2020 | Item3 | Item3Var1 | 2 |
SummerSale2020 | Item1 | Item1Var2 | 3 |
Consulte também
Descrição geral do contrato de dadosTabela de mapeamento de entidades de dadosEntidades de dados de catálogoEntidades de dados de mapeamento de imagem para itemEntidades 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 melhoramento de recomendaçõesAPI do Intelligent RecommendationsGuia de Início Rápido: Configurar e executar o Intelligent Recommendations com dados de amostra