Sobre os atributos do produto

A Vertex AI para Pesquisa para Retail pode usar atributos do produto para indexação, atributos dinâmicos, capacidade de pesquisa, filtragem e qualidade do modelo. Nesta página, você vai aprender a definir configurações de atributos de produtos e como elas são tratadas dependendo do método e da configuração usados.

Tipos de atributo

Os atributos do produto podem ter configurações padrão e opções permitidas diferentes dependendo do tipo.

  • Atributos do sistema: os atributos do sistema predefinidos são campos Product existentes que fornecem mais informações sobre o produto. Isso inclui atributos do produto, como marca, disponibilidade, cor e tamanho. Para todos atributos de sistema disponíveis para produtos, consulte Documentação de referência do Product.

  • Atributos personalizados: são atributos extras que você define. usando o campo Product.attributes. Por exemplo, isso pode incluir loja nomes, fornecedores ou estilo. Para conferir exemplos e limites de atributos personalizados, consulte a documentação de referência de Product.attributes.

  • Atributos no nível do inventário: atributos do sistema ou personalizados que fornecem informações no nível da loja sobre o produto. Você pode usar atributos no nível do inventário para produtos com propriedades que variam significativamente entre lojas e regiões, como itens de supermercado, ou para produtos com promoções específicas da loja.

    inventories.price e inventories.originalPrice são atributos do sistema numérico predefinidos pela Vertex AI para Pesquisa no varejo. É possível criar configurações atributos de nível de inventário, que podem ser textuais ou numéricos. Os atributos no nível do inventário são indexáveis por padrão. Não é possível definir a pesquisa e a segmentação dinâmica em atributos no nível do inventário.

Configurações disponíveis

As configurações de atributos afetam o comportamento da pesquisa e das recomendações em todo o site.

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

  • Indexável: a pesquisa pode filtrar e criar facetas usando esse atributo.
  • Atributos dinâmicos: a pesquisa pode usar automaticamente esse atributo como um atributo dinâmico com base no comportamento anterior do usuário, como cliques e visualizações de atributos. Para ativar o atributo dinâmico para um atributo, Indexable precisa ser definido como verdadeiro para esse atributo.
  • Pesquisável: esse atributo pode ser pesquisado pelas consultas de pesquisa, o que aumenta o recall dele. Esse controle é aplicável apenas a atributos de texto.
  • Recuperável: se definido como "true", a pesquisa vai retornar esse atributo nas respostas às consultas de pesquisa. Se todos os atributos tiverem Se pode ser recuperado definido como falso, os resultados da pesquisa contêm apenas o nome do produto ou, no caso de variantes, o nome do produto e as informações de cor. O campo REST RetrievableFields foi descontinuado para produtos. Use o controle recuperável em todo o site.

As recomendações usam as seguintes configurações de atributo:

  • Filtrável (pré-lançamento público): esse atributo pode ser usado em expressões de filtro de recomendações. Esse controle é aplicável apenas a atributos de texto.

Indexável

Se um atributo for definido como indexável, a pesquisa poderá filtrar e usar o atributo.

  • Atributos do sistema: a indexação está sempre ativada para o sistema predefinido atributos. Não é possível desativar essa configuração para atributos do sistema.
  • Atributos personalizados: ativados por padrão. É possível desativar a indexabilidade para qualquer atributo personalizado. Se você planeja tornar um atributo personalizado indexável, ele precisa seguir o padrão de regex [a-zA-Z0-9][a-zA-Z0-9_]*. Por exemplo, key0LikeThis ou KEY_1_LIKE_THIS.
  • Atributos no nível do inventário: sempre ativados para nível de inventário do sistema. atributos essa configuração não pode ser alterada. Ativado por padrão para atributos personalizados no nível do inventário; essa configuração pode ser desativada.
  • Dependências: N/A

As mudanças na configuração do índice entram em vigor imediatamente após a importação dos dados do catálogo. Caso contrário, pode levar até 12 horas ou mais para que as mudanças entrem em vigor. É possível testar se as mudanças foram aplicadas na página Avaliar.

Atributos dinâmicos

Quando um atributo é configurado como dinâmico, a pesquisa pode usá-lo como um atributo dinâmico. Os atributos dinâmicos podem ser adicionados automaticamente a uma pesquisa com base no comportamento anterior do usuário, como cliques e visualizações.

  • Atributos do sistema: ativados por padrão se a indexabilidade estiver definida como verdadeira. Você pode desativar a filtragem de atributos dinâmicos para qualquer atributo do sistema.
  • Atributos personalizados: ativados por padrão se a indexabilidade for definida como verdadeira. É possível desativar o atributo dinâmico para qualquer atributo personalizado.
  • Atributos no nível do inventário: não compatíveis.
  • Dependências: para ativar as facetas dinâmicas de um atributo, primeiro é preciso ativar a indexabilidade desse atributo.

A definição do atributo dinâmico para um atributo sempre global. A configuração de atributos dinâmicos aplicada a esse atributo é usada por produtos no catálogo que o utilizam.

