Crear 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 los parámetros de configuración de entrega individuales. Para obtener más información sobre la configuración de entrega, consulta Acerca de la configuración de entrega.

Los controles de entrega te permiten crear reglas que personalicen la forma en que los parámetros de configuración de entrega entregan resultados.

Puedes crear un control de entrega en la consola de Google Cloud que consista en una condición, que active el control, y una acción que se lleve a cabo cuando la condición se active. Luego, puedes adjuntar el control de entrega nuevo a una configuración de entrega.

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 varios parámetros de configuración de entrega.

Cuando creas controles de entrega y parámetros de configuración de entrega, seleccionas un producto (Recomendaciones IA o Retail Search) para el que se puede usar. Los controles de entrega solo se pueden asociar con la configuración de entrega del mismo tipo de producto. Por ejemplo, un control de entrega creado para Recomendaciones IA no se puede asociar con una configuración de entrega creada para Retail Search.

Los parámetros de configuración de entrega administran qué controles se aplican durante una solicitud de búsqueda o predicción. En el momento de la entrega, solo se tienen en cuenta los controles de la configuración de entrega activa para una solicitud. Por ejemplo, supongamos que creaste dos controles: un control llamado “Ofertas de gShoe” que potencia los resultados de la marca gShoe cuando se busca “calzado” y un control llamado “Más zapatos” que expande las consultas con el término “calzado para correr” para incluir “calzado deportivo”. Si adjuntas solo el control “gShoe Sale” a una configuración de entrega, las solicitudes de búsqueda que usen esa configuración aumentan los resultados de gShoe para las consultas que usan el término “zapatos”, pero el control “More Shoes” no tiene efecto porque no está conectado a la configuración de entrega que usas.

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

Crea o modifica los controles de entrega en cualquier momento en la página Controles o de forma intercalada con el método Controls.create. En la consola, tienes la opción de crear controles durante el proceso de creación de la configuración de entrega.

Puedes crear hasta 100 controles de entrega. Si necesitas más controles de entrega, solicita una cuota adicional. Si quieres solicitar una cuota adicional, consulta Aumenta tus cuotas. Una configuración de entrega puede tener hasta 100 controles de entrega de cualquier tipo, además de los de redireccionamiento, cuyo límite es de 1,000 por configuración de entrega.

Los controles de entrega están disponibles para las siguientes tareas:

  • Mejorar/ocultar: afecta la clasificación y el orden de los resultados en la lista de resultados que se muestra. Disponible para Retail Search y Recomendaciones IA.
  • Filter (Filtro): Quita los resultados que no pasan el filtro de la lista de resultados que se muestra. Disponible solo para Retail Search.
  • Redireccionamiento: Redirecciona a tus usuarios a una página específica según la búsqueda. Disponible solo para Retail Search.
  • Lingüística: Personaliza la lingüística de las búsquedas. Disponible solo para Retail Search. Hay 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.

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

Instructivo de control de redireccionamiento

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

Crea un control de entregas nuevo

Crea un control de entrega nuevo en la página Controles de la consola de Google Cloud o de forma intercalada con el método Controls.create.

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 mejorar y ocultar

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

Este tipo de control está disponible para Retail Search y Recomendaciones IA.

Sigue estos pasos para crear un control de mejorar o ocultar de Retail Search:

Consola

  1. Ve a la página Controles de Retail en Google Cloud Console.

    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.

En la sección Preferencias, haz lo siguiente:

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

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

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

  4. Elige Boost/bury controls como el tipo de control.

  5. Haga clic en Continuar para avanzar a la sección Activadores.

