En esta página, se enumeran una serie de instructivos interactivos para Vertex AI Search for Commerce. Estos instructivos incluyen acciones que se pueden ejecutar en el editor de Google Cloud Shell. Con esta herramienta, puedes escribir, compilar, probar, ejecutar y depurar aplicaciones nativas de la nube directamente desde tu navegador.
Descripción general
Prueba diferentes instructivos según lo que quieras aprender:
Si vas a comenzar un proyecto, prueba los instructivos de Importación de información del catálogo. Aquí, aprenderás a importar productos al catálogo para que puedas probar, por ejemplo, diferentes funcionalidades de búsqueda. A continuación, consulta los instructivos sobre cómo importar eventos históricos de usuarios. Vertex AI Search for Commerce usa eventos del usuario para generar recomendaciones y resultados de búsqueda iniciales. Luego, prueba los instructivos para registrar eventos de usuario en tiempo real. Los eventos de usuario en tiempo real proporcionan resultados relevantes y de alta calidad.
Si te interesa saber cómo funciona la Búsqueda en general, prueba los instructivos de Búsqueda.
Si quieres aprender a configurar la búsqueda con controles y parámetros de configuración de publicación, prueba los siguientes instructivos:
Si necesitas actualizar la información de tu catálogo, consulta los instructivos para administrar la información del catálogo.
Si quieres aprender a actualizar el inventario, consulta los instructivos para actualizar el inventario para la Búsqueda.
Si deseas obtener información para registrar, consultar o quitar eventos de usuario en tiempo real, consulta los instructivos sobre cómo registrar eventos de usuario en tiempo real.
Si planeas usar recomendaciones, consulta los instructivos para importar y administrar catálogos y eventos de usuario.
Importa información de los catálogos
En estos instructivos, se describe cómo importar la información de tu catálogo y mantenerla actualizada.
Importa datos de un catálogo desde BigQuery
En este instructivo, se muestra cómo usar una tabla de BigQuery para importar grandes cantidades de datos de catálogo sin límites.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Importa datos de catálogo desde Cloud Storage
En este instructivo, se muestra cómo importar una gran cantidad de elementos a un catálogo.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Importa datos de catálogos intercalados
En este instructivo, se muestra cómo importar productos a un catálogo intercalado.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Administra la información del catálogo
En estos instructivos, se describe cómo administrar la información de tus productos después de importar un catálogo. Puedes leer, escribir y borrar productos en tu catálogo.
Aprende a llamar a la API con el lenguaje que elijas.
Instructivo para crear, obtener, actualizar o borrar productos
En este instructivo, se muestra cómo usar los métodos de la API, que realizan las siguientes acciones:
- Crea un producto
- Obtén un producto
- Actualiza un producto
- Borrar un producto
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para crear un producto
En este instructivo, se muestra cómo crear un solo producto.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para obtener un producto
En este instructivo, se muestra cómo recuperar un elemento de producto.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para actualizar productos
En este instructivo, se muestra cómo actualizar un producto en un catálogo.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para borrar un producto
En este instructivo, se muestra cómo borrar un producto de un catálogo.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Importa eventos históricos de usuarios
En estos instructivos, se describe cómo importar datos de eventos de usuario de forma masiva desde eventos anteriores. Los modelos requieren datos de eventos de usuarios para el entrenamiento.
Instructivo para importar eventos de Cloud Storage
En este instructivo, se muestra cómo importar eventos de usuarios desde Cloud Storage.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para importar eventos desde BigQuery
En este instructivo, se muestra cómo importar eventos de usuario desde BigQuery.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para importar eventos intercalados
En este instructivo, se muestra cómo importar datos de eventos de usuario intercalados.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Registra eventos de usuario en tiempo real
En estos instructivos, se describe cómo registrar, ver o quitar eventos de usuario en tiempo real. Vertex AI Search for Commerce usa eventos de usuario en tiempo real para generar recomendaciones y resultados de la búsqueda. Registrar todos los tipos de eventos de usuario posibles con información válida del producto aumenta la calidad de tus resultados.
Instructivo para escribir eventos de usuario
En este instructivo, se muestra cómo registrar eventos de usuario con el método userEvents.write.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para volver a unir los eventos de usuario
En este instructivo, se muestra cómo volver a unir eventos del usuario realizando una solicitud de POST al extremo de userEvents:rejoin.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para quitar eventos de usuario
En este instructivo, se muestra cómo borrar definitivamente los eventos de usuario.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Buscar instructivos
El método search() se usa para realizar búsquedas en el catálogo según el término de búsqueda y otros parámetros, como filter, facet o order_by.
De forma predeterminada, la respuesta a la búsqueda incluye una cantidad razonable de resultados ordenados por relevancia.
Instructivo de búsqueda
En este instructivo, se muestra cómo enviar una búsqueda sencilla y analizar la respuesta.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo de paginación
En este instructivo, se muestra cómo controlar la paginación en la solicitud de búsqueda. Cuando un comprador busca productos en una tienda, puede mejorar su navegación por los resultados de la búsqueda. Por ejemplo, pueden limitar la cantidad de elementos en la respuesta de la búsqueda con la función de tamaño de página o saltar a la página que prefieran con la función de desplazamiento.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo de búsqueda expandida
En este instructivo, se muestra cómo habilitar la función de búsqueda expandida. Cuando un comprador usa una frase de búsqueda ambigua o de varias palabras, puede recibir una respuesta vacía. Después de activar la búsqueda expandida, se analiza la solicitud y se devuelve la lista expandida de productos según la búsqueda analizada.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo de filtrado
En este instructivo, se muestra la función de filtrado. Te permite ajustar mejor las solicitudes de búsqueda según tus necesidades o las del cliente. Puedes filtrar por uno o varios campos, por campos de texto o numéricos, o ambos. Puedes usar un lenguaje de expresión para construir un predicado para cada campo o combinar diferentes expresiones con operadores lógicos. Por ejemplo, un comprador que busca zapatos puede usar filtros para limitar su búsqueda a su marca y color preferidos.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo de ordenamiento
En este instructivo, se muestra cómo ordenar elementos en una respuesta de búsqueda. Cuando un comprador busca un producto en tu sitio, puedes mostrar los resultados ordenados por varios campos. Por ejemplo, un comprador busca un vestido con el mejor precio y descuento. El precio y el descuento son varios campos aquí. Al comprador se le muestran los vestidos ordenados por precio y, en el caso de los vestidos con el mismo precio, ordenados por descuento.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo de boosting
En este instructivo, se muestran algunos ejemplos de boosting de productos en los resultados de la búsqueda. Con la mejora, puedes aplicarla a un producto para priorizarlo o reducir su prioridad en los resultados de la búsqueda.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo de control de redireccionamiento
En este instructivo, se muestra cómo usar el control de redireccionamiento. Este control permite especificar una URL a la que puedes redireccionar a los usuarios cuando usen una búsqueda específica. Por ejemplo, si un usuario busca "productos de fabricación sustentable", puedes redireccionarlo a una página que contenga las marcas ecológicas con las que trabajas.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Actualiza el inventario para la búsqueda
Si bien los métodos Product de creación, lectura, actualización y eliminación (CRUD) se usan para modificar de forma amplia los atributos de un Product, hay un conjunto de métodos Product que se pueden usar para actualizar campos específicos del inventario con diferentes niveles de detalle. Los siguientes campos Product se consideran campos de inventario:
Product.price_infoProduct.availabilityProduct.available_quantityProduct.fulfillment_info
Instructivo para agregar entregas
En este instructivo, se muestra cómo actualizar la información de entrega de productos con el método AddFulfillmentPlaces. De esta manera, la Búsqueda puede mostrar actualizaciones en las que los productos estén disponibles y se puedan completar los pedidos. Por ejemplo, un comprador busca jeans azules en una tienda, pero no hay en stock. En el momento en que los jeans vuelvan a estar en stock en esta o cualquier otra tienda, el comprador verá las actualizaciones y podrá continuar con su pedido.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para quitar entregas
En este instructivo, se muestra cómo actualizar la información de entrega de productos con el método RemoveFulfillmentPlaces. De esta manera, la Búsqueda puede mostrar actualizaciones en las que los productos no están disponibles y no se pueden completar los pedidos. Por ejemplo, un comprador busca jeans azules en una tienda. Si los jeans se agotan en esta tienda, el comprador verá este mensaje y no podrá continuar con el pedido.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:
Instructivo para configurar el inventario
En este instructivo, se muestra cómo enviar actualizaciones de inventario con el método SetInventory en vez de actualizar todo el producto.
Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme: