Esta es la documentación de Recomendaciones IA, Retail Search y la nueva consola de Retail.

Cómo crear y administrar controles

En esta página, se describe cómo agregar, ver, editar y borrar controles.

  • Los controles de entrega son reglas que defines y aplicas a las configuraciones de entrega individuales de la búsqueda de venta minorista. Para obtener más información sobre la configuración de entrega, consulta Configuración de entrega.
  • Los controles de todo el sitio se aplican a todos los resultados de la búsqueda de venta minorista.

Controles de entrega

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

En Cloud Console, puedes crear un control de entrega que consta de una condición, que activa el control, y una acción que se realiza cuando se activa la condición. Luego, puedes adjuntar el nuevo control de entrega a cualquier configuración de entrega de la Búsqueda de entrega minorista que hayas creado.

Las configuraciones de entrega de búsqueda de venta minorista tienen una relación de varios a varios con los controles. Puedes agregar varios controles a una configuración de entrega, y un solo control se puede asociar con varias configuraciones de entrega.

Las configuraciones de entrega administran qué controles se pueden aplicar. Solo se tienen en cuenta los controles de la configuración de entrega activa para una solicitud en el momento de la entrega.

Puedes crear controles y, luego, agregarlos o cambiarlos a una configuración de entrega de búsqueda de venta minorista en vivo.

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

Puedes crear hasta 1,000 controles de entrega. 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 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.
  • Filter (Filtro): Quita los resultados que no pasan el filtro de la lista de resultados que se muestra.
  • Redireccionamiento: Redirecciona a tus usuarios a una página específica según la búsqueda.
  • Lingüística: Personaliza la lingüística de las búsquedas. Existen varios tipos de controles lingüísticos disponibles:
    • Sinónimo: Expande los sinónimos considerados para una búsqueda.
    • Sinónimo unidireccional: Expande los sinónimos considerados unidireccionalmente para términos específicos.
    • No asociar: Evita que un grupo de términos se use en la búsqueda cuando aparecen términos específicos.
    • Ignorar: Evita que se use un término en las búsquedas.
    • Reemplazo: Reemplaza términos en la búsqueda.

Para ver ejemplos de estos controles, consulta Controles de entrega.

Instructivo de control de redireccionamiento

En este instructivo, aprenderás a usar el control de redireccionamiento.


Para obtener orientación paso a paso directamente sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

Guiarme


En las siguientes secciones, se explican los mismos pasos que cuando se hace clic en Guiarme.

Crea un control de entregas nuevo

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

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

Crea un control de refuerzo/bury

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

Console

  1. Ve a la página Controles de venta minorista 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 en el campo Nombre del control y, luego, ingresa un ID de control nuevo (opcional).

  3. Elige el tipo de control Boost/bury controls.

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

En la sección Activadores, haz lo siguiente:

  1. Haz clic en el botón Agregar consulta (Add query) para agregar términos de consulta (por ejemplo, running shoes) a fin de que se aumenten o sean enterrados, 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.
    • Coincidencia completa: este control se aplica solo 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 solo se aplicará si se cumplen ambas condiciones.

  2. Haz clic en el botón Agregar intervalo para agregar uno o más intervalos durante los cuales se puede aplicar este control (opcional).

    Si especificas una condición de término de consulta además de esta condición de intervalo de tiempo, el control solo se aplicará cuando se cumplan ambas condiciones.

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

En la sección Acciones:

  1. Agrega filtros para los atributos del producto en el campo Producto de refuerzo/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. Haga clic en Continuar para ir a la sección Configuración de publicación.

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

  1. Selecciona las configuraciones de entrega a las que 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 una instancia de Control en el cuerpo de la solicitud.

Para obtener más detalles sobre el 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": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

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

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 de venta minorista 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 en el campo Nombre del control y, luego, ingresa un ID de control nuevo (opcional).

  3. Elija Controles de filtro como el tipo de control.

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

