Entidades de dados de listas externas
As Recomendações Inteligentes permitem que você organize listas de itens criadas manualmente. Essa lista é útil, por exemplo, em um cenário de inicialização a frio, em que você não tem dados suficientes de interações do usuário para gerar recomendações significativas. Outro cenário se destina à criação de listas promocionais, como para uma venda de “volta às aulas” ou “escolhas do editor”.
De qualquer forma, as disponibilidades de itens são sempre respeitadas. Qualquer item não seja considerado disponível quando a API de recomendação é chamada não retorna 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:
| Nome | Tipo de dados | Obrigatório | Valor padrão | Comportamento de valor inválido | Comentários |
|---|---|---|---|---|---|
| ListName | String(64) | Sim | Cortar valor | Identificador de lista exclusivo, também usado ao consultar a lista. Tamanho limitado a 64 caracteres. | |
| Tĩtulo | String(256) | Sim | Cortar valor | Tamanho limitado a 256 caracteres. | |
| ListAvailabilityStartDate | DateTime | Não | 0001-01-01T00:00:00.000Z | Soltar entrada | Consulte Entidades de dados necessárias por cenário de recomendações para obter valores de DateTime. |
| ListAvailabilityEndDate | DateTime | Não | 9999-12-31T23:59:59.999Z | Soltar entrada | Consulte Entidades de dados necessárias por cenário de recomendações para obter valores de DateTime. |
Diretrizes:
Esta entidade de dados é para uso futuro.
O atributo ListName tem as seguintes restrições:
- Conjunto de caracteres permitidos: A-Z, a-z, 0-9, _, -, ~, ..
- Não diferencia maiúsculas de minúsculas.
- Os valores existentes RecoListName são reservados e não podem ser usados como valores ListName. Veja a lista completa de nomes reservados na página de entidades de dados de enriquecimento.
- Usando as datas de início e término da disponibilidade da lista, é possível determinar a disponibilidade da lista, que o Recomendações Inteligentes pode atender apenas entre essas datas especificadas.
Dados de exemplo:
Os cabeçalhos aparecem apenas por conveniência e não devem fazer parte dos dados reais.
| ListName | Tĩtulo | 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:
| Nome | Tipo de dados | Obrigatório | Valor padrão | Comportamento de valor inválido | Comentários |
|---|---|---|---|---|---|
| ListName | String(64) | Sim | Cortar valor | Identificador de lista exclusivo, que também é usado ao consultar a lista. Tamanho limitado a 64 caracteres. Você pode ver a tabela de ListNames aqui. | |
| ItemId | String(16) | Sim | Soltar entrada | Consulte Entidades de dados necessárias por cenário de recomendações para itemId. |
|
| ItemVariantId | String(16) | Não | Soltar entrada | Consulte Entidades de dados necessárias por cenário de recomendações para itemVariantId. |
|
| Classificar | Int | Sim | Soltar entrada | A ordem de posição em que você deseja que cada item apareça. |
Diretrizes:
Esta entidade de dados é para uso futuro.
Consulte as diretrizes ListName na entidade de dados Reco_ExternalRecommendationsLists.
As Recomendações Inteligentes não garantem a ordenação interna entre vários itens que foram atribuídos com a mesma classificação na mesma lista.
No caso de o mesmo item ou variante de item aparecer em uma lista mais de uma vez, a classificação mais alta é usada e todas as outras entradas são ignoradas.
Para cada valor ListName nesta entidade de dados, deve haver uma entrada correspondente com o mesmo valor ListName na entidade de dados Reco_ExternalRecommendationsLists; caso contrário, a entrada é ignorada.
Dados de exemplo:
Os cabeçalhos aparecem apenas por conveniência e não devem fazer parte dos dados reais.
| ListName | ItemId | ItemVariantId | Classificar |
|---|---|---|---|
| SummerSale2020 | Item2 | 1 | |
| SummerSale2020 | Item3 | Item3Var1 | 2 |
| SummerSale2020 | Item1 | Item1Var2 | 3 |
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 mapeamentos de imagem para item
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 enriquecimento de recomendações
API do Recomendações Inteligentes
Guia de Início Rápido: configurar e executar o Recomendações Inteligentes com dados de exemplo