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 importados para a Vertex AI Search para varejo 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
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 do Search for Retail. 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ê usa recomendações, recomendamos usar apenas a ramificação padrão devido ao atraso na atualização durante a troca de 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. 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.
| Campo | Observações |
|---|---|
name
|
O nome exclusivo completo do recurso do produto. Obrigatório para todos
os mé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.
Campos recuperáveis
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.
Opção de pesquisa exata
É possível atribuir um valor específico para consultas de string específicas à opção de pesquisa exata, um campo de atributo do catálogo. Se uma consulta corresponder a qualquer produto no seu catálogo em que o valor desse campo for a string fornecida na consulta, ela vai retornar exatamente esse produto na consulta de pesquisa. Essa opção funciona bem para números de série, em que os clientes esperam uma experiência de pesquisa segmentada.
Um campo útil para atributos de produtos com um valor exato (como ModelId ou ManufacturerId), o campo ExactSearchableOption geralmente é usado para atributos personalizados. Atributos como "product_id" são campos de índice principais, ou seja, pesquisáveis por padrão. O campo item_id está sempre ativado para correspondência exata e não pode ser desativado.
- Para evitar a exibição de itens não relacionados nas pesquisas, nunca defina a opção pesquisável como um valor genérico, como
battery. - Para evitar a suboferta de consultas de pesquisa, não defina campos especiais como
tag, que pode ter como um dos valores de string "iphone", para pesquisa exata. Isso pode fazer com que essas consultas limitem os resultados de todos os iPhones no catálogo de produtos.
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 nas recomendações ou nos resultados da pesquisa. Os primários podem ser itens individuais (nível da SKU) e grupos 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.
Os itens de coleção são pacotes de produtos principais ou variantes de produto, como um conjunto de joias com colar, brincos e anel. Estruturas hierárquicas semelhantes a produtos e variantes, coleções agrupam produtos principais relacionados. Os clientes não podem comprar esses produtos diretamente, eles não são muito usados e só estão disponíveis na pesquisa.
Exemplos de produtos
Por exemplo, de acordo com esses tipos de designação de produtos, os itens de supermercado são melhor catalogados como produtos principais, cada um deles consiste em um único produto SKU, 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 individual (para cada tamanho) e cada item principal representa um grupo de SKUs, em que cada SKU é um tamanho diferente para um estilo de camiseta geral. 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.
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 para o varejo tem uma lógica que os credita com compras. Por exemplo: um comprador clica em produtos de um conjunto de lençóis, depois adiciona ao carrinho ou compra um produto principal dessa coleção. A coletânea recebe o crédito por essa compra, e o modelo representa com precisão a popularidade e o valor das coletâneas.
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
somente 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, 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 da estrutura de SKU dos seus produtos. 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 a SKU seja mostrada como um resultado de pesquisa ou recomendação individual: SKU=primary
- A 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/cor, essas opções geralmente são enviadas como variantes no catálogo de produtos. Considere se você quer que tipos diferentes do mesmo produto com atributos diferentes, como tamanho e cor, apareçam como um único resultado de pesquisa ou separados. Por exemplo, para um livro, você pode decidir se quer que uma SKU de capa dura e uma SKU de capa flexível do mesmo livro apareçam como resultados de pesquisa separados (SKU = principal) ou como um (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 precisa ter itens principais e variantes, ou seja, grupos de SKUs e SKUs, mas só tiver SKUs, é necessário criar itens principais para os grupos de SKUs. Essas primárias às vezes são chamadas de "primárias virtuais" 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ê 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 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 importá-lo vinculando sua conta do Merchant Center.
Se o catálogo não estiver no Merchant Center, mas no Cloud Storage, no BigQuery ou em outro armazenamento, faça 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 esteja 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", "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
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 do produto, incluindo como manter os dados de inventário, 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. Eles usam o inventário local para fazer isso.
Há dois campos de produto que podem ser usados para armazenar o inventário local. Ambos os 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 envio em cada loja
Você pode usar um ou ambos os 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 for 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 saber como conferir as métricas de qualidade de dados e os níveis de desempenho de pesquisa no console da Pesquisa para varejo, 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 de produto de varejo do Vertex AI Search 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.