Aumente os resultados

A Pesquisa de IA para o comércio oferece uma funcionalidade que lhe permite especificar registos que devem ser destacados nas pesquisas. Pode controlar a classificação dos resultados aplicando uma regra de destaque para dar ou retirar prioridade aos itens de pesquisa devolvidos.

O destaque permite-lhe controlar a classificação dos resultados promovendo (destacando) ou rebaixando (enterrando) itens específicos com base nos critérios que definir. Ao contrário da filtragem, que remove itens do conjunto de resultados, o destaque ajusta a posição dos itens que já são elegíveis para serem devolvidos.

Substituições de destaque e filtro

Nota: as regras de filtragem têm sempre precedência sobre as regras de destaque. Para mais informações sobre a filtragem e a ordenação de resultados da pesquisa, consulte o artigo Filtre e ordene os resultados.

Estes são exemplos de tipos de filtros comuns que têm precedência sobre as regras de destaque:

1. Especificados pelo utilizador. Podem ser aspetos como o preço ou a marca. São apresentados ao utilizador final como mosaicos ou facetas no Website.

• Atualidade (relevância). Estes filtros só existem para consultas de pesquisa (não para navegação). Excluem produtos menos relevantes dos resultados da pesquisa. Por exemplo, a pesquisa frigorífico não devolve micro-ondas nem acessórios, como pegas de frigoríficos. O filtro reconhece que não deve destacar um micro-ondas para uma pesquisa de frigorífico.

Regras de destaque

As regras de destaque só podem ser aplicadas quando existe uma pontuação de relevância base, como em pesquisas ordenadas por relevância ou resultados de navegação com pontuações de pré-ordenamento. O destaque é uma função de multiplicador aplicada aos resultados da pesquisa e da navegação. A sintaxe e a lógica do destaque podem ser divididas em:

• Disponibilidade. O destaque não pode substituir as regras de disponibilidade. Se um item for filtrado (por exemplo, esgotado), destacá-lo não o faz aparecer.

• Operadores. Pode usar operações como maior que e menor que para campos numéricos em condições de destaque, que não estão disponíveis na filtragem restrita padrão.

Destaque ou rebaixe valores

Um produto pode ser condicionado por várias regras de destaque ou rebaixamento, que são definidas na boostSpec classe da API Search. Um valor de destaque é um número de vírgula flutuante entre -1,0 e 1,0.

• Valor positivo (0,0 a 1,0): promove o item, movendo-o para uma posição superior nos resultados. Um valor de 1,0 dá a promoção máxima.

• Valor negativo (-1,0 a 0,0): rebaixa (enterra) o item, movendo-o para uma posição inferior nos resultados. Um valor de -1,0 dá o rebaixamento máximo.

Várias regras de destaque ou rebaixamento num único produto

Várias regras de destaque ou rebaixamento podem afetar um produto, com uma soma ou um máximo dos valores de destaque a determinar a pontuação final. Quando são aplicadas várias regras de destaque ao mesmo produto, verifique sempre se a pontuação de outro produto ultrapassou a do produto em questão. O modo máximo está definido como predefinição para que este problema seja menos provável de ocorrer.

Suponha que um produto recebe destaques de 2, 3 e 0,5, e outro produto recebe um destaque de 0,5. Embora o produto só tenha recebido uma pontuação de destaque de 0,5, quando é destacado repetidamente, supera o outro produto. Verifique cuidadosamente a especificação de destaque para se certificar de que não se sobrepõe ou que se sobrepõe, conforme pretendido.

Resolução de conflitos

Se forem aplicadas várias regras de destaque ao mesmo produto, pode definir a forma como interagem.

• Regra de destaque máximo (predefinição) : a Pesquisa de IA para o comércio verifica qual é o valor máximo e ignora as outras regras.

• Soma do efeito de destaque (definição alternativa): se existir um rebaixamento mais uma promoção, a Pesquisa de IA para o comércio soma os valores de todas as regras de destaque e rebaixamento aplicáveis. Isto permite um efeito cumulativo. A soma resultante é um destaque inferior ou um efeito de rebaixamento líquido.

Configure o destaque

Para configurar um conjunto de dados com regras de destaque ou rebaixamento, defina condições com base nos atributos do produto (como a marca ou o preço) e atribua um valor de destaque entre -1,0 (rebaixamento) e 1,0 (destaque) para ajustar a pontuação de classificação dos itens correspondentes. Os seguintes produtos estão disponíveis para configurar controlos de destaque ou rebaixamento:

• Pesquisa: filtro de atualidade mais quaisquer outros filtros aplicados pelo utilizador, como facetas no site. Leia mais sobre como configurar o destaque para a pesquisa.

• Navegação: uma vez que não existe uma consulta de texto, só são aplicados os filtros aplicados pelo utilizador. Os filtros também são aplicados para verificar se o produto (digamos, fatos) pertence à categoria de produtos correta (não camisolas, por exemplo). Leia mais sobre como configurar o destaque para recomendações.

Conjunto de dados de exemplo

Veja um exemplo de um conjunto de dados de produtos

id	title	brands	categories	price_info.price
"nest_mini_2nd_gen"	"Nest Mini (2.ª geração)"	["Google", "Nest"]	["Nest > altifalantes e ecrãs"]	49.00
"nest_audio"	"Nest Audio"	["Google", "Nest"]	["Nest > altifalantes e ecrãs"]	99.99
"nest_hub_max"	"Nest Hub Max"	["Google", "Nest"]	["Nest > altifalantes e ecrãs"]	229.00
"nest_hub"	"Nest Hub"	["Google", "Nest"]	["Nest > altifalantes e ecrãs"]	88.99
"google_home_max"	"Google Home Max"	["Google", "Nest"]	["Nest > altifalantes e ecrãs"]	299.00
"google_home_mini"	"Google Home Mini"	["Google", "Nest"]	["Nest > altifalantes e ecrãs"]	49.00
"google_pixel_5"	"Google Pixel 5"	["Google", "Pixel"]	["Pixel > telemóveis"]	699.00
"google_pixel_4a_with_5g"	"Google Pixel 4a com 5G"	["Google", "Pixel"]	["Pixel > telemóveis"]	499.00
"google_pixel_4a"	"Telemóveis Google Pixel 4a"	["Google", "Pixel"]	["Pixel > telemóveis"]	349.00
"google_pixel_stand"	"Google Pixel Stand"	["Google", "Pixel"]	["Pixel > acessórios em destaque"]	79.00
"google_pixel_buds"	"Google Pixel Buds"	["Google", "Pixel"]	["Pixel > acessórios em destaque"]	179.00
"google_pixel_5_case"	"Capa para Google Pixel 5"	["Google", "Pixel"]	["Pixel > acessórios em destaque"]	40.00
"google_pixel_4a_5g_case"	"Capa para Google Pixel 4a (5G)"	["Google", "Pixel"]	["Pixel > acessórios em destaque"]	40.00
"google_pixel_4a_case"	"Capa para Google Pixel 4a"	["Google", "Pixel"]	["Pixel > acessórios em destaque"]	40.00

Opções de configuração

Na Pesquisa de IA para o comércio, o destaque é aplicado como um multiplicador à pontuação de relevância base gerada pelo algoritmo de pesquisa. Pode configurar regras de destaque diretamente num pedido de pesquisa através de uma especificação de destaque ou anexando controlos de publicação a uma configuração de publicação. Na resposta, os itens que correspondem a estas condições recebem uma pontuação de relevância modificada, o que faz com que apareçam numa posição superior ou inferior na lista de resultados sem serem removidos por completo. Para configurar um controlo de destaque ou rebaixamento de pesquisa:

Cloud Console

1. Aceda à página Controlos na consola da Pesquisa de IA para o comércio no Gemini Enterprise for Customer Experience.
   
   Aceda à página Controlos

2. No separador Controlos de publicação, clique em Editar à direita de um controlo.

3. No menu flutuante Editar controlo, clique no campo abaixo do campo Nome do controlo para modificar o nome do controlo.

4. Opcional: para a pesquisa, na secção Acionadores, selecione o tipo de comportamento do utilizador que aciona este controlo. As secções Navegar pelas categorias e Pesquisar estão escuras.

5. Opcional: edite os Termos de pesquisa correspondentes.

   Nota: se especificar uma condição de categoria ou termo de consulta mais condições de intervalo de tempo, o controlo só se aplica quando ambas as condições forem cumpridas.

6. Opcional: clique na opção Adicionar intervalo de tempo para adicionar um ou mais intervalos de tempo durante os quais este controlo pode ser aplicado.

   Nota: se especificar condições de intervalo de tempo, além deste tipo de condição, o controlo só é aplicado se ambas as condições forem cumpridas.

7. Clique em Continuar para avançar para a secção Ações.

8. Adicione filtros para atributos do produto no campo Destaque/rebaixe o produto.

   Use a sintaxe de expressão de filtro documentada no artigo Filtre e ordene os resultados. Por exemplo, para especificar as versões vermelha e azul de "product1" e "product2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

9. Para Valor de destaque/rebaixamento, use o controlo de deslize para definir a intensidade do destaque. Os valores positivos destacam os resultados e os valores negativos rebaixam-nos. Clique em Continuar.

10. Na secção Configurações de publicação, selecione as configurações de publicação às quais aplicar o controlo.

11. Envie as definições de controlo.

Agora, pode encontrar a regra de controlo de destaque ou rebaixamento adicionada como um novo Tipo de controlo apresentado em Controlos de publicação para o seu projeto. Saiba como criar um novo controlo de destaque e rebaixamento em Crie controlos.

JSON

Isto demonstra um exemplo de destaque por preço.

Suponha que quer dar prioridade aos produtos mais baratos (menos de 95 USD) e retirar prioridade aos produtos caros (mais de 95 USD). Pode aplicar uma especificação de destaque.

{
  "condition_boost_specs": [
    {
      "condition": "price: IN(*, 95.0e)",
      "boost": 0.5
    },
    {
      "condition": "price: IN(95.0e, *)",
      "boost": -0.5
    }
  ]
}

Neste exemplo, os produtos com um preço inferior a 95 USD recebem uma promoção (0,5), enquanto os produtos com um preço superior a 95 USD são rebaixados (-0,5).

No resultado, "nest_mini_2nd_gen", "google_home_mini" e "nest_hub" podem ser os três primeiros, enquanto "nest_audio", "nest_hub_max" e "google_home_max" podem ser os três últimos. No entanto, não é predeterminada nenhuma ordem específica, ao contrário da ordenação por preço, conforme abordado no artigo Filtre e ordene os resultados.

Destaque na pesquisa

Para a pesquisa, aplique a pontuação de classificação dos itens correspondentes de forma dinâmica incluindo uma especificação de destaque (boostSpec) com condition_boost_specs diretamente no SearchRequest.

Condições e acionadores

O destaque da pesquisa pode ser condicional. Pode acionar uma regra de destaque com base nestas condições:

• Termos de consulta: aplique o destaque apenas quando o utilizador pesquisar termos específicos (como destacar casacos de inverno quando a consulta contém casaco).

• Intervalos de tempo: aplique o destaque apenas durante um período promocional específico.

• Global: aplique o destaque a todas as consultas publicadas por uma configuração específica.

Exemplo de pedido e resposta de pesquisa

No conjunto de dados de exemplo apresentado anteriormente, se pesquisar "altifalante Google", recebe "nest_mini_2nd_gen", "nest_audio", "nest_hub_max", "nest_hub", "google_home_max" e "google_home_mini" sem uma ordem específica.

Veja um exemplo de pedido e resposta de pesquisa

Java

import com.google.cloud.retail.v2.SearchRequest;
import com.google.cloud.retail.v2.SearchRequest.BoostSpec;
import com.google.cloud.retail.v2.SearchRequest.BoostSpec.ConditionBoostSpec;
import com.google.cloud.retail.v2.SearchResponse;
import com.google.cloud.retail.v2.SearchServiceClient;

