Acerca de los catálogos y los productos

En esta página, se proporcionan prácticas recomendadas para crear la información y propagar los datos de tu catálogo.

Descripción general

El catálogo es una colección de objetos de productos.

Los datos del catálogo que importas a Vertex AI Search para el comercio tienen un efecto directo en la calidad del modelo resultante y, por lo tanto, en la calidad de los resultados de la búsqueda y las recomendaciones. En general, cuanto más precisa y específica sea la información del catálogo que puedas proporcionar, mejor será la calidad de tu modelo.

Tu catálogo debe mantenerse actualizado. Puedes subir los cambios del catálogo con la frecuencia que sea necesaria. Idealmente, todos los días para catálogos con una alta tasa de cambio. Puedes subir (actualizar) elementos de productos existentes; solo se actualizarán los campos modificados. No se aplican cargos por subir información del catálogo. Para obtener más información, consulta Cómo mantener tu catálogo actualizado.

Ramas del catálogo

Ramas del catálogo con búsqueda

Si usas la búsqueda, puedes usar las ramas del catálogo para probar los datos nuevos que subiste sin conexión antes de que se publiquen en tu sitio.

Puedes usar hasta tres ramas, identificadas como 0, 1 y 2. Tu sitio en vivo apunta a default_branch para sus datos del catálogo. Especifica qué rama es tu default_branch en vivo (la predeterminada está configurada como 0 de la rama) con setDefaultBranch o la pestaña Datos en la consola de Search for commerce. Luego, tu sitio usa los datos del catálogo que proporciona la rama a la que apunta default_branch.

Por ejemplo, supongamos que default_branch está configurado en el ID de rama 0, por lo que tu sitio usa los datos del catálogo que subiste a esa rama. Puedes subir datos de catálogos nuevos a la rama 1 y obtener una vista previa. Una vez que confirmes que el catálogo se subió de forma correcta, puedes cambiar a la rama 1 como default_branch en vivo.

La caché del catálogo puede tardar hasta 30 minutos en actualizarse después de cambiar de rama.

Si usas recomendaciones, te sugerimos que solo uses la rama predeterminada debido a la demora en la actualización durante el cambio de rama. Si la diferencia de datos entre las ramas es grande, la demora en la actualización puede afectar negativamente los resultados de la predicción.

Información requerida del producto

Los siguientes campos son obligatorios: Debes proporcionar valores para ellos cuando creas elementos de productos en tu catálogo. También deben corresponder a los valores usados en tu base de datos interna de productos y deben reflejar con precisión el producto representado, ya que se incluyen en el entrenamiento de tus modelos.

En algunos casos, también se requieren otros campos. Consulta la lista completa de todos los campos de productos en la página de referencia de Product.

Toda la información del producto que proporcionas se puede usar para mejorar la calidad de las recomendaciones y los resultados de la búsqueda. Asegúrate de proporcionar tantos campos como sea posible.

Categorías del catálogo

En esta sección, se describe la estructura del catálogo y cómo designarlo para su uso en la taxonomía y el filtrado.

Estructura del catálogo

El campo categories del catálogo debe contener la ruta de categoría más detallada para cada producto. No se requieren categorías principales y no deben incluirse.

A continuación, se muestra un ejemplo de cómo estructurar tu catálogo:

• Correcto: categories: ["Flowers, Cards, Occasion > Seasonal Items > Christmas"]
• Incorrecto: categories: ["Flowers, Cards, Occasion", "Flowers, Cards, Occasion > Seasonal Items", "Flowers, Cards, Occasion > Seasonal Items > Christmas"]

Categorías principales

Las categorías principales de un producto determinado no deben incluirse en el campo categories. El filtrado para la navegación se debe controlar con otros atributos personalizados.

Nombres de categorías

Los nombres de las categorías deben elegirse con cuidado para evitar introducir palabras clave incorrectas y mejorar el rendimiento. Usar términos más específicos y precisos mejorará la relevancia y reducirá los problemas.

• Recomendado: Comida congelada > Frutas congeladas
• No se recomienda: Frutas y verduras congeladas > Frutas congeladas

Estructura específica del proyecto a nivel del catálogo

Crea un solo catálogo para cada idioma. Si operas en varios países, puedes usar el mismo catálogo para proporcionar resultados de la búsqueda en diferentes países.

Proporciona precios, que se determinan a través de los inventarios locales, en la misma moneda en todos los países. Si los precios varían entre países, crea un inventario local para cada país. Especifica los precios allí.

Para optimizar tus resultados de la búsqueda, proporciona el nombre de cada país como SearchRequest.entity y UserEvent.entity. Las entidades de país se usan solo para fines de clasificación.

Descripción general de la jerarquía de productos

Cuando administras tu catálogo de productos en Vertex AI Search para comercio, es fundamental comprender cómo se controlan los atributos de los productos primarios y las variantes para que las búsquedas y las recomendaciones sean eficaces. Las designaciones de SKU de productos determinan la jerarquía del catálogo.

Tipos de designación de productos

Existen tres tipos de designaciones de productos:

1. Los elementos principales o superiores se muestran en los resultados de las recomendaciones o las búsquedas, y sirven como contenedores lógicos o grupos de elementos similares. Los artículos principales pueden ser elementos individuales (a nivel del SKU) y grupos de elementos similares (grupos de SKU).

2. Los artículos variantes o secundarios son versiones específicas e individuales de un producto principal del grupo de SKU. Por ejemplo, si el producto principal es camisa con cuello en V,las variantes podrían ser camisa marrón con cuello en V, talle XL y camisa blanca con cuello en V, talle S.

3. Los artículos de Colección son paquetes de productos principales o productos variantes, como un conjunto de joyas con un collar, aretes y un anillo. Las estructuras jerárquicas similares a los productos y las variantes, las colecciones agrupan los productos principales relacionados. Los clientes no pueden comprarlos directamente, no se usan de forma generalizada y solo están disponibles en la búsqueda.

Ejemplos de productos

Por ejemplo, según estos tipos de designación de productos, los artículos de supermercado se catalogan mejor como productos principales, cada uno de los cuales consta de un solo producto SKU, como"bananas, fresh".

Por otro lado, las camisetas se estructurarían mejor de forma jerárquica, como elementos principales con su conjunto correspondiente de variantes. Cada variante representa un SKU individual (para cada tamaño) y cada artículo principal representa un grupo de SKU, en el que cada SKU es un tamaño diferente para un estilo general de camiseta. Esta organización por estructura de SKU permite que los resultados de la búsqueda y los paneles de recomendaciones muestren una variedad de estilos de camisetas. Permite que el comprador profundice en un estilo principal en particular para seleccionar la variante (tamaño) que desea comprar.

Las colecciones agrupan productos relacionados que un cliente podría comprar. Para representarlos con precisión en el modelo de nuevo ranking, Vertex AI Search para el comercio tiene una lógica que los acredita con las compras. Por ejemplo, un comprador hace clic en los productos de un juego de sábanas y, luego, agrega al carrito o compra un producto principal de esa colección. Se le otorga crédito a la colección por esa compra, y el modelo representa con precisión la popularidad y el valor de las colecciones.

También existe un tipo de catálogo solo para variantes, que ahora es obsoleto. Este tipo de catálogo solo se puede usar con recomendaciones. En el catálogo solo de variantes, ingestionProductType se establece en variant durante la importación. Se infiere un producto principal para cada variante, según el ID de producto principal especificado para cada variante.

Configura tu catálogo de productos

Cuando planifiques tu catálogo de productos, debes decidir si contendrá productos designados solo como principales, principales y variantes, o una combinación de ambos. Piensa en la estructura de los SKU de tus productos. Tus productos pueden ser artículos principales, que pueden tener variantes o no.

Según cómo se designen los SKU de tus productos, considera las opciones para configurar tu catálogo de productos:

• Quieres que tu SKU se muestre como un resultado de la búsqueda o una recomendación individual: SKU=principal
• Tu SKU debe formar parte de un grupo de SKU similares: SKU=variante, grupo de SKU=principal
• Una combinación de ambas combinaciones: SKU=principal, SKU=variante, grupo de SKU=principal

Si en la página de detalles del producto se muestra un selector de opción, tamaño o color, estas opciones suelen subirse como variantes en tu catálogo de productos. Considera si quieres que los diferentes tipos del mismo producto con diferentes atributos, como el tamaño y el color, aparezcan como un solo resultado de la búsqueda o como resultados separados. Por ejemplo, para un libro, puedes decidir si quieres que un SKU de tapa dura y un SKU de tapa blanda del mismo libro aparezcan como resultados de la búsqueda separados (SKU = principal) o como uno solo (SKU = variante, grupo de SKU = principal).

Cuando configures tu catálogo de productos, ten en cuenta que los resultados de las recomendaciones y las búsquedas solo muestran elementos principales.

Productos principales mínimos

Si determinas que tu catálogo debe tener tanto productos principales como variantes, es decir, grupos de SKU y SKU, pero solo tienes SKU ahora, debes crear productos principales para los grupos de SKU. A veces, estos colores primarios se denominan colores primarios virtuales o falsos.

Estos elementos principales solo deben contener información mínima: id, title y categories.

Si no se especifica type, el tipo de producto se establece de forma predeterminada como principal. Si realizas una importación, no es necesario que especifiques name. Para obtener más información, consulta la sección anterior, Información del producto requerida.

Importación de catálogos

Si tu catálogo está en Cloud Storage, BigQuery o algún otro almacenamiento, realiza una importación masiva de datos.

Para obtener información detallada sobre cómo subir un catálogo, consulta Importa información del catálogo.

Inventario de productos

El inventario de productos abarca lo siguiente:

• El precio, tanto el actual como el original

• Disponibilidad, como en stock, agotado, pendiente y pedido por adelantado

• Cantidad disponible

• Información de cumplimiento, como retiro en la tienda, envío a la tienda y entrega al día siguiente

Existen dos niveles de inventario: a nivel del producto y local.

Inventario a nivel del producto

En el caso de los minoristas que solo venden en línea, el inventario se especifica a nivel del producto. Se establecen el precio, la disponibilidad y otros datos del inventario para cada producto del catálogo.

Para obtener más información sobre el inventario a nivel del producto, incluido cómo mantener los datos del inventario, consulta Actualiza el inventario de Vertex AI Search para el comercio.

Inventario local

Los minoristas que tienen tiendas físicas y una tienda en línea deben mantener la información del inventario por tienda. Para ello, utilizan el inventario local.

Hay dos campos de productos que se pueden usar para almacenar el inventario local. Ambos campos son listas de ubicaciones (IDs de lugar) con información de inventario asociada:

• Product.fulfillmentInfo. Métodos de retiro y envío en cada ubicación de la tienda

• Product.localInventories. Información de precios, atributos del producto y métodos de retiro y envío en cada ubicación de la tienda

Puedes usar uno o ambos campos para la información a nivel de la tienda.

Para obtener más información sobre los inventarios locales, consulta Actualiza el inventario local para Vertex AI Search for Commerce.

Estructura del inventario de variantes principales

La estructura de datos de inventario de variantes principales se compone de productos principales, variantes y de inventario local:

• Productos principales: Los datos de los productos principales se almacenan sin precios.

• Productos variantes (con el precio más bajo en todo el país): Por ejemplo, la variante del producto principal (color, tamaño) debe tener el precio más bajo en todo el país. Los datos de precios de las variantes se agregan a los datos del producto principal, y el precio principal se usa a su vez para fines de clasificación. Se ignoran los precios específicos de la ubicación.

• Inventario local (precios específicos de la región o la tienda): Utiliza la información de precios del inventario local en la clasificación de nuevo en el momento de la publicación.

• Atributos del producto principal: Los productos principales solo deben incluir atributos comunes a todas sus variantes asociadas.

Métricas de calidad de los datos del catálogo

En la página Calidad de los datos de la consola de Búsqueda para comercio, se evalúa si necesitas actualizar los datos del catálogo para mejorar la calidad de los resultados de la búsqueda y desbloquear los niveles de rendimiento de la búsqueda.

En la siguiente tabla, se describen las métricas de calidad que usa Vertex AI Search para comercio para ayudarte a evaluar los datos de tus productos. Para obtener detalles sobre cómo ver las métricas de calidad de los datos y los niveles de rendimiento de la búsqueda en la consola de Search for commerce, consulta Cómo desbloquear los niveles de rendimiento de la búsqueda.

Esquema de productos

Cuando importes un catálogo desde BigQuery, usa el siguiente esquema de productos de Vertex AI Search para comercio electrónico para crear una tabla de BigQuery con el formato correcto y cargarla con los datos de tu catálogo. Luego, importa el catálogo.

[
  {
    "name": "name",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "id",
    "type": "STRING",
    "mode": "REQUIRED"
  },
  {
    "name": "type",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "primaryProductId",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "collectionMemberIds",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "gtin",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "categories",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "title",
    "type": "STRING",
    "mode": "REQUIRED"
  },
  {
    "name": "brands",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "description",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "languageCode",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "attributes",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "key",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "value",
        "type": "RECORD",
        "mode": "NULLABLE",
        "fields": [
          {
            "name": "text",
            "type": "STRING",
            "mode": "REPEATED"
          },
          {
            "name": "numbers",
            "type": "FLOAT",
            "mode": "REPEATED"
          }
        ]
      }
    ]
  },
  {
    "name": "tags",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "priceInfo",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "currencyCode",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "price",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "originalPrice",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "cost",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "priceEffectiveTime",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "priceExpireTime",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "rating",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "ratingCount",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "averageRating",
        "type": "FLOAT",
        "mode": "NULLABLE"
      },
      {
        "name": "ratingHistogram",
        "type": "INTEGER",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "expireTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "ttl",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "seconds",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "nanos",
        "type": "INTEGER",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "availableTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "availability",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "availableQuantity",
    "type": "INTEGER",
    "mode": "NULLABLE"
  },
  {
    "name": "fulfillmentInfo",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "type",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "placeIds",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "uri",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "images",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "uri",
        "type": "STRING",
        "mode": "REQUIRED"
      },
      {
        "name": "height",
        "type": "INTEGER",
        "mode": "NULLABLE"
      },
      {
        "name": "width",
        "type": "INTEGER",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "audience",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "genders",
        "type": "STRING",
        "mode": "REPEATED"
      },
      {
        "name": "ageGroups",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "colorInfo",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "colorFamilies",
        "type": "STRING",
        "mode": "REPEATED"
      },
      {
        "name": "colors",
        "type": "STRING",
        "mode": "REPEATED"
      }
    ]
  },
  {
    "name": "sizes",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "materials",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "patterns",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "conditions",
    "type": "STRING",
    "mode": "REPEATED"
  },
  {
    "name": "publishTime",
    "type": "STRING",
    "mode": "NULLABLE"
  },
  {
    "name": "promotions",
    "type": "RECORD",
    "mode": "REPEATED",
    "fields": [
      {
        "name": "promotionId",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  }
]