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 ver exemplos e limites de atributos personalizados, consulte as Documentação de referência do Product.attributes.

  • Atributos de nível de inventário: atributos personalizados ou do sistema 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 sistemas numéricos predefinidos pela Vertex AI para Pesquisa para Retail. É possível criar configurações atributos de nível de inventário, que podem ser textuais ou numéricos. 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 atributos usando esse atributo.
  • Atributos dinâmicos: a Pesquisa pode usar esse recurso automaticamente atributo como um atributo dinâmico com base no comportamento anterior do usuário, como cliques em atributos e visualizações. Para ativar o atributo dinâmico para um atributo, Indexable precisa ser definido como verdadeiro para esse atributo.
  • Pesquisável: este atributo é pesquisável por pesquisa. o que aumenta o recall do atributo. Esse controle é aplicável apenas a atributos de texto.
  • Recuperável: se definido como verdadeiro, a pesquisa retornará este nas respostas de consultas de pesquisa. Se todos os atributos tiverem "Retrievable" definido como falso, os resultados da pesquisa vão conter apenas o nome do produto ou (para 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.

A seção "Recomendações" usa as seguintes configurações de atributo:

  • Filtrável (pré-lançamento público): esse atributo pode ser usado em recomendações e filtrar expressõ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 criar atributos usando o atributo.

  • Atributos do sistema: a capacidade de indexação está sempre ativada para atributos predefinidos do sistema. Não é possível desativar essa configuração para atributos do sistema.
  • Atributos personalizados: ativados por padrão. É possível desativar a capacidade de indexação de 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 alterações entrem em vigor. Você pode testar se as alterações foram aplicadas. no(a) 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. É possível desativar o atributo dinâmico para qualquer atributo do sistema.
  • Atributos personalizados: ativados por padrão se a indexabilidade for definida como verdadeira. Você é possível desativar os atributos dinâmicos de qualquer atributo personalizado.
  • Atributos no nível do inventário: não sã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 alterações foram aplicadas 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 os valores de atributos textuais podem ter a capacidade de pesquisa ativada. Não é aplicáveis 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 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. Não é compatível com atributos numéricos.
  • Atributos personalizados: desativado por padrão. É possível ativar essa configuração para qualquer atributo textual personalizado de 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 atributos que são tratadas e quais delas você pode definido.

  • 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 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 estiver no modo de configuração no nível do produto e precisar alternar para o modo de configuração no 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 a coluna Indexable não estiver disponível na guia Controles em todo o site, o modelo de configuração será no nível do produto.

Métodos de configuração

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

  • A pesquisa pelo console do Retail: defina de atributos no nível do catálogo usando o Pesquise o console 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 isso no console, consulte Gerenciar controles de atributos para 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 mudanças entrem em vigor. É possível testar se as mudanças foram aplicada 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 as opções de atributos 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 de catálogo que você incluir na solicitação serão atualizados no catálogo ou inseridas caso não existam. 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 de catálogo individuais:

  • 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 por atualizando o atributo de 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 estiver em uso por qualquer produto.

    Consulte a documentação de referência da API para 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 específico pelo método de API Product: