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.

No es necesario configurar una configuración de entrega para que funcione la búsqueda. Cualquier serving_config_id se puede colocar como parte de la solicitud de búsqueda, en cuyo caso, se establece de forma predeterminada en un control de publicación vacío o no configurado. Luego, se realiza la búsqueda en el catálogo con la capacidad de búsqueda predeterminada de Vertex AI Search for Commerce.

Si tienes posiciones existentes o creas nuevas, Vertex AI Search para comercio electrónico crea automáticamente una configuración de entrega asociada con cada posición. La creación de una configuración de entrega no crea una posición correspondiente. Si borras una configuración de entrega, se borrará la posición correspondiente, y si borras una posición, se borrará la configuración de entrega correspondiente.

Edita configuraciones de entrega

Puedes editar los parámetros de configuración de la entrega con la consola de Search for Commerce o la API.

Edita la configuración de entrega 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 de 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 entrega 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 la configuración de entrega de forma intercalada

Puedes actualizar los campos de configuración de entrega, agregar controles de entrega y quitar controles de entrega de forma intercalada con los métodos de la API.

Aplica parches a los parámetros de configuración de entrega de forma intercalada

Para actualizar los 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 configurar para actualizar todos los campos admitidos.

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 de forma intercalada

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'

Cómo quitar controles de las configuraciones de entrega de forma directa

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

Para obtener más información sobre este método, consulta la referencia de la API de ServingConfig.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'

Consulta los parámetros de configuración de entrega

Puedes ver las configuraciones de entrega con la consola de búsqueda para comercio o la API.

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

Puedes ver todas tus configuraciones de entrega en la página Configuraciones de entrega.

Consulta la configuración de entrega intercalada

Para ver una sola configuración de entrega 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 todos los parámetros de configuración de entrega intercalados, usa ServingConfig.list.

De manera opcional, puedes usar el parámetro pageSize para establecer una cantidad máxima de resultados que se devolverá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 Commerce o la API.

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 Serving Configs en la consola de Search for commerce.
   
   Ir a la página Configuración de entrega

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

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

4. Si la configuración de entrega 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 de forma intercalada

Para borrar una sola configuración de entrega 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 las configuraciones de entrega

Puedes ver los detalles de cada configuración de entrega en la página Configuraciones de entrega. 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.