En esta página, se describe cómo crear parámetros de configuración de entrega. Una configuración de entrega es una entidad de entrega que asocia un modelo o un conjunto de controles que se usan para generar tus resultados de búsqueda o recomendación.
Antes de comenzar
Las recomendaciones y los parámetros de configuración de entrega de búsqueda tienen diferentes requisitos y opciones:
y las de entrega de recomendaciones requieren un modelo. Si planeas conectar un modelo existente a una configuración de entrega nueva, obtén el ID del modelo que planeas usar (obligatorio cuando se usa el método
ServingConfig.create
).Si creas la configuración de entrega con la consola, puedes crear un modelo nuevo durante el proceso de creación en lugar de conectar un modelo existente.
Puedes cambiar de modelo más adelante, siempre que sea del mismo tipo de modelo.
pueden usar controles de entrega, pero no son obligatorios. Si planeas adjuntar controles existentes a una configuración de entrega nueva, obtén los ID de los controles que planeas usar.
Si creas la configuración de entrega con la consola, también puedes crear controles nuevos durante el proceso de creación.
Puedes cambiarla o agregar controles de entrega a la configuración de entrega después de crearla.
Crea una configuración de entrega
Puedes crear una configuración de entrega con lo siguiente:
Se permiten hasta 100 parámetros de configuración de entrega por catálogo.
Si tienes posiciones existentes o creas posiciones nuevas, se crea automáticamente una configuración de entrega asociada con cada posición. Crear una configuración de entrega no crea la posición correspondiente. Si borras una configuración de entrega, se borra su posición correspondiente; si se borra una posición, se borra su configuración de entrega correspondiente.
Crea una configuración de entrega en la consola
Agrega una nueva configuración de entrega en la página Parámetros de configuración de entrega en Search for Retail Console.
Para crear una nueva configuración de entrega, haz lo siguiente:
Ve a la página Parámetros de configuración de entrega en la consola de Search for Retail.
Ir a la página Configuración de entregaHaz clic en add_box Crear una opción de configuración de entrega.
recomendaciones
Selecciona Recomendación (Recommendation) como el producto para el que se usará la configuración de entrega.
Proporciona un nombre para la configuración de entrega.
El nombre debe tener 1,024 caracteres como máximo, y solo puede contener caracteres alfanuméricos, guiones bajos, guiones y espacios.
Opcional: Si es necesario, actualiza el ID.
El ID se genera a partir del nombre que proporcionas y debe ser único en todo el proyecto. Debe tener 50 caracteres o menos, y no puede contener espacios.
Elige o crea un modelo para el que desees que esta configuración de entrega proporcione recomendaciones.
Obtén más información para crear modelos nuevos.
Selecciona en qué medida el reclasificación de precio debería afectar los resultados de las recomendaciones, si está disponible para el modelo que seleccionaste.
La reclasificación de precio hace que los productos sugeridos del catálogo con una probabilidad de recomendarse similar se ordenen según el precio, con los elementos de precio más alto primero. La relevancia también se usa para ordenar elementos, por lo que habilitar la reclasificación de precio no es lo mismo que ordenarlos por precio.
Selecciona si quieres usar la diversificación basada en reglas o basada en datos:
Basada en reglas: La diversificación basada en reglas afecta si los resultados que se muestran de una sola solicitud de predicción corresponden a diferentes categorías de tu catálogo de productos.
Basada en datos: La diversificación basada en datos usa el aprendizaje automático para equilibrar la diversidad de categorías y la relevancia en los resultados de tu predicción.
Para obtener más información, consulta Diversificación.
Selecciona cuánto quieres diversificar los resultados de recomendaciones.
Si seleccionaste un modelo de Elementos similares para esta configuración de entrega, selecciona si quieres habilitar la coincidencia de categorías.
Cuando la coincidencia de categoría está habilitada, los únicos resultados de productos que se muestran son los que comparten al menos una categoría con el producto de contexto. La coincidencia de categorías se puede usar en combinación con otras opciones de filtrado, como el precio, la disponibilidad y las etiquetas de filtro.
search
- En la página Crear una configuración de entrega, elige Buscar como el producto para el que se usará la configuración de entrega.
- Proporciona un nombre para la configuración de publicación.
El nombre debe tener 1,024 caracteres o menos y solo puede contener caracteres alfanuméricos, guiones bajos, guiones y espacios. - Opcional: Si es necesario, actualiza el ID.
El ID se genera a partir del nombre que proporcionas y debe ser único en todo el proyecto. Debe tener 50 caracteres como máximo y no puede contener espacios. - Haz clic en Continuar.
- Elige si quieres habilitar la faceta dinámica para esta configuración de entrega.
- Elige o crea controles de entrega para optimizar las búsquedas.
Para obtener más información sobre los controles, consulta Crea y administra controles.
Haz clic en Crear para crear el grupo nuevo.
La configuración nueva aparecerá en la página de Opciones de configuración de entrega.
Es posible que la configuración tarde unos minutos en estar disponible para su uso en solicitudes de búsqueda. Está disponible de inmediato para obtener recomendaciones.
Opcional: En la página Configuración de entrega, haz clic en un nombre de configuración de entrega y ve a la pestaña Evaluar para obtener una vista previa de los productos que se mostrarían con esta configuración.
La vista previa de la evaluación puede ayudarte a confirmar que la configuración tiene el rendimiento esperado.
Crea una configuración de entrega con ServingConfig.create
Puedes crear una configuración de entrega con el método de la API ServingConfig.create
. Si deseas obtener documentación de referencia de la API para este método, consulta ServingConfig.create
.
Los campos que uses dependerán de si creas una configuración de entrega para las recomendaciones o la búsqueda.
Para obtener más detalles sobre los campos ServingConfig
, consulta la referencia de la API de ServingConfigs
.
recomendaciones
Realiza una solicitud ServingConfig.create
con un ID de configuración de entrega y una instancia de ServingConfig
incluida en el cuerpo de la solicitud.
servingConfigId
: Obligatorio. Crea un ID para tuServingConfig
. Este valor debe tener entre 4 y 63 caracteres. Los caracteres válidos son/[a-z][0-9]-_/
.displayName
: Obligatorio. Es el nombreServingConfig
legible que se muestra en la consola de Search for Retail.modelID
: Obligatorio. El ID del modelo que se usará en el momento de la entrega.priceRerankingLevel
: Opcional Establece en qué medida el reclasificación de precio debería afectar los resultados de las recomendaciones. Los valores permitidos sonno-price-reranking
(valor predeterminado si no está establecido),low-price-raranking
,medium-price-reranking
yhigh-price-reranking
.diversityLevel
: Opcional Determina en qué medida se deben diversificar los resultados de las recomendaciones. Los valores permitidos sonno-diversity
(predeterminado),low-diversity
,medium-diversity
,high-diversity
yauto-diversity
. Si no se configuradiversityLevel
, se inhabilita la diversidad.diversityType
: Opcional Configúralo enRULE_BASED_DIVERSITY
para diversificar los resultados de las recomendaciones según la categoría de producto. Configúralo enDATA_DRIVEN_DIVERSITY
para diversificar las recomendaciones en función del aprendizaje de los metadatos del producto para equilibrar la relevancia y la diversidad de categorías. Si se configuradiversityLevel
, pero no se establecediversityType
,diversityType
se establece de forma predeterminada basada en reglas. Para obtener más información, consulta Diversificación.enableCategoryFilterLevel
: Opcional Establece si se deben agregar filtros de categoría adicionales en el modelo de elementos similares. Los valores permitidos sonrelaxed-category-match
(valor predeterminado si no está configurado) yno-category-match
.solutionTypes
: Obligatorio. Configúralo comoSOLUTION_TYPE_RECOMMENDATION
para los parámetros de configuración de entrega de las recomendaciones.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "modelId": "MODEL_ID", "priceRerankingLevel": "PRICE_RERANKING_LEVEL", "diversityType": "DIVERSITY_TYPE", "diversityLevel": "DIVERSITY_LEVEL", "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL", "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ] }' \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
search
Realiza una solicitud ServingConfig.create
con un ID de configuración de entrega y una instancia de ServingConfig
incluida en el cuerpo de la solicitud.
servingConfigId
: Obligatorio. Crea un ID para tuServingConfig
. Este valor debe tener entre 4 y 63 caracteres. Los caracteres válidos son/[a-z][0-9]-_/
.displayName
: Obligatorio. Es el nombreServingConfig
legible que se muestra en la consola de Search for Retail.facetControlIds
: Opcional Los IDs de los controles que solo tienen configuradoFacetSpec
.dynamicFacetSpec.mode
: Opcional Modo de la funciónDynamicFacet
Los valores permitidos sonDISABLED
(predeterminado si no está configurado) yENABLED
.boostControlIds
: Opcional IDs de los controles de entrega de boostingfilterControlIds
: Opcional IDs de los controles de entrega de filtros.redirectControlIds
: Opcional IDs de los controles de entrega de redireccionamiento.twowaySynonymsControlIds
: Opcional ID de los controles de entrega de sinónimos bidireccionales.onewaySynonymsControlIds
: Opcional ID de controles de entrega de sinónimos unidireccionales.doNotAssociateControlIds
: Opcional ID de controles de entrega no asociadosreplacementControlIds
: Opcional IDs de los controles de entrega de reemplazo.ignoreControlIds
: Opcional IDs de los controles de entrega de omisión.solutionTypes
: Obligatorio. Se establece enSOLUTION_TYPE_SEARCH
para los parámetros de configuración de entrega de búsqueda.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": DISPLAY_NAME, "facetControlIds": [ "FACET_CONTROL_ID_1", "FACET_CONTROL_ID_2" ], "dynamicFacetSpec": { "mode": "DYNAMIC_FACET_MODE" }, "boostControlIds": [ "BOOST_CONTROL_ID_1", "BOOST_CONTROL_ID_2" ], "filterControlIds": [ "FILTER_CONTROL_ID_1", "FILTER_CONTROL_ID_2" ], "redirectControlIds": [ "REDIRECT_CONTROL_ID_1", "REDIRECT_CONTROL_ID_2" ], "twowaySynonymsControlIds": [ "TWO_WAY_SYNONYM_CONTROL_ID_1", "TWO_WAY_SYNONYM_CONTROL_ID_2" ], "onewaySynonymsControlIds": [ "ONE_WAY_SYNONYM_CONTROL_ID_1", "ONE_WAY_SYNONYM_CONTROL_ID_2" ], "doNotAssociateControlIds": [ "DO_NOT_ASSOCIATE_CONTROL_ID_1", "DO_NOT_ASSOCIATE_CONTROL_ID_2" ], "replacementControlIds": [ "REPLACEMENT_CONTROL_ID_1", "REPLACEMENT_CONTROL_ID_2" ], "ignoreControlIds": [ "IGNORE_CONTROL_ID_1", "IGNORE_CONTROL_ID_2" ], "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ] }' \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
Próximos pasos
- Solicita predicciones desde tu posición nueva.