Acerca dos atributos dos produtos

A Vertex AI Search for commerce pode usar atributos dos produtos para indexação, filtragem dinâmica, capacidade de pesquisa, filtragem e qualidade do modelo. Esta página aborda a configuração dos atributos dos produtos e a forma como são tratados, consoante o método e a configuração que usar.

Tipos de atributos

Os atributos dos produtos podem ter diferentes definições predefinidas e opções permitidas, consoante o respetivo tipo.

  • Atributos do sistema: os atributos do sistema predefinidos são Productcampos existentes que fornecem mais informações sobre o produto. Estes incluem atributos do produto, como marca, disponibilidade, cor e tamanho. Para ver todos os atributos do sistema disponíveis para produtos, consulte a Productdocumentação de referência.

  • Atributos personalizados: os atributos personalizados são atributos adicionais que define usando o campo Product.attributes. Por exemplo, podem incluir nomes de lojas, fornecedores ou estilo. Para ver exemplos e limites de atributos personalizados, consulte a Product.attributes documentação de referência.

    Seguem-se alguns exemplos dos 20 principais atributos personalizados:

    • Linha de produtos à qual este produto pertence
    • Volume de vendas na loja deste produto
    • Ocasião para vestuário
    • Ofertas e cupões aplicáveis a este produto
    • Popularidade dos produtos em todo o site

  • Atributos ao nível do inventário: atributos do sistema ou personalizados que fornecem informações ao nível da loja sobre o produto. Pode usar atributos ao nível do inventário para produtos cujas propriedades variam significativamente entre lojas e regiões, como artigos de mercearia, ou para produtos que têm promoções específicas da loja.

    inventories.price e inventories.originalPrice são atributos do sistema numérico predefinidos pelo Vertex AI Search for commerce. Pode criar atributos personalizados ao nível do inventário, que podem ser textuais ou numéricos. Por predefinição, os atributos ao nível do inventário são indexáveis. A definição de filtragem dinâmica e pesquisável não é suportada para atributos ao nível do inventário.

Definições de configuração disponíveis

As definições de configuração dos atributos afetam o comportamento da pesquisa e das recomendações no seu site.

A pesquisa usa as seguintes definições de atributos:

  • Indexável: a pesquisa pode filtrar e criar facetas com este atributo.
  • Filtragem dinâmica: a pesquisa pode usar automaticamente este atributo como uma filtragem dinâmica com base no comportamento anterior do utilizador, como cliques e visualizações de filtros. Para ativar a segmentação dinâmica para um atributo, Indexable tem de estar definido como verdadeiro para esse atributo.
  • Pesquisável: este atributo é pesquisável por consultas de pesquisa, o que aumenta a capacidade de memorização desse atributo. Este controlo é aplicável apenas a atributos de texto.
  • Retrievable: se for definido como verdadeiro, a pesquisa devolve este atributo nas respostas às consultas de pesquisa. Se todos os atributos tiverem o valor Retrievable definido como falso, os resultados da pesquisa contêm apenas o nome do produto ou (para variantes) o nome do produto e as informações de cor. O campo REST RetrievableFields está descontinuado para produtos. Em alternativa, use o controlo recuperável ao nível do site.

As recomendações usam as seguintes definições de atributos:

  • Filtrável (pré-visualização pública): este atributo pode ser usado em expressões de filtro de recomendações. Este controlo só é aplicável a atributos de texto.

Indexável

Se um atributo estiver definido como indexável, a pesquisa pode filtrar e segmentar usando o atributo.

  • Atributos do sistema: a capacidade de indexação está sempre ativada para atributos do sistema predefinidos. Não é possível desativar esta definição para atributos do sistema.
  • Atributos personalizados: ativados por predefinição. Pode desativar a capacidade de indexação para qualquer atributo personalizado. Se planeia tornar um índice de atributos personalizados, este tem de seguir o padrão de expressão regular [a-zA-Z0-9][a-zA-Z0-9_]*. Por exemplo, key0LikeThis ou KEY_1_LIKE_THIS.
  • Atributos ao nível do inventário: sempre ativados para atributos ao nível do inventário do sistema; não é possível alterar esta definição. Ativada por predefinição para atributos personalizados ao nível do inventário. Esta definição pode ser desativada.
  • Dependências: N/A

As alterações à configuração do índice entram em vigor imediatamente após importar os dados do catálogo. Caso contrário, as alterações podem demorar até 12 horas ou mais a entrar em vigor. Pode testar se as alterações foram aplicadas na página Avaliar.

Filtragem dinâmica

