Atributos para pesquisa

Nesta página, apresentamos alguns dos recursos de atributos e como usá-los.

Nesta seção, fornecemos algumas definições básicas e explicações para alguns termos relacionados a atributos:

  • Facets: as especificações de atributo para executar a pesquisa de atributos. Eles ajudam os usuários a encontrar o que desejam filtrando os resultados. Por exemplo, se um usuário pesquisar por shoes, alguns atributos que podem ser retornados serão: price, attributes.department, attributes.colors e attributes.size.

  • Atributos do sistema: atributos do sistema predefinidos são campos de produto que fornecem mais informações sobre o produto. Eles incluem alguns atributos de produto predefinidos, como brand, availability, color e size.

  • Atributos personalizados: os atributos personalizados são atributos extras que você define usando o campo Product.attributes. Por exemplo, isso pode incluir style, color ou department.

  • Chave de atributo: é o nome de um atributo. Por exemplo, pode ser attributes.department ou sizes. As chaves de atributo correspondem aos nomes dos atributos. Por exemplo, o nome de atributo do sistema (produto) sizes corresponde à chave de atributo sizes. Da mesma forma, o nome do atributo personalizado (produto) department corresponde à chave de atributo attributes.department. Para atributos personalizados, o prefixo attributes. é adicionado ao nome do atributo personalizado para receber a chave do atributo. Os termos nome do atributo, chave e nome do atributo são intercambiáveis.

  • Facet value: para chaves textuais, é um dos valores textuais de um atributo. Por exemplo, a chave de atributo textual brands pode ter valores textuais de Asics e Nike. Para chaves numéricas, um valor de atributo é um intervalo. Por exemplo, o preço da chave de atributo numérico pode ter um intervalo do formato [20, 30).

  • Tipo de um atributo ou atributo: pode ser textual ou numérico.

  • Atributos fixados: são um atributo que você transmite na solicitação usando o FacetSpec com a opção enableDynamicPosition=false. Os atributos precisam aparecer na ordem original deles antes de todos os atributos dinâmicos na resposta.

  • Atributos dinâmicos: são atributos que pesquisam classificações. Elas são transmitidas na solicitação com a opção enableDynamicPosition=true ou buscadas de acordo com os modelos de pesquisa. Em seguida, eles são classificados pelos mesmos modelos treinados, com os mais relevantes no topo.

  • Atributos facetas ou dinâmicos: quando um atributo é ativado para atributos dinâmicos, a pesquisa pode usar esse atributo automaticamente como um atributo dinâmico com base no comportamento anterior do usuário, como cliques e visualizações de atributos. Para ativar a filtragem dinâmica de um atributo, também é necessário ativar a indexação desse atributo.

  • Filtro: a sintaxe filter consiste em uma linguagem de expressão para construir um predicado a partir de um ou mais campos dos produtos que estão sendo filtrados. Por exemplo, se um usuário interagir com os valores Asics da chave de atributo attributes.brands, parte do filtro poderá ser (attributes.brands:ANY(\"Asics",\"Nike\")). A expressão de filtro diferencia maiúsculas de minúsculas. Veja mais detalhes sobre o filtro neste guia do usuário.

Sobre os atributos dinâmicos

Quando os filtros de atributos dinâmicos estão ativados para uma configuração de veiculação, a pesquisa pode usar automaticamente atributos como atributos dinâmicos nos resultados da pesquisa para essa configuração com base no comportamento anterior do usuário, como cliques e visualizações de atributos. Os atributos dinâmicos não serão eficazes para exibir a configuração sem que eles estejam ativados. Os atributos dinâmicos são transmitidos na solicitação com a opção enableDynamicPosition=true ou buscados de acordo com os modelos de pesquisa. Em seguida, eles são classificados pelos mesmos modelos, com os mais relevantes no topo.

Por padrão, a maioria das chaves de atributo é de facetas. As configurações de atributos dinâmicos na API podem ser substituídas por algumas chaves de atributos específicas de sua escolha por controles de atributos em todo o site no console do Search for Retail. Em outras palavras, se você quiser que algumas chaves de atributos não sejam atributos, será necessário desativar a facetação dinâmica de cada uma delas na guia Attribute controls. Para mais informações, consulte Como gerenciar controles de atributos em todo o site. Os atributos dinâmicos podem ser criados com base apenas nos dados precisos do catálogo de produtos. No entanto, para que o recurso funcione da melhor forma possível no seu site, os modelos de atributos precisam aprender com as atividades no seu site. Para isso, você precisa definir com precisão os campos de consulta, categoria e filtro nos uploads de eventos de pesquisa.

Se nenhuma das suas configurações de exibição tiver atributos dinâmicos ativados e você só tiver ativado os atributos dinâmicos em uma configuração de exibição, espere de três a quatro dias para que eles funcionem.

Controles de atributo

Nesta seção, fornecemos instruções para criar diferentes tipos de controles de atributos:

A Vertex AI para Pesquisa para varejo faz a correspondência diferenciando maiúsculas de minúsculas para todos esses controles de atributos, a menos que indicado de outra forma.

Criar um controle de valores de atributos para ignorar

Crie um controle de valores de atributos para ignorar quando quiser remover alguns valores indesejados de algumas chaves de atributos específicas.

Esse controle é útil para apagar valores de atributos indesejados, como NA e Not_applicable. Mas ele também pode ser usado para apagar tendências sazonais, como Easter, se você estiver em outubro.

Para criar um controle que ignore os valores dos atributos:

  1. Acesse a página "Controles" no console da Pesquisa for Retail.

    Acessar a página "Controles"

  2. Na guia Controles de atributo, clique em Criar controle.

    O painel Criar controle é aberto.

  3. Selecione Ignorar valores de atributos.

  4. Especifique o nome do atributo.

    Por exemplo, brands para um atributo do sistema. Para um atributo personalizado, o nome começa com attributes., por exemplo, attributes.department e attributes.colors.

  5. Opcional: especifique o Horário de início e/ou o Horário de término.

  6. Especifique um ou mais valores de atributo como Ignorar valores.

    Por exemplo, NA, Not_applicable e Easter.

  7. Clique em Enviar.

Criar um controle de substituição de valores de atributos

Crie um controle de substituição de valores de atributos quando quiser consolidar vários valores de atributos semelhantes em um único termo.

A substituição de valores de atributo às vezes é chamada de mesclagem de valores de atributo.

Para evitar conflitos e mapeamentos inúteis, se um valor de atributo facet_value_1 for substituído por outro valor de atributo facet_value_2, este último não poderá ser substituído por outro valor de atributo. Por exemplo, se você substituir ruby por dark red, não será possível substituir dark red por red.

Para cada nome de atributo, um valor de atributo não deve aparecer mais de uma vez no campo Substituir valores.

Para criar um controle que substitua os valores de atributos:

  1. Acesse a página "Controles" no console da Pesquisa for Retail.

    Acessar a página "Controles"

  2. Na guia Controles de atributo, clique em Criar controle.

    O painel Criar controle é aberto.

  3. Selecione Substituir valores de atributos.

  4. Especifique o nome do atributo.

    Esse recurso funciona apenas para atributos personalizados, que começam com o prefixo attributes., por exemplo, attributes.department e attributes.colors.

  5. Especifique um ou mais valores de atributo como Substituir valores.

    Por exemplo, RED, Red, dark red, bright red, ruby e crimson.

    Um valor de atributo só pode aparecer uma vez no campo Substituir valores.

  6. Especifique um único valor de atributo como Termo de substituição, por exemplo, red.

  7. Clique em Enviar.

Os valores substituídos podem desaparecer rapidamente, mas os termos de substituição podem levar até quatro dias para aparecer.

Quando o controle de substituição de valores de atributo entrar em vigor, se a chave de atributo (neste exemplo, attributes.colors) for retornada na resposta, os valores de atributo substituídos (como dark red e crimson) não estarão presentes como valores de atributo. Elas são substituídas pelos termos de substituição (por exemplo, red).

Criar um controle de mesclagem de atributos

É melhor definir corretamente os nomes e valores de atributos personalizados do produto antes que os produtos sejam ingeridos no banco de dados da pesquisa. No entanto, se não for possível mudar nomes de atributos personalizados, crie controles de atributos de combinação. Crie um controle de mesclagem de atributos se quiser mesclar (substituir) um atributo por outro. Por exemplo, você pode ter várias chaves de atributos personalizadas para cores como attributes.colors_jeans, attributes.colors_clothes e attributes.colors_hue e quer substituí-las por uma chave de atributo personalizada atual chamada attributes.colors.

Para criar um controle que mesclou um atributo com outro:

  1. Acesse a página "Controles" no console da Pesquisa for Retail.

    Acessar a página "Controles"

  2. Na guia Controles de atributo, clique em Criar controle.

    O painel Criar controle é aberto.

  3. Selecione Mesclar atributos.

  4. Especifique uma chave de atributo personalizada válida que se mescle a outra.

    Esse recurso funciona apenas para atributos personalizados, que começam com o prefixo attributes., por exemplo, attributes.colors_clothes e attributes.colors_jeans.

  5. Especifique uma chave de atributo personalizada válida como a chave mesclada.

  6. Clique em Enviar.

Esse controle normalmente entra em vigor em dois a quatro dias.

Criar um controle de intervalos numéricos

Com o controle de intervalos numéricos definido, você determina os intervalos de um atributo numérico em vez de aceitar intervalos calculados.

Por exemplo, a pesquisa pode calcular os intervalos [10,15), [15,20) [20,25), [25,30), [30,40) e [40,50) e [50,infinity) para a chave de atributo numérica personalizada attributes.monitor_size. Mas você pode preferir os intervalos [0,14), [14,17), [17,21), [21,24), [24,27), [27,32) e [32,infinity)].

Sobre intervalos calculados e definidos

Para todos os atributos personalizados numéricos e os atributos de sistema numérico price, rating e ratingCount, a pesquisa calcula alguns intervalos com limites arredondados com base na distribuição de todos os valores de atributos numéricos para cada um desses atributos. Também é possível especificar alguns intervalos na solicitação. Como última opção, você pode definir seus próprios intervalos para cada tecla de atributo numérica usando os controles de intervalos numéricos definidos a seguir.

Confira a ordem de prioridade que determina quais intervalos são usados:

  • Primeiro, se alguns intervalos forem especificados na solicitação de uma chave de atributo numérica, esses intervalos serão mantidos.

  • Caso contrário, se uma chave de atributo numérica for dinâmica ou transmitida na solicitação sem intervalos, os intervalos incluídos com os controles intervalos numéricos definidos serão adicionados a essa chave de atributo numérico se esses intervalos não estiverem vazios.

  • Caso contrário, os intervalos calculados anteriormente mencionados com limites arredondados serão adicionados.

Criar o controle

Se você quiser especificar seus próprios intervalos para chaves de atributos numéricos em vez de usar aqueles que a Vertex AI para Pesquisa para varejo calcula para você, crie um controle de intervalos numéricos definidos.

Se quiser criar um controle para adicionar intervalos, faça o seguinte:

  1. Acesse a página "Controles" no console da Pesquisa for Retail.

    Acessar a página "Controles"

  2. Na guia Controles de atributo, clique em Criar controle.

    O painel Criar controle é aberto.

  3. Selecione Definir intervalos numéricos.

  4. Especifique o nome de um atributo numérico.

    Por exemplo, price para um atributo do sistema. Para um atributo personalizado, o nome começa com attributes., por exemplo, attributes.number_of_pieces.

  5. Especifique pelo menos um valor Mínimo ou Máximo. Se ambos forem especificados, o mínimo não poderá ser maior que o máximo. Você pode escolher cada limite como Inclusivo ou Exclusivo.

  6. Se quiser incluir outros, clique em + Adicionar intervalos. O número máximo de intervalos é 40.

  7. Clique em Enviar.

Criar um controle de remoção de atributos

Com o controle de remoção de atributos, é possível remover uma chave de atributo específica dos atributos dinâmicos. As chaves de atributo são removidas com base em alguns termos de consulta ou categorias de página fornecidos.

Esse controle é útil se você quiser remover algumas chaves de atributo para alguns termos de consulta ou navegação. Por exemplo, é possível usar esse controle para remover a chave de atributo attributes.shoe_size da consulta "sapatos".

Para criar um controle para remover atributo:

  1. Acesse a página "Controles" no console da Pesquisa for Retail.

    Acessar a página "Controles"

  2. Na guia Controles de atributo, clique em Criar controle.

    O painel Criar controle é aberto.

  3. Selecione Remover atributos.

  4. Cada controle é usado na pesquisa ou na navegação, mas não pode ser aplicado a ambos. Escolha uma destas opções:

    • Para consultas de pesquisa, clique em Pesquisar e especifique alguns termos de consulta parcial ou exatos para correspondência. Veja informações detalhadas nos termos de consulta e nas conditions. Os termos de consulta precisam estar em letras minúsculas nos dois casos. Por exemplo, é possível especificar os termos de consulta parcial shirts, polo, jackets, t-shirt e fall coats e as chaves de atributo especificadas em seguida não aparecerão como um atributo dinâmico se a consulta em minúsculas for um desses termos ou contiver qualquer um deles como um unigrama.

    • Para a navegação, clique em Procurar categorias e especifique algumas categorias de página. É possível especificar uma lista (até 10 entradas) de categorias ou departamentos. O formato precisa ser igual às categorias de página de evento do usuário. Por exemplo, pode ser page_categories : Sales > 2023 Black Friday Deals. Se houver uma correspondência exata (diferencia maiúsculas de minúsculas) entre o segundo e uma das categorias de página transmitidas no evento (para navegação), as chaves de atributo especificadas a seguir não aparecerão como um atributo dinâmico.

  5. Especifique pelo menos uma chave de atributo válida em Atributos a serem ignorados.

  6. Clique em Enviar.

Criar um controle de atributos de retorno forçado

O controle de atributos de retorno forçado pode afetar a posição da lista de uma chave de atributo dinâmica para uma consulta ou evento de navegação específico.

Esse controle é útil se você quiser forçar uma chave de atributo específica entre os atributos dinâmicos para alguns termos de consulta ou navegação. Por exemplo, é possível usar esse controle para forçar a chave de atributo brands a aparecer na posição 10 ou em uma posição menor para a consulta handbags. Se o atributo brands já estiver entre os 10 principais para os atributos dinâmicos desta consulta, ele não deverá se mover muito. Se ele não estiver entre os 10 principais ou não na lista de atributos dinâmicos, deverá mover aproximadamente para a posição 10.

Para criar um controle para o atributo de retorno forçado:

  1. Acesse a página "Controles" no console da Pesquisa for Retail.

    Acessar a página "Controles"

  2. Na guia Controles de atributo, clique em Criar controle.

    O painel Criar controle é aberto.

  3. Selecione Forçar o retorno de atributos.

  4. Cada controle é usado na pesquisa ou na navegação, mas não pode ser aplicado a ambos. Escolha uma destas opções:

    • Para consultas de pesquisa, clique em Pesquisar e especifique alguns termos de consulta parcial ou exatos para correspondência. Veja informações detalhadas nos termos de consulta e nas conditions. Os termos de consulta precisam estar em letras minúsculas nos dois casos. Por exemplo, especifique os termos de consulta parcial shirts, polo, jackets, t-shirt e fall coats. Assim, as chaves de atributo especificadas em seguida devem aparecer ao redor das respectivas posições ou acima entre os atributos dinâmicos, se a consulta em letras minúsculas for um desses termos ou contiver qualquer um deles como um unigrama.

    • Para a navegação, clique em Procurar categorias e especifique algumas categorias de página. É possível especificar uma lista (até 10 entradas) de categorias ou departamentos. O formato precisa ser igual às categorias de página de evento do usuário. Por exemplo, pode ser page_categories : Sales > 2023 Black Friday Deals. Se houver uma correspondência exata (diferencia maiúsculas de minúsculas) entre a última e uma das categorias de página transmitidas no evento (para navegação), as chaves de atributos especificadas a seguir aparecerão ao redor da respectiva posição ou acima entre os atributos dinâmicos.

  5. Especifique uma chave de atributo válida e uma posição de número inteiro entre 1 e 100 (inclusive).

  6. Se você quiser especificar mais de uma chave de atributo, clique em + Adicionar ajuste e refaça a etapa anterior.

  7. Clique em Enviar.

Criar um controle de atributos dinâmicos de reclassificação

A classificação de atributos dinâmicos depende da consulta (pesquisa) ou das categorias de páginas (navegação). O controle de atributos dinâmicos de reclassificação também permite que a classificação dependa de alguns valores de atributos engajados pelo usuário.

Por exemplo, ao usar esse controle, se o usuário engajar o valor de atributo watches da chave de atributo attributes.department após uma pesquisa ou navegação, a classificação também vai depender do valor de atributo watches. É possível especificar os valores de atributos que você quer reclassificar por chave de atributo ou especificar apenas a chave de atributo e reclassificar todos os valores de atributo dele.

Para criar um controle para atributos dinâmicos de reclassificação:

  1. Acesse a página "Controles" no console da Pesquisa for Retail.

    Acessar a página "Controles"

  2. Na guia Controles de atributo, clique em Criar controle.

    O painel Criar controle é aberto.

  3. Selecione Reclassificar atributos dinâmicos.

  4. Especifique uma chave de atributo textual personalizada válida (todas as chaves personalizadas têm o prefixo attributes.).

  5. É possível especificar alguns valores de atributos específicos ou aplicar a todos.

    • Se você quiser reclassificar todos os valores dos atributos, clique em Qualquer alteração de valor.

    • Se você quiser reclassificar valores de atributos específicos, clique em Alterações nos valores selecionados. Em seguida, insira todos os valores de atributos que você quer reclassificar (diferencia maiúsculas de minúsculas). Por exemplo, pode ser watches, luggages, bed.

  6. Clique em Enviar.

É preciso transmitir todas as chaves de atributos engajadas pelo usuário na solicitação pelo motivo mostrado abaixo. Suponha que um usuário procure vendas. O usuário recebe uma primeira lista de chaves de atributo apresentada. Em seguida, o usuário engaja primeiro a chave de atributo attributes.age_group. Em seguida, eles interagem com a chave de atributo attributes.department com os valores de atributo watches, para os quais você configura um controle para reclassificação. Nesse ponto, a pesquisa reclassifica as chaves. Portanto, é possível que a chave de atributo anteriormente engajada attributes.age_group não seja retornada na resposta. Se você passar essa chave na solicitação (usando um Facetspec com enableDynamicPosition definido como true), ela será retornada automaticamente na resposta. No entanto, a pesquisa pode retornar essa chave na posição 27, e é possível mostrar apenas as 20 primeiras chaves ao usuário. Por isso, você precisa garantir que as chaves engajadas anteriormente pelo usuário sejam mostradas. Talvez seja necessário filtrar algumas chaves não engajadas intermediárias na resposta se não quiser mostrar muitas chaves ao usuário.