En la sección Activadores, haz lo siguiente:

  1. Haz clic en el botón Agregar consulta para agregar términos de consulta (por ejemplo, running shoes) que deseas filtrar y selecciona uno de los siguientes (en función de cada término):

    • Coincidencia parcial: este control se aplica cuando una consulta contiene una coincidencia parcial con este término de consulta.
    • Coincidencia completa: este control se aplica solo 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 solo se aplicará si se cumplen ambas condiciones.

  2. Haz clic en el botón Agregar intervalo para agregar uno o más intervalos durante los cuales se puede aplicar este control (opcional).

    Si especificas una condición de término de consulta además de esta condición de intervalo de tiempo, el control solo se aplicará cuando se cumplan ambas condiciones.

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

En la sección Acciones:

  1. Agregue filtros para los atributos del producto en el campo Filtrar acción.

    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 publicación.

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

  1. Selecciona las configuraciones de entrega a las que 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 una instancia de Control en el cuerpo de la solicitud.

Para obtener más detalles sobre el campo, consulta la referencia de la API de Controls y la referencia de la API de Controls.create.

En este ejemplo, se muestran campos para un

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": {
                  "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"
                    }
                  ]
                },
                "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. Consulta Cómo agregar controles a las configuraciones de entrega intercaladas.

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 de venta minorista 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 en el campo Nombre del control y, luego, ingresa un ID de control nuevo (opcional).

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

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

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

  1. Haz clic en el botón Agregar consulta para agregar términos de consulta (por ejemplo, running shoes) que se 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.
    • Coincidencia completa: este control se aplica solo 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 solo se aplicará si se cumplen ambas condiciones.

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

    Si especificas una condición de término de consulta además de esta condición de intervalo de tiempo, el control solo se aplicará cuando se cumplan ambas condiciones.

  3. Haz 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 publicación.

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

  1. Selecciona las configuraciones de entrega a las que 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 una instancia de Control en el cuerpo de la solicitud.

Para obtener más detalles sobre el 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": {
                  "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. Consulta Cómo agregar controles a las configuraciones de entrega intercaladas.

Cómo crear un control de sinónimos bidireccional

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

Console

  1. Ve a la página Controles de venta minorista 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. Para cambiar el ID de control creado automáticamente, haz clic en Editar en el campo Nombre del control y, luego, ingresa un ID de control nuevo (opcional).

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

  3. Haz clic en Continuar para pasar a la sección Activadores.

En la sección Activadores, haz lo siguiente:

  1. Haz clic en el botón Agregar intervalo para agregar uno o más intervalos durante los cuales se puede aplicar este control (opcional).

  2. Haz 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 cualquiera de estos términos se incluya en una consulta, la búsqueda considerará los otros términos de consulta como sinónimos del término incluido.

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

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

  1. Selecciona las configuraciones de entrega a las que 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 una instancia de Control en el cuerpo de la solicitud.

Para obtener más detalles sobre el 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 Cómo agregar controles a las configuraciones de entrega 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 control.

Console

  1. Ve a la página Controles de venta minorista 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 en el campo Nombre del control y, luego, ingresa un ID de control nuevo (opcional).

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

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

En la sección Activadores, haz lo siguiente:

  1. Haz clic en el botón Agregar intervalo para agregar uno o más intervalos durante los cuales se puede aplicar este control (opcional).

  2. Haz 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 deberían tener sinónimos asociados con ellos cuando se incluye alguno de ellos en una consulta.

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

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

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

  1. Selecciona las configuraciones de entrega a las que 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 una instancia de Control en el cuerpo de la solicitud.

Para obtener más detalles sobre el 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. Consulta Cómo agregar controles a las configuraciones de entrega intercaladas.

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.

Console

  1. Ve a la página Controles de venta minorista 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 en el campo Nombre del control y, luego, ingresa un ID de control nuevo (opcional).

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

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

En la sección Activadores, haz lo siguiente:

  1. Haz clic en el botón Agregar intervalo para agregar uno o más intervalos durante los cuales se puede aplicar este control (opcional).

  2. Haz 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 explícitamente los demás.

  2. En el campo Términos disociados, ingresa los términos que no deben estar asociados 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 publicación.

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

  1. Selecciona las configuraciones de entrega a las que 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 una instancia de Control en el cuerpo de la solicitud.

Para obtener más detalles sobre el 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. Consulta Cómo agregar controles a las configuraciones de entrega intercaladas.

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 de venta minorista 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 en el campo Nombre del control y, luego, ingresa un ID de control nuevo (opcional).

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

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

En la sección Activadores, haz lo siguiente:

  1. Haz clic en el botón Agregar intervalo para agregar uno o más intervalos durante los cuales se puede aplicar este control (opcional).

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

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

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

  1. Selecciona las configuraciones de entrega a las que 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 una instancia de Control en el cuerpo de la solicitud.

Para obtener más detalles sobre el 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. Consulta Cómo agregar controles a las configuraciones de entrega intercaladas.

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 de venta minorista 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 en el campo Nombre del control y, luego, ingresa un ID de control nuevo (opcional).

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

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

En la sección Activadores, haz lo siguiente:

  1. Haz clic en el botón Agregar intervalo para agregar uno o más intervalos durante los cuales se puede aplicar este control (opcional).

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

En la sección Acciones:

  1. En el campo Términos de consulta, ingresa 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 publicación.

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

  1. Selecciona las configuraciones de entrega a las que 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 una instancia de Control en el cuerpo de la solicitud.

Para obtener más detalles sobre el 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. Consulta Cómo agregar controles a las configuraciones de entrega intercaladas.

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

Cómo ver y editar los controles de publicación

Puedes ver los controles de entrega con la consola de venta minorista o la API de Retail.

Ver y editar los controles de publicación en la consola

En la pestaña Controles de publicación de la página Controles, se enumeran todos tus controles de entrega y sus configuraciones de entrega asociadas. Haz clic en el ícono Editar control para cambiar los parámetros de configuración y las configuraciones de entrega asociadas en el panel Control de edición. Haz clic en el ícono Borrar control para borrar un control, que también lo quita de todas las configuraciones de entrega.

