Crea controles de entrega

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

Los controles de publicación son reglas que defines y aplicas a las configuraciones de publicación individuales. Para obtener más información sobre las configuraciones de publicación, consulta Acerca de las configuraciones de publicación.

Los controles de entrega te permiten crear reglas que personalicen la forma en que tus configuraciones de entrega entregan resultados.

Puedes crear un control de entrega en la consola de Search for Retail compuesto por una condición, que activa el control, y una acción que realiza cuando la condición se active. Luego, puedes adjuntar el nuevo control de entrega a una configuración de entrega.

Los parámetros de configuración de entrega tienen una relación de varios a múltiples con los controles. Puedes agregar varios controles a una configuración de entrega asociados con varios parámetros de configuración de entrega.

Cuando creas controles de entrega y parámetros de configuración de entrega, debes seleccionar un producto (recomendaciones o búsqueda) que pueda que se usará. Los controles de entrega solo se pueden asociar con los parámetros de configuración de entrega del mismo tipo de producto. Por ejemplo, un control de entrega creado para las recomendaciones no se pueden asociar con una configuración de entrega que se creó para la búsqueda.

Los parámetros de configuración de entrega administran qué controles se aplican durante una búsqueda o en una solicitud de predicción en particular. Solo los controles en la configuración de entrega activa para un se consideran en el momento de la publicación. Por ejemplo, supongamos que creaste dos controles: uno llamado "Venta de gShoe" que potencia los resultados de la marca gShoe cuando "shoes" y un control llamado "Más calzado" que expande las búsquedas con el término "calzado para correr" incluir "calzado deportivo". Si agregar solo la columna "Venta de gShoe" a una configuración de entrega, buscar solicitudes usar esa configuración de entrega mejora los resultados de gShoe para las búsquedas que usan el término "calzado", pero el botón "Más zapatos" el control no tiene efecto porque no con la configuración de entrega que estás usando.

Puedes crear controles y, luego, agregarlos o intercambiarlos en una publicación configuración.

Crea o modifica los controles de entrega en cualquier momento en la 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 publicación. Si necesitas más controles de entrega solicitar una cuota adicional. Para saber cómo 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 controles de redireccionamiento, cuyo límite es 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 búsquedas y recomendaciones.
  • Filter (Filtro): Quita los resultados que no pasan el filtro de la lista de resultados que se muestra. Disponible solo para 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.
  • Lingüística: Personaliza la lingüística de las búsquedas. Disponible solo para la búsqueda. 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 publicación.

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 nuevo control de entrega en la Página Controles en la Consola de Google Cloud o de forma intercalada con el método Controls.create

Los controles tienen diferentes requisitos según su tipo. Ir a la creación procedimiento para el tipo de control que planeas crear:

Crea un control para mejorar o ocultar contenido

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

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

Sigue estos pasos para crear un control de mejorar y ocultar la búsqueda:

Console

  1. Ve a la página Controles en la consola de Search for Retail.

    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 Preferences, 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, elige Buscar.

  4. Elige Controles mejorar y ocultar como el tipo de control.

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

En la sección Activadores, establece las condiciones que activen 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 en tu sitio (search.request.query es vacía).

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

    Puedes establecer categorías o búsquedas específicas que pueden activar este control. en el siguiente paso. Configurar este control para que se active cuando se active cualquier categoría se explora o se busca cualquier consulta, omite el siguiente paso.

  2. Opcional: establezca una condición de control que active la regla según si se produce un cuando se explora una categoría específica o se busca una consulta específica.

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

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

    • Si eliges Explorar categorías: En el campo Categorías, ingresa lo siguiente: qué categorías activarán este control cuando se explore.

    • Si seleccionaste Buscar, haz clic en el botón Agregar consulta para agregar una consulta. términos (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 consulta contiene un concordancia parcial con este término de consulta.
      • Concordancia completa: este control se aplica solo cuando una consulta contiene un concordancia 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 , 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 condición de término de búsqueda además de un tiempo de rango, el control se aplica solo cuando ambas condiciones se se cumplen.

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

En la sección Acciones, haz lo siguiente:

  1. Agrega filtros para los atributos de producto en el campo Mejorar y 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"))

  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. Haz clic en Continuar para ir a la sección Configuración de entrega.

En la sección Serving configs, 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 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 un instancia de Control que se encuentra en el cuerpo de la solicitud.

Para obtener más información sobre los campos, consulta la La referencia de la API de Controls y la Referencia de la API de Controls.create.

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

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

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

Crea un control de mejora y ocultamiento de recomendaciones

Sigue estos pasos para crear un control de mejora y ocultamiento de recomendaciones:

Console

  1. Ve a la página Controles en la consola de Search for Retail.

    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 Preferences, 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, elige Recomendación.

  4. Elige Controles mejorar y ocultar como el tipo de control.

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

En la sección Acciones, haz lo siguiente:

  1. Agrega filtros para los atributos de producto en el campo Mejorar y 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"))

  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. Haz clic en Continuar para ir a la sección Configuración de entrega.

En la sección Serving configs, 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 tus cambios se aplicaron en 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 un instancia de Control que se encuentra 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 documentada en Filtrar 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 entrega, usa ServingConfig.addControl. método:

Crea un control de filtros

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

Console

  1. Ve a la página Controles en la consola de Search for Retail.

    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 Preferences, 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 filtro como el tipo de control.

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

En la sección Activadores, haz lo siguiente:

  1. 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 es vacía).

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

  2. Opcional: Establece una condición de control que active la regla en función de lo que qué categoría se explora o qué búsqueda se busca. La opción disponible depende de si elegiste Explorar categorías o Buscar:

    • Si eliges Explorar categorías: En el campo Categorías, ingresa lo siguiente: qué categorías activarán este control cuando se explore.

    • Si seleccionaste Buscar, haz clic en el botón Agregar consulta para agregar una consulta. términos (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 consulta contiene un concordancia parcial con este término de consulta.
      • Concordancia completa: este control se aplica solo cuando una consulta contiene un concordancia 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 el control solo se aplica 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, además de esta condición, especifica una categoría o un término de búsqueda condición de intervalo de tiempo, el control se aplica solo cuando ambas condiciones los objetivos de la empresa.

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

En la sección Acciones, haz lo siguiente:

  1. Agrega filtros para los atributos de 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"))

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

En la sección Serving configs, 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 tus cambios se aplicaron en 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 un instancia de Control que se encuentra 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 filtros cuando un usuario explora categorías de tu sitio (search.request.query está vacío) o cuando un usuario búsquedas en tu sitio (search.request.query no está vacía).

En el siguiente ejemplo, se muestran campos para un control activado por navegación, en los 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 los 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 ServingConfig.addControl. método:

Crea un control de redireccionamiento

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

Console

  1. Ve a la página Controles en la consola de Search for Retail.

    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 Preferences, 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 ID de control nuevo.

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

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

En la sección Activadores, crea al menos un término de consulta o un intervalo de tiempo. un activador. 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 en tu sitio (search.request.query es vacía).

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

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

    • Si eliges Explorar categorías: En el campo Categorías, ingresa lo siguiente: qué categorías activarán este control cuando se explore.

    • Si seleccionaste Buscar, haz clic en el botón Agregar consulta para agregar una consulta. términos (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 consulta contiene un concordancia parcial con este término de consulta.
      • Concordancia completa: este control se aplica solo cuando una consulta contiene un concordancia 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, 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 en las que se puede aplicar este control.

    Si, además de esta condición, especifica una categoría o un término de búsqueda condición de intervalo de tiempo, el control se aplica solo cuando ambas condiciones los objetivos de la empresa.

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

En la sección Acciones, haz lo siguiente:

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

  2. Haz clic en Continuar para ir a la sección Configuraciones de publicación.

En la sección Serving configs, 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 tus cambios se aplicaron en 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 contenida en el cuerpo de la solicitud.

Para obtener más información sobre los campos, consulta la 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 búsquedas en tu sitio (search.request.query no está vacía).

En el siguiente ejemplo, se muestran campos para un control activado por navegación, en los 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 los 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 ServingConfig.addControl. método:

Crear un control de sinónimos bidireccionales

Consulte los controles de sinónimos bidireccionales para obtener más información al respecto. tipo de control.

Console

  1. Ve a la página Controles en la consola de Search for Retail.

    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 Preferences, 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. Haz clic en Continuar para ir a la sección Activadores.

Haz lo siguiente en la sección Activadores:

  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. Haz clic en Continuar para ir a la sección Acciones.

En la sección Acciones, haz lo siguiente:

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

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

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

En la sección Serving configs, 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 tus cambios se aplicaron en 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 un instancia de Control que se encuentra en el cuerpo de la solicitud.

Para obtener más información sobre los campos, consulta la 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 ServingConfig.addControl. Consulta Cómo agregar controles a las configuraciones de publicación intercaladas.

Crear un control de sinónimos unidireccional

Consulte Controles de sinónimos unidireccionales para obtener más información sobre este control el tipo de letra.

Console

  1. Ve a la página Controles en la consola de Search for Retail.

    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 Preferences, 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 ID de control nuevo.

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

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

Haz lo siguiente en la sección Activadores:

  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. Haz clic en Continuar para ir a la sección Acciones.

En la sección Acciones, haz lo siguiente:

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

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

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

En la sección Serving configs, 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 tus cambios se aplicaron en 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 contenida en el cuerpo de la solicitud.

Para obtener más información sobre los campos, consulta la 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 ServingConfig.addControl. método:

Cómo crear un control de no asociar

Consulta Controles de no asociar para obtener más información al respecto. tipo de control.

Console

  1. Ve a la página Controles en la consola de Search for Retail.

    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 Preferences, 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 no asociar como el tipo de control.

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

Haz lo siguiente en la sección Activadores:

  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. Haz clic en Continuar para ir a la sección Acciones.

En la sección Acciones, haz lo siguiente:

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

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

    Por ejemplo, puedes disociar el término de consulta gShoe del término cheap.

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

En la sección Serving configs, 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 tus cambios se aplicaron en 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 contenida en el cuerpo de la solicitud.

Para obtener más información sobre los campos, consulta la 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 publicación, usa el método ServingConfig.addControl:

Crea un control de omisión

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

Console

  1. Ve a la página Controles en la consola de Search for Retail.

    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 Preferences, 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 no asociar como el tipo de control.

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

Haz lo siguiente en la sección Activadores:

  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. Haz clic en Continuar para ir a la sección Acciones.

En la sección Acciones, haz lo siguiente:

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

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

En la sección Serving configs, 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 tus cambios se aplicaron en 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 un instancia de Control que se encuentra 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"
                    }
                  ]
                },
                "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 publicación, usa el método ServingConfig.addControl:

Cómo crear un control de reemplazo

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

Console

  1. Ve a la página Controles en la consola de Search for Retail.

    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 Preferences, 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. Haz clic en Continuar para ir a la sección Activadores.

Haz lo siguiente en la sección Activadores:

  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. Haz clic en Continuar para ir a la sección Acciones.

En la sección Acciones, haz lo siguiente:

  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 a los términos de consulta que especificaste.

    Por ejemplo, puedes reemplazar el término de consulta gShoe con el término de reemplazo término Google Shoe.

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

En la sección Serving configs, 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 tus cambios se aplicaron en 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 contenida 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"
                    }
                  ]
                },
                "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 ServingConfig.addControl. método: