Sobre catálogos e produtos

Esta página informa as práticas recomendadas para criar informações do catálogo e preencher os dados do catálogo.

Visão geral

O catálogo é um conjunto de objetos de produto.

Os dados do catálogo importados para a Vertex AI para Pesquisa no comércio têm um efeito direto na qualidade do modelo resultante e, portanto, na qualidade dos resultados de pesquisa e recomendação. Em geral, quanto mais precisas e específicas forem as informações de catálogo que você fornecer, maior será a qualidade do seu modelo.

Seu catálogo precisa estar atualizado. É possível fazer upload das alterações do catálogo quantas vezes forem necessárias. Idealmente, todos os dias para catálogos com uma alta taxa de mudanças. É possível fazer upload (patch) de itens de produto existentes somente os campos alterados serão atualizados. Não há cobrança pelo upload das informações do catálogo. Para mais informações, consulte Como manter seu catálogo atualizado.

Ramificações do catálogo

Ramificações do catálogo com pesquisa

Se você usa a pesquisa, pode usar as ramificações do catálogo para testar novos dados enviados off-line antes de disponibilizá-los no seu site.

É possível usar até três ramificações, identificadas como 0, 1 e 2. Seu site ativo aponta para default_branch para os dados do catálogo. Especifique qual ramificação é a default_branch ativa (o padrão é definido como ramificação 0) usando setDefaultBranch ou a guia "Dados" no console de pesquisa para comércio. Em seguida, seu site usa os dados do catálogo fornecidos pela ramificação para que o default_branch aponta.

Por exemplo, digamos que default_branch esteja definido com o ID da ramificação 0. Portanto, seu site está usando os dados do catálogo que você enviou para essa ramificação. Você pode fazer upload de novos dados de catálogo para a ramificação 1 e visualizá-los. Depois de confirmar que o catálogo foi enviado corretamente, mude para a ramificação 1 como a default_branch ativa.

O cache do catálogo pode levar até 30 minutos para ser atualizado após a troca de ramificação.

Se você usa recomendações, recomendamos usar apenas a ramificação padrão devido ao atraso na atualização durante a troca de ramificações. Se a diferença de dados entre as ramificações for grande, o atraso na atualização poderá afetar negativamente os resultados da previsão.

Informações obrigatórias do produto

Os campos a seguir são obrigatórios. É preciso fornecer valores a eles ao criar itens de produtos no catálogo. Eles também precisam corresponder aos valores usados no banco de dados interno do produto e refletir com precisão o produto representado, porque estão incluídos no treinamento dos modelos.

Em alguns casos, outros campos também são obrigatórios. Consulte a lista completa de todos os campos de produtos na página de referência Product.

Todas as informações do produto que você fornece podem ser usadas para melhorar a qualidade das recomendações e dos resultados da pesquisa. Forneça o maior número possível de campos.

Categorias do catálogo

Esta seção descreve a estrutura do catálogo e como designá-lo para uso em taxonomia e filtragem.

Estrutura do catálogo

O campo categories no catálogo precisa conter o caminho de categoria mais granular para cada produto. As categorias principais não são obrigatórias e não devem ser incluídas.

Veja um exemplo de como estruturar seu catálogo:

• Correto: categories: ["Flowers, Cards, Occasion > Seasonal Items > Christmas"]
• Incorreto: categories: ["Flowers, Cards, Occasion", "Flowers, Cards, Occasion > Seasonal Items", "Flowers, Cards, Occasion > Seasonal Items > Christmas"]

Categorias principais

As categorias principais de um determinado produto não devem ser incluídas no campo categories. A filtragem para navegação precisa ser feita usando outros atributos personalizados.

Nomeação de categorias

Os nomes de categorias precisam ser escolhidos com cuidado para evitar palavras-chave incorretas e melhorar a performance. Usar termos mais específicos e precisos aumenta a relevância e reduz os problemas.

• Recomendado: Alimentos congelados > Frutas congeladas
• Não recomendado: Frutas e legumes congelados > Frutas congeladas

Estrutura específica do projeto no nível do catálogo

Crie um catálogo para cada idioma. Se você opera em vários países, pode usar o mesmo catálogo para fornecer resultados da pesquisa em diferentes locais.