As mudanças na configuração do atributo dinâmico levam até dois dias. É possível testar se as mudanças foram aplicadas na página Avaliar.

Para atributos personalizados numéricos, os buckets precisam ser especificados na solicitação. Os valores numéricos não são agrupados automaticamente.

Pesquisável

Se um atributo for definido como pesquisável, faça o recall desse atributo em as consultas de pesquisa são aprimoradas.

Somente valores de atributos textuais podem ter o recurso de pesquisa ativado. Não é aplicável a atributos numéricos.

  • Atributos do sistema: os atributos textuais do sistema predefinidos para Product têm as configurações de pesquisa definidas pela Vertex AI para Pesquisa para Retail. Esses configuração não pode ser alterada.
  • Atributos personalizados: desativados por padrão. É possível ativar essa configuração para qualquer atributo personalizado textual.
  • Atributos no nível do inventário: não são compatíveis.
  • Dependências: N/A

Embora os produtos com um atributo pesquisável tenham mais probabilidade de aparecer em resultados de pesquisa para esse atributo, eles não têm garantia de exibição.

Filtragem de recomendações

Se um atributo tiver a filtragem de recomendações ativada, ele poderá ser usado em as recomendações filtram expressões para filtrar produtos previsões.

  • Atributos do sistema: desativado por padrão. É possível ativar essa configuração para qualquer atributo textual predefinido do sistema para Product, exceto FulfillmentInfo e title. Incompatível com atributos numéricos.
  • Atributos personalizados: desativado por padrão. Você pode ativar essa configuração para qualquer atributos textuais personalizados para Product. Não é compatível com atributos numéricos.
  • Atributos no nível do inventário: compatíveis apenas com o valor availability. IN_STOCK.
  • Dependências: N/A

Modos de configuração

O modo de configuração determina como as configurações de atributo são tratadas e quais configurações de atributo você pode definir.

  • Modo de configuração no nível do catálogo (padrão): nesse modo, as configurações de atributos no nível do catálogo e do catálogo são usadas como a fonte da verdade.
  • Modo de configuração no nível do produto (descontinuado): nesse modo, as configurações de atributos no nível do produto são usadas como fonte de verdade.

Antes, a configuração no nível do produto era o modo padrão. Se você ainda estão no modo de configuração no nível do produto e precisam mudar para o nível do catálogo entre em contato com o suporte. A pesquisa não é compatível com o retorno ao modo de configuração no nível do produto depois de alternar.

Para verificar o modo de configuração, acesse o console do Search for Retail página Controles. Se o A opção Indexável está disponível como uma coluna na guia Controles em todo o site. o modelo de configuração será de nível de catálogo. Se o A coluna Indexável não está disponível na guia Controles em todo o site. Em seguida, o modelo de configuração é no nível do produto.

Métodos de configuração

É possível definir configurações de atributos das seguintes maneiras:

  • O console da Pesquisa de varejo: defina configurações de atributos no nível do catálogo usando o console da Pesquisa de varejo. Isso configura os atributos globalmente em todos os produtos. Quais dessas configurações estão disponíveis no console depende do o modo de configuração.

  • Método de API AttributeConfig: defina as configurações de atributo no nível do catálogo usando a API. Isso configura os atributos em todos os produtos.

  • Método de API Product (descontinuado): defina atributos personalizados no nível do produto usando o método de API Product. Definir atributos com este não está disponível para novos usuários e não é recomendado.

Configurar atributos no console

É possível definir globalmente as opções de atributo em todos os produtos na página Controles do console de pesquisa para varejo, na guia Controles em todo o site. Para mais detalhes sobre como definir no console, consulte Gerenciar controles de atributos em todo o site

Para usar esse recurso, o modo de configuração precisa estar no nível do catálogo.

As mudanças nas configurações de atributos para indexação e pesquisa entram em vigor imediatamente após a ingestão do catálogo. Caso contrário, pode levar até 12 horas. ou mais para que as alterações entrem em vigor. É possível testar se as mudanças foram aplicadas na página Avaliar.

Configurar atributos com AttributesConfig

O recurso da API AttributesConfig permite gerenciar configurações de atributos em no nível do catálogo.

Os campos a seguir definem opções de atributo no nível do catálogo:

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

Atualizar vários atributos

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

Os atributos do catálogo incluídos na solicitação são atualizados no catálogo ou inseridos se não existirem. Se não houver valor para um catálogo atributo, será atribuído um valor padrão.

O número máximo de atributos de catálogo permitidos em uma solicitação é 1.000.

Atualizar um atributo individual

Os métodos a seguir 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. Isso 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 excluir CatalogAttributes que não estão sendo usados pelos produtos. Se um CatalogAttribute estiver em uso, o RemoveCatalogAttribute não o excluirá, mas redefinirá as propriedades de configuração para os valores padrão. CatalogAttribute.inUse é definido como True se o atributo for usado por qualquer produtos.

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

Configurar atributos com o método Product (descontinuado)

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

Os campos a seguir definem configurações indexáveis e pesquisáveis para um produto pelo método de API Product: