Entidades de datos de enriquecimiento de recomendaciones
En este artículo se proporcionan instrucciones sobre cómo configurar entidades de datos de enriquecimiento de recomendaciones en el contrato de datos de Intelligent Recommendations.
Revisión de entidades de datos
Una entidad de datos es un conjunto de uno o más archivos de texto de datos, cada uno con una lista de columnas (también llamadas atributos) y filas que contienen los valores de datos reales.
Intelligent Recommendations define grupos lógicos de entidades de datos, cada uno con su propio propósito.
Nota
Las entidades de datos se consideran opcionales, a menos que se indique explícitamente lo contrario, lo que significa que sus datos pueden estar vacíos o faltar.
Volver a la lista completa de entidades de datos
Presentación
Intelligent Recommendations admite el enriquecimiento manual de las recomendaciones generadas, lo que le permite agregar o eliminar manualmente artículos específicos o variantes de artículos de cualquier lista de recomendaciones.
Las acciones de enriquecimiento admitidas son:
Incluir: agrega el artículo o la variante del artículo especificados on la parte superior de la lista especificada. Estos artículos agregados manualmente se ordenarán por su atributo Rank.
Excluir: elimina el artículo o variante de artículo especificados de la lista especificada, independientemente del rango del artículo en dicha lista.
Siempre se respetan las disponibilidades de artículos. Cualquier artículo que no se considere disponible en el momento en que se llama a la API de recomendación no se devolverá como parte de la respuesta.
Las siguientes entidades de datos forman parte de las entidades de datos de enriquecimiento de recomendaciones:
Volver a la lista completa de entidades de datos
Enriquecimiento de recomendaciones para un artículo específico
Nombre de la entidad de datos:Reco_SeededRecommendationsEnrichment
Descripción: enriquecimiento de los resultados de recomendación para un artículo específico utilizando ItemId conocido como SeedItemId. Solo se aplica a listas como "A la gente también le gusta", que están marcadas con un elemento específico.
Atributos:
| Name | Tipo de datos | Obligatorio | Default value | Comportamiento de valor no válido | Comments |
|---|---|---|---|---|---|
| RecoListName | String | Sí | Valor de ajuste | Vaya a la Tabla ListNames para ver los nombres de lista admitidos. | |
| AlgoType | String | No | Valor de ajuste | No todos los nombres de lista requieren que se establezca este valor. Consulte la Tabla AlgoTypes para conocer los tipos de algoritmo admitidos para cada nombre de lista. | |
| SeedItemId | String(16) | Sí | Anular entrada | El ItemId para el que se recomienda la lista. Vea Entidades de datos requeridas por escenario de recomendaciones para conocer el id. del artículo. | |
| SeedItemVariantId | String(16) | No | Anular entrada | El ItemVariantId para el que se recomienda la lista. Vea Entidades de datos requeridas por escenario de recomendaciones para conocer el id. de variante de artículo. | |
| ItemId | String(16) | Sí | Anular entrada | Vea Entidades de datos requeridas por escenario de recomendaciones para conocer el id. del artículo. | |
| ItemVariantId | String(16) | No | Anular entrada | Vea Entidades de datos requeridas por escenario de recomendaciones para conocer el id. de variante de artículo. | |
| EnrichmentAction | String | Sí | Anular entrada | Solo admite Incluir o Excluir por ahora. | |
| Clasificación | Int | No | Anular entrada | Para la acción de enriquecimiento Excluir, este valor se ignora. |
Directrices:
Los artículos marcados con Incluir solo se puede agregar al principio de una lista de recomendaciones generada.
Excluir un artículo de una lista en la que no aparece no hará nada.
La exclusión siempre gana. Si incluye y excluye el mismo artículo de la misma lista, se excluirá de la respuesta final de la API.
El atributo Rank solo especifica el orden entre los artículos agregados o las variantes de artículos. En cualquier caso, siempre se añadirán al principio de la lista. Si hay valores de rango duplicados para varios elementos, se agregarán en algún orden aleatorio entre ellos.
Los enriquecimientos con un valor AlgoType no admitidos se ignoran.
Datos de ejemplo:
Los encabezados aparecen solo por conveniencia y no deben ser parte de los datos reales.
| RecoListName | AlgoType | SeedItemId | SeedItemVariantId | ItemId | ItemVariantId | EnrichmentAction | Clasificación |
|---|---|---|---|---|---|---|---|
| Similar | MF | Item1 | Item2 | Incluir | 1 | ||
| Similar | MF | Item1 | Item3 | Item3Var1 | Incluir | 2 | |
| Similar | DAS | Item3 | Item3Var1 | Item1 | Item1Var2 | Excluir | |
| Carro | Item3 | Item1 | Item1Var1 | Incluir | 1 |
Enriquecimiento de recomendaciones
Nombre de la entidad de datos:Reco_RecommendationsEnrichment
Descripción: enriquecimiento de los resultados de recomendaciones
Atributos:
| Name | Tipo de datos | Obligatorio | Default value | Comportamiento de valor no válido | Comments |
|---|---|---|---|---|---|
| RecoListName | String | Sí | Valor de ajuste | Vaya a la Tabla ListNames para ver los nombres de lista admitidos. | |
| ItemId | String(16) | Sí | Anular entrada | Vaya a Entidades de datos requeridas por escenario de recomendaciones para conocer el id. del artículo. | |
| ItemVariantId | String(16) | No | Anular entrada | Vaya a Entidades de datos requeridas por escenario de recomendaciones para conocer el id. de variante de artículo. | |
| EnrichmentAction | String | Sí | Anular entrada | Solo admite Incluir o Excluir por ahora. | |
| Clasificación | Int | No | Anular entrada | Para la acción de enriquecimiento Excluir, este valor se ignora. |
Directrices:
- Igual que Reco_SeededRecommendationsEnrichment.
Volver a la lista completa de entidades de datos
ListNames, AlgoTypes y Refinements
Tabla de ListNames
La lista actual de ListNames disponibles se proporciona en la tabla:
| ListName | Facturación (estándar/premium) | Conjunto de características de modelado |
|---|---|---|
| BrowseLists | Estándar | Básica |
| ExternalLists | Estándar | Básica |
| PeopleAlso | Estándar | Básica |
| NextBestAction (formalmente "Carro") | Estándar | Básica |
| Picking | Estándar | Estándar |
| ViewedInSession | Estándar | Estándar |
| VisualSimilarity | Premium | Premium |
| TextualSimilarity | Premium | Premium |
Tabla de AlgoTypes
Los AlgoTypes disponibles y las diferentes API con las que puede usarlos se muestran en la tabla:
| AlgoType | Descripción | API admitida |
|---|---|---|
| RecentPurchases | Las recomendaciones de selecciones se calculan en función de las compras más recientes (u otra interacción) del usuario. | Solo disponible con la API de selecciones de usuarios. |
| RecentViews | Las recomendaciones de selecciones se calculan en función del historial de visualización más reciente y las preferencias del usuario. | Solo disponible con la API de selecciones de usuarios. |
| FullHistory | Las recomendaciones de selecciones se calculan en función del historial de ventas completo (u otra interacción) del usuario. | Solo disponible con la API de selecciones de usuarios. |
| MF(Factorización de matrices) | La vista predeterminada para la API Similar. | Solo disponible con el API similar |
| Objeto visual | Las similitudes de los elementos se calculan en función de las similitudes visuales de las imágenes del catálogo. | Solo disponible con el API similar. |
| Textual | Las similitudes de los elementos se calculan en función de las similitudes textuales (comprensión del idioma) de las descripciones y títulos textuales del catálogo. | Solo disponible con el API similar. |
| BringSimilarItems | Cuando se le proporciona una imagen compuesta, este AlgoType sugiere elementos que son visualmente similares a los elementos identificados en la imagen compuesta. | Solo disponible con el API similar. |
| CompleteSimilarStyles | Cuando se le proporciona un elemento inicial, este AlgoType sugiere otras imágenes compuestas de estilos similares que son similares al elemento inicial. | Solo disponible con el API similar. |
| CompleteSimilarItems | Cuando se le proporciona un elemento inicial, este AlgoType sugiere elementos de otras imágenes compuestas que son similares al elemento inicial. | Solo disponible con el API similar. |
| DAS | "DAS" significa Puntuación Asociada Directa. Este AlgoType proporciona recomendaciones basadas en similitudes utilizando las co-ocurrencias de elementos dentro de la entidad de datos de interacciones. Este Algotype es el predeterminado para la API NextBestAction. | Solo disponible con la API similar y la API NextBestAction (formalmente llamada "Carro"). |
Tabla de Refinements
Los refinamientos disponibles y las diferentes API con las que puede usarlos se indican en la tabla: Puede agregar varios refinamientos separados por comas, siempre que no se contradigan entre sí.
| Refinement | Definición | API admitida | comportamiento predeterminado |
|---|---|---|---|
| RemoveUserHistory | Elimina los artículos que el usuario ya compró para que no se los recomiende nuevamente. | todas las API | Habilitado de forma predeterminada solo para la API "Obtener selecciones de usuarios". |
| KeepUserHistory | Mantiene el historial de artículos comprados por el usuario que el servicio de recomendación puede considerar para el mismo usuario nuevamente. | todas las API | Habilitado de forma predeterminada para todas las API, excepto "Obtener selecciones de usuarios". |
| EnableShuffling | Cambia ligeramente el orden de los elementos sin afectar significativamente a la relevancia, para evitar que los usuarios vean las mismas recomendaciones una y otra vez. | todas las API | Habilitado de forma predeterminada solo para la API "Obtener selecciones de usuarios". |
| DisableShuffling | Mantiene el orden de los elementos recomendados sin mezclar los resultados. | todas las API | Habilitado de forma predeterminada para todas las API, excepto "Obtener selecciones de usuarios". |
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 copn datos de ejemplo