Quando a filtragem dinâmica está ativada para um atributo, a pesquisa pode usar o atributo como uma filtragem dinâmica. As facetas dinâmicas podem ser adicionadas automaticamente a uma pesquisa com base no comportamento anterior do utilizador, como cliques e visualizações de facetas.

  • Atributos do sistema: ativados por predefinição se a capacidade de indexação estiver definida como verdadeira. Pode desativar a segmentação dinâmica para qualquer atributo do sistema.
  • Atributos personalizados: ativados por predefinição se a capacidade de indexação estiver definida como verdadeira. Pode desativar a segmentação dinâmica para qualquer atributo personalizado.
  • Atributos ao nível do inventário: não suportados.
  • Dependências: para ativar a segmentação dinâmica para um atributo, primeiro tem de ativar a capacidade de indexação para esse atributo.

A definição da segmentação dinâmica para um atributo é sempre global. A configuração de filtragem dinâmica que aplica a esse atributo é usada pelos produtos no catálogo que usam esse atributo.

As alterações à configuração da segmentação dinâmica demoram até dois dias. Pode testar se as alterações foram aplicadas na página Avaliar.

Para atributos personalizados numéricos, os intervalos têm de ser especificados no pedido. Os valores numéricos não são agrupados automaticamente.

Pesquisável

Se um atributo estiver definido como pesquisável, a capacidade de memorização desse atributo nas consultas de pesquisa é melhorada.

A capacidade de pesquisa só pode ser ativada para valores de atributos textuais. Não é aplicável a atributos numéricos.

  • Atributos do sistema: os atributos do sistema textuais predefinidos para Product têm as respetivas definições de capacidade de pesquisa configuradas pelo Vertex AI Search for commerce. Não é possível alterar estas definições.
  • Atributos personalizados: desativados por predefinição. Pode ativar esta configuração para qualquer atributo personalizado textual.
  • Atributos ao nível do inventário: não suportados.
  • Dependências: N/A
  • Pesquisável de forma exata: os resultados da pesquisa segmentados para consultas de pesquisa que correspondem a qualquer produto específico no seu catálogo. Esta opção funciona bem para números de série. Veja mais informações sobre a opção de pesquisa exata.

Embora os produtos com um atributo pesquisável tenham maior probabilidade de aparecer nos resultados da pesquisa para esse atributo, não é garantido que apareçam.

Filtragem de recomendações

Se um atributo tiver a filtragem de recomendações ativada, pode ser usado em expressões de filtro de recomendações para filtrar produtos em previsões.

  • Atributos do sistema: desativados por predefinição. Pode ativar esta definição para quaisquer atributos textuais do sistema predefinidos para Product, exceto para FulfillmentInfo e title. Não suportado para atributos numéricos.
  • Atributos personalizados: desativados por predefinição. Pode ativar esta definição para quaisquer atributos textuais personalizados para Product. Não suportado para atributos numéricos.
  • Atributos ao nível do inventário: suportados apenas para o valor availability IN_STOCK.
  • Dependências: N/A

Opção de pesquisa exata

Pode atribuir um determinado valor a consultas de strings específicas na opção exact-searchable, um campo de atributo do catálogo. Se uma consulta corresponder a qualquer produto no seu catálogo em que o valor desse campo seja a string fornecida na consulta, devolve exatamente esse produto na consulta de pesquisa. Esta opção funciona bem para números de série, em que os clientes esperam uma experiência de pesquisa segmentada.

Normalmente, para atributos personalizados, o campo ExactSearchableOption é útil para atributos de produtos com um valor exato (como ModelId ou ManufacturerId). Os atributos como product_id são campos de índice principais, pesquisáveis exatamente por predefinição. O campo item_id está sempre ativado para a correspondência exata e não pode ser desativado.

  • Para evitar a devolução de itens não relacionados em pesquisas, nunca defina a opção de pesquisa para um valor genérico, como battery.
  • Para evitar a publicação insuficiente de consultas de pesquisa, não defina campos especiais, como tag, que podem ter "iphone" como um dos seus valores de string, como pesquisáveis exatamente. Se o fizesse, essas consultas poderiam limitar os resultados para todos os iphones no catálogo de produtos.

Para mais informações, consulte o artigo Acerca dos atributos dos produtos.

Comportamento dos atributos

Ao estruturar o catálogo de produtos com designações de produtos principais e variantes, saiba como os atributos dos produtos são processados para filtragem. O respetivo comportamento depende de estar a usar a pesquisa ou as recomendações, e da forma como configura a taxonomia do catálogo.

Para garantir um comportamento de filtragem previsível e preciso, mantenha a consistência e a integridade nas definições de atributos filtráveis nos produtos principais e nas variantes. Esta abordagem ajuda na filtragem precisa, o que melhora a descoberta de produtos e a relevância da pesquisa.

