En esta página, se proporciona una guía paso a paso para implementar la API de venta minorista.
Introducción
Cuando uses Recomendaciones IA o la Búsqueda de venta minorista, usarás la API de venta minorista para transferir eventos de usuario y datos de catálogo, y entregar predicciones o resultados de la búsqueda en tu sitio.
La API de venta minorista usa los mismos datos para Recomendaciones IA y Búsqueda de venta minorista, por lo que, si usas ambos, no necesitas transferir los mismos datos dos veces.
Consulta los requisitos y las prácticas recomendadas de eventos de usuarios para obtener datos sobre los eventos de los usuarios que usan la venta minorista y la Búsqueda de venta minorista. Si usas modelos de Recomendaciones IA, en Requisitos de datos de eventos del usuario, se enumeran los requisitos adicionales según el tipo de modelo y el objetivo de optimización. Estos requisitos ayudan a la API de venta minorista a generar resultados de calidad.
El tiempo de integración promedio de la API de venta minorista es de semanas. Ten en cuenta que, para la Búsqueda de venta minorista, la duración real depende en gran medida de la calidad y la cantidad de datos que se deben transferir.
Si usas Google Tag Manager o Google Merchant Center, puedes implementar la API de venta minorista con marketing de Google.
Puedes usar la API de venta minorista para obtener resultados personalizados para tu sitio web, ya sea que uses o no las herramientas de marketing de Google. Si no lo tienes, consulta Implementación de la API de venta minorista.
Implementación de la API de venta minorista con marketing de Google
Si usas la pila de marketing de Google (Google Tag Manager y Google Merchant Center), puedes usar esos productos para proporcionar datos que la API de venta minorista pueda usar.
| Paso | Descripción |
|---|---|
| 1. Configura un proyecto de Google Cloud | Puedes usar un proyecto existente de Google Cloud si ya tienes uno. |
| 2a. Importa tu catálogo de productos con Merchant Center |
También puedes importar directamente tu catálogo de productos, pero la vinculación a Merchant Center reduce los pasos necesarios para importar tu catálogo. Ten en cuenta que Merchant Center no admite el tipo de producto de colecciones. Antes de importar, asegúrate de revisar las limitaciones de Merchant Center para verificar si satisfacen las necesidades de tu catálogo. |
| 2b. Configura Tag Manager para registrar eventos de usuarios | Los eventos de usuarios realizan un seguimiento de las acciones de los usuarios, como hacer clic en un producto, agregar un artículo a un carrito de compras o comprar un artículo. Puedes comenzar a registrar eventos de usuario en paralelo con la importación del catálogo. Una vez completada la importación del catálogo, vuelve a unirte a cualquier evento que se haya subido antes de que se complete la importación. |
| 3. Importar eventos históricos de usuarios |
Tus modelos necesitan datos de entrenamiento suficientes antes de que puedan proporcionar predicciones precisas. Proporcionar datos históricos de eventos de los usuarios te permite comenzar el entrenamiento de modelos sin tener que esperar meses para que se recopilen suficientes datos de eventos de los usuarios de tu sitio. Más información |
| 4. Crea la configuración, el modelo y los controles de entrega |
Una configuración de entrega es una entidad de entrega que asocia un modelo o un conjunto de controles que se usan para generar tus resultados de búsqueda o recomendación. Cuando creas una configuración de entrega, puedes crear un modelo (solo para Recomendaciones IA) o controles (solo para Búsqueda de venta minorista). También puedes crearlos por separado. Si usas Recomendaciones IA, elige un tipo de modelo basado en la ubicación de la configuración de entrega y sus objetivos. Revisa los tipos de recomendaciones disponibles, los objetivos de optimización y otras opciones de ajuste de modelos. a fin de determinar las mejores opciones para tus objetivos comerciales. (En el caso de la configuración de entrega de la Búsqueda de venta minorista, la API de venta minorista crea un modelo predeterminado). |
| 5. Espera el tiempo para ajustar el modelo |
Crear un modelo inicia el entrenamiento del modelo. El entrenamiento y el ajuste del modelo inicial tardan entre 2 y 5 días en completarse. |
| 6. Obtén una vista previa de la configuración de entrega |
Después de activar tu modelo, obtén una vista previa de las recomendaciones de la configuración de entrega o los resultados de la búsqueda para asegurarte de que tu configuración funcione como se espera. |
| 7. Configura un experimento A/B (opcional) |
Puedes usar un experimento A/B para comparar el rendimiento de tu sitio web cuando usas la API de venta minorista con una versión de referencia que no usa la API de venta minorista. |
| 8. Evalúa tu configuración |
Evalúa las métricas que proporciona Cloud Console para ayudarte a determinar cómo la incorporación de la API de venta minorista afecta a tu empresa. Consulta las métricas de tu proyecto en la página de Monitoring y Analytics de Cloud Console. |
Implementa la API de venta minorista
Sigue los pasos que se indican a continuación para integrar la API de venta minorista en tu sitio web.
| Paso | Descripción |
|---|---|
| 1. Configura un proyecto de Google Cloud |
Para usar la API de venta minorista, crea un proyecto de Google Cloud y crea credenciales de autenticación que incluyan una clave de API y un token de OAuth (ya sea con una cuenta de usuario o una cuenta de servicio) para acceder al proyecto. |
| 2a. Importa tu catálogo de productos |
Puedes agregar artículos a tu catálogo de productos de forma individual con el método |
| 2b. Registra eventos de usuario |
Los eventos de usuarios realizan un seguimiento de las acciones de los usuarios, como hacer clic en un producto, agregar un artículo a un carrito de compras o comprar un artículo, etcétera. La API de venta minorista se basa en datos de los eventos de los usuarios para generar resultados personalizados. Los eventos de los usuarios deben transferirse en tiempo real para reflejar con precisión el comportamiento de los usuarios. Puedes comenzar a registrar eventos de usuario en paralelo con la importación del catálogo. Una vez completada la importación del catálogo, vuelve a unirte a cualquier evento que se haya subido antes de que se complete la importación. |
| 3. Importar eventos históricos de usuarios |
Tus modelos necesitan datos de entrenamiento suficientes antes de que puedan proporcionar predicciones precisas. Proporcionar datos históricos de eventos de los usuarios te permite comenzar el entrenamiento de modelos sin tener que esperar meses para que se recopilen suficientes datos de eventos de los usuarios de tu sitio. Más información |
| 4. Crea la configuración, el modelo y los controles de entrega |
Una configuración de entrega es una entidad de entrega que asocia la configuración con un modelo o un conjunto de controles que se usan para generar los resultados de la búsqueda o de recomendaciones. Cuando creas una configuración de entrega, puedes crear un modelo o controles a la vez, o crearlos por separado. En Recomendaciones IA, la ubicación de la configuración de entrega y sus objetivos afectan el ajuste del modelo. Revisa los tipos de recomendaciones disponibles, los objetivos de optimización y otras opciones de ajuste de modelos. a fin de determinar las mejores opciones para tus objetivos comerciales. |
| 5. Espera el tiempo de entrenamiento |
Crear tu modelo o configuración de entrega comienza el entrenamiento. El entrenamiento y el ajuste del modelo inicial tardan entre 2 y 5 días en completarse. |
| 6. Obtén una vista previa de la configuración de entrega |
Después de activar la configuración, obtén una vista previa de las recomendaciones o los resultados de la búsqueda de la configuración de entrega para asegurarte de que la configuración funcione como se espera. |
| 7. Configura un experimento A/B (opcional) |
Puedes usar un experimento A/B para comparar el rendimiento de tu sitio web cuando usas la API de venta minorista con una versión de referencia que no usa la API de venta minorista. |
| 8. Evalúa tu configuración |
Evalúa las métricas que proporciona Cloud Console para ayudarte a determinar cómo la incorporación de la API de venta minorista afecta a tu empresa. Consulta las métricas de tu proyecto en la página de Monitoring y Analytics de Cloud Console. |
Condiciones del Servicio
El uso del producto se encuentra sujeto a los Términos y Condiciones de Google Cloud y la información del cliente se usará de acuerdo con la Política de Privacidad de Google.
Para garantizar la calidad, se envía un pequeño conjunto de consultas de búsqueda y resultados de la búsqueda de registros de la API de venta minorista para la calificación humana a proveedores externos, como Cognizant Worldwide Limited.