Forneça preços, que são determinados por inventários locais, na mesma moeda em todos os países. Se os preços variarem entre os países, crie um inventário local para cada um deles. Especifique os preços lá.

Para otimizar os resultados da pesquisa, forneça o nome de cada país como SearchRequest.entity e UserEvent.entity. Use entidades de país apenas para fins de classificação.

Visão geral da hierarquia de produtos

Ao gerenciar seu catálogo de produtos na Vertex AI para Pesquisa no comércio, é fundamental entender como os atributos são processados para produtos principais e variantes para uma pesquisa e recomendações eficazes. As designações de SKU de produto determinam a hierarquia do catálogo.

Tipos de designação de produto

Há três tipos de designação de produto:

1. Os itens principais ou parentes são retornados em recomendações ou resultados de pesquisa e servem como contêineres lógicos ou grupos de itens semelhantes. Os produtos principais podem ser itens individuais (nível da SKU) e grupos de itens semelhantes (grupos da SKU).

2. Os itens variantes ou secundários são versões específicas e individuais de um produto principal do grupo de SKUs. Por exemplo, se o produto principal for camisa com gola em V,as variantes poderão ser camisa com gola em V marrom, tamanho XL e camisa com gola em V branca, tamanho P.

3. Os itens de coleção são pacotes de produtos principais ou variantes de produto, como um conjunto de joias com um colar, brincos e um anel. Estruturas hierárquicas semelhantes a produtos e variantes, as coleções agrupam produtos principais relacionados. Os clientes não podem comprar esses anúncios diretamente, eles não são muito usados e estão disponíveis apenas na pesquisa.

Exemplos de produtos

Por exemplo, de acordo com esses tipos de designação de produto, os itens de supermercado são mais bem catalogados como produtos principais, cada um consistindo em um único produto de SKU, como"bananas, fresh".

Por outro lado, as camisetas seriam mais bem estruturadas hierarquicamente, como principais com o conjunto correspondente de variantes. Cada variante representa uma SKU individual (para cada tamanho), e cada item principal representa um grupo de SKUs, em que cada SKU é um tamanho diferente para um estilo geral de camiseta. Essa organização por estrutura de SKU permite que os resultados da pesquisa e os painéis de recomendação mostrem uma variedade de estilos de camisetas. Ele permite que o comprador detalhe um estilo principal específico para selecionar a variante (tamanho) a ser comprada.

As coleções agrupam produtos relacionados que um cliente pode comprar. Para representá-los com precisão no modelo de reclassificação, a Vertex AI para Pesquisa de comércio tem uma lógica que os credita com compras. Por exemplo, um comprador clica em produtos em um conjunto de lençóis e adiciona ao carrinho ou compra um produto principal nessa coleção. A compra é atribuída à coleção, e o modelo representa com precisão a popularidade e o valor das coleções.

Também há um tipo de catálogo somente de variantes, que agora está descontinuado. Esse tipo de catálogo só pode ser usado com recomendações. Para o catálogo somente de variantes, o ingestionProductType é definido como variant durante a importação. Um produto principal é inferido para cada variante com base em um ID de produto principal especificado para cada variante.

Configurar seu catálogo de produtos

Ao planejar seu catálogo de produtos, você precisa decidir se ele contém produtos designados como apenas principais, principais e variantes ou uma mistura dos dois arranjos. Pense na estrutura de SKU dos seus produtos. Seus produtos podem ser itens principais, que podem ou não ter variantes.

Com base em como os SKUs dos produtos são designados, considere as opções para configurar o catálogo de produtos:

• Você quer que sua SKU apareça como um resultado de pesquisa ou recomendação individual: SKU=primary
• Sua SKU precisa fazer parte de um grupo de SKUs semelhantes: SKU=variante, grupo de SKUs=principal
• Uma mistura das duas combinações: SKU=principal, SKU=variante, grupo de SKUs=principal

Se a página de detalhes do produto mostrar um seletor de opção, tamanho ou cor, essas opções geralmente são enviadas como variantes para o catálogo de produtos. Considere se você quer que diferentes tipos do mesmo produto com atributos diferentes, como tamanho e cor, apareçam como um único resultado da pesquisa ou separados. Por exemplo, para um livro, você precisa decidir se quer que uma SKU de capa dura e uma de capa flexível do mesmo livro apareçam como resultados de pesquisa separados (SKU = principal) ou como um só (SKU = variante, grupo de SKUs = principal).

Ao configurar seu catálogo de produtos, lembre-se de que as recomendações e os resultados da pesquisa retornam apenas itens principais.

Produtos principais mínimos

Se você determinar que seu catálogo deve ter produtos principais e variantes, ou seja, grupos de SKUs e SKUs, mas só tiver SKUs agora, crie produtos principais para os grupos de SKUs. Às vezes, essas primárias são chamadas de primárias virtuais ou falsas.

Essas chaves precisam conter apenas informações mínimas: id, title e categories.

Se type não for especificado, o tipo de produto será definido como "principal". Se você estiver importando, não será necessário especificar name. Para mais informações, consulte a seção anterior, Informações obrigatórias do produto.

Importação de catálogo

Se o catálogo estiver no Cloud Storage, no BigQuery ou em outro armazenamento, faça uma importação de dados em massa.

Para informações detalhadas sobre como fazer upload de um catálogo, consulte Importar informações do catálogo.

Inventário de produtos

O inventário de produtos inclui:

• Preço, tanto o atual quanto o original

• Disponibilidade, como em estoque, esgotado, aguardando estoque e em pré-venda

• Quantidade disponível

• Informações de fulfillment, como retirada na loja, frete para a loja e entrega no dia seguinte

Há dois níveis de inventário: no nível do produto e local.

Inventário no nível do produto

Para varejistas que vendem apenas on-line, o inventário é especificado no nível do produto. O preço, a disponibilidade e outros dados de inventário são definidos para cada produto no catálogo.

Para mais informações sobre o inventário no nível do produto, incluindo como manter dados de inventário, consulte Atualizar o inventário da Vertex AI para Pesquisa de comércio.

Inventário local

Os varejistas que têm lojas físicas e on-line precisam manter as informações de inventário por loja. Eles usam o inventário local para fazer isso.

Há dois campos de produto que podem ser usados para armazenar inventário local. Os dois campos são listas de locais (IDs de lugar) com informações de inventário associadas:

• Product.fulfillmentInfo. Métodos de retirada e envio em cada loja

• Product.localInventories. Informações de preço, atributos do produto e métodos de retirada e frete em cada local da loja

Você pode usar um ou os dois campos para as informações da loja.

Para mais informações sobre inventários locais, consulte Atualizar o inventário local para a Vertex AI Search para e-commerce.

Estrutura de inventário de variante principal

A estrutura de dados de inventário de variante principal é composta por produtos principais, variantes e inventários locais:

• Produtos principais: os dados de produtos principais são armazenados sem preços.

• Produtos variantes (com o menor preço em todo o país): por exemplo, a variante do produto principal (cor, tamanho) precisa ter o menor preço em todo o país. Os dados de preço da variante são acumulados nos dados do produto principal, e o preço principal é usado para fins de classificação. Os preços específicos de local são ignorados.

• Inventário local (preços específicos da região ou da loja): use as informações de preço do inventário local na reclassificação no momento da veiculação.

• Atributos principais do produto: os produtos principais só podem incluir atributos comuns a todas as variantes associadas.

Métricas de qualidade de dados do catálogo

A página Qualidade de dados no console de pesquisa para comércio avalia se você precisa atualizar os dados do catálogo para melhorar a qualidade dos resultados da pesquisa e desbloquear níveis de performance da pesquisa.

A tabela a seguir descreve as métricas de qualidade que a Vertex AI para Pesquisa no comércio usa para ajudar você a avaliar os dados de produtos. Para detalhes sobre como ver as métricas de qualidade de dados e os níveis de desempenho da pesquisa no console de pesquisa para comércio, consulte Desbloquear níveis de desempenho da pesquisa.

Esquema de produto

Ao importar um catálogo do BigQuery, use o seguinte esquema de produto da Pesquisa da Vertex AI para e-commerce para criar uma tabela do BigQuery com o formato correto e carregá-la com os dados do catálogo. Em seguida, importe o 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"
      }
    ]
  }
]