Crea controles de entrega

Console

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

2. En la pestaña Controles de publicación, haz clic en add_boxCrear 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:

• 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 las configuraciones de publicación.

Console

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

2. En la pestaña Controles de entrega, haz clic en add_boxCrear 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:

• 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 las configuraciones de publicación.

Console

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

2. En la pestaña Controles de entrega, haz clic en add_boxCrear 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 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 categorías en 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:

• 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 las configuraciones de publicación.

Console

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

2. En la pestaña Controles de entrega, haz clic en add_boxCrear 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 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 categorías en 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:

• 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 las configuraciones de publicación.

Console

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

2. En la pestaña Controles de entrega, haz clic en add_boxCrear 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 nuevo ID de control.

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.

Console

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

2. En la pestaña Controles de entrega, haz clic en add_boxCrear 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:

• 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 las configuraciones de publicación.

Console

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

2. En la pestaña Controles de entrega, haz clic en add_boxCrear 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:

• 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 las configuraciones de publicación.

Console

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

2. En la pestaña Controles de entrega, haz clic en add_boxCrear 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:

• 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 las configuraciones de publicación.

Console

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

2. En la pestaña Controles de entrega, haz clic en add_boxCrear 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 reemplazar 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:

• 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 las configuraciones de publicación.

Console

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

2. En la pestaña Controles de entrega, haz clic en add_boxCrear 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 no enteros.

    Vertex AI Search para la venta minorista 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:

• 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 las configuraciones de publicación.

Console

1. Ve a la página Evaluar en la consola de Search for Retail.
   
   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"