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
Os dados do catálogo que você importa para a Vertex AI para Pesquisa para varejo têm efeito direto na do modelo resultante e, portanto, da qualidade da pesquisa e resultados das recomendações. 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
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 no momento (o padrão é definido como
ramificação 0) usando setDefaultBranch ou a guia Data em
Pesquise o console de varejo. Seu site usa os dados de catálogo fornecidos
pela ramificação para a qual default_branch aponta.
Por exemplo, digamos que default_branch esteja definido como 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
default_branch ativa.
O cache do catálogo pode levar até 30 minutos para ser atualizado após a troca da ramificação.
Se você usar as recomendações, recomendamos utilizar apenas o padrão devido ao atraso na atualização durante a troca da ramificação. Se a diferença de dados entre as filiais for grande, o atraso na atualização poderá afetar negativamente os resultados da previsão.
Produtos
O catálogo é um conjunto de objetos de produto.
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. Veja 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.
| Campo | Observações |
|---|---|
name
|
O nome exclusivo completo do recurso do produto. Obrigatório para todos
Product, exceto import. Durante a importação, o nome é gerado automaticamente e não precisa ser fornecido manualmente.
|
id
|
O ID do produto usado pelo banco de dados do produto. O campo "ID" precisa ser exclusivo em todo o catálogo. O mesmo valor é usado quando você
registra um evento de usuário e também é retornado pelos métodos predict
e search.
|
title
|
Título do produto do seu banco de dados de produtos. Uma string codificada em UTF-8. Limitado a 1.250 caracteres. |
categories
|
Categorias de produtos. Todos os produtos precisam ser atribuídos a pelo menos uma categoria.
Se um produto pertencer a mais de uma categoria, repita o campo para cada categoria.
O valor precisa ser uma string UTF-8 não vazia com um limite de comprimento de
5.000 caracteres. Sempre especifique o caminho completo da categoria, por exemplo:
["Sports & Fitness > Athletic Clothing > Shoes"]:
|
Atributos do produto
É altamente recomendável fornecer valores para atributos predefinidos do sistema em Product, como marca, cor e tamanho. Também é possível incluir atributos
personalizados definidos com Product.attributes.
Se você estiver usando a pesquisa, os atributos serão incluídos em um produto
na resposta da pesquisa se forem marcados como recuperáveis em
Product.retrievableFields. Eles podem ser usados para
outros recursos de pesquisa, como filtragem e atributos.
Para mais informações, consulte Sobre os atributos do produto.
Níveis de produto
As designações de SKU do produto determinam a hierarquia no seu catálogo.
Tipos de designação de produto
Há três tipos de designação de produto:
Os itens primários são retornados em recomendações ou resultados da pesquisa. As primárias podem ser itens e grupos individuais (no nível do SKU) de itens semelhantes (grupos de SKUs).
Os itens variantes são versões de um produto principal do grupo de SKUs. As variantes podem ser somente itens individuais (no nível da SKU). Por exemplo, se o produto principal for "Camisa de gola V", as variantes podem ser "Camisa de gola V marrom, tamanho XG" e "Branco Camisa de gola em V, tamanho P". As primárias e variantes às vezes são descritas como itens parent e child.
Os itens de coleção são coleções de produtos. As coleções são pacotes de produtos principais ou variantes. Por exemplo, uma coleção pode ser um conjunto de joias com colar, brincos e anel. As coleções são apenas disponíveis na pesquisa e não são amplamente usados.
Exemplos de produtos
De acordo com esses tipos de designação de produto, os mantimentos, por exemplo, consistiam em produtos com uma SKU única, como "bananas, fresh".
Por outro lado, as camisetas seriam mais bem estruturadas hierarquicamente, como primárias com seu conjunto correspondente de variantes. Cada variante representa uma SKU (para cada tamanho), e cada item principal representa um grupo de SKUs, em que cada SKU tem um tamanho diferente para um estilo de camiseta abrangente. 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 camiseta. Ele permite que o comprador acesse um item principal específico (estilo) para selecionar a variante (tamanho) a ser comprada.
Há também um tipo de catálogo somente de variantes, que foi descontinuado. Este catálogo
tipo só pode ser usado com recomendações. Para o catálogo
apenas de variantes, o ingestionProductType é definido como variant durante a importação. Um primário
é inferido para cada variante, com base em um ID do produto principal especificado para cada
variante.
Configurar o catálogo de produtos
Ao planejar seu catálogo de produtos, decida se ele contém produtos designados apenas como primários, primários e variantes ou uma combinação dos dois arranjos. Pense nisso em termos dos seus produtos estrutura de SKU. Seus produtos podem ser itens principais, que podem ou não ter variantes.
Com base na forma como os SKUs dos produtos são designados, considere as opções de configuração do catálogo de produtos:
- Você quer que sua SKU seja mostrada como um resultado da pesquisa ou uma recomendação individual: SKU=primary
- A SKU precisa fazer parte de um grupo de SKUs semelhantes: SKU=variante, grupo de SKUs=primárias
Uma combinação 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/cor, geralmente essas opções serão enviadas como variantes no seu catálogo de produtos. Considere se você quer ou não que diferentes tipos do mesmo produto com atributos distintos, como tamanho e cor, apareçam como um único resultado da pesquisa ou separados. Por exemplo, para um livro, decida se você quer que uma SKU de capa dura e uma SKU de capa especial 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 a recomendação e os resultados da pesquisa retornam apenas itens principais.
Produtos primários mínimos
Se você determinar que seu catálogo deve ter primários e variantes, isso grupos de SKUs e SKUs, mas, no momento, você só tem SKUs, primárias para os grupos de SKUs. Às vezes, essas primárias são chamadas primárias" ou "primárias falsas".
Esses primários só precisam conter informações mínimas: id, title e
categories
Se type não for especificado, o tipo de produto será definido por padrão 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.
O tipo é imutável
Não é possível mudar o tipo de um produto, por exemplo, de variante para principal ou de principal para variante.
Se precisar alterar o tipo de um produto, exclua o produto e recriar um produto com um tipo diferente. Antes de excluir um produto principal, as variantes associadas precisam ser excluídas.
Importação de catálogo
Se você tiver seu catálogo no Merchant Center, recomendamos importar seu catálogo vinculando seu conta do Merchant Center.
Se o catálogo não estiver no Merchant Center, mas o Cloud Storage, o BigQuery ou outro tipo de armazenamento, fazer uma importação de dados em massa.
Se você planeja importar dados do catálogo do Merchant Center na No futuro, revise seus dados conforme descrito para as importações do Merchant Center para garantir que você está fazendo as escolhas corretas sobre seu catálogo. Isso é importante porque, para mudar a configuração de um catálogo, é necessário excluí-lo e fazer upload novamente. Consulte Mudar a configuração no nível do produto.
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", "Encomendado" e "Encomendado"
Quantidade disponível
Informações de atendimento, como retirada na loja, frete para a loja e entrega no dia seguinte
Existem dois níveis de inventário: 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 do produto, incluindo como manter os dados de inventário, consulte Atualizar o inventário da Vertex AI Search para varejo.
Inventário local
Varejistas que têm lojas físicas e lojas on-line precisam manter informações de inventário por loja. Para isso, ele usa o inventário local.
Há dois campos de produto que podem ser usados para armazenar o inventário local. Ambos 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ços, produto atributos e métodos de retirada e envio em cada filial
Você pode usar um ou ambos os campos para suas informações no nível da loja.
Para mais informações sobre inventários locais, consulte Atualizar o inventário local de Vertex AI para Pesquisa para Retail
Métricas de qualidade de dados do catálogo
A página Qualidade dos dados no console da Pesquisa para varejo avalia se você precisa atualizar os dados do catálogo para melhorar a qualidade dos resultados da pesquisa e desbloquear níveis de desempenho da pesquisa.
A tabela a seguir descreve as métricas de qualidade que a Vertex AI para Pesquisa para varejo usa para ajudar você a avaliar os dados do seu produto. Para detalhes sobre como visualizar a qualidade de dados métricas e níveis de desempenho de pesquisa no console do Search for Retail; consulte Desbloquear níveis de desempenho de pesquisa.
| Métrica de qualidade do catálogo | Regra de qualidade | Observações |
|---|---|---|
| O URI está presente e acessível | O produto tem um Product.uri válido. O URI precisa estar acessível e corresponder ao seu domínio. |
A pesquisa usa sinais da Web rastreados usando esse URI para melhorar a qualidade da pesquisa. |
| Atende à conformidade de tempo | Product.availableTime é anterior ao horário atual, e Product.expireTime é anterior ao horário atual. |
Somente produtos em conformidade com o horário estão disponíveis para pesquisa. |
| O atributo pesquisável está presente | O produto tem pelo menos um attribute definido para pesquisa. |
Os atributos personalizados marcados como pesquisáveis podem ser pesquisados por consultas de texto. |
| A descrição está presente | O produto não tem um Product.description vazio. |
Uma descrição abrangente ajuda a melhorar a qualidade da pesquisa. |
| O título consiste em pelo menos duas palavras | Product.title consiste em pelo menos duas palavras. |
Um título abrangente ajuda a melhorar a qualidade da pesquisa. |
| Tem variante com imagem | O produto variant tem pelo menos um Product.image. Você poderá ignorar essa métrica se todos os seus produtos estiverem no nível primary. |
Essa métrica é apenas informativa e não afeta a qualidade da pesquisa. |
| Tem variante com informações de preço | O produto variant tem Product.priceInfo definido. Você poderá ignorar essa métrica se todos os seus produtos estiverem no nível primary. |
Essa métrica é apenas informativa e não afeta a qualidade da pesquisa. |
Esquema de produtos da Vertex AI para Pesquisa para Retail
Ao importar um catálogo do BigQuery, use o esquema de produto de varejo do Vertex AI Search abaixo 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.