Crea controles de entrega

En esta página, se describe cómo crear controles de entrega.

Los controles de entrega son reglas que defines y aplicas a las configuraciones de entrega individuales.

Puedes crear un control de entrega en la consola de AI Commerce Search en Gemini Enterprise for Customer Experience que conste de una condición, que active el control, y una acción que se realice cuando la condición se active. Luego, puedes adjuntar el nuevo control de entrega a una configuración de entrega.

Relación entre los controles y las configuraciones de la publicación

Los parámetros de configuración de entrega tienen una relación de varios a varios con los controles. Puedes agregar varios controles a una configuración de entrega, y un solo control se puede asociar con varias configuraciones de entrega.

Cuando creas controles y parámetros de configuración de entrega, seleccionas un producto (recomendaciones o búsqueda) para el que se puede usar el control.

Los controles de entrega solo se pueden asociar con parámetros de configuración de entrega del mismo tipo de producto. Por ejemplo, un control de entrega creado para recomendaciones no se puede asociar con una configuración de entrega que se creó para la búsqueda.

Parámetros de configuración de entrega

Los parámetros de configuración de entrega administran qué controles se aplican durante una búsqueda o una solicitud de predicción. Solo se consideran los controles de la configuración de publicación activa para una solicitud en el momento de la publicación. Por ejemplo, supongamos que creaste dos controles: uno llamado Oferta de gShoe que mejora los resultados de la marca gShoe cuando se busca zapatos y otro llamado Más zapatos que expande las búsquedas con el término zapatos para correr para incluir zapatos deportivos. Si solo adjuntas el control gShoe Sale a una configuración de publicación, las solicitudes de búsqueda que usen esa configuración potenciarán los resultados de gShoe para las búsquedas que usen el término zapatos,pero el control More shoes no tendrá efecto porque no está adjunto a la configuración de publicación que estás usando.

Para obtener más información, consulta Acerca de los archivos de configuración de la entrega.

Videos y guías de inicio rápido

  • Introducción a los controles de entrega: Los controles de entrega te permiten crear reglas que personalizan la forma en que tus configuraciones de entrega muestran los resultados de la búsqueda.
  • Mejorar/ocultar: afecta la clasificación y el orden de los resultados en la lista de resultados que se muestra. Está disponible para la búsqueda y las recomendaciones.
  • Filter (Filtro): Quita los resultados que no pasan el filtro de la lista de resultados que se muestra. Solo está disponible para la búsqueda.
  • Redireccionamiento: Redirecciona a tus usuarios a una página específica según la búsqueda. Solo está disponible para la búsqueda.

En este instructivo, se muestra cómo usar el control de redireccionamiento.

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

GUIARME

  • Lingüística: Personaliza la lingüística de las búsquedas. Solo está disponible para la búsqueda.
    Existen varios tipos de controles lingüísticos disponibles:
    • Sinónimo: Expande los sinónimos considerados para una búsqueda.
    • Sinónimo unidireccional: Expande los sinónimos considerados unidireccionalmente para términos específicos.
    • No asociar: Evita que un grupo de términos se use en la búsqueda cuando aparecen términos específicos.
    • Ignorar: Evita que se use un término en las búsquedas.
    • Reemplazo: Reemplaza términos en la búsqueda.
  • Fijación: Afecta el orden de los resultados, ya que coloca un resultado en una posición específica, por ejemplo, en la posición 4. Disponible para la búsqueda y exploración.

Para ver ejemplos de estos controles, consulta Acerca de los controles de entrega.

Opciones de configuración de control de entrega

Puedes crear controles y, luego, agregarlos o cambiarlos a una configuración de entrega en vivo.

Puedes crear hasta 100 controles de entrega en la Búsqueda de comercio con IA. Si necesitas más controles de publicación, solicita una cuota adicional. Para ello, sigue los pasos que se indican en Aumenta tus cuotas.

