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ê usar a pesquisa, poderá usar ramificações do catálogo para testar novos dados que você enviou off-line antes de ativá-lo 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 da Pesquisa para 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.
A atualização do cache do catálogo pode levar até 30 minutos após a mudança de filial.
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
os métodos Product, exceto import. Durante
importar, o nome é gerado automaticamente e não precisa ser
fornecidos 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 filtros 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 só podem ser itens individuais (nível SKU). Por exemplo, se o produto principal for "Camisa com gola em V", as variantes poderão ser "Camisa com gola marrom branca, tamanho XL" e "Camisa com gola branca, tamanho P". As primárias e as variantes às vezes são descritas como itens pais e filhos.
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 conjunto de joias com colar, brincos e anel. As coletâneas estão disponíveis apenas na pesquisa e não são muito usadas.
Exemplos de produtos
De acordo com esses tipos de designação, os produtos de supermercado, por exemplo, seriam produtos de SKU único, como "bananas, fresh".
Por outro lado, as camisetas seriam melhor estruturadas hierarquicamente, como primárias com o 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. 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. Esse tipo de catálogo
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 de 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 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 as recomendações e os resultados da pesquisa só retornam itens principais.
Produtos principais 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".
Essas imagens principais 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ê 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 de principal para variante.
Se você precisar mudar o tipo de um produto, exclua-o e crie 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ê pretende importar dados do catálogo do Merchant Center no futuro, revise seus dados conforme descritos para importações do Merchant Center para garantir que 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", "aguardando estoque" e "em pré-encomenda"
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 no seu catálogo.
Para mais informações sobre o inventário do produto, incluindo como manter os dados, consulte Atualizar o inventário da Vertex AI Search para varejo.
Inventário local
Os varejistas que têm lojas físicas e uma loja on-line precisam manter as 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ço, atributos do produto e métodos de retirada e envio em cada loja
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 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 produto para a Vertex AI para Pesquisa para varejo
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.