Crea parámetros de configuración de entrega

En esta página, se describe cómo crear configuraciones de publicación. 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

Parámetros de configuración de entrega de búsquedas y recomendaciones tienen diferentes requisitos y opciones:

  • los parámetros de configuración de entrega de recomendaciones requieren un modelo. Si planeas adjuntar un modelo existente a una nueva configuración de publicación, 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 una nueva un modelo durante el proceso de creación en vez de adjuntar uno existente.

    Puedes cambiar de modelo más adelante, siempre que sea del mismo tipo.

  • La búsqueda puede usar controles de publicación, pero no son obligatorios. Si planeas adjuntar los controles existentes a una nueva configuración de entrega, IDs de los controles que planeas usar.

    Si creas la configuración de publicación con la consola, también puedes crear controles nuevos durante el proceso de creación.

    Puedes cambiar o agregar controles de entrega a tu configuración de entrega después cuando la creas.

Crea una configuración de entrega

Puedes crear una configuración de entrega con las siguientes opciones:

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. Borrar un la configuración de entrega borra la posición correspondiente y la eliminación de una posición borra su configuración de entrega correspondiente.

Crea una configuración de entrega en la consola

Agrega una nueva configuración de entrega Página de configuraciones de entrega en la Consola de Search for Retail.

Para crear una nueva configuración de entrega, sigue estos pasos:

  1. 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 entrega

  2. Haz clic en Crear una opción de configuración de entrega.

    recomendaciones

    1. Selecciona Recomendación (Recommendation) como el producto de la configuración de entrega. que se usará.

    2. 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.

    3. 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.

    4. 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.

    5. Selecciona la cantidad de tiempo que la reclasificación de precio debería afectar los resultados de la recomendación, 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.

    6. Selecciona si deseas usar una diversificación basada en reglas o en datos:

      • Basada en reglas: La diversificación basada en reglas afecta los resultados que se devuelven de una sola solicitud de predicción son diferentes categorías del 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 tu predicción resultados.

      Para obtener más información, consulta Diversificación.

    7. Selecciona cuánto quieres diversificar los resultados de recomendaciones.

    8. Si seleccionaste un modelo de elementos similares para esta configuración de entrega, elige si deseas habilitar la coincidencia de categorías.

      Cuando la coincidencia de categorías está habilitada, los únicos resultados de productos que se muestran son aquellos que comparten al menos una categoría con el producto de contexto. La coincidencia de categorías se puede usar en combinación con otros filtros como precio, disponibilidad y etiquetas de filtro.

    1. En la página Crear configuración de entrega, elige Búsqueda como el producto que la configuración de entrega. que se usará.
    2. Proporciona un nombre para tu configuración de entrega.

      Debe ser Debe tener 1,024 caracteres o menos y solo puede contener caracteres alfanuméricos. guiones bajos, guiones y espacios.
    3. Opcional: Si es necesario, actualiza el ID.

      El ID se genera a partir del nombre que proporciones y debe ser único en todo el proyecto. Debe ser 50 caracteres o menos, y no puede contener espacios.
    4. Haga clic en Continuar.
    5. Elige si quieres habilitar la creación de facetas dinámicas para esta configuración de publicación.
    6. Elige o crea controles de publicación para optimizar tus búsquedas.

      Para obtener más información información sobre los controles, consulta Cómo crear y administrar controles.

  3. 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.

  4. Opcional: En la página Opciones de 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.

Crear una configuración de entrega con ServingConfig.create

Puedes crear una configuración de entrega con la API de ServingConfig.create . Si quieres ver la 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 recomendaciones o búsquedas.

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 un instancia de ServingConfig que se encuentra en el cuerpo de la solicitud.

  • servingConfigId: Obligatorio. Crea un ID para tu ServingConfig. Esta debe tener entre 4 y 63 caracteres. Los caracteres válidos son /[a-z][0-9]-_/.
  • displayName: Obligatorio. El nombre ServingConfig legible que se muestra en la consola de Search for Retail.
  • modelID: Obligatorio. El ID del modelo que se usará al momento de la entrega.
  • priceRerankingLevel: Opcional Establece qué nivel de reclasificación de precio se debe realizar afectará los resultados de las recomendaciones. Los valores permitidos son no-price-reranking (valor predeterminado si no se establece), low-price-raranking, medium-price-reranking, y high-price-reranking.
  • diversityLevel: Opcional Establece cuánto se diversificarán los resultados de las recomendaciones. Los valores permitidos son no-diversity (predeterminado), low-diversity y medium-diversity, high-diversity y auto-diversity. Si no se configura diversityLevel, la diversidad se inhabilita.
  • diversityType: Opcional Configúralo en RULE_BASED_DIVERSITY para diversificar resultados de recomendaciones según la categoría de producto. Establecer en DATA_DRIVEN_DIVERSITY para diversificar las recomendaciones en función del aprendizaje desde metadatos de productos para equilibrar relevancia y diversidad de categorías. Si se establece diversityLevel, pero no se establece diversityType, De forma predeterminada, diversityType se basa en reglas. Para obtener más información, consulta Diversificación.
  • enableCategoryFilterLevel: Opcional Configura si se agregarán filtros de categorías en el modelo de Artículos similares Los valores permitidos son los siguientes: relaxed-category-match (valor predeterminado si no se establece) y no-category-match.
  • solutionTypes: Obligatorio. Se estableció en SOLUTION_TYPE_RECOMMENDATION para de entrega de 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 un instancia de ServingConfig que se encuentra en el cuerpo de la solicitud.

  • servingConfigId: Obligatorio. Crea un ID para tu ServingConfig. Esta debe tener entre 4 y 63 caracteres. Los caracteres válidos son /[a-z][0-9]-_/.
  • displayName: Obligatorio. El nombre ServingConfig legible que se muestra en la consola de Search for Retail.
  • facetControlIds: Opcional IDs de los controles que solo tienen FacetSpec automático.
  • dynamicFacetSpec.mode: Opcional Es el modo de la función DynamicFacet. Los valores permitidos son DISABLED (valor predeterminado si no se establece) y ENABLED.
  • boostControlIds: Opcional IDs de controles de mejora de la publicación.
  • filterControlIds: Opcional Son los IDs de los controles de entrega de filtros.
  • redirectControlIds: Opcional Son los IDs de los controles de publicación de redireccionamiento.
  • twowaySynonymsControlIds: Opcional IDs de los controles de publicación de sinónimos bidireccionales
  • onewaySynonymsControlIds: Opcional ID de publicación unidireccional de sinónimos controles de seguridad.
  • doNotAssociateControlIds: Opcional IDs de publicaciones no asociadas controles de seguridad.
  • replacementControlIds: Opcional IDs de los controles de entrega de reemplazo.
  • ignoreControlIds: Opcional IDs de los controles de publicación que deben ignorarse.
  • solutionTypes: Obligatorio. Se estableció en SOLUTION_TYPE_SEARCH para en la configuración de entrega de la 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