Una configuración de entrega puede tener hasta 100 controles de entrega de cualquier tipo, con la excepción de los controles de redireccionamiento de búsqueda, cuyo límite puede ser de hasta 1,000 por configuración de entrega. Ten en cuenta que la cuota para los controles en una configuración de publicación puede diferir de la cuota general permitida para un tipo de control en tu API de AI Commerce Search.

Puedes crear un control de entrega de las siguientes maneras:

Para usar la consola de Google Cloud para crear controles de entrega, haz lo siguiente:

  1. Ve a la página Controles en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ir a la página Controles

  2. Sigue los pasos de la consola de Google Cloud en cada sección de control de la publicación.

Tipos de controles

Los controles tienen diferentes requisitos según su tipo. Ve al procedimiento de creación del tipo de control que planeas crear:

Crea un control de mejorar y ocultar

Este tipo de control está disponible para la búsqueda y las recomendaciones.

Consulta Controles de Mejorar/ocultar para obtener más información sobre este tipo de control.

Para crear un control de mejorar y ocultar la búsqueda, sigue estos pasos:

Consola de Cloud

  1. Ve a la página Controles en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ir a la página Controles

  2. En la pestaña Controles de entrega, haz clic en Crear control.

    Se abrirá el panel Crear control.

  3. En la sección Preferencias, en el campo Nombre del control, ingresa un nombre para el nuevo control.

  4. Opcional: Para cambiar el ID de control creado automáticamente, haz clic en Editar y, luego, ingresa un ID de control nuevo.

  5. En la sección Selección de productos, selecciona Buscar.

  6. Elige Controles para potenciar/ocultar como el tipo de control. Haz clic en Continuar.

  7. En la sección Activadores, selecciona qué tipo de comportamiento del usuario activa este control.

    • Explorar categorías: La regla se activa cuando un usuario explora categorías en tu sitio (search.request.query está vacío).

    • Search: La regla se activa cuando un usuario realiza una búsqueda en tu sitio (search.request.query no está vacío). Para configurar este control de modo que se active cuando se explore cualquier categoría o se busque cualquier consulta, omite el siguiente paso.

  8. Opcional: Establece categorías o búsquedas específicas que pueden activar este control, según si se explora una categoría específica o se busca una consulta específica.

    • Si elegiste Explorar categorías: En el campo Categorías, ingresa qué categorías activarán este control cuando se exploren.

    • Si elegiste Buscar, haz clic en el botón Agregar consulta para agregar términos de búsqueda (por ejemplo, running shoes) que se filtrarán. Para cada término, elige Concordancia parcial o Concordancia exacta.

  9. Opcional: Haz clic en el botón Agregar intervalo de tiempo para agregar uno o más intervalos de tiempo durante los cuales se puede aplicar este control.

  10. Haz clic en Continuar para ir a la sección Acciones.

  11. Agrega filtros para los atributos del producto en el campo Mejorar/ocultar producto.

    Usa la sintaxis de expresión de filtro documentada en Filtrado y orden. Por ejemplo, para especificar versiones rojas y azules de “product1” y “product2”: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

  12. Para Mejorar/ocultar valor, usa el control deslizante a fin de establecer la intensidad de la mejora. Los valores positivos mejoran los resultados y los valores negativos los ocultan. Haga clic en Continuar.

  13. En la sección Configuraciones de entrega, selecciona las configuraciones de entrega a las que se aplicará el control.

  14. Envía la configuración de control.

    Los controles recién creados o actualizados pueden tardar unos minutos en estar listos para entregar tráfico en vivo. Puedes probar si se aplicaron los cambios en la página Evaluar de la consola.

Ahora puedes encontrar el nuevo control en la pestaña Controles de entrega de la página Controles.

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control incluida en el cuerpo de la solicitud.

Para obtener detalles sobre los campos, consulta la referencia de la API de Controls y la referencia de la API de Controls.create.

Se puede activar un control de refuerzo o de ocultamiento cuando un usuario navega por las categorías de tu sitio (search.request.query está vacío) o cuando realiza una búsqueda en él (search.request.query no está vacío).

En el siguiente ejemplo, se muestran los campos de un control activado por la navegación, en el que searchSolutionUseCase se establece en SEARCH_SOLUTION_USE_CASE_BROWSE.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

En el siguiente ejemplo, se muestran los campos de un control activado por la búsqueda, en el que searchSolutionUseCase se establece en SEARCH_SOLUTION_USE_CASE_SEARCH.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Los controles recién creados o actualizados pueden tardar unos minutos en estar listos para entregar tráfico en vivo. Puedes probar si se aplicaron los cambios en la página Evaluar de la consola.

Para agregar un control a una configuración de publicación, usa el método ServingConfig.addControl:

Crea un control de potenciación o ocultamiento de recomendaciones

Sigue estos pasos para crear un control de refuerzo o eliminación de recomendaciones:

Consola de Cloud

  1. Ve a la página Controles en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ir a la página Controles

  2. En la pestaña Controles de entrega, haz clic en Crear control.

    Se abrirá el panel Crear control.

  3. En la sección Preferencias, en el campo Nombre del control, ingresa un nombre para el nuevo control.

  4. (Opcional) Para cambiar el ID de control creado automáticamente, haz clic en Editar y, luego, ingresa un ID de control nuevo.

  5. En la sección Selección de producto, selecciona Recomendación.

  6. Elige Controles para potenciar/ocultar como el tipo de control.

  7. Haz clic en Continuar para ir a la sección Acciones.

  8. Agrega filtros para los atributos del producto en el campo Mejorar/ocultar producto.

    Usa la sintaxis de expresión de filtro documentada en Filtra recomendaciones.

    Por ejemplo, para especificar versiones rojas y azules de “product1” y “product2”: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

  9. Para Mejorar/ocultar valor, usa el control deslizante a fin de establecer la intensidad de la mejora. Los valores positivos mejoran los resultados y los valores negativos los ocultan.

  10. Haz clic en Continuar para ir a la sección Configuraciones de entrega.

  11. Selecciona las configuraciones de entrega a las que se aplicará el control.

  12. Envía la configuración de control.

    Los controles recién creados o actualizados pueden tardar unos minutos en estar listos para entregar tráfico en vivo. Puedes probar si se aplicaron los cambios en la página Evaluar de la consola.

Puedes encontrar el nuevo control enumerado en la pestaña Controles de entrega de la página Controles.

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control incluida en el cuerpo de la solicitud.

Para obtener detalles sobre los campos, consulta la referencia de la API de Controls y la referencia de la API de Controls.create.

Para crear una expresión de filtro, usa la sintaxis de expresión de filtro que se documenta en Filtra 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",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ],
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Los controles recién creados o actualizados pueden tardar unos minutos en estar listos para entregar tráfico en vivo. Puedes probar si se aplicaron los cambios en la página Evaluar de la consola.

Para agregar un control a una configuración de publicación, usa el método ServingConfig.addControl:

Crea un control de filtro

Consulta Controles de filtros para obtener más información sobre este tipo de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ir a la página Controles

  2. En la pestaña Controles de entrega, haz clic en Crear control.

    Se abrirá el panel Crear control.

  3. En la sección Preferencias, en el campo Nombre del control, ingresa un nombre para el nuevo control.

  4. Opcional: Para cambiar el ID de control creado automáticamente, haz clic en Editar y, luego, ingresa un ID de control nuevo.

  5. Elige Controles de filtros como el tipo de control.

  6. Haz clic en Continuar para ir a la sección Activadores.

  7. Selecciona qué tipo de comportamiento del usuario activa este control:

    • Explorar categorías: La regla se activa cuando un usuario explora categorías en tu sitio (search.request.query está vacío).

    • Search: La regla se activa cuando un usuario realiza una búsqueda en tu sitio (search.request.query no está vacío).

  8. Opcional: Establece una condición de control que active la regla según la categoría que se explora o la búsqueda que se realiza. La opción disponible depende de si elegiste Explorar categorías o Buscar:

    • Si elegiste Explorar categorías: En el campo Categorías, ingresa qué categorías activarán este control cuando se exploren.

    • Si elegiste Búsqueda, haz clic en el botón Agregar consulta para agregar términos de búsqueda (por ejemplo, running shoes) que se filtrarán y selecciona una de las siguientes opciones para cada término:

      • Coincidencia parcial: Este control se aplica cuando una búsqueda contiene una coincidencia parcial con este término de búsqueda.
      • Concordancia completa: Este control solo se aplica cuando una búsqueda contiene una coincidencia completa con este término de búsqueda.

      Cuando se incluye uno de estos términos en una búsqueda, se aplica el control.

  9. Opcional: Haz clic en el botón Agregar intervalo de tiempo para agregar uno o más intervalos de tiempo durante los cuales se puede aplicar este control.

  10. Haz clic en Continuar para ir a la sección Acciones.

  11. Agrega filtros para los atributos del producto en el campo Acción de filtro.

    Usa la sintaxis de expresión de filtro documentada en Filtrado y orden.

    Por ejemplo, para especificar versiones rojas y azules de “product1” y “product2”: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

  12. Haz clic en Continuar para ir a la sección Configuraciones de entrega.

  13. Selecciona las configuraciones de entrega a las que se aplicará el control.

  14. Envía la configuración de control.

    Los controles recién creados o actualizados pueden tardar unos minutos en estar listos para entregar tráfico en vivo. Puedes probar si se aplicaron los cambios en la página Evaluar de la consola.

Puedes encontrar el nuevo control enumerado en la pestaña Controles de entrega de la página Controles.

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control incluida en el cuerpo de la solicitud.

Para obtener detalles sobre los campos, consulta la referencia de la API de Controls y la referencia de la API de Controls.create.

Se puede activar un control de filtro cuando un usuario explora categorías en tu sitio (search.request.query está vacío) o cuando realiza una búsqueda en tu sitio (search.request.query no está vacío).

En el siguiente ejemplo, se muestran los campos de un control activado por la navegación, en el que searchSolutionUseCase se establece en SEARCH_SOLUTION_USE_CASE_BROWSE.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

En el siguiente ejemplo, se muestran los campos de un control activado por la búsqueda, en el que searchSolutionUseCase se establece en SEARCH_SOLUTION_USE_CASE_SEARCH.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Para agregar un control a una configuración de publicación, usa el método ServingConfig.addControl:

Crea un control de redireccionamiento

Consulta Controles de redireccionamiento para obtener más información sobre este tipo de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ir a la página Controles

  2. En la pestaña Controles de entrega, haz clic en Crear control.

    Se abrirá el panel Crear control.

  3. En la sección Preferencias, en el campo Nombre del control, ingresa un nombre para el nuevo control.

  4. Opcional: Para cambiar el ID de control creado automáticamente, haz clic en Editar y, luego, ingresa un ID de control nuevo.

  5. Elige Controles de redireccionamiento como el tipo de control.

  6. Haz clic en Continuar para ir a la sección Activadores.

  7. Crea al menos un activador de período o término de búsqueda. Los controles de redireccionamiento requieren al menos un activador:

  8. Selecciona qué tipo de comportamiento del usuario activa este control:

    • Explorar categorías: La regla se activa cuando un usuario explora categorías en tu sitio (search.request.query está vacío).

    • Search: La regla se activa cuando un usuario realiza una búsqueda en tu sitio (search.request.query no está vacío).

  9. Establece una condición de control que active la regla según la categoría que se explora o la búsqueda que se realiza. La opción disponible depende de si elegiste Explorar categorías o Buscar:

    • Si elegiste Explorar categorías: En el campo Categorías, ingresa qué categorías activarán este control cuando se exploren.

    • Si elegiste Búsqueda, haz clic en el botón Agregar consulta para agregar términos de búsqueda (por ejemplo, running shoes) que se filtrarán y selecciona una de las siguientes opciones para cada término:

      • Coincidencia parcial: Este control se aplica cuando una búsqueda contiene una coincidencia parcial con este término de búsqueda.
      • Concordancia completa: Este control solo se aplica cuando una búsqueda contiene una coincidencia completa con este término de búsqueda.

      Cuando se incluye uno de estos términos en una búsqueda, se aplica el control.

  10. Haz clic en el botón Agregar intervalo de tiempo para agregar uno o más intervalos de tiempo durante los cuales se puede aplicar este control.

  11. Haz clic en Continuar para ir a la sección Acciones.

  12. Ingresa el URI al que se redireccionará cuando se active este control.

  13. Haz clic en Continuar para ir a la sección Configuraciones de entrega.

  14. Selecciona las configuraciones de entrega a las que se aplicará el control.

  15. Envía la configuración de control.

    Los controles recién creados o actualizados pueden tardar unos minutos en estar listos para entregar tráfico en vivo. Puedes probar si se aplicaron los cambios en la página Evaluar de la consola.

