Esta página apresenta 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 para comércio 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 facultar, 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 (aplicar 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 de catálogo
Ramos do catálogo 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 em direto default_branch.
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, 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
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"].
|
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 específica do projeto ao nível do catálogo
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.
Estrutura do produto
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 itens variantes ou secundários são versões específicas e individuais de um produto principal do 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.
Hierarquias de classificação de produtos
Usando os três tipos ao nível do produto, existem três hierarquias de classificação de produtos principais:
- Variante principal: a variante principal é quase sempre apenas um marcador de posição de informações (comuns), e as variantes são os SKUs reais que podem ser comprados. Por exemplo, 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 abrangente. 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.
- Apenas principal: 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". - Coleções: 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 lhes atribui 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.
Produtos com uma variante
Para produtos que tenham uma variante, estruture-os como produto principal-variante, porque existem várias vantagens, incluindo:
- A página de pesquisa tem resultados diversificados que podem ser apresentados aos utilizadores finais. Caso contrário, se as variantes fossem tratadas como produtos principais, a página de resultados da pesquisa seria preenchida com os mesmos produtos.
- Os produtos têm um esquema de classificação mais detalhado, uma vez que os produtos principais com variantes são classificados melhor se uma variante específica estiver a gerar mais interação. Isto ajuda na reclassificação e na otimização da receita.
- Facilidade de manutenção do catálogo. Se um atributo tiver uma alteração para um grupo de produtos que diferem apenas no tamanho, pode fazê-lo através de uma estrutura de variante principal, como alterar o atributo ao nível principal em vez de alterar vários atributos principais.
- As funcionalidades da API e os campos de resposta de pesquisa das chaves de agregação de variantes e dos campos recuperáveis só são suportados para variantes.
- A resposta da pesquisa contém os detalhes mínimos do elemento principal e mais detalhes das variantes. Por isso, tem sempre de aumentar ou enriquecer a resposta de pesquisa com detalhes adicionais, que podem ser devolvidos pelo Vertex AI Search for commerce se estiverem marcados como recuperáveis.
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 seus produtos podem ser artigos principais, que podem 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 combinação de ambas as opçõ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 ou não 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.
Correção do URL do produto
O campo product.uri é o URL canónico que direciona diretamente para a página de detalhes do produto. Deve ser um URI rastreável publicamente e não estar protegido por um início de sessão ou uma autorização. Isto deve-se ao facto de o back-end rastrear a página Web do URI e obter o máximo de informações possível, que são usadas para a pontuação de relevância e popularidade. O back-end também determina a forma como o URI interagiu na Web, incluindo backlinks. O nome de domínio de nível superior tem de ser o mesmo em todos os URIs dos produtos.
Se tiver o mesmo produto listado em vários sites de faixas, considere usar a funcionalidade de várias entidades. Contacte a equipa da conta para saber mais sobre este assunto.
O Vertex AI Search for commerce usa URLs de produtos para enriquecer as descrições dos produtos. Se usar um URL diferente no catálogo de produtos do que no site real, certifique-se de que os dois URLs se referem ao mesmo produto e têm informações quase idênticas.
Os URLs dos produtos melhoram os catálogos das seguintes formas:
- Enriquecer dados dos produtos: a Vertex AI Search for commerce extrai informações suplementares através da análise 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 rastreio de URIs 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 estar acessível publicamente e ser carregada corretamente, e não pode 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. Manter o mesmo nome de domínio de nível superior em todos os URIs dos produtos.
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 Pesquisa Vertex AI para comércio.
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 dos produtos principais, 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 respetivas variantes associadas.
Correção da disponibilidade do produto
O campo de disponibilidade é definido pelo sistema de atualização do inventário à medida que o estado do stock do produto muda. Acompanhe todos os produtos que estão no estado IN_STOCK e OUT_OF_STOCK.
Se tiver a maioria dos produtos como OUT_OF_STOCK, a resposta da pesquisa teria muitos produtos esgotados e, ao adicionar um filtro, os números de recordação são reduzidos. Se o produto estiver esgotado, mas o estado do catálogo for IN_STOCK, os utilizadores veem o produto como disponível, mas provavelmente têm problemas no momento da compra ou de adicionar ao carrinho. Isto tem um maior efeito na experiência do cliente do que no treino do modelo. Mantenha o campo Product.availability o mais atualizado possível através das APIs patchProduct ou das APIs de importação com um readMask.
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.
Use campos incorporados em vez de atributos personalizados
Para todos os outros atributos do produto que não fazem parte do esquema de informações do produto, use o elemento Product.attributes (atributos personalizados).
Os campos de produtos incorporados, como o título, a descrição e as marcas, têm um impacto maior na capacidade de pesquisa e indexação, em comparação com os atributos personalizados.
Por outras palavras, o back-end tem uma compreensão mais profunda dos campos incorporados do que dos atributos personalizados. O back-end tem em conta as informações dos campos incorporados para a otimização da relevância. Por este motivo, use os campos integrados. Isto significa mapear as informações dos produtos para campos incorporados sempre que possível e usar apenas atributos do cliente quando necessário.
Por exemplo, definir as marcas no campo Product.brands tem um impacto muito maior na pesquisa e na recordação do que definir as mesmas informações num atributo personalizado. Para um atributo como sleeve length, que não é suportado nativamente, é melhor usar atributos personalizados.
Use o campo de marca
O campo da marca nas informações do produto, que é pesquisável, indexável e filtrável por predefinição, é um sinal forte para a classificação e a relevância. Uma boa percentagem das consultas de pesquisa tem o formato brand query ou query brand e, sem dúvida, a marca é uma das facetas mais usadas.
As taxas de conversão de cliques e compras são muito afetadas se o produto tiver o campo de marca correto. Por isso, é importante que o campo da marca esteja preenchido com as informações corretas e, se possível, nunca fique em branco. O que é mais prejudicial é preencher os nomes das marcas com palavras aleatórias, como "NA", "Not available" ou "Miscellaneous". Isto associa fortemente o produto ao texto mencionado no campo das marcas, o que pode levar a uma compreensão incorreta do produto e a uma má memorização.
Se um determinado produto não estiver absolutamente associado a nenhuma marca, é melhor deixar os campos vazios. No entanto, é preciso ter cuidado para que estes produtos de marca vazios representem uma pequena percentagem dos produtos do catálogo.
Use o campo de público-alvo
Existem dois subcampos no campo de público-alvo das informações sobre o produto. Existem Audience.gender e Audience.ageGroup. É muito mais eficaz preencher estes campos com os dados adequados, o que ajuda o modelo a compreender o público-alvo pretendido do produto.
Isto desempenha um papel importante quando a personalização está ativada. Ter gender e ageGroup ajuda a segmentar melhor os produtos e ajuda o modelo a recordar o produto certo para o utilizador adequado.
Os dados Audience também são úteis quando tem consultas como camisas para mulheres ou meias para homens. Com as informações do público-alvo preenchidas, a compreensão dos produtos é muito melhor e o modelo melhorou a capacidade de memorização para consultas específicas de género.
Procure produtos com títulos duplicados
O campo Product.title é provavelmente o mais importante, uma vez que a maioria das consultas de pesquisa teria uma grande sobreposição com o que está definido como Product.title. É provavelmente a primeira informação que os utilizadores finais veem e com a qual interagem na vista da página de detalhes. Por isso, é uma boa prática manter o product.title exclusivo e ter informações de texto mais relevantes para o produto.
Ter dois produtos (produtos principais) com o mesmo título afeta a capacidade de pesquisa e a relevância dos resultados devolvidos. Se existirem dois produtos principais separados com diferenças significativas, mantenha os títulos diferentes. Se os produtos forem iguais, mas diferirem apenas em alguns aspetos, como a cor, o tamanho ou a estrutura, estruture os produtos como tipos primários e variantes.
Definições de idioma
O Vertex AI Search for commerce é compatível com vários idiomas. Mais informações aqui. O principal aspeto a ter em atenção é que o catálogo e a consulta de pesquisa têm de estar no mesmo idioma. Não existe tradução entre idiomas das informações de consulta ou do catálogo. Por exemplo, se o seu catálogo estiver em espanhol, a consulta de pesquisa também tem de estar em espanhol.
Por isso, é importante marcar o código de idioma nas informações do produto em conformidade. Caso contrário, o idioma predefinido é o inglês (en-US). Isto é importante para os controlos de pesquisa, como spellCorrectionSpec, em que, se o idioma não estiver definido, leva a um comportamento indesejável. Isto também é extremamente importante para a compreensão da intenção da consulta.
Definições de informações sobre o preço
O campo Product.priceInfo tem de ser o mais preciso e completo possível. Estas informações de preços são usadas para obter sinais relacionados com descontos e são usadas na otimização da receita. Isto é particularmente importante para consultas de navegação.
Para uma estrutura de produtos de variante principal, preencha o preço de, pelo menos, uma das variantes.
Para um produto que não tenha preços ao nível do produto e todos os preços estejam no inventário local, o que significa que a pesquisa está sempre associada a um inventário local, preencha as informações de preço mediano de todos os preços ao nível do inventário nas informações de preço ao nível do produto.
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 pesquisa para 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 de tempo | 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 o elemento 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 imagem | O produto variant tem, pelo menos, um Product.image. Pode ignorar esta métrica se todos os seus produtos estiverem ao nível de 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. |