Atributos para pesquisa

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

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

  • Facets: especificações para realizar a pesquisa facetada. Eles ajudam os usuários a encontrar o que querem filtrando os resultados. Por exemplo, se um pesquisas do usuário por shoes, alguns atributos que podem ser retornados 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: os atributos personalizados são atributos extras que você define usando o campo Product.attributes. Para 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 atributos correspondem à 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 do atributo de atributos são intercambiáveis.

  • Valor do atributo: para chaves de texto, é um dos valores de texto de um atributo. Por exemplo, a chave de atributo textual brands poderia ter esses 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 aparecem na ordem original, antes de todas as facetas dinâmicas na resposta.

  • Atributos dinâmicos: são os atributos classificados pela pesquisa lado. Elas são transmitidas 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 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 os anúncios dinâmicos facetas para um atributo, você também precisa 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 engajar os valores de atributo Asics do chave de atributo 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 atributos e blocos dinâmicos

Quando a filtragem de atributos dinâmicos está ativada para uma configuração de veiculação, pesquisa podem usar automaticamente atributos como facetas e blocos dinâmicos nos resultados da pesquisa para este com base no comportamento anterior do usuário, como visualizações e cliques em atributos. 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 facetas é facetável. Configurações de atributos dinâmicos na API pode ser substituído por algumas chaves de atributos específicas de sua escolha por todo o site controles de atributos 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 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 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 de suas configurações de exibição tiver facetas e blocos dinâmicos ativados e você acabou de ativar atributos e blocos dinâmicos em uma configuração de exibição, espere de três a quatro dias antes que eles funcionem.

Controles de atributo

Nesta seção, fornecemos instruções para criar diferentes tipos de atributos controles, muitos dos quais também regem o comportamento de blocos:

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.

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 uma delas abre uma caixa de diálogo com opções para controlar os atributos. Todos os tipos de controle de atributo exigem pelo menos as informações do atributo, mas cada formulário exige informações um pouco diferentes.

Texto alternativo

Criar um controle de valores de bloco e atributo de ignorar

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:

  1. Acesse a página "Controles" no console do Search 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 e blocos.

  4. Especifique o nome do atributo.

    Por exemplo, brands para um sistema . Para um atributo personalizado, o nome começa com attributes., para 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.

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 será aberto.

  3. Selecione Substituir valores de atributo e bloco.

  4. Especifique o nome do atributo.

    Esse recurso só funciona para atributos personalizados, que começam com o prefixo com 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 atributos

É 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. Crie um controle de mesclagem de atributos se quiser mesclar (substituir) um atributo por outro. 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, perderá os dados de engajamento, que são usada para treinar modelos de atributos dinâmicos.

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, o que resulta no número de valores de atributo para a chave mesclada excedendo o limite de valores de atributo permitido, a pesquisa trunca arbitrariamente os valores dos atributos.

Para criar um controle que mesclou uma faceta em outra:

  1. Acesse a página "Controles" no console do Search for Retail.

    Acessar a página "Controles"

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

    O painel Criar controle será aberto.

  3. Selecione Mesclar atributos.

  4. Especifique uma chave de atributo personalizada válida que seja mesclada com outra.

    Esse recurso só funciona para atributos personalizados, que começam com o prefixo com 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 definido

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. Mas, talvez você prefira intervalos [0,14), [14,17), [17,21), [21,24), [24,27), [27,32) e [32,infinity) como alternativa.

Sobre intervalos calculados e intervalos 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.

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

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

  • Caso contrário, se uma chave de atributo numérico for dinâmica ou transmitida na solicitação sem intervalos, os intervalos que você incluir usando a função controles definir intervalos numéricos são adicionados a essa chave de atributo numérico 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 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.

Para criar um controle para adicionar intervalos:

  1. Acesse a página "Controles" no console do Search for Retail.

    Acessar a página "Controles"

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

    O painel Criar controle será aberto.

  3. Selecione Definir atributos numéricos e intervalos de blocos.

  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., para 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 facetas 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 atributos e blocos são removidas com base em alguns termos de consulta ou categorias de página.

Esse tipo de controle de atributo 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 para remover um atributo ou bloco:

  1. Acesse a página "Controles" no console do Search for Retail.

    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. Os controles são para pesquisa ou navegação, mas não podem ser aplicados a ambos. Escolha uma destas opções:

    • Para consultas de pesquisa, clique em Pesquisar e especifique alguns valores termos da consulta ou alguns termos exatos da consulta para correspondência. Mais detalhes informações nos termos de consulta e 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, fall coats e as as chaves de atributo especificadas a seguir não aparecerão como um atributo dinâmico se o consulta em letras minúsculas é um desses termos de consulta ou contém qualquer um destes termos de consulta como um unigrama.

    • Para navegação, clique em Procurar categorias e especifique páginas categorias. 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 correspondência exata (diferencia maiúsculas de minúsculas) entre este último e um dos resultados da página categorias transmitidas no evento (para navegação) e, em seguida, as chaves de atributo especificado em seguida não aparecerá 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 um 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 o atributo brands já estiver no topo 10 para os atributos dinâmicos da consulta, ela não deve 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 do Search for Retail.

    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. Os controles são para pesquisa ou navegação, mas não podem ser aplicados a 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. Mais detalhes informações nos termos de consulta e condições. Os termos da consulta devem estar em letras minúsculas para nos dois casos. Por exemplo, é possível especificar os termos de consulta parcial shirts, polo, jackets, t-shirt, fall coats e as as chaves de atributo especificadas a seguir devem aparecer ao redor das respectivas posição mais alta entre os atributos dinâmicos se a consulta em letras 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 correspondência exata (diferencia maiúsculas de minúsculas) entre este último e um dos resultados da página categorias transmitidas no evento (para navegação) e, em seguida, as chaves de atributo especificado a seguir devem aparecer ao redor de sua respectiva posição ou mais altos entre os atributos dinâmicos.

  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 atributo, clique em Adicionar ajuste e refazer 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 alguns valores de atributo engajados pelo usuário.

Por exemplo, usando esse controle, se o o usuário engaja o valor de atributo watches da chave de atributo attributes.department após uma pesquisa ou navegação, a classificação também dependerá do atributo o valor 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:

  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 atributos específicos ou aplicar a todos.

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

    • Para reclassificar valores de atributos específicos, clique em Mudanças nos valores selecionados. Em seguida, insira todos os valores de atributo que você gostaria de reclassificar. (diferencia maiúsculas de minúsculas). Por exemplo, pode ser watches, luggages, bed

  6. 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 engaja primeiro a chave de atributo 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 reclassifica as chaves.

Portanto, é possível que a chave de atributo anteriormente engajada attributes.age_group não seja retornada no 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 20 primeiras chaves para o usuário. Por isso, certifique-se de que essas chaves previamente acionadas pelo usuário serão mostrados ao usuário. 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.