Compartir a través de


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) Valor de ajuste Identificador de lista único, también utilizado al consultar la lista. Longitud limitada a 64 caracteres.
Nombre String(256) 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) 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) 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 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