También puedes ver y editar los controles de una configuración de entrega específica en la página Configuraciones de publicación. Haz clic en una configuración de entrega para ver su página de Detalles, que enumera todos los controles de entrega de esa configuración. Haz clic en el ícono Editar control para cambiar un parámetro de configuración en el panel Editar control. Haz clic en el ícono Quitar control para desvincular el control de la configuración de entrega (esto no borra el 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.

Ver los controles de publicación intercalados

Para ver un solo control de publicación intercalado, usa Control.get.

Para obtener más información sobre este método, consulta la referencia de la API de Control.get.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID'

Para enumerar varios controles de publicación intercalados, usa Controls.list.

De manera opcional, puedes usar el parámetro pageSize para establecer una cantidad máxima de resultados que se mostrarán. Si hay más resultados disponibles, la respuesta list incluye un token de página. Puedes pasar un token de página en el parámetro pageToken de una solicitud list para recuperar la siguiente página de resultados.

Para enumerar solo los controles asociados con una configuración de entrega específica, usa el parámetro de búsqueda filter a fin de especificar el ID de configuración de entrega.

Para obtener más información sobre este método, consulta la referencia de la API de Control.list.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

Controles de publicación de parches intercalados

Para actualizar los campos de un control de entrega, usa Controls.patch y, luego, incluye una instancia de Control en el cuerpo de la solicitud. Especifica los campos que se deben actualizar con el parámetro updateMask o déjalos sin configurar para actualizar todos los campos compatibles.

Para obtener más información sobre este método, consulta la referencia de la API de Controls.patch.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

Agrega controles a las configuraciones de entrega intercaladas

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

Para obtener más información sobre este método, consulta la referencia de la API de ServingConfig.addControl.

Para ver un ejemplo de este método, consulta Administra la configuración de entrega.

Quita los controles de las configuraciones de entrega intercaladas

Para quitar un control de una configuración de entrega, usa ServingConfig.removeControl.

Para obtener más información sobre este método, consulta la referencia de la API de ServingConfig.addControl.

Para ver un ejemplo de este método, consulta Administra la configuración de entrega.

Borra un control de entrega

Puedes borrar un control de entrega desde la consola o de manera intercalada con el método Controls.delete.

Borra un control de entrega en la consola

Borra un control de entrega para quitar ese control de todas las configuraciones de entrega que lo usen.

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

    Ir a la página Controles

  2. En la fila de la tabla del control que planeas quitar, haz clic en Borrar.

  3. En la ventana de confirmación, haz clic en Borrar para completar la eliminación.

Borra un control de publicación intercalado

Para borrar los controles de publicación intercalados, usa Controls.delete.

Para obtener más información sobre este método, consulta la referencia de la API de Controls.delete.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/SERVING_CONTROL_ID'

Controles de todo el sitio

Los controles de todo el sitio te permiten administrar la configuración de manera global en todas las configuraciones de entrega.

Controles de atributos

Los controles de atributos que se encuentran en todo el sitio están disponibles en Cloud Console para los atributos de producto de tu catálogo.

Los controles de atributos de todo el sitio disponibles son los siguientes:

  • Indexable: La búsqueda de venta minorista puede filtrar y facetar mediante este atributo.
  • Faceta dinámica: La búsqueda de venta minorista puede usar automáticamente este atributo como faceta dinámica en función del comportamiento pasado de los usuarios, como los clics y las vistas de la faceta. A fin de habilitar las facetas dinámicas para un atributo, Indexable debe configurarse como verdadero en ese atributo.
  • Se puede buscar: Este atributo se puede buscar mediante búsquedas de venta minorista, lo que aumenta la recuperación para ese atributo. Este control se aplica solo a los atributos de texto.

Puedes habilitar o inhabilitar los controles de atributos de todo el sitio para atributos individuales.

La faceta dinámica está disponible como un control de atributos para todo el sitio. De forma predeterminada, la faceta dinámica está habilitada para todos los atributos personalizados.

En el modo de configuración a nivel del catálogo, los controles de atributos para todo el sitio están disponibles para indexar y buscar.

Para obtener más información sobre las configuraciones de los atributos y sus configuraciones predeterminadas y permitidas, consulta el tema Configurar atributos.

Establece controles de atributos de todo el sitio

Establece un control de atributo para todo el sitio en la página Controles de Google Cloud Console.

La configuración global de los controles de atributos en todo el sitio está disponible en el modo de configuración a nivel del catálogo predeterminado. Anteriormente, la configuración a nivel de producto era el modo predeterminado. Si todavía estás en el modo de configuración a nivel del producto y necesitas cambiar de modo, comunícate con el equipo de asistencia de venta minorista.

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

    Ir a la página Controles

  2. Ve a la pestaña Controles de todo el sitio.

    En esta pestaña, se muestra una tabla de todos los atributos de producto para los que puedes establecer controles de todo el sitio.

  3. Haz clic en Modificar controles.

  4. Habilita o inhabilita un control.

    • Verdadero: Habilita un control para ese atributo. Esto anula cualquier configuración de atributos a nivel del producto en la API de Retail.
    • Falso: inhabilita un control para ese atributo. Esto anula cualquier configuración de atributo a nivel de producto en la API de Retail.

      Ten en cuenta que solo puedes configurar la faceta dinámica como verdadera para los atributos que también están configurados como indexables.

  5. Haz clic en Guardar controles.

    Los cambios en las opciones de configuración de los atributos para la indexación y la búsqueda se aplican en un plazo de 12 horas, o inmediatamente en la próxima transferencia de catálogos. Los cambios en la configuración de las facetas dinámicas toman hasta dos días. Puedes probar si se aplicaron los cambios en la página Evaluar, lo que reflejará tus cambios de inmediato.