Comportamento da variante principal na pesquisa em comparação com as recomendações

Embora apenas os itens principais sejam devolvidos nos resultados da pesquisa e das recomendações, o Vertex AI Search for commerce otimiza a qualidade da pesquisa e das recomendações.

  • Para modelos de pesquisa, os atributos das variantes são usados para o produto principal no índice de pesquisa. Os resultados da pesquisa apresentam diversas opções para o produto principal com base nos atributos das respetivas variantes.

  • Para modelos de recomendações, os detalhes e os atributos dos produtos não são herdados do produto principal para o produto variante. Para uma qualidade ideal das recomendações, é fundamental que os produtos principais e variantes tenham detalhes completos e precisos para atributos importantes, como product.categories, product.title, product.attributes e product.prices.

Processar atributos durante a indexação e a filtragem

Se o mesmo atributo for definido em Principal e Variante, o atributo na variante faz parte da filtragem. Por exemplo, suponhamos que um atributo está definido para um produto principal e as respetivas variantes (cor ou tamanho). Os valores dos atributos das variantes destinam-se principalmente à filtragem, durante a qual o sistema verifica se alguma das variantes principais corresponde ao valor do atributo. Considere a disponibilidade do produto: um produto principal pode ser marcado como out-of-stock, mas, se pelo menos uma das respetivas variantes for in-stock, o produto principal está disponível para resultados da pesquisa se for aplicado um filtro in-stock.

Pelas seguintes razões, defina os mesmos atributos filtráveis em Principal e Variante:

  • Os atributos das variantes têm precedência para a filtragem. Se um atributo estiver definido num produto principal e nas respetivas variantes, o atributo da variante é usado na filtragem. Por exemplo, se um produto principal tiver uma cor de marcador de posição, mas as respetivas variantes tiverem cores reais, a cor da variante deve ser preenchida e é usada para filtragem.

  • Para atributos relacionados com o inventário, como a disponibilidade, se um produto principal tiver variantes, a disponibilidade do produto principal deve ser definida como OUT_OF_STOCK, enquanto a disponibilidade real (como IN_STOCK) deve ser definida ao nível da variante. Desta forma, o produto principal é considerado em stock desde que, pelo menos, uma variante esteja em stock. Se for o caso, os filtros, como availability: ANY("IN_STOCK"), devolvem corretamente o produto principal.

  • Quando é usada uma expressão de filtro, a resposta de previsão devolve produtos principais que têm, pelo menos, um produto principal ou variante que corresponde ao valor do atributo do filtro.

Atributos opcionais para filtragem

Mantenha o campo categories limpo e otimizado para a taxonomia. Se precisar de mais filtragem, implemente-a com base em categorias amplas através de atributos personalizados separados e não no campo categories. Isto também evita um impacto negativo na preparação do preenchimento automático para sugestões de categorias.

Por exemplo, suponhamos que define normalmente categorias como [lvl1, lvl1>lvl2, lvl1>lvl2>lvl3] para filtragem. O preenchimento automático contabiliza as categorias mais frequentes para uma determinada consulta, pelo que acaba por ter lvl1 e lvl2 (todos os seus produtos) como categorias sugeridas.

Práticas recomendadas

Se o seu catálogo consistir em produtos principais e variantes e o mesmo atributo estiver definido em ambos, o atributo na variante é considerado durante a filtragem.

  • Preencha os atributos com precisão: certifique-se de que os produtos principais e variantes têm detalhes completos e precisos para os respetivos atributos, especialmente os usados para filtragem, de modo a maximizar a eficácia.

  • Use campos incorporados: não confie apenas nos atributos personalizados. Mapeie as informações dos produtos para os campos Product incorporados (brands, colors, sizes e os campos obrigatórios). Os campos incorporados têm um maior impacto na capacidade de pesquisa, na indexação e nas otimizações de relevância. Os atributos personalizados (Product.attributes) destinam-se a dados de produtos que não se enquadram nos atributos do sistema predefinidos.

  • Defina o controlo de campos recuperáveis ao nível do site: a API suporta variantRollupKeys para variantes, o que lhe permite obter detalhes nas respostas de pesquisa.

  • Idioma do catálogo consistente: o catálogo de produtos deve estar apenas num idioma, e as consultas de pesquisa devem ser enviadas no mesmo idioma. Ter vários idiomas no catálogo pode degradar o desempenho do modelo. Se não definir o código do idioma, pode afetar funcionalidades como a correção ortográfica.

  • Informações sobre preços: preencha corretamente as informações sobre preços dos produtos principais e das variantes para garantir recomendações e filtragem precisas. Se um produto não tiver preços ao nível do produto e depender apenas dos preços do inventário local, preencha os preços do produto principal com a mediana dos preços ao nível do inventário.

