Acerca de los catálogos y los productos

En esta página se describen las prácticas recomendadas para crear la información de tu 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 para el comercio tienen un efecto directo 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 (parchear) artículos de producto que ya tenga. Solo se actualizarán los campos que haya modificado. 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. Especifique 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 se ha definido como el ID de sucursal 0, por lo que su sitio usa 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, te recomendamos que utilices solo la rama predeterminada debido al retraso de la actualización durante el cambio de rama. Si la diferencia de datos entre las ramas es grande, el retraso de la actualización puede afectar negativamente a los resultados de las predicciones.

Información obligatoria del producto

Los siguientes campos son obligatorios. 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.

Enriquecimiento de la descripción del producto

Vertex AI Search para el sector del comercio usa las URLs de los productos para enriquecer sus descripciones. 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 más detalles y señales 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. También se recomienda mantener el mismo nombre de dominio de nivel superior en todos los URIs de producto.

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. Si usas términos más específicos y precisos, aumentarás la relevancia y reducirás los problemas.

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

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

Crea un solo catálogo para cada idioma. Si opera en varios países, puede usar el mismo catálogo para proporcionar 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.

Descripción general de la jerarquía de productos

Cuando gestionas tu catálogo de productos en Vertex AI Search para el sector del comercio, 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 padres 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 elementos individuales (a nivel de SKU) y grupos de elementos 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.

Ejemplos de productos

Por ejemplo, según estos tipos de designación de producto, los productos de alimentación se catalogan mejor como productos principales, cada uno de ellos con un solo SKU, como "bananas, fresh".

Por otro lado, 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.

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 para el sector del comercio tiene una lógica que les asigna 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.

También hay un tipo de catálogo de solo variantes, que ya no se admite. Este tipo de catálogo solo se puede usar con recomendaciones. En el catálogo que solo contiene variantes, el valor de ingestionProductType se define como variant durante la importación. Se infiere un valor principal para cada variante en función del ID de producto principal especificado para cada variante.

Configurar el catálogo de productos

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

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, debe 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 obligatoria de los productos.

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.

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 para el comercio.

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 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.

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

La página Calidad de los datos de la consola de búsqueda de comercio evalúa si debe actualizar los datos del catálogo para mejorar la calidad de los resultados de búsqueda y acceder a los niveles de rendimiento de búsqueda.

En la siguiente tabla se describen las métricas de calidad que usa Vertex AI Search para el sector del comercio para ayudarte a evaluar los datos de tus productos. Para obtener más información 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 búsqueda de comercio, consulte el artículo Desbloquear niveles de rendimiento de la búsqueda.

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": [
      {
        "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"
      }
    ]
  }
]