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
eattributes.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
esize
.Atributos personalizados: atributos personalizados são atributos extras que você define usando o campo Product.attributes. Por exemplo, isso pode incluir
style
,color
oudepartment
.Chave de atributo: é o nome de um atributo. Por exemplo, pode ser
attributes.department
ousizes
. As chaves de faceta correspondem aos nomes de atributos. Por exemplo, o nome do atributo do sistema (produto)sizes
corresponde à chave de facetasizes
. Da mesma forma, o nome do atributo personalizado (produto)department
corresponde à chave de facetaattributes.department
. Para atributos personalizados, o prefixoattributes.
é 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 comoAsics
eNike
. 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 formulário [20, 30].Tipo de 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 facetaattributes.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 são buscadas 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 controles de atributos
em todo o site no console de Pesquisa para comércio. 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ê tiver ativado 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 atributos e blocos
- 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 Vertex AI Search for commerce faz a correspondência sensível a maiúsculas para todos esses controles de faceta, a menos que seja indicado o contrário.
Para controlar valores de facetas específicas e o comportamento do bloco, acesse a guia Controles de facetas no console de Pesquisa para comércio.
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 uma delas 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.
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:
Acesse a página "Controles" no console do Search for Commerce.
Na guia Controles de faceta, clique em add_boxCriar controle.
O painel Criar controle é aberto.
Selecione Ignorar valores de atributo e bloco.
Especifique o nome do atributo.
Por exemplo,
brands
para um atributo do sistema. Para um atributo personalizado, o nome começa comattributes.
, por exemplo,attributes.department
eattributes.colors
.Opcional: especifique o Horário de início e/ou o Horário de término.
Especifique um ou mais valores de atributo como Ignorar valores.
Por exemplo,
NA
,Not_applicable
eEaster
.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.
Para criar um controle que substitua o atributo e os valores:
Acesse a página "Controles" no console do Search for Commerce.
Na guia Controles de faceta, clique em add_boxCriar controle.
O painel Criar controle é aberto.
Selecione Substituir valores de atributo e bloco.
Especifique o nome do atributo.
Esse recurso funciona apenas para atributos personalizados, que começam com o prefixo
attributes
, por exemplo,attributes.department
eattributes.colors
.Especifique um ou mais valores de atributo como Replace values (substituir valores), por exemplo,
RED
,Red
,dark red
,bright red
,ruby
ecrimson
.Um valor de atributo só pode aparecer uma vez no campo Substituir valores.
Especifique um único valor de atributo como Termo de substituição, por exemplo,
red
.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
.
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:
Acesse a página "Controles" no console do Search for Commerce.
Na guia Controles de faceta, clique em add_boxCriar controle.
O painel Criar controle é aberto.
Selecione Mesclar atributos.
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
eattributes.colors_jeans
.Especifique uma chave de faceta personalizada válida como a chave mesclada.
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
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 são adicionados.
Criar o controle
Se você quiser especificar seus próprios intervalos para chaves de bloco e faceta numérica em vez de usar os calculados pela Vertex AI para Pesquisa no comércio, crie um conjunto de controles de intervalos numéricos.
Para criar um controle para adicionar intervalos:
Acesse a página "Controles" no console do Search for Commerce.
Na guia Controles de faceta, clique em add_boxCriar controle.
O painel Criar controle é aberto.
Selecione Definir intervalos de facetas e blocos numéricos.
Especifique o nome de um atributo numérico.
Por exemplo,
price
para um atributo do sistema. Para um atributo personalizado, o nome começa comattributes.
, por exemplo,attributes.number_of_pieces
.Especifique pelo menos uma das opções 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.
Para adicionar mais intervalos, clique em add_boxAdicionar intervalos. O número máximo de intervalos é 40.
Clique em Enviar.
Criar um controle para remover atributos e blocos
O controle de remoção de atributos permite remover uma chave de bloco e de atributo específica 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, é possível usar esse controle para remover a chave de faceta
attributes.shoe_size
da consulta shoes
.
Use o Merchandising Console ou o console do Google Cloud para remover uma faceta ou um bloco:
Console de merchandising
Clique no URL fornecido pelo administrador. Faça login.
Isso vai levar você à página Controles no Console de merchandising.
Clique em add_boxCriar controle.
Defina as metas para os usuários finais e o tempo necessário. Todas as perguntas precisam ser respondidas. Clique em Próxima.
Selecione um controle. Insira o nome do controle, selecione o produto Pesquisa e escolha o tipo de controle Remover facetas.
Configure o controle Remove facets:
Em Ativações, defina qual atributo do catálogo aciona esse controle fornecendo critérios para uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se nenhum atributo de catálogo tiver sido configurado, esse controle será aplicado sempre.
Defina um Período aplicável inserindo um Período. Se algum dos intervalos de tempo especificados for atendido, o atributo do catálogo será correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um período com add_boxAdicionar período.
Defina o Atributo a ignorar na seção Ações para remover facetas para os atributos que você não quer que apareçam nas facetas dinâmicas dos termos de consulta especificados na seção Acionadores anterior.
Clique em class="material-icons">add_boxAdicionar atributo para incluir mais atributos.
Clique em Enviar para enviar a solicitação de controle a um aprovador. Você vai poder conferir o status das solicitações enviadas no console de merchandising. Se você mudar de ideia, poderá excluir o pedido de controle.
console do Cloud
Acesse a página "Controles" no console do Search for Commerce.
Na guia Controles de faceta, clique em add_boxCriar controle. O painel Criar controle é aberto.
Selecione Remover atributos e blocos.
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 parciais
shirts
,polo
,jackets
,t-shirt
efall 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 conter qualquer um desses termos como um unigrama.Para navegar, clique em Procurar categorias e especifique algumas categorias de páginas. É possível 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.
Especifique pelo menos uma chave de faceta válida em Atributos a ignorar.
Clique em Enviar.
Criar um controle de atributos de devolução forçada
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.
É possível criar um controle para as facetas de devolução forçada no Console de merchandising ou no Google Cloud.
Console de merchandising
Clique no URL fornecido pelo administrador. Faça login.
Isso vai levar você à página Controles no Console de merchandising.
Clique em add_boxCriar controle.
Defina as metas para os usuários finais e o tempo necessário. Todas as perguntas precisam ser respondidas. Clique em Próxima.
Selecione um controle. Insira o nome do controle, selecione o produto Pesquisar ou Procurar e escolha o tipo de controle Forçar facetas de retorno.
Configure o controle Forçar o retorno de atributos:
Em Acionadores, defina qual atributo do catálogo aciona esse controle fornecendo critérios para uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se nenhum atributo de catálogo tiver sido configurado, esse controle será aplicado sempre.
Defina um Período aplicável inserindo um Período. Se algum dos intervalos de tempo especificados for atendido, o atributo do catálogo será correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um período com add_boxAdicionar período.
Defina o Ajuste de posição do atributo na seção Forçar ações de facetas de retorno. Aqui, você pode escolher um atributo que quer incluir nas facetas ou nos blocos dinâmicos da consulta ou categoria de página definida na seção Gatilhos anterior. Por exemplo, escolher uma posição de 5 faz com que a faceta apareça na quinta posição ou mais alta, a partir da parte de baixo da página.
Clique em add_boxAdicionar ajuste para adicionar mais atributos a serem governados por esse controle.
Clique em Enviar para enviar a solicitação de controle a um aprovador. Você vai poder conferir o status das solicitações enviadas no console de merchandising. Se você mudar de ideia, poderá excluir o pedido de controle.
console do Cloud
Acesse a página "Controles" no console do Search for Commerce.
Na guia Controles de faceta, clique em add_boxCriar controle.
O painel Criar controle é aberto.
Selecione Forçar o retorno de atributos.
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
efall 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. É possível 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 acima entre as facetas dinâmicas.
Especifique uma chave de faceta válida e uma posição de número inteiro entre 1 e 100.
Se você quiser especificar mais de uma chave de faceta, clique em add_boxAdicionar ajuste e repita a etapa anterior.
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.
Para criar um controle para reclassificar atributos dinâmicos:
Acesse a página "Controles" no console do Search for Commerce.
Na guia Controles de faceta, clique em add_boxCriar controle.
O painel Criar controle é aberto.
Selecione Reclassificar atributos dinâmicos.
Especifique uma chave de faceta textual personalizada válida. Todas as chaves personalizadas têm o prefixo
attributes.
.É possível especificar alguns valores de faceta específicos ou aplicar a todos.
Se você quiser reordenar todos os valores da faceta, clique em add_boxQualquer mudança de valor.
Se você quiser reclassificar valores de faceta específicos, clique em add_boxValores selecionados mudam. Em seguida, insira todos os valores de faceta que você quer classificar novamente (considerando maiúsculas e minúsculas). Por exemplo, pode ser
watches
,luggages
oubed
.
Clique em Enviar.
É necessário 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 facetawatches
, 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.