Facetas para pesquisa

Esta página apresenta alguns dos recursos de facetas e como usá-los.

Definições relacionadas a atributos

Esta seção apresenta algumas definições e explicações básicas de alguns termos relacionados a facetas:

• Atributos: as especificações de atributos para realizar a pesquisa facetada. Eles ajudam os usuários a encontrar o que querem filtrando os resultados. Por exemplo, se um usuário pesquisar shoes, algumas facetas que podem ser retornadas são: price, attributes.department, attributes.colors e attributes.size.

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

• Atributos personalizados: 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 faceta correspondem aos nomes de atributos. Por exemplo, o nome do atributo do sistema (produto) sizes corresponde à chave de faceta sizes. Da mesma forma, o nome do atributo personalizado (produto) department corresponde à chave de faceta attributes.department. Para atributos personalizados, o prefixo attributes. é adicionado ao nome do atributo personalizado para conseguir a chave de faceta. Os termos "nome do atributo", "chave de faceta" e "nome da faceta" são intercambiáveis.

• Valor do atributo: para chaves de texto, é um dos valores de texto de um atributo. Por exemplo, a chave de faceta textual brands pode ter valores textuais como Asics e Nike. Para chaves numéricas, o valor de um atributo é um intervalo. Por exemplo, a chave de faceta numérica price pode ter um intervalo do tipo [20, 30].

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

• Atributos fixados: é um atributo que você transmite na solicitação usando o FacetSpec com a opção enableDynamicPosition=false. As facetas precisam aparecer na ordem original antes de todas as facetas dinâmicas na resposta.

• Facetas dinâmicas: são as facetas que a pesquisa classifica ao lado. Elas são transmitidas na solicitação com a opção enableDynamicPosition=true ou extraídas de acordo com os modelos de pesquisa. Em seguida, eles são classificados pelos mesmos modelos treinados, com os mais relevantes no topo.