Modos de configuração

O modo de configuração determina como as configurações de atributos são tratadas e que configurações de atributos pode definir.

  • Modo de configuração ao nível do catálogo (predefinição): neste modo, as configurações de atributos ao nível do catálogo são usadas como a fonte de verdade.
  • Modo de configuração ao nível do produto (descontinuado): neste modo, as configurações dos atributos ao nível do produto são usadas como fonte de dados fidedigna.

Anteriormente, a configuração ao nível do produto era o modo predefinido. Se ainda estiver no modo de configuração ao nível do produto e precisar de mudar para o modo de configuração ao nível do catálogo, contacte o apoio técnico. A pesquisa não suporta o regresso ao modo de configuração ao nível do produto depois de ter mudado.

Para verificar o modo de configuração, aceda à página Controlos da consola de pesquisa para comércio. Se a opção Indexável estiver disponível como uma coluna no separador Controlos ao nível do site, o modelo de configuração é ao nível do catálogo. Se a coluna Indexável não estiver disponível no separador Controlos ao nível do site, significa que o modelo de configuração é ao nível do produto.

Métodos de configuração

Pode definir configurações de atributos das seguintes formas:

  • A consola de pesquisa para comércio: defina as configurações dos atributos ao nível do catálogo através da consola de pesquisa para comércio. Esta opção configura os atributos globalmente em todos os produtos. As definições disponíveis na consola dependem do modo de configuração. Consulte a secção seguinte para ver mais detalhes sobre como configurar atributos na consola.

  • O AttributeConfigmétodo da API: defina as configurações dos atributos ao nível do catálogo através da API. Esta ação configura atributos em todos os produtos.

  • O método da API Product (descontinuado): defina atributos personalizados ao nível do produto através do método da API Product. A definição de atributos com este método não está disponível para novos utilizadores e não é recomendada.

Configure atributos na consola

Pode definir globalmente opções de atributos em todos os produtos a partir da página Pesquisar na consola de comércio Controlos, no separador Controlos ao nível do site. Para mais detalhes sobre como definir esta opção na consola, consulte o artigo Gerir controlos de atributos ao nível do site.

Para usar esta funcionalidade, o modo de configuração tem de ser ao nível do catálogo.

As alterações às definições de configuração de atributos para indexáveis e pesquisáveis entram em vigor imediatamente após o carregamento do catálogo. Caso contrário, as alterações podem demorar até 12 horas ou mais a entrar em vigor. Pode testar se as alterações foram aplicadas na página Avaliar.

Configure atributos com o AttributesConfig

O recurso da API AttributesConfig permite-lhe gerir as configurações de atributos ao nível do catálogo.

Os seguintes campos definem opções de atributos ao nível do catálogo:

Para obter todas as configurações de atributos, use o método GetAttributesConfig.

Atualize vários atributos

Use o método updateAttributesConfig para atualizar vários atributos ao nível do catálogo.

Os atributos do catálogo que inclui no pedido são atualizados no catálogo ou inseridos se não existirem. Se não existir um valor para um campo de atributo do catálogo, é-lhe atribuído um valor predefinido.

O número máximo de atributos do catálogo permitidos num pedido é 1000.

Atualize um atributo individual

Os seguintes métodos são usados para atualizar atributos individuais do catálogo:

  • AddCatalogAttribute: adiciona uma configuração de atributo individual a um atributo do catálogo.

    Consulte a documentação de referência da API para AddCatalogAttribute.

  • ReplaceCatalogAttribute: modifica a configuração de um atributo individual. Isto substitui o CatalogAttribute especificado no AttributesConfig atualizando o atributo do catálogo com o mesmo CatalogAttribute.key.

    Consulte a documentação de referência da API para ReplaceCatalogAttribute.

  • RemoveCatalogAttribute: remove uma configuração de atributo individual de AttributesConfig.

    Só é possível eliminar CatalogAttributes que não estejam a ser usados por produtos. Se um CatalogAttribute estiver em utilização, RemoveCatalogAttribute não o elimina, mas repõe as respetivas propriedades de configuração para os valores predefinidos. CatalogAttribute.inUse está definido como True se o atributo estiver a ser usado por quaisquer produtos.

    Consulte a documentação de referência da API para RemoveCatalogAttribute.

Configure atributos com o método Product (descontinuado)

A definição de atributos com este método não está disponível para novos utilizadores e não é recomendada.

Os seguintes campos definem as definições indexáveis e pesquisáveis para um produto específico através do método da API Product: