Esta página fornece práticas recomendadas para criar as informações do catálogo e preencher os dados do catálogo.
Vista geral
O catálogo é uma coleção de objetos de produtos.
Os dados do catálogo que importa para o Vertex AI Search for commerce têm um efeito direto na qualidade do modelo resultante e, por conseguinte, na qualidade dos resultados da pesquisa e das recomendações. Em geral, quanto mais precisas e específicas forem as informações do catálogo que conseguir fornecer, maior será a qualidade do modelo.
O catálogo deve ser mantido atualizado. Pode carregar alterações ao catálogo com a frequência necessária. Idealmente, todos os dias para catálogos com uma elevada taxa de alteração. Pode carregar (patch) itens de produtos existentes. Apenas os campos alterados são atualizados. Não é cobrado nenhum valor pelo carregamento de informações do catálogo. Para mais informações, consulte o artigo Mantenha o catálogo atualizado.
Ramos do catálogo
Ramos de catálogos com pesquisa
Se usar a pesquisa, pode usar ramificações do catálogo para testar novos dados que carregou offline antes de os publicar no seu site.
Pode usar até três ramificações, identificadas como
0, 1 e 2. O seu site ativo aponta para default_branch para os dados do catálogo. Especifique que ramo é o seu ramo default_branch em direto (o predefinido é o ramo 0) através de setDefaultBranch ou do separador Dados na
consola de comércio. Em seguida, o seu site usa os dados do catálogo fornecidos
pela ramificação para a qual default_branch aponta.
Por exemplo, suponhamos que default_branch está definido para o ID da filial 0, pelo que o seu site está a usar os dados do catálogo que carregou para essa filial. Pode
carregar novos dados do catálogo para a ramificação 1 e pré-visualizá-los. Depois de confirmar que o catálogo foi carregado corretamente, pode mudar para a ramificação 1 como a ramificação default_branch em produção.
A atualização da cache do catálogo pode demorar até 30 minutos após a mudança de ramificação.
Se usar recomendações, recomendamos que use apenas a ramificação predefinida devido ao atraso na atualização durante a mudança de ramificações. Se a diferença de dados entre as ramificações for grande, o atraso na atualização pode afetar negativamente os resultados das previsões.
Informações sobre o produto necessárias
Os seguintes campos são obrigatórios. Tem de fornecer valores para os mesmos quando criar artigos de produtos no catálogo. Também devem corresponder aos valores usados na sua base de dados de produtos interna e refletir com precisão o produto representado, uma vez que são incluídos na preparação dos seus modelos.
Em alguns casos, também são necessários outros campos. Consulte a lista completa de todos os campos de produtos na página de referência Product.
Todas as informações sobre o produto que fornecer podem ser usadas para melhorar a qualidade das recomendações e dos resultados da pesquisa. Certifique-se de que preenche o maior número de campos possível.
| Campo | Notas |
|---|---|
name
|
O nome completo e exclusivo do recurso do produto. Obrigatório para todos os métodos de
Product, exceto para import. Durante a
importação, o nome é gerado automaticamente e não tem de ser
indicado manualmente.
|
id
|
O ID do produto usado pela sua base de dados de produtos. O campo ID tem de ser
exclusivo em todo o catálogo. O mesmo valor é usado quando
regista um evento do utilizador e também é devolvido pelos métodos predict
e search.
|
title
|
Título do produto da sua base de dados de produtos. Uma string codificada em UTF-8. Limitado a 1250 carateres. |
categories
|
Categorias de produtos. Todos os produtos têm de 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 tem de ser uma string codificada em UTF-8 não vazia com um limite de comprimento de 5000 carateres. Especifique sempre o caminho completo da categoria, por exemplo:
["Sports & Fitness > Athletic Clothing > Shoes"].
|
Enriquecimento da descrição do produto
O Vertex AI Search for commerce usa URLs de produtos para enriquecer as descrições dos produtos. Os URLs dos produtos melhoram os catálogos através do seguinte:
- Enriquecer dados dos produtos: a Vertex AI Search for commerce extrai informações suplementares através da indexação do URI do produto, o identificador único de recursos por detrás da localização exata de cada produto na Web (URL). Este processo ajuda a obter detalhes e sinais adicionais das páginas Web associadas. A compreensão mais detalhada dos produtos obtida através da análise de links uniformes de recursos contribui diretamente para a qualidade dos dados do catálogo.
- Melhorar a qualidade e a relevância da pesquisa: os sinais Web recolhidos dos URIs rastreados são usados para melhorar a qualidade da pesquisa. O back-end usa as informações rastreadas, incluindo a forma como o URI interagiu na Web, como quando o utilizador clica em backlinks, para a pontuação de relevância e popularidade nos resultados da pesquisa.
- Fornecer uma base para a preparação do modelo: além do ID do produto, do título, da hierarquia de categorias e do preço, os URLs são considerados um dos campos principais usados como entradas para a preparação do modelo.
Para maximizar as vantagens dos URLs dos produtos, siga estas práticas recomendadas:
- A página Web associada tem de ser acessível publicamente e carregar corretamente, e não estar protegida por um início de sessão ou uma autenticação.
- Cada URI deve ser exclusivo e apontar sempre para a página Web do produto correto. O conteúdo deve refletir com precisão as informações do produto no catálogo. Também recomendamos que mantenha o mesmo nome de domínio de nível superior em todos os URIs dos produtos
Categorias do catálogo
Esta secção descreve a estrutura do catálogo e como designá-la para utilização na taxonomia e na filtragem.
Estrutura do catálogo
O campo categories no catálogo deve conter o caminho da categoria mais detalhado para cada produto. As categorias principais não são obrigatórias e não devem ser incluídas.
Segue-se um exemplo de como estruturar o seu catálogo:
- Correto:
categories: ["Flowers, Cards, Occasion > Seasonal Items > Christmas"] - Incorreto:
categories: ["Flowers, Cards, Occasion", "Flowers, Cards, Occasion > Seasonal Items", "Flowers, Cards, Occasion > Seasonal Items > Christmas"]
Categorias principais
As categorias principais de um determinado produto não devem ser incluídas no campo categories. A filtragem para navegação deve ser processada através de outros atributos personalizados.
Nomenclatura das categorias
Os nomes das categorias devem ser escolhidos cuidadosamente para evitar a introdução de palavras-chave incorretas e melhorar o desempenho. A utilização de termos mais específicos e precisos melhora a relevância e reduz os problemas.
- Recomendado: Frozen Food > Frozen Fruits
- Não recomendado: Frutas e legumes congelados > Frutas congeladas
Estrutura ao nível do catálogo específica do projeto
Crie um único catálogo para cada idioma. Se operar em vários países, pode usar o mesmo catálogo para fornecer resultados da pesquisa em diferentes países.
Disponibilizar preços, determinados através de inventários locais, na mesma moeda em todos os países. Se os preços diferirem entre países, crie um inventário local para cada país. Especificar os respetivos preços.
Para otimizar os resultados da pesquisa, indique o nome de cada país como SearchRequest.entity e UserEvent.entity. Use entidades de país apenas para fins de classificação.
Vista geral da hierarquia de produtos
Quando gere o catálogo de produtos no Vertex AI Search for commerce, é fundamental compreender como os atributos são processados para produtos principais e variantes para uma pesquisa e recomendações eficazes. As designações de SKU do produto determinam a hierarquia do catálogo.
Tipos de designação de produtos
Existem três tipos de designação de produtos:
Os itens principais ou principais são devolvidos nos resultados da pesquisa ou nas recomendações e servem como contentores lógicos ou grupos de itens semelhantes. Os itens principais podem ser itens individuais (ao nível da SKU) e grupos de itens semelhantes (grupos de SKUs).
Os artigos variantes ou secundários são versões específicas e individuais de um produto principal de um grupo de SKUs. Por exemplo, se o produto principal for Camisola de gola em V,as variantes podem ser Camisola de gola em V castanha, tamanho XL e Camisola de gola em V branca, tamanho S.
Os artigos de coleção são pacotes de produtos principais ou produtos variantes, como um conjunto de joias com um colar, brincos e um anel. Estruturas hierárquicas semelhantes a produtos e variantes, as coleções agrupam produtos principais relacionados. Os clientes não podem comprá-los diretamente, não são amplamente usados e só estão disponíveis na pesquisa.
Exemplos de produtos
Por exemplo, de acordo com estes tipos de designação de produtos, os artigos de mercearia são melhor catalogados como produtos principais, cada um composto por um único produto de SKU, como"bananas, fresh".
Por outro lado, as t-shirts seriam melhor estruturadas hierarquicamente, como produtos principais com o respetivo conjunto de variantes. Cada variante representa um SKU individual (para cada tamanho) e cada artigo principal representa um grupo de SKUs, em que cada SKU é um tamanho diferente para um estilo de t-shirt geral. Esta organização por estrutura de SKU permite que os resultados da pesquisa e os painéis de recomendações apresentem uma variedade de estilos de t-shirts. Permite ao comprador detalhar um determinado atributo principal (estilo) para selecionar a variante (tamanho) a comprar.
As coleções agrupam produtos relacionados que um cliente pode comprar. Para os representar com precisão no modelo de reclassificação, o Vertex AI Search para comércio tem uma lógica que os credita com compras. Por exemplo: um comprador clica em produtos num conjunto de lençóis, e depois adiciona ao carrinho ou compra um produto principal nessa coleção. A coleção é creditada com essa compra e o modelo representa com precisão a popularidade e o valor das coleções.
Também existe um tipo de catálogo apenas de variantes, que está agora descontinuado. Este tipo de catálogo só pode ser usado com recomendações. Para o catálogo apenas com variantes, o valor de ingestionProductType é definido como variant durante a importação. É inferido um produto principal para cada variante com base num ID do produto principal especificado para cada variante.
Configure o seu catálogo de produtos
Ao planear o seu catálogo de produtos, tem de decidir se contém produtos designados apenas como principais, principais e variantes, ou uma combinação dos dois tipos. Pense na estrutura do SKU dos seus produtos. Os produtos podem ser artigos principais, que podem ou não ter variantes.
Com base na forma como os SKUs dos produtos estão designados, considere as opções para configurar o catálogo de produtos:
- Quer que o seu SKU seja apresentado como um resultado da pesquisa ou uma recomendação individual: SKU=primary
- O seu SKU deve fazer parte de um grupo de SKUs semelhantes: SKU=variante, grupo de SKUs=principal
- Uma mistura de ambas as combinações: SKU=principal, SKU=variante, grupo de SKUs=principal
Se a página de detalhes do produto apresentar um seletor de opções, tamanhos ou cores, estas opções são normalmente carregadas como variantes no catálogo de produtos. Considere se quer que diferentes tipos do mesmo produto com atributos diferentes, como o tamanho e a cor, apareçam como um único resultado da pesquisa ou resultados separados. Por exemplo, para um livro, quer decidir se quer que uma SKU de capa dura e uma SKU de capa mole do mesmo livro apareçam como resultados de pesquisa separados (SKU = principal) ou como um só (SKU = variante, grupo de SKUs = principal).
Ao configurar o catálogo de produtos, tenha em atenção que os resultados de pesquisa e as recomendações só devolvem itens principais.
Produtos principais mínimos
Se determinar que o seu catálogo deve ter produtos principais e variantes, ou seja, grupos de SKUs e SKUs, mas só tem SKUs agora, tem de criar produtos principais para os grupos de SKUs. Por vezes, estes elementos primários são denominados elementos primários virtuais ou elementos primários falsos.
Estas informações principais só precisam de conter informações mínimas: id, title e
categories.
Se type não for especificado, o tipo de produto é predefinido como principal. Se estiver a importar, não precisa de especificar name. Para mais informações, consulte a secção anterior, Informações do produto obrigatórias.
Importação de catálogos
Se o seu catálogo estiver no Cloud Storage, no BigQuery ou noutro armazenamento, faça uma importação de dados em massa.
Para obter informações detalhadas sobre como carregar um catálogo, consulte o artigo Importe informações do catálogo.
Inventário de produtos
O inventário de produtos abrange:
Preço, tanto o preço atual como o original
Disponibilidade, como em stock, esgotado, em atraso e pré-encomendado
Quantidade disponível
Informações de processamento, como recolha na loja, envio para a loja e entrega no dia seguinte
Existem dois níveis de inventário: ao nível do produto e local.
Inventário ao nível do produto
Para retalhistas que vendem apenas online, o inventário é especificado ao 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 ao nível do produto, incluindo como manter os dados do inventário, consulte o artigo Atualize o inventário para a pesquisa do Vertex AI para comércio.
Inventário local
Os retalhistas que têm lojas físicas e uma loja online têm de manter as informações de inventário por loja. Usam o inventário local para o fazer.
Existem dois campos de produtos que podem ser usados para armazenar o inventário local. Ambos os campos são listas de localizações (IDs de locais) com informações de inventário associadas:
Product.fulfillmentInfo. Métodos de envio e recolha em cada localização da loja
Product.localInventories. Informações de preços, atributos dos produtos e métodos de recolha e envio em cada localização da loja
Pode usar um ou ambos os campos para as informações ao nível da loja.
Para mais informações sobre inventários locais, consulte o artigo Atualize o inventário local para a Vertex AI Search for commerce.
Estrutura de inventário de variante principal
A estrutura de dados de inventário de variantes principais é composta por produtos principais, variantes e de inventário local:
Produtos principais: os dados dos produtos principais são armazenados sem preços.
Produtos variantes (com o preço mais baixo no país): por exemplo, a variante do produto principal (cor, tamanho) deve ter o preço mais baixo no país. Os dados de preços das variantes são agregados aos dados do produto principal, sendo o preço principal usado para fins de classificação. Os preços específicos da localização são ignorados.
Inventário local (preços específicos da região ou da loja): use as informações de preços do inventário local na reclassificação no momento da publicação
Atributos do produto principal: os produtos principais só podem incluir atributos comuns a todas as variantes associadas.
Métricas de qualidade de dados do catálogo
A página Qualidade dos dados na consola de pesquisa para comércio avalia se precisa de 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 seguinte descreve as métricas de qualidade que a Vertex AI Search for commerce usa para ajudar a avaliar os dados dos produtos. Para ver detalhes sobre como ver as métricas de qualidade dos dados e os níveis de desempenho da pesquisa na consola de comércio, consulte o artigo Desbloqueie os níveis de desempenho da pesquisa.
| Métrica de qualidade do catálogo | Regra de qualidade | Notas |
|---|---|---|
| O URI está presente e acessível | O produto tem um Product.uri válido. O URI tem de estar acessível e corresponder ao seu domínio. |
A Pesquisa usa sinais da Web rastreados através deste URI para melhorar a qualidade da pesquisa. |
| Cumpre a conformidade temporal | Product.availableTime é anterior à hora atual e Product.expireTime é posterior à hora atual. |
Apenas os produtos que cumprem a conformidade de tempo estão disponíveis para pesquisa. |
| O atributo pesquisável está presente | O produto tem, pelo menos, um attribute definido como pesquisável. |
Os atributos personalizados marcados como pesquisáveis podem ser pesquisados por consultas de texto. |
| A descrição está presente | O produto tem Product.description não vazio. |
Uma descrição abrangente ajuda a melhorar a qualidade da pesquisa. |
| O título tem, pelo menos, duas palavras | Product.title é composto por, pelo menos, duas palavras. |
Um título abrangente ajuda a melhorar a qualidade da pesquisa. |
| Tem uma variante com uma imagem | O produto variant tem, pelo menos, um Product.image. Pode ignorar esta métrica se todos os seus produtos estiverem ao nível primary. |
Esta métrica destina-se a fins informativos e não afeta a qualidade da pesquisa. |
| Tem uma variante com informações de preços | O produto variant tem Product.priceInfo definido. Pode ignorar esta métrica se todos os seus produtos estiverem ao nível primary. |
Esta métrica destina-se a fins informativos e não afeta a qualidade da pesquisa. |
Esquema de produto
Quando importar um catálogo do BigQuery, use o seguinte esquema de produtos do Vertex AI Search for commerce 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.