Crea controles de entrega

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

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.

Puedes crear un control de publicación en la consola de Search for commerce que conste de una condición, que active el control, y una acción que se realice cuando la condición se active. Luego, puedes adjuntar el nuevo control de publicación a una configuración de publicación.

Las configuraciones de publicación tienen una relación de varios a varios con los controles. Puedes agregar varios controles a una configuración de publicación, y un solo control se puede asociar con varias configuraciones de publicación.

Cuando creas controles de publicación y configuraciones de publicación, seleccionas un producto (recomendaciones o búsqueda) para el que se pueden usar. Los controles de publicación solo se pueden asociar con parámetros de configuración de publicación del mismo tipo de producto. Por ejemplo, un control de publicación creado para las recomendaciones no se puede asociar con una configuración de publicación creada para la búsqueda.

Las configuraciones de entrega administran qué controles se aplican durante una búsqueda o una solicitud de predicción. Solo se consideran los controles de la configuración de publicación activa para una solicitud en el momento de la publicación. Por ejemplo, supongamos que creaste dos controles: un control llamado Oferta de gShoe que aumenta los resultados de la marca gShoe cuando se busca zapato y un control llamado Más zapatos que expande las búsquedas con el término zapato para correr para incluir zapato deportivo. Si solo adjuntas el control gShoe Sale a una configuración de publicación, las solicitudes de búsqueda que usan esa configuración de publicación aumentan los resultados de gShoe para las búsquedas que usan el término zapatos,pero el control Más zapatos no tiene efecto porque no está adjunto a la configuración de publicación que usas.

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

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

Puedes crear hasta 100 controles de publicación. Si necesitas más controles de publicación, solicita una cuota adicional. Si deseas obtener información para solicitar una cuota adicional, consulta Cómo aumentar 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 de 1,000 por configuración de entrega.

Videos y guías de inicio rápido

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

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


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

GUIARME


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

Para ver ejemplos de estos controles, consulta Acerca de los controles de publicación.

Opciones de la consola para crear controles

Puedes elegir una de las siguientes rutas de la consola para crear todos los controles de publicación en Vertex AI Search para comercio.

Usa la consola de Google Cloud

Sigue los pasos de la consola de comercialización en cada sección de control de publicación.

Usa la consola de Merchandising

Si eres administrador de la Consola de Google Cloud, puedes otorgarles acceso a la Consola de Merchandising a los especialistas en merchandising del sitio y asignarles el rol de creador o revisor.

Accede a la consola de Merchandising como usuario

Si se te otorgó acceso con la URL, tienes la opción de usar la consola de Merchandising en lugar de la consola estándar de Google Cloud. Para crear controles con la consola de Merchandising, sigue estos pasos:

  1. Accede a través del acceso externo que te proporciona tu administrador.

  2. Sigue los pasos de la documentación de la consola de Merchandising en cada sección de control de publicación.

Incorpora a los usuarios de la consola de Merchandising

Si eres administrador de la consola de Google Cloud, puedes proporcionar a los minoristas acceso a la consola de Merchandising:

  1. Ve a la página Controles en la consola de Búsqueda para comercio.

    Ir a la página Controles

  2. Navega a la pestaña Consola de merchandising.

  3. Configura la configuración de identidad.

  4. Otórgales a los usuarios los roles de Aprobador o Creador.

  5. Puedes ver la URL única a la consola de Merchandising asociada con el proyecto Google Cloud actual. Copia el vínculo o ábrelo directamente en la consola de Google Cloud.

  6. Selecciona la configuración de publicación predeterminada para Versión preliminar en la consola de Merchandising.

  7. (Opcional) Edita el acceso a la consola de Merchandising con estas funciones:

    • Agrega usuarios: Otorga a los usuarios acceso de Aprobador o Creador a la consola de Merchandising.

    • Borrar usuarios: Borra a los Aprobadores o Creadores para revocar el acceso a la Consola de Merchandising.

  8. Ve a la página Administrador de IAM en la consola de Search for commerce.

    Ir a la página Administrador de IAM