public static void searchProductsWithBoostSpec(String query, int pageSize,
    String condition, float boostStrength) throws IOException, InterruptedException {
  BoostSpec boostSpec = BoostSpec.newBuilder()
      .addConditionBoostSpecs(ConditionBoostSpec.newBuilder()
          .setCondition(condition)
          .setBoost(boostStrength)
          .build())
      .build();

  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .setPageSize(pageSize)
      .setBoostSpec(boostSpec)
      .build();

  try (SearchServiceClient searchClient = SearchServiceClient.create()) {
    SearchResponse response = searchClient.search(searchRequest).getPage().getResponse();
    System.out.println("Search response: " + searchResponse);
  }
}

Destaque em recomendações

O destaque para recomendações é gerido através de controlos de publicação. Ao contrário da pesquisa, o destaque de recomendações não é compatível com condições baseadas em consultas (uma vez que não existe uma consulta do utilizador). Em alternativa, o controlo aplica-se a todas as previsões geradas pela configuração de publicação à qual está anexado. Por este motivo, normalmente, configura as recomendações anexando controlos de publicação de destaque ou rebaixamento à configuração de publicação, em vez de transmitir uma especificação de destaque no pedido.

Campos compatíveis para recomendações

Quando definir os produtos a destacar nas recomendações, use uma expressão de filtro. Embora a filtragem de recomendações padrão esteja limitada a campos de texto, o destaque é compatível com campos numéricos adicionais.

Tipo de campo	Campos compatíveis	Descrição
Textual	productId, brands, categories, genders, ageGroups, colorFamilies, colors, sizes, title,materials, patterns, conditions, attributes.key, tags	Campos padrão disponíveis para filtragem e destaque. Tenha em atenção que tags são etiquetas personalizadas associadas ao produto.
Numérico	price, discount, rating, ratingCount	Exclusivo para destaque/rebaixamento. Estes campos permitem-lhe destacar produtos com base no preço, nos descontos ou nas classificações dos utilizadores.

Para mais informações, consulte a secção Campos compatíveis com destaque/rebaixamento no artigo Filtre recomendações.

Destaque produtos com classificação elevada

Suponha que quer garantir que os filmes com classificação elevada aparecem numa posição superior no respetivo painel de recomendações "Outros que lhe podem agradar". Para este exemplo de utilização, crie um controlo de publicação para destacar itens com uma contagem de classificações superior a 100. Configure os controlos, tendo em conta o seguinte:

• Tipo de controlo: destaque ou rebaixamento

• Seleção de produtos: recomendação

• Ação:

  • Expressão de filtro: ratingCount > 100

  • Valor de destaque: 0.5

Este controlo garante que os itens populares e com boas classificações têm prioridade na lista de recomendações, ao mesmo tempo que mantém a relevância da personalização para o utilizador.

Depure e resolva problemas

Todos os produtos são elegíveis para um destaque ilimitado, mas os filtros aplicados pelo utilizador eliminam produtos da resposta da pesquisa. Para resolver problemas relacionados com o motivo pelo qual um produto destacado pode não aparecer nos resultados da pesquisa e da navegação, verifique o seguinte:

• Várias regras de destaque (incluindo rebaixamentos): verifique a configuração do modo de destaque (soma ou máximo) e determine a pontuação final.
• Relevância: um produto tem de ser relevante para a consulta e passar os filtros de relevância. Se uma consulta de pesquisa for para sapatos Nike e o título do produto for Air Jordans,as palavras não correspondem, mas a respetiva relação semântica próxima resulta numa pontuação de relevância elevada. Um título do produto como casaco amarelo tem uma pontuação de relevância baixa com uma consulta de pesquisa Nike. Da mesma forma, se o título do produto for um número de modelo enigmático que não tenha qualquer relação com nenhuma palavra, a pontuação de relevância será baixa para qualquer consulta.
• Filtros: as regras de filtragem substituem qualquer regra de destaque e impedem que os produtos destacados apareçam nos resultados. O filtro é sempre aplicado acima do destaque. Se um produto tiver filtros aplicados pelo utilizador ou se uma categoria de produtos filtrar a navegação, o destaque não funciona.

Tutorial de destaque

Este tutorial mostra-lhe alguns exemplos de destaque de produtos.

---

Para seguir as orientações passo a passo para esta tarefa diretamente no Editor do Cloud Shell, clique em Visita guiada:

Visita guiada

---