Administra las configuraciones de entrega

En esta página, se describe cómo borrar, editar y enumerar configuraciones de entrega, además de cómo revisar estadísticas sobre cada configuración.

Para obtener ayuda con la creación de una configuración de entrega nueva, consulta Crea configuraciones de entrega.

Si tienes posiciones existentes o creas nuevas, Vertex AI Search para venta minorista crea automáticamente una configuración de entrega asociada con cada posición. Crear una configuración de entrega no crea una posición correspondiente. Si borras una configuración de publicación, se borrará la posición correspondiente, y si borras una posición, se borrará la configuración de publicación correspondiente.

Edita las configuraciones de entrega

Puedes editar las configuraciones de publicación con la consola de Search for Retail o la API.

Nota: Si realizas cambios significativos en una configuración de publicación que contiene un modelo de optimización a nivel de la página, es posible que este modelo muestre resultados poco óptimos mientras se vuelve a entrenar. Debido a que el entrenamiento del modelo de optimización a nivel de la página puede tardar mucho tiempo, considera volver a crear el modelo de optimización a nivel de la página y su configuración de entrega asociada.

Edita las configuraciones de publicación en la consola

Puedes ver y editar los controles para cada configuración de entrega en la página Configuración de entregas. Haz clic en una configuración de entrega para ver su página Detalles, en la que se enumeran todos los controles de entrega y de todo el sitio para esa configuración.

En esta página, puedes editar los controles, crear controles nuevos o aplicar los controles existentes a la configuración.

Los parámetros de configuración de publicación recién creados o actualizados pueden tardar unos minutos en estar listos para entregar tráfico en vivo. Puedes probar los cambios de inmediato en la página Evaluar.

Edita configuraciones de entrega intercaladas

Puedes actualizar los campos de configuración de publicación, agregar controles de publicación y quitar controles de publicación intercalados con métodos de API.

Cómo aplicar parches a los parámetros de configuración de entrega intercalados

Para actualizar campos en una configuración de publicación, usa ServingConfig.patch y, luego, incluye una instancia de ServingConfig en el cuerpo de la solicitud. Especifica los campos que se actualizarán con el parámetro updateMask o déjalo sin definir para actualizar todos los campos compatibles.

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

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

Agrega controles a los parámetros de configuración de entrega intercalados

Para agregar un control a una configuración de publicación, usa ServingConfig.addControl. El control se agrega en la última posición de la lista de controles a la que pertenece. Por ejemplo, se aplica un control facetSpec en la última posición de servingConfig.facetSpecIds.

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

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

Quita los controles de las configuraciones de entrega intercaladas

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

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

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

Cómo ver los parámetros de configuración de entrega

Puedes ver las configuraciones de publicación con la consola de Search for Retail o la API.

Cómo ver los parámetros de configuración de publicación en la consola

Puedes ver todas tus configuraciones de entrega en la página Configuración de entrega.

Cómo ver los parámetros de configuración de entrega intercalados

Para ver una sola configuración de publicación intercalada, usa ServingConfig.get.

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

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

Para enumerar todas las configuraciones de publicación intercaladas, usa ServingConfig.list.

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

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

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

Borra una configuración de entrega

Puedes borrar las configuraciones de publicación con la consola de Search for Retail o la API.

Nota: Si borras una configuración de publicación que usa un modelo de optimización a nivel de la página, también borra y vuelve a crear el modelo de optimización a nivel de la página. De lo contrario, el modelo de optimización a nivel de la página mostrará la configuración de publicación borrada.

Borra las configuraciones de entrega en la consola

Para borrar una configuración de entrega en la consola, sigue estos pasos:

1. Ve a la página Configuraciones de publicación en la consola de Search for Retail.
   
   Ir a la página Configuración de entrega

2. Haz clic en la configuración de publicación que deseas borrar para abrir su página de detalles.

3. Haz clic en Reiniciar en la barra de botones en la parte superior de la página.

4. Si la configuración de publicación se considera activa, debes volver a escribir su ID y hacer clic en Confirmar para completar la eliminación.

Borra una configuración de entrega intercalada

Para borrar una sola configuración de publicación intercalada, usa ServingConfig.delete.

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

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

Revisa las estadísticas de la configuración de entrega

Puedes ver los detalles de cada configuración de entrega en la página Configuración de entregas. Si deseas ver cualquier configuración en la tabla, haz clic en Ver estadísticas para ver sus estadísticas.

La tasa de clics muestra los clics por búsqueda de la configuración de entrega. El porcentaje de conversiones indica las compras por búsqueda para la configuración.

Nota: Los períodos para las estadísticas se encuentran en la zona horaria del Pacífico. Por ejemplo, las estadísticas diarias representan los datos del día anterior a la medianoche de la hora del Pacífico.