Pasos adicionales para los revisores

  1. Para ajustar la configuración de la consola de Merchandising, haz clic en Crear control.

  2. Agrega preguntas a la regla inicial o bórralas en la pantalla Definir objetivos.

  3. (Opcional) Después de recibir las solicitudes de control enviadas por correo electrónico, cambia el estado, aprueba o rechaza las solicitudes en el panel, donde se muestran las solicitudes.

  4. Para administrar la aprobación de cada control en la sección Revisar y aprobar, haz clic en Aprobar, Rechazar o Editar.

    • La última opción te dirige a la siguiente pantalla, en la que puedes hacer tus ediciones y hacer clic en Aprobar con ediciones.

    • Los controles que agregues como responsable de aprobación se aprobarán automáticamente.

Crea un control de entregas nuevo

Crea un control de publicación nuevo en la página Controles en la consola de Google Cloud o intercalado 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 de aumento o disminución

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

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

Para crear un control de aumento o ocultación de la búsqueda, sigue estos pasos:

Consola de comercialización

  1. Haz clic en la URL que proporcionó el administrador. Accede.

    Esta acción te llevará a la página Controles en la consola de Merchandising.

  2. Haz clic en Crear control.

  3. Define los objetivos de tus usuarios finales y los plazos necesarios. Se deben responder todas las preguntas. Haz clic en Siguiente.

  4. Selecciona un control. Ingresa el nombre de tu control, selecciona el producto Búsqueda y, luego, elige el tipo de control Mejorar/ocultar.

  5. Configura el control Boost/Bury:

    1. En Activadores, define qué atributo del catálogo activa este control. Para ello, proporciona criterios a una búsqueda relacionada, como contiene o no está dentro del rango. Si no se configuró ningún atributo de catálogo, este control siempre se aplicará.

    2. Para definir un período aplicable, ingresa un período. Si se cumple alguno de los intervalos de tiempo especificados, el atributo del catálogo coincidirá con la búsqueda durante cualquiera de ellos. Agrega un intervalo de tiempo con Agregar intervalo de tiempo.

    3. Define las acciones de Mejorar/ocultar que deseas activar con este control. Estas acciones se definen mediante un atributo del catálogo, como colors, un criterio, como contains, y un valor, como red.

    4. Haz clic en Agregar atributo para agregar más atributos.

  6. Usa el control deslizante para establecer el valor de aumento o ocultación. Los números negativos se ocultan y los números positivos se aumentan.

  7. Haz clic en Enviar para enviar tu solicitud de control a un responsable de aprobación. Podrás ver el estado de las solicitudes enviadas en la Consola de merchandising. Si cambias de opinión, puedes borrar tu solicitud de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de Búsqueda para comercio.

    Ir a la página Controles

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

    Se abrirá el panel Crear control.

  3. En la sección Preferences, en el campo Control name, ingresa un nombre para el control nuevo.

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

  5. En la sección Selección de productos, selecciona Búsqueda.

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

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

    • Explorar categorías: La regla se activa cuando un usuario explora las categorías de tu sitio (search.request.query está 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). Para configurar este control para que se active cuando se explore cualquier categoría o se realice una búsqueda, omite el siguiente paso.

  8. Opcional: Establece categorías o consultas específicas que puedan activar este control según si se navega por una categoría específica o se busca una consulta específica.

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

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

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

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

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

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

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

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

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

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

Ahora puedes encontrar el nuevo control 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.

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

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

Crea un control de mejora o ocultación de recomendaciones

Para crear un control de aumento o ocultación de recomendaciones, sigue estos pasos:

Consola de comercialización

  1. Haz clic en la URL que proporcionó el administrador. Accede.

    Esta acción te llevará a la página Controles en la consola de Merchandising.

  2. Haz clic en Crear control.

  3. Define los objetivos de tus usuarios finales y los plazos necesarios. Se deben responder todas las preguntas. Haz clic en Siguiente.

  4. Selecciona un control. Ingresa el nombre del control, selecciona el producto Explorar y, luego, elige el tipo de control Mejorar/ocultar.

  5. Configura el control Boost/Bury:

    1. En Activadores, ingresa las categorías de páginas que activarán el control. Si no se configuran atributos de catálogo, este control siempre estará vigente.

    2. Para definir un período aplicable, ingresa un período. Si se cumple alguno de los intervalos de tiempo especificados, el atributo del catálogo coincidirá con la búsqueda durante cualquiera de ellos. Agrega un intervalo de tiempo con Agregar intervalo de tiempo.

    3. Define las acciones de Mejorar/ocultar que deseas activar con este control. Estas acciones se definen mediante un atributo del catálogo, como colors, un criterio, como contains, y un valor, como red.

    4. Haz clic en Agregar atributo para agregar más atributos.

  6. Usa el control deslizante para establecer el valor de aumento o ocultación. Los números negativos ocultan los datos, mientras que los números positivos los aumentan.

  7. Haz clic en Enviar para enviar tu solicitud de control a un revisor. Podrás ver el estado de las solicitudes enviadas en la Consola de merchandising. Si cambias de opinión, puedes borrar tu solicitud de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de Búsqueda para comercio.

    Ir a la página Controles

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

    Se abrirá el panel Crear control.

  3. En la sección Preferences, en el campo Control name, ingresa un nombre para el control nuevo.

  4. De manera opcional, para cambiar el ID de control creado automáticamente, haz clic en Editar y, luego, ingresa un ID de control nuevo.

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

  6. Elige Controles de Mejorar/ocultar como el tipo de control.

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

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

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

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

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

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

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

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

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

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

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control 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.

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 publicación, usa el método ServingConfig.addControl:

Crea un control de filtro

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

Consola de comercialización

  1. Haz clic en la URL que proporcionó el administrador. Accede.

    Esta acción te llevará a la página Controles en la consola de Merchandising.

  2. Haz clic en Crear control.

  3. Define los objetivos de tus usuarios finales y los plazos necesarios. Se deben responder todas las preguntas. Haz clic en Siguiente.

  4. Selecciona un control. Ingresa el nombre de tu control, selecciona el producto Search o Browse y, luego, elige el tipo de control Filter.

  5. Configura el control Filtrar:

    1. En Activadores, define qué atributo del catálogo activa este control. Para ello, proporciona criterios a una búsqueda relacionada o a una categoría de página, como contiene o no está dentro del rango. Si no se configuró ningún atributo de catálogo, este control siempre se aplicará.

    2. Para definir un período aplicable, ingresa un período. Si se cumple alguno de los intervalos de tiempo especificados, el atributo del catálogo coincidirá con la búsqueda durante cualquiera de ellos. Agrega un intervalo de tiempo con Agregar intervalo de tiempo.

    3. Define las acciones de filtro que deseas activar con este control. Estas acciones se definen mediante un atributo del catálogo, como colors, un criterio, como contains, y un valor, como red.

    4. Haz clic en Agregar atributo para agregar más atributos.

  6. Haz clic en Enviar para enviar tu solicitud de control a un revisor. Podrás ver el estado de las solicitudes enviadas en la Consola de merchandising. Si cambias de opinión, puedes borrar tu solicitud de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de Búsqueda para comercio.

    Ir a la página Controles

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

    Se abrirá el panel Crear control.

  3. En la sección Preferences, en el campo Control name, ingresa un nombre para el control nuevo.

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

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

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

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

    • Explorar categorías: La regla se activa cuando un usuario explora las categorías de tu sitio (search.request.query está 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).

  8. Opcional: 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 elegiste Explorar categorías, en el campo Categorías, ingresa las categorías que activarán este control cuando se exploren.

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

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

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

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

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

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

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

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

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

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

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

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

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

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control 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.

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

Crea un control de redireccionamiento

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

Consola de comercialización

  1. Haz clic en la URL que proporcionó el administrador. Accede.

    Esta acción te llevará a la página Controles en la consola de Merchandising.

  2. Haz clic en Crear control.

  3. Define los objetivos de tus usuarios finales y los plazos necesarios. Se deben responder todas las preguntas. Haz clic en Siguiente.

  4. Selecciona un control. Ingresa el nombre de tu control, selecciona el producto Búsqueda y, luego, elige el tipo de control Redireccionar.

  5. Configura el control Redireccionamiento:

    1. En Activadores, define qué atributo del catálogo activa este control. Para ello, proporciona criterios a una búsqueda relacionada, como contiene o no está dentro del rango. Si no se configuró ningún atributo de catálogo, este control siempre se aplicará.

    2. Para definir un período aplicable, ingresa un período. Si se cumple alguno de los intervalos de tiempo especificados, el atributo del catálogo coincidirá con la búsqueda durante cualquiera de ellos. Agrega un intervalo de tiempo con Agregar intervalo de tiempo.

    3. Ingresa la URL de redireccionamiento para definir las acciones de redireccionamiento que deseas activar con este control.

  6. Haz clic en Enviar para enviar tu solicitud de control a un responsable de aprobación. Podrás ver el estado de las solicitudes enviadas en la Consola de merchandising. Si cambias de opinión, puedes borrar tu solicitud de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de Búsqueda para comercio.

    Ir a la página Controles

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

    Se abrirá el panel Crear control.

  3. En la sección Preferences, en el campo Control name, ingresa un nombre para el control nuevo.

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

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

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

  7. Crea al menos un término de consulta o activador de intervalo de tiempo. Los controles de redireccionamiento requieren al menos un activador:

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

    • Explorar categorías: La regla se activa cuando un usuario explora las categorías de tu sitio (search.request.query está 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).

  9. 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 elegiste Explorar categorías, en el campo Categorías, ingresa las categorías que activarán este control cuando se exploren.

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

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

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

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

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

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

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

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

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

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

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

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control 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.

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

Cómo crear un control de sinónimos bidireccional

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

Consola de comercialización

  1. Haz clic en la URL que proporcionó el administrador. Accede.

    Esta acción te llevará a la página Controles en la consola de Merchandising.

  2. Haz clic en Crear control.

  3. Define los objetivos de tus usuarios finales y los plazos necesarios. Se deben responder todas las preguntas. Haz clic en Siguiente.

  4. Selecciona un control. Ingresa el nombre de tu control, selecciona el producto Búsqueda y, luego, elige el tipo de control Sinónimos.

  5. Configura el control de sinónimos bidireccionales:

    1. En Activadores, define qué atributo del catálogo activa este control. Para ello, proporciona criterios a una búsqueda relacionada, como contiene o no está dentro del rango. Si no se configuró ningún atributo de catálogo, este control siempre se aplicará.

    2. Para definir un período aplicable, ingresa un período. Si se cumple alguno de los intervalos de tiempo especificados, el atributo del catálogo coincidirá con la búsqueda durante cualquiera de ellos. Agrega un intervalo de tiempo con Agregar intervalo de tiempo.

    3. Define el tipo de sinónimo que deseas activar con este control. Selecciona Dos vías. Consulta la sección sobre sinónimos para obtener más información sobre los tipos de sinónimos.

  6. Haz clic en Enviar. Se abrirá una pantalla de configuración detallada de sinónimos de dos vías.

  7. Ingresa los sinónimos en el campo Acciones de sinónimos de dos vías. Esta acción vincula los términos de forma bidireccional para que se traten de la misma manera en los resultados de la búsqueda, de modo que una búsqueda de sofá rojo resulte en sofá rojo oscuro, pero las búsquedas de sofá rojo oscuro se expandan para incluir todos los tipos de sofás rojos, como carmesí o rosa.

  8. Vuelve a hacer clic en Enviar para enviar tu solicitud de control a un responsable de aprobación. Podrás ver el estado de las solicitudes enviadas en la Consola de merchandising. Si cambias de opinión, puedes borrar tu solicitud de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de Búsqueda para comercio.

    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.

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

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

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

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

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

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

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

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

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

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

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

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

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

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control 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"
                    }
                    ]
                },
                "twoWaySynonymAction": {
                  "synonyms": [
                    "SYNONYM_1",
                    "SYNONYM_2"
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

Crea un control de sinónimos unidireccional

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

Consola de comercialización

  1. Haz clic en la URL que proporcionó el administrador. Accede.

    Esta acción te llevará a la página Controles en la consola de Merchandising.

  2. Haz clic en Crear control.

  3. Define los objetivos de tus usuarios finales y los plazos necesarios. Se deben responder todas las preguntas. Haz clic en Siguiente.

  4. Selecciona un control. Ingresa el nombre de tu control, selecciona el producto Búsqueda y, luego, elige el tipo de control Sinónimos.

  5. Configura el control de sinónimos unidireccionales:

    1. En Activadores, define qué atributo del catálogo activa este control. Para ello, proporciona criterios a una búsqueda relacionada, como contiene o no está dentro del rango. Si no se configuró ningún atributo de catálogo, este control siempre se aplicará.

    2. Para definir un período aplicable, ingresa un período. Si se cumple alguno de los intervalos de tiempo especificados, el atributo del catálogo coincidirá con la búsqueda durante cualquiera de ellos. Agrega un intervalo de tiempo con Agregar intervalo de tiempo.

    3. Define el tipo de sinónimo que deseas activar con este control. Selecciona Un solo sentido. Consulta la sección sobre Sinónimos para obtener más información sobre los tipos de sinónimos.

  6. Haz clic en Enviar. Esta acción te llevará a una pantalla de configuración detallada de sinónimos unidireccionales.

  7. Ingresa tus sinónimos en el campo Acciones de sinónimos unidireccionales. Esta acción vincula términos de forma unidireccional para que se traten de la misma manera en los resultados de la búsqueda, de modo que una búsqueda de sofá rojo incluya sofás granate, pero una búsqueda de sofá granate no muestre otros tipos de sofás rojos, lo que restringe los resultados solo a sofás granate.

  8. Vuelve a hacer clic en Enviar para enviar tu solicitud de control a un responsable de aprobación. Podrás ver el estado de las solicitudes enviadas en la Consola de merchandising. Si cambias de opinión, puedes borrar tu solicitud de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de Búsqueda para comercio.

    Ir a la página Controles

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

    Se abrirá el panel Crear control.

  3. En la sección Preferences, en el campo Control name, ingresa un nombre para el control nuevo.

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

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

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

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

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

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

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

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

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

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

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

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

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control 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"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

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

Cómo crear un control de no asociación

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

Consola de comercialización

  1. Haz clic en la URL que proporcionó el administrador. Accede.

    Esta acción te llevará a la página Controles en la consola de Merchandising.

  2. Haz clic en Crear control.

  3. Define los objetivos de tus usuarios finales y los plazos necesarios. Se deben responder todas las preguntas. Haz clic en Siguiente.

  4. Selecciona un control. Ingresa el nombre de tu control, selecciona el producto Búsqueda y, luego, elige el tipo de control No asociar.

  5. Configura el control No asociar:

    1. En Activadores, define qué atributo del catálogo activa este control. Para ello, proporciona criterios a una búsqueda relacionada, como contiene o no está dentro del rango. Si no se configuró ningún atributo de catálogo, este control siempre se aplicará.

    2. Para definir un período aplicable, ingresa un período. Si se cumple alguno de los intervalos de tiempo especificados, el atributo del catálogo coincidirá con la búsqueda durante cualquiera de ellos. Agrega un intervalo de tiempo con Agregar intervalo de tiempo.

    3. En No asociar acciones, especifica los términos que no deben estar asociados con los términos de consulta que ingresaste en la sección Activadores anterior. Ingresa los términos en los campos de términos de búsqueda y términos desvinculados, respectivamente.

  6. Haz clic en Enviar para enviar tu solicitud de control a un responsable de aprobación. Podrás ver el estado de las solicitudes enviadas en la Consola de merchandising. Si cambias de opinión, puedes borrar tu solicitud de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de Búsqueda para comercio.

    Ir a la página Controles

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

    Se abrirá el panel Crear control.

  3. En la sección Preferences, en el campo Control name, ingresa un nombre para el control nuevo.

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

  5. Elige Control de no asociar como el tipo de control.

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

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

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

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

  10. En el campo Términos desvinculados, ingresa los términos que se deben desvincular de 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.

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

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

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

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

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

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control 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"
                    }
                  ]
                },
                "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.

