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 de catálogo que você carregou 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 upload do catálogo foi feito corretamente, você pode alternar para a ramificação 1 conforme
default_branch ao vivo.
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 ramificações é grande, o atraso na atualização pode afetar negativamente a previsão resultados.
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. Cada produto precisa ser atribuído 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 uma pesquisa, os atributos serão incluídos em um produto
na resposta de pesquisa se você marcá-los como recuperáveis em
Product.retrievableFields Eles podem ser usados para
outros recursos de pesquisa, como filtros e atributos.
Para mais informações, consulte Sobre os atributos do produto.
Níveis de produto
As designações de SKU dos produtos 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 de variante são versões de um produto principal do grupo de SKUs. As variantes só podem ser itens individuais (nível 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.
Itens de coleção são coleções de produtos. As coleções são pacotes de produtos principais ou variantes de produto. Por exemplo, uma coleção pode ser 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 estrutura de organização por SKU permite que os resultados da pesquisa e os painéis de recomendações mostrem diversos estilos de camisetas. Ela permite que o comprador detalhe uma parte principal (estilo) específica para selecionar a variante. (tamanho) até a compra.
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 campo somente da variante
catálogo, o ingestionProductType é definido como variant durante a importação. Uma instância principal
é inferido para cada variante, com base em um ID do 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 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 as SKUs dos produtos são designadas, considere as opções para configurar o 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ê for
importando, não é preciso 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 da primária para a variante.
Se precisar alterar o tipo de um produto, exclua o produto e recriar um produto com um tipo diferente. Antes de excluir uma instância principal produto, 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 alterar a configuração de um catálogo existente exige a exclusão do do catálogo e fazer o upload novamente (consulte Alterar a configuração no nível do produto).
Para informações detalhadas sobre como fazer upload de um catálogo, consulte Importar catálogo mais recentes.
Inventário de produtos
O inventário de produtos abrange:
Preço: o preço atual e o original
Disponibilidade, como "Em estoque", "Esgotado", "Esgotado" e "Encomendado"
Quantidade disponível
Informações de atendimento, como retirada na loja, envio 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 de dados na A Pesquisa no console do Retail avalia se é necessário atualizar catalogar dados para melhorar a qualidade dos resultados da pesquisa e desbloquear níveis de desempenho de 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 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 indicadores da Web rastreados por 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 do produto Vertex AI para Pesquisa para varejo abaixo para criar uma tabela do BigQuery com o formato correto e carregue-o com os dados do seu catálogo. Em seguida, importe o catálogo.