Entidades de datos de listas externas
Intelligent Recommendations le permite seleccionar listas de elementos creados manualmente. Esta lista es útil, por ejemplo, en un escenario de arranque en frío, donde no tiene suficientes datos de interacciones de usuarios para generar recomendaciones significativas. Otro escenario es para crear listas promocionales, como para una venta de “regreso a la escuela” o "Selecciones del editor".
En cualquier caso, siempre se respetan las disponibilidades de artículos. Cualquier artículo que no se considere disponible cuando se llama a la API de recomendación no se devuelve como parte de la respuesta.
Las siguientes entidades de datos forman parte de las entidades de datos de listas externas:
Listas de recomendaciones externas
Nombre de la entidad de datos:Reco_ExternalRecommendationsLists
Descripción: listas externas de recomendaciones
Atributos:
| Name | Tipo de datos | Obligatorio | Default value | Comportamiento de valor no válido | Comments |
|---|---|---|---|---|---|
| ListName | String(64) | Sí | Valor de ajuste | Identificador de lista único, también utilizado al consultar la lista. Longitud limitada a 64 caracteres. | |
| Nombre | String(256) | Sí | Valor de ajuste | Longitud limitada a 256 caracteres. | |
| ListAvailabilityStartDate | Fecha y hora | No | 0001-01-01T00:00:00.000Z | Anular entrada | Vea Entidades de datos requeridas por escenario de recomendaciones para valores de DateTime. |
| ListAvailabilityEndDate | Fecha y hora | No | 9999-12-31T23:59:59.999Z | Anular entrada | Vea Entidades de datos requeridas por escenario de recomendaciones para valores de DateTime. |
Directrices:
Esta entidad de datos es solo para uso futuro.
El atributo ListName tiene las siguientes restricciones:
- Conjunto de caracteres permitidos: A-Z, a-z, 0-9, _, -, ~, ..
- No distingue entre mayúsculas y minúsculas.
- Los valores RecoListName existentes están reservados y no se pueden usar como valores ListName. Consulte la lista completa de nombres reservados en la Página de entidades de datos de enriquecimiento.
- Utilizando las fechas de inicio y finalización de disponibilidad de la lista, puede determinar la disponibilidad de la lista, que Intelligent Recommendations solo puede atender entre estas fechas especificadas.
Datos de ejemplo:
Los encabezados aparecen solo por conveniencia y no deben ser parte de los datos reales.
| ListName | Nombre | ListAvailabilityStartDate | ListAvailabilityEndDate |
|---|---|---|---|
| SummerSale2020 | Los mejores artículos de verano para 2020 | 2020-07-01T00:00:00.000Z | 2020-08-31T23:59:59.999Z |
Elementos de recomendaciones externas
Nombre de la entidad de datos:Reco_ExternalRecommendationsItems
Descripción: elementos para listas externas de recomendaciones
Atributos:
| Name | Tipo de datos | Obligatorio | Default value | Comportamiento de valor no válido | Comments |
|---|---|---|---|---|---|
| ListName | String(64) | Sí | Valor de ajuste | Identificador de lista único, también utilizado al consultar la lista. Longitud limitada a 64 caracteres. Puede ver la tabla de ListNames aquí. | |
| ItemId | String(16) | Sí | Anular entrada | Vea Entidades de datos requeridas por escenario de recomendaciones para itemId. |
|
| ItemVariantId | String(16) | No | Anular entrada | Vea Entidades de datos requeridas por escenario de recomendaciones para itemVariantId. |
|
| Clasificación | Int | Sí | Anular entrada | El orden de posición en el que desea que aparezca cada elemento. |
Directrices:
Esta entidad de datos es solo para uso futuro.
Consulte las directrices ListName en la entidad de datos Reco_ExternalRecommendationsLists.
Recomendaciones inteligentes no garantiza el orden interno entre varios elementos que se asignaron con el mismo rango en la misma lista.
En el caso de que el mismo artículo o variante de artículo aparezca en una lista más de una vez, se utiliza su clasificación más alta y todas las demás entradas se ignoran.
Para cada valor ListName en esta entidad de datos, debe haber una entrada correspondiente con el mismo valor ListName en la entidad de datos Reco_ExternalRecommendationsLists; de lo contrario, la entrada se ignora.
Datos de ejemplo:
Los encabezados aparecen solo por conveniencia y no deben ser parte de los datos reales.
| ListName | ItemId | ItemVariantId | Clasificación |
|---|---|---|---|
| SummerSale2020 | Item2 | 1 | |
| SummerSale2020 | Item3 | Item3Var1 | 2 |
| SummerSale2020 | Item1 | Item1Var2 | 3 |
Consulte también
Descripción general del contrato de datos
Tabla de asignación de entidades de datos
Entidades de datos de catálogo
Entidades de datos de interacciones
Entidades de datos de configuración Reco
Entidades de datos de usuarios de baja
Entidades de datos de listas externas
Entidades de datos de asignación de imagen a elemento
API de Intelligent Recommendations
Guía de inicio rápido: configfurar y ejecutar Intelligent Recommendations con datos de ejemplo