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 de catálogo importados para a Vertex AI para Pesquisa para o varejo têm 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ê usar a pesquisa, poderá usar ramificações do catálogo para testar novos dados enviados off-line antes de ativá-los no 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 é o default_branch ativo no momento (ele é definido como
0 por padrão) usando setDefaultBranch ou a guia "Data" no
console do Search for Retail. Seu site usa os dados de catálogo fornecidos
pela ramificação para que o default_branch aponta.
Por exemplo, digamos que default_branch esteja definido atualmente 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
o default_branch ativo.
O cache de catálogo pode levar até 30 minutos para ser atualizado após a troca da ramificação.
Se você usar recomendações, recomendamos utilizar apenas a ramificação padrão, devido ao atraso na atualização durante a alternância de ramificação. Se a diferença de dados entre as ramificações for grande, o atraso da 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
a importação, o nome é gerado automaticamente e não precisa ser
fornecido de forma manual.
|
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 deve 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 codificada em 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 com um produto
na resposta da pesquisa se você os marcar 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 atributos do produto.
Níveis de produto
Os níveis de produto determinam a hierarquia no seu catálogo. Normalmente, é necessário escolher entre um catálogo de nível único ou de dois níveis.
Por exemplo, é possível ter um catálogo de nível único em que cada item de produto tem uma SKU. Como alternativa, você pode escolher um catálogo de dois níveis que contenha grupos de SKUs e SKUs individuais.
Tipos no nível do produto
Há três tipos no nível do produto:
Os itens principais são retornados nas recomendações ou nos resultados da pesquisa. As primárias podem ser itens individuais (no nível da SKU) e grupos de itens semelhantes (grupos de SKU).
Os itens variantes são versões de um produto principal no grupo de SKUs. As variantes podem ser apenas itens individuais (no nível da SKU). Por exemplo, se o produto principal for "Camisa com gola V", as variantes poderão ser "Camisa marrom com gola V, tamanho XG" e "Camisa branca com gola V, tamanho P". Às vezes, os itens primários e as variantes são descritos como itens parent e parent.
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 um conjunto de joias com um colar, brincos e um anel. As coleções estão disponíveis apenas na pesquisa e não são amplamente usadas.
Sobre a hierarquia de catálogo
Ao planejar a hierarquia do catálogo, é necessário decidir se ele precisa conter apenas primárias ou primárias e variantes. É importante lembrar que a previsão e os resultados da pesquisa retornam apenas itens principais.
Por exemplo, um catálogo somente principal pode funcionar bem para a venda de livros, em que um painel de recomendações retorna uma seleção de livros, cada um com a própria SKU. No entanto, um catálogo apenas principal para camisetas provavelmente mostraria a mesma camiseta em cada tamanho disponível no painel de recomendações.
O catálogo de camisetas seria melhor ter as primárias e as variantes, com as SKUs como variantes (uma variante para cada tamanho) e as primárias representando os grupos de SKUs para os tamanhos de cada estilo de camiseta. Esse catálogo de dois níveis permite que o painel de recomendações mostre uma variedade de estilos semelhantes de camisetas. O comprador pode detalhar um principal (estilo) específico para selecionar a variante (tamanho) a ser comprada.
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 exclusivo 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.
Mínimo de produtos primários
Se você determinar que o catálogo precisa ter primárias e variantes, ou seja, grupos de SKUs e SKUs, mas você só tem SKUs no momento, será necessário criar primárias para os grupos de SKUs. Essas primárias às vezes são chamadas de "primárias virtuais" ou "primárias falsas".
Essas primárias só precisam conter o mínimo de informações: id, title e
categories.
Se type não for especificado, o tipo de produto será definido como principal por padrão. Se você estiver importando, não será necessário especificar name. Para saber mais, 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 recrie um produto com um tipo diferente. Antes de excluir um produto principal, exclua as variantes associadas.
Importação de catálogo
Se você já tem 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 algum 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 descrito nas importações do Merchant Center para garantir que está fazendo escolhas corretas em relação ao catálogo. Isso é importante porque a alteração da configuração de um catálogo existente requer a exclusão do catálogo e o upload dele novamente (consulte Alterar 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 abrange:
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
Há 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 no nível do produto, incluindo como manter dados de inventário, consulte Atualizar inventário da Vertex AI para Pesquisa 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, a empresa usa o inventário local.
Há dois campos de produtos que podem ser usados para armazenar o 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 coleta 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
É possível usar um dos campos ou ambos para informações no nível da loja.
Para mais informações sobre inventários locais, consulte Atualizar inventário local da Vertex AI para Pesquisa para varejo.
Métricas de qualidade de dados do catálogo
A página Qualidade de dados no console da Search for Retail avalia se você precisa atualizar os dados do catálogo para melhorar a qualidade dos resultados da pesquisa e desbloquear os 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 visualizar métricas de qualidade de dados 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 do produto da Vertex AI para Pesquisa para varejo
Ao importar um catálogo do BigQuery, use o esquema de produtos da Vertex AI para Pesquisa para varejo 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.