• Exibição dinâmica de atributos, atributos dinâmicos ou blocos: 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. Para ativar o atributo dinâmico para um atributo, também é necessário ativar a indexação para esse 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 de faceta Asics da chave de faceta attributes.brands, parte do filtro poderá ser (attributes.brands:ANY(\"Asics",\"Nike\")). A expressão do filtro diferencia maiúsculas de minúsculas. Confira mais detalhes sobre o filtro neste guia do usuário.

Sobre os atributos e blocos dinâmicos

Quando a exibição dinâmica de atributos está ativada para uma configuração de veiculação, a pesquisa pode usar automaticamente os atributos como atributos dinâmicos e blocos nos resultados da pesquisa para essa configuração, com base no comportamento anterior do usuário, como cliques e visualizações. As facetas dinâmicas são transmitidas na solicitação com a opção enableDynamicPosition=true ou extraídas 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 facetas é facetável. As configurações de reconhecimento dinâmico na API podem ser substituídas para algumas chaves de faceta específicas usando os controles de atributos em todo o site no console da Pesquisa para varejo. Em outras palavras, se você quiser que algumas chaves de faceta não sejam facetadas, desative a facetação dinâmica para cada uma dessas chaves na guia Attribute controls. Para mais informações, consulte Gerenciar controles de atributos para todo o site.

Os atributos e blocos dinâmicos podem ser criados com base em 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 a atividade no site. Para isso, é necessário definir os campos de consulta, categoria e filtro nos uploads de eventos de pesquisa com precisão.

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

Controles de atributo

Esta seção fornece instruções para criar diferentes tipos de controles de faceta, muitos dos quais também governam o comportamento do bloco:

• Ignorar controles de valores de atributo e bloco
• Substituir controles de valores de atributos e blocos
• Controles de mesclagem de atributos
• Definir controles de intervalos numéricos
• Remover atributos e controles de blocos
• Forçar controles de retorno de atributos
• Controles de reclassificação de atributos dinâmicos

A Pesquisa da Vertex AI para varejo faz a correspondência sensível a maiúsculas para todos esses controles de faceta, a menos que seja indicado o contrário.

Observação: os três últimos tipos de controle de facetas dinâmicas, "Remover", "Forçar retorno" e "Reclassificar", não afetam os blocos.

Para controlar valores de faceta e o comportamento do bloco, acesse a guia Controles de faceta no console da Pesquisa para varejo.

Acessar a página "Controles"

Clique em Criar controle para modificar os atributos retornados da pesquisa. O painel Criar controle é aberto. Clique no campo Tipo de controle para abrir um menu suspenso em que você pode selecionar o tipo de controle. Cada um deles abre uma caixa de diálogo com opções para controlar seus atributos. Todos os tipos de controle de facetas exigem pelo menos as informações de atributo, mas cada formulário exige informações um pouco diferentes.

Criar um controle de ignorar valores de atributo e bloco

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

Observação: só é possível ignorar atributos textuais. Esse controle não se aplica a atributos numéricos.

Esse controle é útil para apagar valores de faceta e bloco indesejados, como NA e Not_applicable. No entanto, 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 de atributo e bloco:

1. Acesse a página "Controles" no console da Pesquisa para varejo.

   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Selecione Ignorar valores de atributo e bloco.

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 atributo e bloco

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

A substituição de valores de atributo e bloco às vezes é chamada de mesclar valores de atributo e bloco.

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 pode aparecer mais de uma vez no campo Replace values.

Observação: esse recurso só funciona para atributos de texto personalizados. Os valores de atributos numéricos não podem ser substituídos. Durante a indexação de cada produto, os valores substituídos e os valores de substituição serão incluídos como valores de atributo, a menos que você exceda o número máximo de valores permitidos por atributo personalizado em um produto. Nesse caso, a pesquisa vai truncar os valores de substituição de forma arbitrária.

Para criar um controle que substitua o atributo e os valores:

1. Acesse a página "Controles" no console da Pesquisa para varejo.

   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Selecione Substituir valores de atributo e bloco.

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 Replace values (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.

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

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

Criar um controle de mesclagem de facetas

É melhor definir corretamente os nomes e valores dos atributos personalizados do produto do seu lado antes que os produtos sejam transferidos para o banco de dados da Pesquisa. No entanto, se não for possível mudar os nomes de atributos personalizados, crie controles de mesclagem de facetas. Você cria um controle de mesclagem de facetas se quiser mesclar (substituir) uma faceta por outra. Por exemplo, você pode ter várias chaves de facetas personalizadas para cores como attributes.colors_jeans, attributes.colors_clothes e attributes.colors_hue e querer substituí-las por uma chave de faceta personalizada chamada attributes.colors.

Observação: só é possível mesclar uma faceta de texto com outra faceta de texto. Da mesma forma, só é possível mesclar um atributo numérico em outro único. É possível mesclar um atributo em, no máximo, um atributo mesclado. É possível mesclar vários atributos no mesmo atributo mesclado. Uma chave e a chave mesclada precisam ser nomes de atributos personalizados válidos (com o prefixo attributes. adicionado). Em outras palavras, essas duas chaves precisam ser os nomes de atributos personalizados de alguns produtos ingeridos.

De preferência, as chaves mescladas devem ser:

• Nomes de atributos personalizados que são permanentes e não mudam de tipo.
• Atributo de nomes de muitos produtos ingeridos.

Se você excluir uma chave mesclada, vai perder os dados de engajamento dela, que são usados para treinar modelos de facetas dinâmicas.

Durante a indexação de cada produto, as chaves e as chaves mescladas são incluídas como nomes de atributos, a menos que você exceda o número máximo de atributos permitidos por produto. Se o número máximo de atributos exceder a cota permitida por produto, a pesquisa truncará arbitrariamente as chaves mescladas que se tornam nomes de atributos.

Por exemplo, se você já tiver o número máximo de nomes de atributos personalizados para um produto específico e um deles for colors_jeans, suponha que você use um controle de mesclagem de facetas para mesclar attributes.colors_jeans em attributes.colors. Nesse caso, o nome do atributo colors não será adicionado a esse produto específico, porque ele já contém o número máximo de chaves personalizadas por produto. As chaves mescladas não serão excluídas dos nomes de atributos (personalizados) dos produtos, mas também não serão retornadas como chaves de facetas dinâmicas. Da mesma forma, se você mesclar várias chaves com a mesma chave e isso resultar no número de valores de atributo para a chave mesclada excedendo o limite de valores de atributo permitidos, a pesquisa truncará arbitrariamente os valores de atributo.

Para criar um controle que mesclou uma faceta em outra:

1. Acesse a página "Controles" no console da Pesquisa para varejo.

   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Selecione Mesclar atributos.

4. Especifique uma chave de faceta personalizada válida que seja mesclada 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 faceta personalizada válida como a chave mesclada.

6. Clique em Enviar.

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

Criar um controle de intervalos numéricos definidos

O controle de intervalos numéricos definidos permite determinar os intervalos de um bloco ou 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,infinito] para a chave de faceta numérica personalizada attributes.monitor_size. No entanto, talvez você prefira os intervalos [0,14), [14,17), [17,21), [21,24), [24,27), [27,32] e [32,infinito].

Sobre os intervalos calculados e definidos

Observação: a pesquisa calcula intervalos somente se você tiver pelo menos um serving config com DynamicFacetSpec definido como Enabled.

Para todos os atributos personalizados numéricos e os atributos do 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 atributo (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 chave de faceta numérica usando os controles definir intervalos numéricos abaixo.

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 faceta numérica, eles serão mantidos.

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

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

Criar o controle

Se você quiser especificar seus próprios intervalos para chaves de faceta e bloco numéricos em vez de usar os calculados pela Vertex AI para Pesquisa de varejo, crie um conjunto de controles de intervalos numéricos.

Observação: só é possível definir intervalos para atributos numéricos.

Para criar um controle para adicionar intervalos:

1. Acesse a página "Controles" no console da Pesquisa para varejo.

   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Selecione Definir intervalos de facetas e blocos 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 Mínimo ou Máximo. Se ambos forem especificados, o mínimo não poderá ser maior que o máximo. Você pode escolher se cada limite será inclusivo ou exclusivo.

6. Para adicionar mais intervalos, clique em Adicionar intervalos. O número máximo de intervalos é 40.

7. Clique em Enviar.

Criar um controle para remover atributos e blocos

O controle de remoção de atributos permite remover um atributo e uma chave de bloco específicos dos atributos dinâmicos. As chaves de atributo e de bloco são removidas com base em alguns termos de consulta ou categorias de página.

Esse tipo de controle de faceta controla o próprio atributo. Nenhum atributo ou bloco associado a esse atributo como membros será retornado na pesquisa se esse tipo de controle de atributo for aplicado.

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

Para criar um controle de remoção de um atributo ou bloco:

1. Acesse a página "Controles" no console da Pesquisa para varejo.

   Acessar a página "Controles"

2. Na guia Controles de faceta, clique em Criar controle. O painel Criar controle é aberto.

3. Selecione Remover atributos e blocos.

4. Cada controle é para pesquisar ou navegar, mas não pode ser usado para ambos. Escolha uma destas opções:

   • Para consultas de pesquisa, clique em Pesquisar e especifique alguns termos de consulta parciais ou alguns termos de consulta exatos para fazer a correspondência. Confira informações detalhadas nos termos da consulta e nas condições. Os termos da consulta precisam estar em letras minúsculas em ambos os casos. Por exemplo, é possível especificar os termos de consulta parcial shirts, polo, jackets, t-shirt e fall coats, e as chaves de faceta especificadas a seguir não vão aparecer como uma faceta dinâmica se a consulta em letras minúsculas for um desses termos ou contiver qualquer um desses termos como um unigrama.

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

5. Especifique pelo menos uma chave de faceta válida em Atributos a ignorar.

6. Clique em Enviar.

Criar um controle de força de retorno de atributos

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

Esse controle é útil se você quiser forçar uma chave de faceta específica entre as facetas dinâmicas para alguns termos de consulta ou navegação. Por exemplo, é possível usar esse controle para forçar a chave de faceta brands a aparecer na posição 10 ou em uma posição menor para a consulta handbags. Se a faceta brands já estiver entre as 10 primeiras facetas dinâmicas para essa consulta, ela não vai se mover muito. Se ele não estiver entre os 10 primeiros ou na lista de facetas dinâmicas, ele vai se mover para a posição 10 aproximadamente.

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

1. Acesse a página "Controles" no console da Pesquisa para varejo.

   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Selecione Forçar o retorno de atributos.

4. Cada controle é para pesquisar ou navegar, mas não pode ser usado para ambos. Escolha uma destas opções:

   • Para consultas de pesquisa, clique em Pesquisar e especifique alguns termos de consulta parciais ou alguns termos de consulta exatos para fazer a correspondência. Confira informações detalhadas nos termos da consulta e nas condições. Os termos da consulta precisam estar em letras minúsculas em ambos os casos. Por exemplo, é possível especificar os termos de consulta parcial shirts, polo, jackets, t-shirt e fall coats, e as chaves de faceta especificadas em seguida precisam aparecer em torno da respectiva posição ou mais altas entre as facetas dinâmicas, se a consulta em minúsculas for um desses termos de consulta ou contiver qualquer um desses termos de consulta como um unigrama.

   • Para navegar, clique em Procurar categorias e especifique algumas categorias de páginas. Você pode especificar uma lista (até 10 entradas) de categorias ou departamentos. O formato precisa ser o mesmo das categorias de página do evento do usuário. Por exemplo, pode ser page_categories : Sales > 2023 Black Friday Deals. Se houver uma correspondência exata (sensível a maiúsculas e minúsculas) entre o último e uma das categorias de página transmitidas no evento (para navegação), as chaves de faceta especificadas em seguida vão aparecer na respectiva posição ou mais altas entre as facetas dinâmicas.

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

6. Se você quiser especificar mais de uma chave de faceta, clique em Adicionar ajuste e repita a etapa anterior.

7. Clique em Enviar.

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

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

Por exemplo, usando esse controle, se o usuário interagir com o valor de atributo watches da chave de atributo attributes.department após uma pesquisa ou navegação, o ranking também vai depender do valor de atributo watches. É possível especificar os valores de atributo que você quer classificar novamente por chave de atributo ou especificar apenas a chave de atributo e classificar novamente todos os valores de atributo.

Observação: esse controle só pode ser usado para chaves textuais customizáveis. Para usar esse controle, também é necessário transmitir todas as chaves de faceta engajadas pelo usuário na solicitação usando o campo FacetSpec. Especificamente, se você não passar as chaves de facetas engajadas que quer classificar novamente, esse controle não será eficaz. Além disso, para conseguir resultados melhores, os valores de faceta que você quer reclassificar precisam ser próximos do inglês (de preferência, compostos de palavras, sublinhados e espaços).

Para criar um controle para reclassificar atributos dinâmicos:

1. Acesse a página "Controles" no console da Pesquisa para varejo.

   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Selecione Reclassificar atributos dinâmicos.

4. Especifique uma chave de faceta textual personalizada válida. Todas as chaves personalizadas têm o prefixo attributes..

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

   • Se você quiser reordenar todos os valores da faceta, clique em Qualquer mudança de valor.

   • Se você quiser reclassificar valores de faceta específicos, clique em Valores selecionados mudam. Em seguida, insira todos os valores de faceta que você quer classificar novamente (sensível a maiúsculas e minúsculas). Por exemplo, pode ser watches, luggages ou bed.

6. Clique em Enviar.

Você precisa transmitir todas as chaves de facetas engajadas pelo usuário na solicitação pelos seguintes motivos:

• Suponha que um usuário procure vendas e receba uma primeira lista de chaves de facetas apresentadas.
• Em seguida, o usuário interage primeiro com a chave de faceta attributes.age_group.
• Em seguida, eles usam a chave de faceta attributes.department com os valores de faceta watches, para os quais você configura um controle para reclassificar.

Nesse ponto, a pesquisa classifica as chaves novamente.

Portanto, é possível que a chave de faceta attributes.age_group, que foi usada anteriormente, não seja retornada na resposta. Se você transmitir 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 você pode mostrar apenas as primeiras 20 chaves para o usuário. Por isso, verifique se essas chaves engajadas anteriormente pelo usuário serão mostradas a ele. Se você não quiser mostrar muitas teclas ao usuário, talvez seja necessário filtrar algumas teclas intermediárias não engajadas na resposta.