Sobre os atributos do produto

A Vertex AI para Pesquisa para varejo pode aproveitar os atributos do produto para indexação, reconhecimento dinâmico, 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 os atributos de sistema disponíveis para produtos, consulte a 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 nomes de lojas, 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 para varejo. É possível criar atributos personalizados no nível do 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 atributo:

  • 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 o valor "retrievable" definido como "false", os resultados da pesquisa vão conter 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 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 atributos no nível do inventário do sistema. Essa configuração não pode ser alterada. Ativada 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: são ativados por padrão se a capacidade de indexação estiver definida como "true". É possível desativar o atributo dinâmico para qualquer atributo do sistema.
  • Atributos personalizados: são ativados por padrão se a capacidade de indexação estiver definida como "true". É possível desativar o atributo dinâmico para qualquer atributo personalizado.
  • Atributos no nível do inventário: não são compatíveis.
  • Dependências: para ativar a configuração de atributo dinâmico, primeiro é necessário ativar a indexabilidade para esse 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, o recall dele nas consultas de pesquisa será melhorado.

Somente os valores de atributos textuais podem ter a capacidade de pesquisa ativada. Não é aplicável a atributos numéricos.

  • Atributos do sistema: os atributos do sistema textual predefinidos para Product têm as configurações de capacidade de pesquisa configuradas pela Vertex AI para Pesquisa para varejo. Não é possível mudar essa configuração.
  • 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
  • Pesquisável exatamente: a pesquisa segmentada retorna consultas de pesquisa que correspondem a qualquer produto no seu catálogo. Essa opção funciona bem para números de série. Saiba mais sobre a opção de pesquisa exata.

Embora os produtos com um atributo pesquisável tenham mais chances de aparecer nos resultados da pesquisa para esse atributo, não há garantia de que eles vão aparecer.

Filtragem de recomendações

Se um atributo tiver a filtragem de recomendações ativada, ele poderá ser usado em expressões de filtro de recomendações para filtrar produtos em 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: aceitos apenas para 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 atributo 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 atributo no nível do produto são usadas como a fonte da 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 a página Controles do console da Search for Retail. Se a opção Indexable estiver disponível como uma coluna na guia Controles em todo o site, o modelo de configuração será no nível do 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:

  • 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 dependem do 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. A definição de atributos com esse método não está disponível para novos usuários e não é recomendada.

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 aplicadas na página Avaliar.

Configurar atributos com AttributesConfig

O recurso da API AttributesConfig permite gerenciar configurações de atributos 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 um valor para um campo de atributo do catálogo, ele vai receber 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 de 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.

    Somente CatalogAttributes que não estão em uso pelos produtos podem ser excluídos. 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: