Acerca de los catálogos y los productos

En esta página se describen las prácticas recomendadas para crear la información de su catálogo y rellenar los datos del catálogo.

Información general

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

Los datos del catálogo que importes en Vertex AI Search for commerce influyen directamente en la calidad del modelo resultante y, por lo tanto, en la calidad de los resultados de búsqueda y recomendación. En general, cuanto más precisa y específica sea la información del catálogo que proporciones, mayor será la calidad del modelo.

Tu catálogo debe estar actualizado. Puede subir los cambios del catálogo con la frecuencia que necesite. Lo ideal es que lo haga todos los días en el caso de los catálogos con una alta tasa de cambios. Puede subir (aplicar un parche) elementos de producto que ya tenga. Solo se actualizarán los campos modificados. No se aplican cargos por subir información de catálogos. Para obtener más información, consulta el artículo Mantener actualizado el catálogo.

Ramas de catálogo

Ramas de catálogo con búsqueda

Si usas la búsqueda, puedes usar ramas de catálogo para probar los nuevos datos que has subido sin conexión antes de publicarlos en tu sitio.

Puedes usar hasta tres ramas, identificadas como 0, 1 y 2. Tu sitio activo apunta a default_branch para obtener los datos del catálogo. Especifica qué rama es la activa default_branch (la predeterminada es la rama 0) mediante setDefaultBranch o la pestaña Datos de la consola de búsqueda de comercio. A continuación, su sitio usa los datos del catálogo proporcionados por la sucursal a la que apunta default_branch.

Por ejemplo, supongamos que default_branch tiene el ID de sucursal 0, por lo que su sitio utiliza los datos del catálogo que ha subido a esa sucursal. Puedes subir nuevos datos de catálogo a la rama 1 y obtener una vista previa. Una vez que haya confirmado que el catálogo se ha subido correctamente, puede cambiar a la rama 1 como default_branch activa.

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

Si usas recomendaciones, utiliza solo la rama predeterminada debido al retraso de la actualización al cambiar de rama. Si la diferencia de datos entre las ramas es grande, el retraso en la actualización puede afectar negativamente a los resultados de las predicciones.

Información obligatoria del producto

Los siguientes campos son obligatorios, por lo que debe proporcionar valores para ellos cuando cree artículos de producto en su catálogo. También deben corresponderse con los valores utilizados en su base de datos de productos interna y reflejar con precisión el producto representado, ya que se incluyen en el entrenamiento de sus modelos.

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

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

Categorías de catálogo

En esta sección se describe la estructura del catálogo y cómo designarlo para usarlo 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 de cada producto. Las categorías principales no son obligatorias y no deben incluirse.

A continuación, se muestra un ejemplo de cómo estructurar su 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 de la navegación debe gestionarse mediante otros atributos personalizados.

Nombres de las 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 mejora la relevancia y reduce los problemas.

• Recomendado: Alimentos congelados > Frutas congeladas
• No recomendado: Frutas y verduras congeladas > Frutas congeladas

Estructura específica de un proyecto a nivel de catálogo

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

Proporcione 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 de un país a otro, cree un inventario local para cada país. Especifica sus precios allí.

Para optimizar los resultados de búsqueda, indique el nombre de cada país como SearchRequest.entity y UserEvent.entity. Utilice entidades de país solo con fines de clasificación.

Estructura del producto

Cuando gestionas tu catálogo de productos en Vertex AI Search for commerce, es fundamental que sepas cómo se gestionan los atributos de los productos principales y de las variantes para que la búsqueda y las recomendaciones sean eficaces. Las designaciones de SKU de producto determinan la jerarquía del catálogo.

Tipos de designación de producto

Hay tres tipos de designación de producto:

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

2. Los artículos con variantes o secundarios son versiones específicas e individuales de un producto principal de un grupo de SKUs. Por ejemplo, si el producto principal es Camiseta de cuello de pico,las variantes podrían ser Camiseta de cuello de pico marrón, talla XL y Camiseta de cuello de pico blanca, talla S.

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

Jerarquías de clasificación de productos

Con los tres tipos a nivel de producto, hay tres jerarquías de clasificación de productos principales:

• Variante principal: la variante principal casi siempre es solo un marcador de posición de información (común) y las variantes son las SKUs reales que se pueden comprar. Por ejemplo, las camisetas se estructurarían mejor de forma jerárquica, como elementos principales con su conjunto de variantes correspondiente. Cada variante representa un SKU individual (para cada talla) y cada artículo principal representa un grupo de SKUs, donde cada SKU es una talla diferente de un estilo de camiseta general. Esta organización por estructura de SKU permite que los resultados de búsqueda y los paneles de recomendaciones muestren una variedad de estilos de camisetas. Permite al comprador desglosar un estilo principal concreto para seleccionar la variante (talla) que quiere comprar.
• Solo principal: según estos tipos de designación de producto, los productos de alimentación se catalogan mejor como productos principales, cada uno de los cuales consta de un solo producto de SKU, como"bananas, fresh".
• Colecciones: las colecciones agrupan productos relacionados que un cliente podría comprar. Para representarlos con precisión en el modelo de reordenación, Vertex AI Search for commerce tiene una lógica que les atribuye las compras. Por ejemplo, un comprador hace clic en los productos de un juego de sábanas y, a continuación, añade al carrito o compra un producto principal de esa colección. La colección se atribuye a esa compra y el modelo representa con precisión la popularidad y el valor de las colecciones.

Productos con una variante

En el caso de los productos que tienen una variante, estructúrelos como primario-variante, ya que esto ofrece varias ventajas:

• La página de búsqueda tiene resultados diversos que se pueden mostrar a los usuarios finales. De lo contrario, si las variantes se trataran como productos principales, la página de resultados de búsqueda se llenaría con los mismos productos.
• Los productos tienen un sistema de clasificación más completo, ya que los productos principales con variantes se clasifican mejor si una variante concreta recibe más interacciones. Esto ayuda a volver a clasificar y optimizar los ingresos.
• Facilidad para mantener el catálogo. Si un atributo cambia en un grupo de productos que solo se diferencian en la talla, puede hacerlo mediante una estructura de variante principal. Por ejemplo, puede cambiar el atributo a nivel principal en lugar de cambiar varios elementos principales.
• Las funciones de la API y los campos de respuesta de búsqueda de las claves de acumulación de variantes y los campos recuperables solo se admiten en las variantes.
• La respuesta de búsqueda contiene los detalles mínimos de la variante principal y más detalles de las variantes. Por lo tanto, siempre tienes que aumentar o enriquecer la respuesta de búsqueda con detalles adicionales, que Vertex AI Search for commerce puede devolver si se marcan como recuperables.

Configurar el catálogo de productos

Al planificar su catálogo de productos, debe decidir si contiene productos designados como principales, principales y variantes, o una combinación de ambos. Piensa en la estructura de los SKUs de tus productos. Sus productos pueden ser artículos principales, que pueden tener variantes.

En función de cómo se designen los SKUs de tus productos, ten en cuenta las opciones que tienes para configurar tu catálogo de productos:

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

Si en la página de detalles de su producto se muestra un selector de opciones, tallas o colores, estas opciones suelen subirse como variantes a su catálogo de productos. Decida si quiere que los diferentes tipos del mismo producto con atributos distintos, como la talla y el color, aparezcan como un único resultado de búsqueda o como resultados independientes. Por ejemplo, en el caso de un libro, puede decidir si quiere que el SKU de la edición de tapa dura y el de la edición de tapa blanda del mismo libro aparezcan como resultados de búsqueda independientes (SKU = principal) o como uno solo (SKU = variante, grupo de SKUs = principal).

Cuando configure su catálogo de productos, tenga en cuenta que las recomendaciones y los resultados de búsqueda solo devuelven artículos principales.

Productos principales mínimos

Si determina que su catálogo debe tener tanto productos principales como variantes (es decir, grupos de SKUs y SKUs), pero solo tiene SKUs, debe crear productos principales para los grupos de SKUs. A veces, estas primarias se denominan primarias virtuales o primarias falsas.

Estas primarias solo deben contener información mínima: id, title y categories.

Si no se especifica type, el tipo de producto será el principal de forma predeterminada. Si vas a importar, no es necesario que especifiques name. Para obtener más información, consulta la sección anterior Información de producto obligatoria.

Importación de catálogos

Si tu catálogo está en Cloud Storage, BigQuery u otro almacenamiento, haz una importación de datos en bloque.

Para obtener información detallada sobre cómo subir un catálogo, consulta el artículo Importar información de catálogos.

Corrección de la URL del producto

El campo product.uri es la URL canónica que enlaza directamente con la página de detalles del producto. Debe ser un URI rastreable públicamente y no estar protegido por ningún muro de inicio de sesión o autorización. Esto se debe a que el backend rastrea la página web de la URI y obtiene la mayor cantidad de información posible, que se usa para calcular la relevancia y la popularidad. El backend también determina cómo se ha interactuado con el URI en la Web, incluidos los enlaces de retroceso. El nombre de dominio de nivel superior debe ser el mismo en todos los URIs de producto.

Si tiene el mismo producto en varios sitios de banners, le recomendamos que utilice la función de varias entidades. Ponte en contacto con el equipo de la cuenta para tratar este tema.

Vertex AI Search for commerce usa las URLs de los productos para enriquecer sus descripciones. Si usa una URL diferente en el catálogo de productos que en el sitio web, asegúrese de que ambas URLs hagan referencia al mismo producto y tengan información casi idéntica.

Las URLs de producto mejoran los catálogos de las siguientes formas:

• Enriquecer los datos de producto: Vertex AI Search para el comercio extrae información complementaria rastreando el URI del producto, el identificador de recurso único que se encuentra detrás de la ubicación exacta de cada producto en la Web (URL). Este proceso ayuda a obtener detalles y señales adicionales de las páginas web vinculadas. El conocimiento más profundo de los productos que se obtiene mediante el rastreo de URIs contribuye directamente a la calidad de los datos del catálogo.
• Mejorar la calidad y la relevancia de la búsqueda: las señales web recogidas de los URIs rastreados se usan para mejorar la calidad de la búsqueda. El backend utiliza la información rastreada, incluida la forma en que se ha interactuado con el URI en la Web (por ejemplo, cuando el usuario hace clic en enlaces de retroceso), para asignar puntuaciones de relevancia y popularidad en los resultados de búsqueda.
• Proporcionar una base para el entrenamiento de modelos: además del ID, el título, la jerarquía de categorías y el precio del producto, las URLs se consideran uno de los campos principales que se usan como entradas para el entrenamiento de modelos.

Para maximizar las ventajas de las URLs de producto, siga estas prácticas recomendadas:

• Se debe poder acceder públicamente a la página web enlazada y debe cargarse correctamente. No debe estar protegida por un muro de inicio de sesión o autenticación.
• Cada URI debe ser único y apuntar siempre a la página web del producto correcto. Su contenido debe reflejar con precisión la información de los productos del catálogo. Mantener el mismo nombre de dominio de nivel superior en todos los URIs de producto.

Inventario de productos

El inventario de productos incluye lo siguiente:

• Precio (tanto el actual como el original)

• Disponibilidad (por ejemplo, en stock, agotado, bajo pedido o reservado)

• Cantidad disponible

• Información sobre la gestión de pedidos, como la recogida en tienda, el envío a tienda y la entrega al día siguiente

Hay dos niveles de inventario: a nivel de producto y local.

Inventario a nivel de producto

En el caso de los comerciantes que solo venden online, el inventario se especifica a nivel de producto. El precio, la disponibilidad y otros datos de inventario se definen para cada producto del catálogo.

Para obtener más información sobre el inventario a nivel de producto, incluido cómo mantener los datos de inventario, consulte Actualizar el inventario de Vertex AI Search for commerce.

Inventario local

Los comercios que tengan tiendas físicas y una tienda online deben mantener la información del inventario de cada tienda. Para ello, usan el inventario local.

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

• Product.fulfillmentInfo. Métodos de recogida y envío en cada tienda

• Product.localInventories. Información sobre los precios, atributos de los productos y métodos de recogida y envío en cada tienda

Puede usar uno de los campos o ambos para proporcionar información a nivel de tienda.

Para obtener más información sobre los inventarios locales, consulte el artículo Actualizar el inventario local en Vertex AI Search for commerce.

Estructura de 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 producto principales se almacenan sin precios.

• Productos variantes (con el precio más bajo en el país): por ejemplo, la variante del producto principal (color, talla) debe tener el precio más bajo en el país. Los datos de precios de las variantes se agregan a los datos de producto principales, y el precio principal se utiliza para la clasificación. Los precios específicos de una ubicación se ignoran.

• Inventario local (precios específicos de una región o una tienda): usa la información de precios del inventario local para volver a clasificar los productos en el momento de la publicación.

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

Corrección de la disponibilidad de los productos

El sistema de actualización de inventario asigna el valor del campo de disponibilidad a medida que cambia el estado del stock del producto. Hacer un seguimiento de todos los productos que están en estado IN_STOCK y OUT_OF_STOCK.

Si la mayoría de los productos tienen el valor OUT_OF_STOCK, la respuesta de búsqueda tendrá muchos productos agotados y, al añadir un filtro, se reducirán las cifras de recuerdo. Si el producto se ha agotado, pero el estado del catálogo es IN_STOCK, los usuarios verán que el producto está disponible, pero probablemente tengan problemas a la hora de comprarlo o añadirlo al carrito. Esto influye más en la experiencia del cliente que en el entrenamiento del modelo. Mantén el campo Product.availability lo más actualizado posible mediante las APIs patchProduct o las APIs de importación con un readMask.

Esquema de producto

Cuando importes un catálogo de BigQuery, usa el siguiente esquema de producto de Vertex AI Search for commerce para crear una tabla de BigQuery con el formato correcto y cargarla con los datos de tu catálogo. A continuación, 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": [
      {