Puedes encontrar el nuevo control enumerado en la pestaña Controles de entrega de la página Controles.

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control incluida en el cuerpo de la solicitud.

Para obtener detalles sobre los campos, consulta la referencia de la API de Controls y la referencia de la API de Controls.create.

Se puede activar un control de redireccionamiento cuando un usuario explora categorías en tu sitio (search.request.query está vacío) o cuando realiza una búsqueda en él (search.request.query no está vacío).

En el siguiente ejemplo, se muestran los campos de un control activado por la navegación, en el que searchSolutionUseCase se establece en SEARCH_SOLUTION_USE_CASE_BROWSE.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

En el siguiente ejemplo, se muestran los campos de un control activado por la búsqueda, en el que searchSolutionUseCase se establece en SEARCH_SOLUTION_USE_CASE_SEARCH.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Para agregar un control a una configuración de publicación, usa el método ServingConfig.addControl:

Cómo crear un control de sinónimos bidireccional

Consulta Controles de sinónimos bidireccionales para obtener más información sobre este tipo de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ir a la página Controles

  2. En la pestaña Controles de entrega, haz clic en Crear control.

  3. En el campo Nombre del control, ingresa un nombre para el nuevo control.

    Se abrirá el panel Crear control.

  4. Estarás en la sección Preferencias.

  5. Opcional: Para cambiar el ID de control creado automáticamente, haz clic en Editar y, luego, ingresa un ID de control nuevo.

  6. Elige Control de sinónimos bidireccionales como el tipo de control.

  7. Haz clic en Continuar para ir a la sección Activadores.

  8. Opcional: Haz clic en el botón Agregar intervalo de tiempo para agregar uno o más intervalos de tiempo durante los cuales se puede aplicar este control.

  9. Haz clic en Continuar para ir a la sección Acciones.

  10. En el campo Sinónimos, ingresa entre 2 y 100 términos de búsqueda (por ejemplo, shirt y top) que deberían ser sinónimos entre sí.

    Cuando cualquiera de estos términos se incluye en una búsqueda, esta considera los otros términos de búsqueda como sinónimos del término incluido.

  11. Haz clic en Continuar para ir a la sección Configuraciones de entrega.

  12. Selecciona las configuraciones de entrega a las que se aplicará el control.

  13. Envía la configuración de control.

    Los controles recién creados o actualizados pueden tardar unos minutos en estar listos para entregar tráfico en vivo. Puedes probar si se aplicaron los cambios en la página Evaluar de la consola.

Puedes encontrar el nuevo control enumerado en la pestaña Controles de entrega de la página Controles.

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control incluida en el cuerpo de la solicitud.

Para obtener detalles sobre los campos, consulta la referencia de la API de Controls y la referencia de la API de Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                    ]
                },
                "twoWaySynonymAction": {
                  "synonyms": [
                    "SYNONYM_1",
                    "SYNONYM_2"
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Para agregar un control a una configuración de publicación, usa el método ServingConfig.addControl. Consulta Cómo agregar controles a las configuraciones de entrega de forma intercalada.

Cómo crear un control de sinónimos unidireccional

Consulta Controles de sinónimo unidireccional para obtener más información sobre este tipo de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ir a la página Controles

  2. En la pestaña Controles de entrega, haz clic en Crear control.

    Se abrirá el panel Crear control.

  3. En la sección Preferencias, en el campo Nombre del control, ingresa un nombre para el nuevo control.

  4. Opcional: Para cambiar el ID de control creado automáticamente, haz clic en Editar y, luego, ingresa un ID de control nuevo.

  5. Elige Control de sinónimo unidireccional como el tipo de control.

  6. Haz clic en Continuar para ir a la sección Activadores.

  7. Opcional: Haz clic en el botón Agregar intervalo de tiempo para agregar uno o más intervalos de tiempo durante los cuales se puede aplicar este control.

  8. Haz clic en Continuar para ir a la sección Acciones.

  9. En el campo Términos de búsqueda, ingresa términos (por ejemplo, shoes) que deberían tener sinónimos asociados cuando se incluya alguno de ellos en una búsqueda.

  10. En el campo Sinónimos, ingresa los términos que se deben usar como sinónimos de los términos de búsqueda que especificaste (por ejemplo, sneakers y sandals como sinónimos unidireccionales del término de búsqueda shoes).

  11. Haz clic en Continuar para ir a la sección Configuraciones de entrega.

  12. Selecciona las configuraciones de entrega a las que se aplicará el control.

  13. Envía la configuración de control.

    Los controles recién creados o actualizados pueden tardar unos minutos en estar listos para entregar tráfico en vivo. Puedes probar si se aplicaron los cambios en la página Evaluar de la consola.

Puedes encontrar el nuevo control enumerado en la pestaña Controles de entrega de la página Controles.

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control incluida en el cuerpo de la solicitud.

Para obtener detalles sobre los campos, consulta la referencia de la API de Controls y la referencia de la API de Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Para agregar un control a una configuración de publicación, usa el método ServingConfig.addControl:

Cómo crear un control de no asociación

Consulta Reglas de control de no asociar para obtener más información sobre este tipo de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de AI Commerce Search en Gemini Enterprise para la experiencia del cliente.

    Ir a la página Controles

  2. En la pestaña Controles de entrega, haz clic en Crear control.

    Se abrirá el panel Crear control.

  3. En la sección Preferencias, en el campo Nombre del control, ingresa un nombre para el nuevo control.

  4. Opcional: Para cambiar el ID de control creado automáticamente, haz clic en Editar y, luego, ingresa un ID de control nuevo.

  5. Elige No asociar control como el tipo de control.

  6. Haz clic en Continuar para ir a la sección Activadores.

  7. Opcional: Haz clic en el botón Agregar intervalo de tiempo para agregar uno o más intervalos de tiempo durante los cuales se puede aplicar este control.

  8. Haz clic en Continuar para ir a la sección Acciones.

  9. En el campo Términos de búsqueda, ingresa los términos (por ejemplo, gShoe) que deseas desambiguar explícitamente de otros.

  10. En el campo Términos disociados, ingresa los términos que se deben disociar de los resultados de la búsqueda con los términos de búsqueda que especificaste.

    Por ejemplo, puedes disociar el término de búsqueda gShoe del término cheap.

  11. Haz clic en Continuar para ir a la sección Configuraciones de entrega.

  12. Selecciona las configuraciones de entrega a las que se aplicará el control.

  13. Envía la configuración de control.

    Los controles recién creados o actualizados pueden tardar unos minutos en estar listos para entregar tráfico en vivo. Puedes probar si se aplicaron los cambios en la página Evaluar de la consola.

Puedes encontrar el nuevo control enumerado en la pestaña Controles de entrega de la página Controles.

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control incluida en el cuerpo de la solicitud.

Para obtener detalles sobre los campos, consulta la referencia de la API de Controls y la referencia de la API de Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "doNotAssociateAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "doNotAssociateTerms": [
                      "DISSOCIATED_TERM_1",
                      "DISSOCIATED_TERM_2"
                    ]
                  ]
                }