Consola de comercialización

  1. Haz clic en la URL que proporcionó el administrador. Accede.

    Esta acción te llevará a la página Controles en la consola de Merchandising.

  2. Haz clic en Crear control.

  3. Define los objetivos de tus usuarios finales y los plazos necesarios. Se deben responder todas las preguntas. Haz clic en Siguiente.

  4. Selecciona un control. Ingresa el nombre de tu control, selecciona el producto Búsqueda y, luego, elige el tipo de control Ignorar.

  5. Configura el control Ignorar:

    1. En Activadores, define qué atributo del catálogo activa este control. Para ello, proporciona criterios a una búsqueda relacionada, como contiene o no está dentro del rango. Si no se configuró ningún atributo de catálogo, este control siempre se aplicará.

    2. Para definir un período aplicable, ingresa un período. Si se cumple alguno de los intervalos de tiempo especificados, el atributo del catálogo coincidirá con la búsqueda durante cualquiera de ellos. Agrega un intervalo de tiempo con Agregar intervalo de tiempo.

    3. Ingresa los términos que deseas ignorar en Acciones para ignorar.

  6. Haz clic en Enviar para enviar tu solicitud de control a un revisor. Podrás ver el estado de las solicitudes enviadas en la Consola de merchandising. Si cambias de opinión, puedes borrar tu solicitud de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de Búsqueda para comercio.

    Ir a la página Controles

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

    Se abrirá el panel Crear control.

  3. En la sección Preferences, en el campo Control name, ingresa un nombre para el control nuevo.

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

  5. Elige Control de no asociar como el tipo de control.

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

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

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

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

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

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

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

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

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

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control 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"
                    }
                  ]
                },
                "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:

Crea un control de reemplazo

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

Consola de comercialización

  1. Haz clic en la URL que proporcionó el administrador. Accede.

    Esta acción te llevará a la página Controles en la consola de Merchandising.

  2. Haz clic en Crear control.

  3. Define los objetivos de tus usuarios finales y los plazos necesarios. Se deben responder todas las preguntas. Haz clic en Siguiente.

  4. Selecciona un control. Ingresa el nombre de tu control, selecciona el producto Búsqueda y, luego, elige el tipo de control Reemplazo.

  5. Configura el control de Reemplazo:

    1. En Activadores, define qué atributo del catálogo activa este control. Para ello, proporciona criterios a una búsqueda relacionada, como contiene o no está dentro del rango. Si no se configuró ningún atributo de catálogo, este control siempre se aplicará.

    2. Para definir un período aplicable, ingresa un período. Si se cumple alguno de los intervalos de tiempo especificados, el atributo del catálogo coincidirá con la búsqueda durante cualquiera de ellos. Agrega un intervalo de tiempo con Agregar intervalo de tiempo.

    3. En Acciones de reemplazo, define los términos de consulta que deseas reemplazar en el primer campo y sus sustitutos en el segundo campo.

  6. Haz clic en Enviar para enviar tu solicitud de control a un responsable de aprobación. Podrás ver el estado de las solicitudes enviadas en la Consola de merchandising. Si cambias de opinión, puedes borrar tu solicitud de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de Búsqueda para comercio.

    Ir a la página Controles

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

    Se abrirá el panel Crear control.

  3. En la sección Preferences, en el campo Control name, ingresa un nombre para el control nuevo.

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

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

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

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

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

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

  10. 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 por el término de reemplazo Google Shoe.

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

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

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

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

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

curl

Realiza una solicitud Control.create con un ID de control y una instancia de Control 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 publicación, usa el método ServingConfig.addControl:

Cómo crear un control de fijación

Para crear un control de fijación, sigue estos pasos:

Consola de comercialización

  1. Haz clic en la URL que proporcionó el administrador. Accede.

    Esta acción te llevará a la página Controles en la consola de Merchandising.

  2. Haz clic en Crear control.

  3. Define los objetivos de tus usuarios finales y los plazos necesarios. Se deben responder todas las preguntas. Haz clic en Siguiente.

  4. Selecciona un control. Ingresa el nombre de tu control, selecciona el producto Búsqueda y, luego, elige el tipo de control Fijado.

  5. Configura el control de fijación:

    1. En Activadores, define qué atributo del catálogo activa este control. Para ello, proporciona criterios a una búsqueda relacionada, como contiene o no está dentro del rango. Si no se configuró ningún atributo de catálogo, este control siempre se aplicará.

    2. Para definir un período aplicable, ingresa un período. Si se cumple alguno de los intervalos de tiempo especificados, el atributo del catálogo coincidirá con la búsqueda durante cualquiera de ellos. Agrega un intervalo de tiempo con Agregar intervalo de tiempo.

    3. Define las acciones de fijación que deseas activar con este control. Estas acciones se definen mediante el ID de producto y la posición de la ficha, preferiblemente un número inferior a 120 (el tamaño de página típico). Puedes hacer clic en Agregar producto y agregar hasta 10.

  6. Haz clic en Enviar para enviar tu solicitud de control a un responsable de aprobación. Podrás ver el estado de las solicitudes enviadas en la Consola de merchandising. Si cambias de opinión, puedes borrar tu solicitud de control.

Consola de Cloud

  1. Ve a la página Controles en la consola de Búsqueda para comercio.

    Ir a la página Controles

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

    Se abrirá el panel Crear control.

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

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

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

  6. Elige Control de fijación como el tipo de control. Haga clic en Continuar.

  7. En la sección Activadores, elige el comportamiento del usuario que activa este control:

    • Explorar categorías: Las solicitudes de exploración deben tener el campo page_categories propagado, además de que search.request.query esté vacío.

    • Búsqueda: Las solicitudes de búsqueda solo requieren que se propague search.request.query.

      De forma predeterminada, todas las categorías que se exploran y las búsquedas que se realizan activan este control.

  8. Opcional: Establece una condición que active la regla según una categoría o una consulta específicas que se hayan explorado o buscado:

    • Explorar categorías: En el campo Categorías, ingresa las categorías que activan el control.

    • Búsqueda: Para agregar términos de búsqueda que se filtrarán (por ejemplo, running shoes), haz clic en Agregar búsqueda. Para cada término, elige Concordancia parcial o Concordancia total.

  9. Opcional: Haz clic en Agregar intervalo de tiempo o Agregar período para agregar uno o más intervalos de tiempo durante los cuales se puede aplicar este control.

  10. Haz clic en Continuar para ir a la sección Acciones. En Ubicación de fijación, usa el control deslizante para especificar en qué posición se fijarán los productos. El control deslizante de valor de fijación no aceptará valores de 0, números negativos ni números que no sean enteros.

    Vertex AI Search para comercios permite 10 pines en el mapa de pines de cualquier control. La posición puede ser cualquier valor entre 1 y 120 (el tamaño máximo de la página de la solicitud).

  11. Haz clic en Continuar para ir a la sección Configuraciones de publicación. Selecciona las configuraciones de publicación a las que se aplicará el control y 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 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" \
 -H "X-Goog-User-Project: PROJECT_NUMBER" \
 --data '{
          "displayName": "DisplayName",
          "solutionTypes": "SOLUTION_TYPE_SEARCH",
          "searchSolutionUseCase": ["SEARCH_SOLUTION_USE_CASE_SEARCH"],
     "rule": {
            "condition": {
 "queryTerms": [
                {
                  "value": "Term1",
                  "fullMatch": "boolean: true / false"
                },
                {
                  "value": "Term2",
                  "fullMatch": "boolean: true / false"
                },
             ],
             "activeTimeRange": [
               {
                 "startTime": timestamp1,
                 "endTime": timestamp2
               },
               {
                 "startTime": timestamp3,
                 "endTime": timestamp4
               }
             ]
            },
            "pinAction": {
               "pinMap" :  {
                        "pin_position1": "product_id",
                      "pin_position2": "product_id>"
                    }
            }
              }
}' \
"https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/controls?controlId=CONTROL_ID"

pin_position debe ser un número entero entre [1,10] inclusive, y product_id debe existir en tu catálogo. La cantidad máxima de elementos permitidos en el mapa de pines es de 10 para cada control.

A continuación, adjunta el control de fijación a tu configuración de publicación:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
-d '{
      "controlId": "CONTROL_ID"
  }' \
'https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

En este caso, CONTROL_ID debe ser el control de fijación id que creaste anteriormente.

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

Por último, para probar la configuración, realiza una solicitud de búsqueda. Para asegurarte de que se aplique correctamente el control de fijación a una solicitud, usa términos de búsqueda (en la búsqueda) o categorías de página (en la navegación) que coincidan con los términos o categorías proporcionados en el control que creaste en los pasos anteriores.

Consola de Cloud

  1. Ve a la página Evaluar en la consola de Búsqueda para comercio.

    Ir a la página Evaluación

  2. Ve a la pestaña Buscar.

  3. Ingresa una consulta de prueba en el campo de búsqueda.

  4. Haz clic en Vista previa de la búsqueda.

  5. Consulta los resultados para asegurarte de que los productos que elegiste estén fijados.

curl

curl -s -X POST -H "Authorization: Bearer " -H "Content-Type: application/json"
--data "{'query': '','visitorId': ''}" \ "https://retail.googleapis.com/v2/projects/PROJECT/locations/global/catalogs/CATALOG/placements/default_search:search"

Restricciones para la verificación de errores

Para la verificación de errores, ten en cuenta estas restricciones:

  • No se pueden fijar dos productos en la misma posición, es decir, los productos "a" y "b" no pueden ocupar la posición 2.
  • Por el contrario, un producto no se puede fijar en más de una ubicación, es decir, el producto "a" no se puede fijar en las posiciones 2 y 3 al mismo tiempo para la misma búsqueda.
  • El product_id debe existir como producto en el catálogo, siempre y cuando no se apliquen filtros ni ordenes.