Esta es la documentación solo de Recomendaciones IA. Para probar Retail Search y la consola unificada de venta minorista en la fase restringida de Google Analytics, comuníquese con el equipo de Ventas de Cloud. Si no planea usar Retail Search, permanezca en la consola de Recomendaciones hasta nuevo aviso.

Si usas la versión v1beta de Recomendaciones IA, migra a la versión minorista de la API.

Preguntas frecuentes

¿Tienes otras dificultades o tu problema no se describe en esta página? Informa un error o solicita una característica y únete al grupo de Google cloud-recommendations-users o a los debates de Stack Overflow.

General

¿Tienes bibliotecas cliente para la API de venta minorista o más código de muestra?

Sí. Puedes consultar la guía de las bibliotecas cliente de Recomendaciones IA aquí para obtener información sobre la configuración y la referencia de cada biblioteca.

El servicio de descubrimiento de la API de Google también se puede usar en lugar de las llamadas REST sin procesar.

¿Todos los modelos de recomendación son personalizados?

Los modelos “Recomendado para ti” y “Otras opciones que podrían gustarte” hacen recomendaciones personalizadas cuando se les proporciona el historial del usuario. El modelo "Se suelen comprar juntos" no es personalizado.

Consulta Tipos de modelos de recomendaciones.

¿Recibiré recomendaciones personalizadas de inmediato o necesito esperar a que mejoren con el tiempo?

Las recomendaciones mejoran a medida que recopilas un historial más extenso. En el modelo “Recomendado para ti”, se muestran productos populares, mientras que en el modelo “Otras opciones que podrían gustarte” se muestran productos similares basados, en su mayoría, en las vistas de otros. Ambos modelos comienzan a tener en cuenta el comportamiento de los usuarios de inmediato, por lo que es importante enviar eventos en tiempo real. Consulta Tipos de modelos de recomendaciones.

Los eventos del usuario deben enviarse en tiempo real, o muy cerca del tiempo real, para que la personalización sea efectiva. Si los eventos de los usuarios solo se envían a diario o por lotes a lo largo del día, es posible que los modelos personalizados no tengan un buen rendimiento como tendrían si se enviaran eventos en tiempo real.

¿Usas los datos demográficos de los usuarios de Google en tus modelos?

Los modelos solo usan los datos del catálogo y de los eventos del usuario que proporciones. Si deseas incluir datos demográficos, puedes incluir otros atributos personalizados textuales o numéricos que podrían ser útiles en Product.attributes[]. Los modelos no usan estos datos, pero es posible que se usen en el futuro.

No incluyas información de identificación personal (PII), como direcciones de correo electrónico o nombres de usuario. Te sugerimos anonimizar los datos demográficos, por ejemplo, mediante el hash de los valores o el uso de los ID de grupos.

¿Puedo hacer recomendaciones basadas en el historial de eventos de un grupo de usuarios, en lugar del historial de un solo usuario?

En la actualidad, las recomendaciones se basan en un solo ID de visitante o de usuario. Deberás realizar solicitudes individuales y, luego, combinar los resultados para basar las recomendaciones en el historial de un grupo. Si los usuarios tienen atributos de metadatos comunes, puedes usar los ID de grupo como ID de usuario para proporcionar recomendaciones a nivel de grupo.

Noté que se pueden enviar las URL de las imágenes para los productos. ¿Los modelos toman en cuenta las imágenes del producto?

No. Estos campos se proporcionan a fin de que puedas recuperar estos metadatos junto con los resultados de las recomendaciones que se muestran, para ayudar a procesar los resultados de las recomendaciones. En la vista previa de la predicción, también se usan las URL de las imágenes para mostrar las imágenes cuando obtienes una vista previa de los resultados de la predicción de un modelo en Cloud Console.

Mi empresa no es un sitio web de comercio electrónico minorista. ¿Puedo usar Recomendaciones IA para predecir x,y,z?

Tuvimos clientes que usaron Recomendaciones IA para recomendaciones de contenido, transmisión de video por Internet y videojuegos, y otros casos de uso. Sin embargo, actualmente, nuestro contenido y experiencia están diseñados para el caso de uso del comercio electrónico de venta minorista, y es posible que aún no sea adecuado para otros casos de uso.

¿Puedo colocar recomendaciones en cualquier página de mi sitio?

Sí, pero los modelos están diseñados para casos de uso específicos y pueden funcionar mejor en determinadas páginas. Consulta Tipos de modelos de recomendaciones.

"Con frecuencia se compran juntos" y "Otras opciones que podrían gustarte" requieren ID de artículo, por lo que deben usarse para recomendaciones mediante, por ejemplo, un ID de producto o artículos en un carrito. Por lo general, "Con frecuencia se compran juntos" suele funcionar mejor en las páginas de agregar al carrito o durante la confirmación de la compra, mientras que “Otras opciones que te pueden gustar” funciona mejor en las páginas de detalles de los productos. "Recomendado para ti" se puede colocar en cualquier página, ya que solo requiere un ID de visitante como entrada, pero está diseñada como una ubicación en la página principal.

¿Puedo usar Recomendaciones IA para obtener recomendaciones en los boletines informativos por correo electrónico?

Sí. Esto se puede hacer llamando a la API con un ID de visitante o de usuario y, luego, incorporando los resultados en una plantilla de correo electrónico. Si quieres que los elementos se carguen de forma dinámica durante la lectura de correos electrónicos, deberás usar un extremo intermediario, como unaGoogle Cloud Function, para enviar la solicitud de predicción. La API solo proporciona una lista de los ID y metadatos del producto ordenados, por lo que también deberás escribir tu propio código para procesar los resultados de la imagen.

¿Puedo usar Recomendaciones IA para otros casos de uso que no sean de la Web (apps para dispositivos móviles, kioscos)?

Sí. Puedes configurar un extremo (p. ej., Google Cloud Function) a fin de obtener los resultados de la app. También necesitas un mecanismo similar para enviar eventos en tiempo real.

No tengo más de 3 meses de datos de eventos. ¿Aún así puedo usar Recomendaciones IA? ¿Puedo agregar más datos en otro momento?

Si puedes registrar suficiente tráfico para los eventos en tiempo real, se pueden usar datos recientes a fin de realizar el entrenamiento. Si tienes datos adicionales disponibles más adelante, puedes subirlos después del entrenamiento inicial del modelo. Los datos recién reabastecidos se incorporan a los modelos durante el reentrenamiento diario. Sin embargo, si los datos son bastante diferentes de los eventos que se usaron para el entrenamiento inicial, es posible que se deban ajustar los modelos.

Los modelos funcionan mejor con al menos tres meses de páginas vistas de productos, páginas principales vistas y eventos de agregar al carrito para todos los modelos. Lo ideal sería entre uno y dos años de historial de compras para "Con frecuencia se compran juntos".

Una o dos semanas de páginas de detalles vistas pueden ser suficientes para comenzar a entrenar los modelos “Otras opciones que te podrían gustar” y “Recomendado para ti”, mientras que “Con frecuencia se compran juntos” por lo general, se necesitan más, ya que, generalmente, hay menos compras por día que páginas vistas. La calidad del modelo puede mejorarse de forma significativa con más datos; es posible que la cantidad mínima no produzca resultados óptimos. Por ejemplo, el año de compras permite que los modelos aprovechen mejor la temporada y las tendencias.

¿Puedo recomendar categorías y productos juntos?

Por el momento, Recomendaciones IA solo muestra recomendaciones de productos, pero puedes obtener las categorías de cada producto que se muestran como parte de los resultados.

¿Puedo implementar Recomendaciones IA en un sitio web sin modificar el código de mi servidor existente?

Esto es posible, pero aún necesitas un extremo para controlar la solicitud AJAX porque la API de predicción de venta minorista está autenticada y usa una solicitud POST. Esto se puede hacer mediante una función de Google Cloud Functions, App Engine o un servicio similar.

¿Tienes integraciones para subir datos de bases de datos SQL o de otros sistemas, como BigQuery?

Sí. Para los eventos, hay código de muestra que lee desde BigQuery. Consulta un conjunto de datos de muestra de Google Analytics para BigQuery.

Creo que la función x,y,z sería excelente. ¿Se puede agregar esto a Recomendaciones IA?

Nos gustaría conocer tu opinión. Las solicitudes de funciones se pueden enviar a través del equipo de cuentas, la Atención al cliente de Google o la herramienta de seguimiento de errores.

¿Puedo seguir usando la API anterior?

Recomendaciones IA se migró de la API de Recommendations Engine a la API de venta minorista. Si usabas la API de Recomendaciones Engine mientras estaba en versión Beta, te recomendamos migrar las recomendaciones a la API de venta minorista (https://retail.googleapis.com del extremo de servicio), que es GA.

La API anterior (https://recommendationengine.googleapis.com del extremo de servicio) y su documentación permanecen disponibles, pero ya no se actualizan.

Catálogos y productos

¿Cómo administra Recomendaciones IA los inicios en frío para los productos nuevos?

Para los productos que no tienen historial de compras, ofrecemos recomendaciones basadas en productos similares. En estos casos, es muy importante tener títulos, categorías y descripciones de productos definidos en el catálogo.

Para los usuarios de inicio en frío (visitantes sin historial), los modelos comienzan con los productos generales más populares y se vuelven más personalizados en tiempo real a medida que se reciben más eventos de usuario.

Consulta Catálogos e información de los catálogos y la página de referencia del producto.

¿Puedo usar mi catálogo de Merchant Center para obtener recomendaciones?

Sí, puedes exportar un catálogo de Merchant Center a BigQuery mediante el Servicio de transferencia de datos de Merchant Center. Luego, podemos leer el catálogo directamente desde BigQuery. Consulta Importa datos de catálogos desde Merchant Center.

¿De qué otra manera puedo importar mi catálogo?

¿Cómo puedo mantener mi catálogo actualizado? ¿Con qué frecuencia se debe actualizar el catálogo?

Consulta Mantenimiento de tu catálogo actualizado.

Si tienes una manera fácil de recibir notificaciones sobre los cambios del catálogo (como a través de Pub/Sub, la cola de mensajes, eventos, etc.), puedes actualizar el catálogo en tiempo real mediante la importación o la creación de métodos de la API.

De lo contrario, te recomendamos que actualices tu catálogo a diario. Puedes realizar una actualización completa desde Cloud Storage o BigQuery, o una actualización incremental (es decir, solo elementos nuevos y modificados).

Por ejemplo, Cloud Scheduler se puede usar para realizar una llamada de importación diaria de BigQuery.

¿Hay tamaños de catálogo mínimos y máximos?

No hay un mínimo, pero los tamaños de catálogo muy pequeños (menos de 100 elementos) podrían no ver mucho el beneficio de las recomendaciones debido a que hay muy pocos productos diferentes para recomendar.

El catálogo máximo es de 40 millones de artículos.

Consulta la documentación para conocer las cuotas y los límites predeterminados y cómo solicitar un cambio en tu cuota.

Mi empresa opera sitios web en varios países. ¿Debo usar un catálogo para todos mis datos?

Por lo general, es mejor tener solo un catálogo con todos los elementos. Los eventos se deben enviar todos con una sola moneda. Por el momento, no hay forma de tener varios catálogos dentro del mismo proyecto, pero las recomendaciones se pueden filtrar a un sitio específico mediante etiquetas de filtro.

Si los catálogos son bastante diferentes entre los sitios y los patrones de los eventos del usuario también son bastante diferentes, por lo general, recomendamos tener un proyecto separado para cada sitio con sus propias recomendaciones independientes.

Sin embargo, si hay sitios similares con poco tráfico en comparación con el sitio principal, puede ser mejor usar un solo catálogo si no hay suficientes eventos que produzcan modelos de alta calidad para todos los sitios individuales.

Para usar un solo catálogo, los ID de los elementos del catálogo deben ser coherentes, es decir, el mismo producto debe tener un solo ID de artículo en todos los sitios para que no haya duplicación de productos dentro del catálogo.

Las etiquetas de filtro pueden tardar hasta 24 horas en actualizarse, por lo que si hay requisitos de disponibilidad específicos del país (agotado), en general, deben manejarse mediante una regla empresarial que filtre los resultados después de la respuesta de predicción.

¿Recomendaciones IA admite varias monedas por catálogo?

No, Recomendaciones IA admite un tipo de moneda por catálogo. Los eventos se deben subir a Recomendaciones IA con una sola moneda.

Si planeas usar Cloud Console para Recomendaciones IA para obtener tus métricas de ingresos, asegúrate de que todos tus eventos usen una sola moneda o conviértelos en la misma moneda antes subirlos a Recomendaciones IA.

Tengo varios sitios web con un catálogo compartido o artículos similares. ¿Recomendaciones IA puede proporcionar recomendaciones entre sitios?

Por lo general, recomendamos usar un solo catálogo como este solo si hay una superposición significativa entre los sitios; deben compartir muchos o todos los mismos productos. Luego, al igual que con los sitios multirregión, puedes usar etiquetas de filtro a fin de mostrar solo los elementos específicos del sitio para una llamada de predicción en particular.

Si los sitios no comparten muchos elementos del catálogo o ninguno, o tienen patrones de uso muy diferentes, se deben usar varios catálogos. Usar varios catálogos requiere un proyecto de Google Cloud separado para cada catálogo.

¿Incluir más metadatos mejora el modelo? ¿El modelo considera los campos x,y,z?

Consulta la Información obligatoria del elemento de catálogo para ver los campos obligatorios.

Otros campos de metadatos son opcionales (p. ej., imágenes, itemAttributes). Se pueden usar para la vista previa de la predicción, el análisis de resultados, el entrenamiento y el ajuste. Recomendamos incluir atributos útiles, como color, tamaño, material, etcétera. Estos campos se pueden mostrar como parte de los resultados de la predicción si se especifica returnProduct:true, de forma que puedan ser útiles para renderizar los resultados. Los atributos de imágenes y elementos se usan para la vista previa de la predicción en Cloud Console.

¿Qué atributos de un elemento de catálogo se usan como entradas de entrenamiento de modelos?

Se usa una combinación del comportamiento del usuario y de los atributos del producto. Los campos principales utilizados son ID, título, jerarquía de categorías, precio y URL. Puedes incluir otros atributos clave-valor personalizados que podrían ser útiles en Product.attributes[].

Las URL de imágenes son una función más conveniente; Puedes mostrar estos metadatos como parte de los resultados de la predicción si especificas returnProduct:true, que puede guardar una llamada adicional para recuperar esta información. Tener URL de imágenes también permite que la vista previa de la predicción muestre las imágenes cuando obtienes una vista previa de los resultados de la predicción de un modelo en Cloud Console.

¿Qué idiomas son compatibles con mis productos?

La API de venta minorista es compatible con la mayoría de los idiomas. El modelo detecta automáticamente el idioma del texto. Consulta el README de GitHub del detector de lenguaje compacto para obtener una lista de los lenguajes admitidos.

Ten en cuenta que tu catálogo puede incluir texto en diferentes idiomas, pero duplicar productos para proporcionar texto en varios idiomas puede degradar el rendimiento del modelo.

Mi catálogo tiene SKU principales o de variantes, o superiores o secundarias. ¿Son compatibles?

Sí. Esto sería similar a item_group_id en Merchant Center. Debes determinar cómo quieres obtener las recomendaciones (a nivel del superior o del secundario) y si los eventos están en el nivel del superior o del secundario.

Consulta cómo usar los niveles de producto para obtener más información sobre los niveles de producto.

Determina y establece el nivel de producto correcto antes de enviar cualquier artículo o evento. El nivel de producto se puede cambiar, pero requiere volver a unir los elementos y volver a ajustar los modelos.

Eventos del usuario

¿Puedo integrarlo en Google Analytics 360?

Puede usar datos históricos de Google Analytics 360 (GA360). Al igual que los datos de Merchant Center, los datos de GA360 se pueden exportar a BigQuery y, luego, Recomendaciones IA puede leer los eventos directamente desde BigQuery.

Para eventos en tiempo real, recomendamos integrar píxeles de seguimiento en Google Tag Manager, ya que los eventos se retrasan desde GA360.

¿Cómo ingreso los eventos en Recomendaciones IA?

Los usuarios suelen importar eventos históricos mediante Cloud Storage o la importación de API y, luego, transmitir eventos en tiempo real con la etiqueta de JavaScript, Pixel o Tag Manager en el sitio en vivo, o a través del método de escritura en el backend.

¿Qué sucede si no puedo enviar todos los tipos de eventos de usuario enumerados como se requiere para un modelo? ¿Cuáles son los tipos de eventos mínimos necesarios para cada modelo?

Cada modelo y objetivo de optimización tiene requisitos que pueden diferir un poco entre sí. Consulta los Requisitos de datos de los eventos del usuario.

El rendimiento del modelo suele ser mejor cuando hay más eventos por elemento de catálogo. Para los sitios con una gran cantidad de tráfico y catálogos más pequeños, es posible que puedas comenzar con un volumen menor de eventos históricos, pero, por lo general, necesitarás al menos unas pocas semanas de datos históricos y eventos en tiempo real en el futuro.

Tengo eventos de agregar al carrito y completar la compra que no tienen un valor para el ingreso o la cantidad. ¿Qué debo enviar?

Si no tienes un valor de cantidad, puedes pasar un valor predeterminado de 1 sin afectar los resultados del modelo. Los artículos siempre deben tener un precio visible establecido (todo lo que se muestre al usuario, como un precio con descuento). El costo y el precio original son opcionales.

Mis datos solo abarcaron tipos de eventos limitados. ¿Aún así puedo usar Recomendaciones IA?

Consulta los Requisitos de los datos de eventos del usuario para conocer los requisitos mínimos de datos de cada tipo de modelo.

Resultados de la predicción

¿Existe un límite para la cantidad de predicciones que puedo mostrar?

De forma predeterminada, una solicitud de predicción muestra 20 elementos en la respuesta. Esto se puede aumentar o disminuir si envías un valor para pageSize.

Si necesitas mostrar más de 100 elementos, comunícate con el equipo de Atención al cliente de Google para aumentar el límite. Sin embargo, ten en cuenta que mostrar más de 100 elementos puede aumentar la latencia de respuesta.

¿Puedo ver los motivos por los que un modelo hizo una recomendación específica del producto?

En este momento, no.

¿Puedo descargar y almacenar en caché los resultados de la predicción?

Debido a que los resultados de la predicción mejoran en tiempo real como respuesta a la actividad del usuario en tu sitio, no recomendamos usar predicciones almacenadas en caché. Los modelos se vuelven a entrenar a diario para incorporar cambios en tu catálogo y reaccionar a tendencias nuevas en los eventos del usuario, lo que también cambia los resultados.

Necesito volver a revisar las recomendaciones que se muestran en función de una regla empresarial. ¿Esto es compatible?

Sí. Si bien puedes volver a clasificar las recomendaciones que se muestran según tus reglas empresariales, ten en cuenta que reordenar o filtrar los resultados recomendados puede reducir la efectividad general del modelo para lograr el objetivo de optimización que elegiste.

La reclasificación de precios ordena los elementos relevantes con precios altos primero en el conjunto de recomendaciones que se muestran y está disponible como una personalización integrada para los modelos “Otras opciones que podrían gustarte” y “Recomendado para ti”.

Consulta Reclasificación de precios.

¿Existen restricciones para la cantidad de etiquetas de filtro que puedo crear y usar?

No hay límites estrictos para la cantidad de etiquetas únicas que puedes crear o usar. Sin embargo, el sistema no está diseñado para manejar muchas etiquetas de filtro por elemento. Recomendamos mantener las etiquetas de filtro limitadas a un máximo de 10 por elemento de catálogo si es posible. Se pueden usar más de 10 valores en todo el catálogo. Este es un límite por elemento. El límite para las etiquetas totales (la suma total de todos los recuentos de etiquetas por artículo) es de 100,000,000.

Consulta la documentación para ver las cuotas y los límites de Recomendaciones IA.

Modelos

Subí mi catálogo y mis eventos, pero sigo recibiendo esta respuesta cuando llamo a la API de predicción: “El modelo de recomendación no está listo. Puedes configurar “dryRun” como verdadero en la solicitud de predicción con fines de integración, lo que muestra elementos arbitrarios del catálogo (NO lo uses para el tráfico de producción)”.

Por lo general, esto significa que tu modelo no terminó de entrenarse. Si transcurrieron más de 10 días desde que creaste el modelo y sigues recibiendo esta respuesta, comunícate con el equipo de asistencia.

¿Cuánto tiempo se necesita para entrenar un modelo?

El entrenamiento y el ajuste del modelo inicial tardan entre 2 y 5 días en completarse. Luego, los modelos se vuelven a entrenar automáticamente a diario, a menos que estén inhabilitados. Consulta Pausar y reanudar el entrenamiento para un modelo.

¿Puedo descargar o exportar el modelo?

No

¿Puedo usar modelos que creé en un proyecto existente en un proyecto nuevo?

No. Debes crear y volver a entrenar los modelos en el proyecto nuevo.

Quiero usar un modelo para mis páginas de categorías. ¿Puedo hacerlo?

Sí. “Recomendado para ti” es útil en las páginas de categorías. Una página de categorías es similar a una página principal, excepto que se muestran solo los elementos de esa categoría. Puedes lograr esto mediante un modelo estándar recomendado para ti con etiquetas de filtro. Por ejemplo, puedes agregar etiquetas de filtro personalizadas (correspondientes a cada página de categoría) a los elementos de tu catálogo. Cuando envíes la solicitud de predicción, configura el objeto del evento de usuario como category-page-view y especifica la etiqueta de página de una categoría específica en el campo “filter”. Solo se muestran los resultados de la recomendación que coinciden con la etiqueta de filtro solicitada. En este caso de uso, se debe inhabilitar la diversidad, ya que la diversidad puede entrar en conflicto con las etiquetas de filtro basadas en categorías.

¿Puedo inhabilitar la personalización de mis modelos?

De forma predeterminada, el usuario personaliza los resultados de la predicción para los tipos de modelo de recomendación “Otras opciones que podrían gustarte” y “Recomendado para ti”.

No se recomienda inhabilitar la personalización porque puede afectar de forma negativa el rendimiento del modelo.

Si necesitas mostrar elementos de catálogo relevantes para el producto que se visualiza en lugar que se basen en las interacciones anteriores del usuario con tu sitio, es posible recibir recomendaciones no personalizadas mediante un ID de visitante falso en una solicitud de predicción. Asegúrate de hacerlo solo para solicitudes en ubicaciones que no quieras que se personalicen.

Cloud Console de Recomendaciones IA

Borré definitivamente varios eventos, pero el panel aún muestra los recuentos de esos tipos de eventos.

Esta situación es esperable. En el panel de Cloud Console, se muestra la cantidad de eventos transferidos durante un período determinado. No se muestran el recuento actual ni la cantidad de eventos.

¿Cómo me doy cuenta si hay errores en mi catálogo o los eventos del usuario?

La mayoría de las llamadas a la API para actualizaciones de elementos del catálogo o eventos de usuario muestran un error si hay un problema con la sintaxis o si la solicitud no se puede procesar por algún motivo.

En el panel de Cloud Console, se muestra el porcentaje de eventos no unidos, que también es una métrica útil para usar en la detección de problemas de catálogos o eventos. Los eventos no unidos (o las llamadas de predicción no unidas) ocurren cuando se especifica un ID de elemento que no está en el catálogo. Por lo general, esto significa que el catálogo está desactualizado y que se deben subir los elementos del catálogo nuevos o modificados, pero también puede deberse a que se pasan ID de elementos incorrectos. Revisa las solicitudes para asegurarte de que los ID de elementos se asignen al catálogo de forma correcta y, luego, revisa el catálogo que subiste para asegurarte de que existan.

Cloud Monitoring y Cloud Logging se pueden usar para supervisar el estado de los eventos. Por ejemplo, puedes recibir alertas si no hay eventos durante un período determinado o si las llamadas de predicción se encuentran por debajo de un umbral determinado.

¿Por qué mis ubicaciones de recomendación se muestran como inactivas? ¿Cómo las activo?

Para usar ubicaciones de recomendación, primero debes enviar el catálogo y los datos de eventos del usuario a fin de entrenar el modelo correspondiente. Una vez que se entrenó un modelo, el panel indica que está listo para consultar.

¿En qué moneda Cloud Console informa las métricas de ingresos?

Cloud Console de Recomendaciones IA informa las métricas en la moneda que se usa en tus datos subidos. Recomendaciones IA no admite el uso de varias monedas por catálogo y no convierte monedas.

Si planeas usar Cloud Console para Recomendaciones IA para obtener tus métricas de ingresos, asegúrate de que todos tus eventos usen una sola moneda o conviértelos en la misma moneda antes subirlos a Recomendaciones IA.