En la sección Activadores, establece las condiciones que activan el control:

  1. Selecciona el tipo de comportamiento del usuario que activa este control:

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

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

    Puedes configurar categorías o consultas específicas que puedan activar este control en el siguiente paso. Si deseas configurar este control para que se active cuando se explore cualquier categoría o si se busca alguna búsqueda, omite el siguiente paso.

  2. Opcional: Configura una condición de control que active la regla según si se explora una categoría específica o si se busca una búsqueda específica.

    Si deseas configurar este control para que se active en cualquier categoría o consulta, omite este paso.

    La opción disponible depende de si eliges Explorar categorías o Buscar:

    • Si eliges Explorar categorías, ingresa las categorías que activarán este control cuando explores en el campo Categorías.

    • Si eliges Buscar, haz clic en el botón Agregar consulta a fin de agregar los términos de búsqueda (por ejemplo, running shoes) que deseas filtrar y selecciona una de las siguientes opciones para cada término:

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

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

    Si especificas condiciones de intervalo de tiempo además de este tipo de condición, el control se aplica solo si se cumplen ambas condiciones.

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

    Si especificas una condición de condición de categoría o término de consulta además de las condiciones de intervalo de tiempo, el control se aplica solo cuando se cumplen ambas condiciones.

  4. Haga clic en Continuar para ir a la sección Acciones.

En la sección Acciones:

  1. Agrega filtros para los atributos de un producto en el campo Producto de buryterio.

    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"))

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

  3. Haga clic en Continuar para ir a la sección Configuración de entrega.

En la sección Configuración de entrega, haz lo siguiente:

  1. Selecciona a qué parámetros de configuración de entrega se aplicará el control.

  2. 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 los cambios se aplicaron 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 en el cuerpo de la solicitud.

Para obtener detalles del campo, consulta la referencia de la API de Controls y la referencia de la API de Controls.create.

Se puede activar un control de mejora/omisión cuando un usuario explora categorías de tu sitio (search.request.query está vacío) o cuando un usuario realiza búsquedas en tu sitio (search.request.query no está vacío).

En el siguiente ejemplo, se muestran campos para un control activado por navegación, en el que searchSolutionUseCase se configura como 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 campos para un control activado por búsqueda, en el que searchSolutionUseCase se configura como 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 los cambios se aplicaron en la página Evaluar de la consola.

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

Crea un control de mejora y ocultar de Recomendaciones IA

Siga estos pasos para crear un control mejorar y ocultar de Recomendaciones IA:

Consola

  1. Ve a la página Controles de Retail en Google Cloud Console.

    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.

En la sección Preferencias, haz lo siguiente:

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

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

  3. En la sección Selección de productos, selecciona Recomendación.

  4. Elige Boost/bury controls como el tipo de control.

  5. Haga clic en Continuar para ir a la sección Acciones.

En la sección Acciones:

  1. Agrega filtros para los atributos de un producto en el campo Producto de buryterio.

    Usa la sintaxis de expresión de filtro documentada en Recomendaciones de filtro.

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

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

  3. Haga clic en Continuar para ir a la sección Configuración de entrega.

En la sección Configuración de entrega, haz lo siguiente:

  1. Selecciona a qué parámetros de configuración de entrega se aplicará el control.

  2. 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 los cambios se aplicaron 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 en el cuerpo de la solicitud.

Para obtener detalles del campo, 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 documentada en Recomendaciones de filtro.

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 los cambios se aplicaron en la página Evaluar de la consola.

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

Crear un control de filtros

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

Consola

  1. Ve a la página Controles de Retail en Google Cloud Console.

    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.

En la sección Preferencias, haz lo siguiente:

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

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

  3. Elige Filtrar controles como el tipo de control.

  4. Haga clic en Continuar para avanzar a la sección Activadores.

En la sección Activadores, haz lo siguiente:

  1. Selecciona el tipo de comportamiento del usuario que activa este control:

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

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

  2. Opcional: Configura una condición de control que active la regla según la categoría que se explore o la búsqueda del elemento. La opción disponible depende de si eliges Explorar categorías o Buscar:

    • Si eliges Explorar categorías, ingresa las categorías que activarán este control cuando explores en el campo Categorías.

    • Si eliges Buscar, haz clic en el botón Agregar consulta a fin de agregar los términos de búsqueda (por ejemplo, running shoes) que deseas filtrar y selecciona una de las siguientes opciones para cada término:

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

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

    Si especificas una condición de intervalo de tiempo además de esta condición, el control se aplica solo si se cumplen ambas condiciones.

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

    Si especificas una categoría o una condición de término de consulta además de esta condición de intervalo de tiempo, el control solo se aplica cuando se cumplen ambas condiciones.

  4. Haga clic en Continuar para ir a la sección Acciones.

En la sección Acciones:

  1. Agregue filtros para los atributos de los productos en el campo Filter action.

    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"))

  2. Haga clic en Continuar para ir a la sección Configuración de entrega.

En la sección Configuración de entrega, haz lo siguiente:

  1. Selecciona a qué parámetros de configuración de entrega se aplicará el control.

  2. 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 los cambios se aplicaron 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 en el cuerpo de la solicitud.

Para obtener detalles del campo, consulta la referencia de la API de Controls y la referencia de la API de Controls.create.

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

En el siguiente ejemplo, se muestran campos para un control activado por navegación, en el que searchSolutionUseCase se configura como 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 campos para un control activado por búsqueda, en el que searchSolutionUseCase se configura como 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 entrega, 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

  1. Ve a la página Controles de Retail en Google Cloud Console.

    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.

En la sección Preferencias, haz lo siguiente:

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

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

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

  4. Haga clic en Continuar para avanzar a la sección Activadores.

En la sección Activadores, crea al menos un término de consulta o un activador de intervalo de tiempo. Los controles de redireccionamiento requieren al menos un activador:

  1. Selecciona el tipo de comportamiento del usuario que activa este control:

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

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

  2. Establece una condición de control que active la regla según la categoría en la que se navega o la búsqueda. La opción disponible depende de si eliges Explorar categorías o Buscar:

    • Si eliges Explorar categorías, ingresa las categorías que activarán este control cuando explores en el campo Categorías.

    • Si eliges Buscar, haz clic en el botón Agregar consulta a fin de agregar los términos de búsqueda (por ejemplo, running shoes) que deseas filtrar y selecciona una de las siguientes opciones para cada término:

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

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

    Si especificas una condición de intervalo de tiempo además de esta condición, el control se aplica solo si se cumplen ambas condiciones.

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

    Si especificas una categoría o una condición de término de consulta además de esta condición de intervalo de tiempo, el control solo se aplica cuando se cumplen ambas condiciones.

  4. Haga clic en Continuar para ir a la sección Acciones.

En la sección Acciones:

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

  2. Haga clic en Continuar para ir a la sección Configuración de entrega.

En la sección Configuración de entrega, haz lo siguiente:

  1. Selecciona a qué parámetros de configuración de entrega se aplicará el control.

  2. 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 los cambios se aplicaron 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 en el cuerpo de la solicitud.

Para obtener detalles del campo, 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 de tu sitio (search.request.query está vacío) o cuando un usuario realiza búsquedas en tu sitio (search.request.query no está vacío).

En el siguiente ejemplo, se muestran campos para un control activado por navegación, en el que searchSolutionUseCase se configura como 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 campos para un control activado por búsqueda, en el que searchSolutionUseCase se configura como 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 entrega, usa el método ServingConfig.addControl:

Cómo crear un control de sinónimos bidireccionales

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

Consola

  1. Ve a la página Controles de Retail en Google Cloud Console.

    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 control nuevo.

    Se abrirá el panel Crear control.

En la sección Preferencias, haz lo siguiente:

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

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

  3. Haga clic en Continuar para avanzar a la sección Activadores.

En la sección Activadores, haz lo siguiente:

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

  2. Haga clic en Continuar para ir a la sección Acciones.

En la sección Acciones:

  1. En el campo Sinónimos, ingresa de 2 a 100 términos de consulta (por ejemplo, shirt y top) que deben ser sinónimos entre sí.

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

  2. Haga clic en Continuar para ir a la sección Configuración de entrega.

En la sección Configuración de entrega, haz lo siguiente:

  1. Selecciona a qué parámetros de configuración de entrega se aplicará el control.

  2. 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 los cambios se aplicaron 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 en el cuerpo de la solicitud.

Para obtener detalles del campo, 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 entrega, usa el método ServingConfig.addControl. Consulta Agrega controles para entregar configuraciones intercaladas.

Cómo crear un control de sinónimos unidireccional

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

Consola

  1. Ve a la página Controles de Retail en Google Cloud Console.

    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.

En la sección Preferencias, haz lo siguiente:

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

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

  3. Elige Control de sinónimos unidireccionales como el tipo de control.

  4. Haga clic en Continuar para avanzar a la sección Activadores.

En la sección Activadores, haz lo siguiente:

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

  2. Haga clic en Continuar para ir a la sección Acciones.

En la sección Acciones:

  1. En el campo Términos de consulta, ingresa los términos (por ejemplo, shoes) que deben tener sinónimos asociados a ellos cuando se incluye alguno de ellos en una consulta.

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

  3. Haga clic en Continuar para ir a la sección Configuración de entrega.

En la sección Configuración de entrega, haz lo siguiente:

  1. Selecciona a qué parámetros de configuración de entrega se aplicará el control.

  2. 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 los cambios se aplicaron 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 en el cuerpo de la solicitud.

Para obtener detalles del campo, 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 entrega, usa el método ServingConfig.addControl:

Crea un control de no asociación

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

Consola

  1. Ve a la página Controles de Retail en Google Cloud Console.

    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.

En la sección Preferencias, haz lo siguiente:

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

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

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

  4. Haga clic en Continuar para avanzar a la sección Activadores.

En la sección Activadores, haz lo siguiente:

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

  2. Haga clic en Continuar para ir a la sección Acciones.

En la sección Acciones:

  1. En el campo Términos de consulta, ingresa los términos (por ejemplo, gShoe) que deseas desambiguar de forma explícita.

  2. En el campo Términos disociados, ingresa los términos que no deben asociarse en los resultados de la búsqueda con los términos de búsqueda que especificaste.

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

  3. Haga clic en Continuar para ir a la sección Configuración de entrega.

En la sección Configuración de entrega, haz lo siguiente:

  1. Selecciona a qué parámetros de configuración de entrega se aplicará el control.

  2. 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 los cambios se aplicaron 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 en el cuerpo de la solicitud.

Para obtener detalles del campo, 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"
                    ]
                  ]
                }
              }
    }' \
    "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 entrega, usa el método ServingConfig.addControl:

Cómo crear un control de omisión

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

Consola

  1. Ve a la página Controles de Retail en Google Cloud Console.

    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.

En la sección Preferencias, haz lo siguiente:

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

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

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

  4. Haga clic en Continuar para avanzar a la sección Activadores.

En la sección Activadores, haz lo siguiente:

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

  2. Haga clic en Continuar para ir a la sección Acciones.

En la sección Acciones:

  1. En el campo Ignorar términos, ingresa los términos (por ejemplo, shoddy) que deseas que una búsqueda ignore cuando se ingresan como términos de búsqueda.

  2. Haga clic en Continuar para ir a la sección Configuración de entrega.

En la sección Configuración de entrega, haz lo siguiente:

  1. Selecciona a qué parámetros de configuración de entrega se aplicará el control.

  2. 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 los cambios se aplicaron 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 en el cuerpo de la solicitud.

Para obtener detalles del campo, 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"
                    }
                  ]
                },
                "ignoreAction": {
                  "ignoreTerms": [
                      "IGNORE_TERM_1",
                      "IGNORE_TERM_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 entrega, usa el método ServingConfig.addControl:

Crea un control de reemplazo

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

Consola

  1. Ve a la página Controles de Retail en Google Cloud Console.

    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.

En la sección Preferencias, haz lo siguiente:

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

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

  3. Elige Control de reemplazo como el tipo de control.

  4. Haga clic en Continuar para avanzar a la sección Activadores.

En la sección Activadores, haz lo siguiente:

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

  2. Haga clic en Continuar para ir a la sección Acciones.

En la sección Acciones:

  1. En el campo Términos de consulta, ingresa los términos de consulta (por ejemplo, gShoe) que deseas reemplazar por el término de reemplazo.

  2. En el campo Término de reemplazo, ingresa el término que debe reemplazar los términos de consulta que especificaste.

    Por ejemplo, puedes reemplazar el término de búsqueda gShoe por el término de reemplazo Google Shoe.

  3. Haga clic en Continuar para ir a la sección Configuración de entrega.

En la sección Configuración de entrega, haz lo siguiente:

  1. Selecciona a qué parámetros de configuración de entrega se aplicará el control.

  2. 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 los cambios se aplicaron 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 en el cuerpo de la solicitud.

Para obtener detalles del campo, 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"
                    }
                  ]
                },
                "replacementAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "replacementTerm": "REPLACEMENT_TERM"
                  }
                }
              }
    }' \
    "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 entrega, usa el método ServingConfig.addControl: