Conferir resultados da pesquisa

Esta página descreve as consultas básicas com a pesquisa, incluindo pesquisas de consulta de texto, pesquisas de navegação, paginação, otimização e resultados personalizados.

Nunca armazene em cache resultados personalizados de um usuário final nem retorne resultados personalizados para outro usuário final.

Relevância na Vertex AI para Pesquisa no varejo

Relevância é diferente de correspondência. A correspondência é a busca de produtos candidatos no índice que correspondem à consulta de pesquisa do usuário. A relevância, por outro lado, é um grau de correspondência. Isso envolve classificar esses produtos de uma forma que melhor satisfaça a intenção e as necessidades do usuário. A Vertex AI para Pesquisa para varejo usa técnicas para melhorar a correspondência e a relevância, oferecendo uma experiência de pesquisa geral melhor para os usuários e atendendo às necessidades dos varejistas.

Pesquisa não padrão

A Vertex AI para Pesquisa no comércio usa a relevância como padrão na pesquisa. No entanto, a pesquisa também é ajustada para mostrar itens marginalmente relevantes mais acima nos resultados da pesquisa e oferecer aos varejistas resultados mais segmentados para aumentar o potencial de conversão dos eventos do usuário.

Esses recursos de pesquisa adicionados otimizam o algoritmo de relevância padrão, oferecendo recursos não padrão ajustados ao perfil de utilização de cada varejista, incluindo:

• Opções para classificar os resultados por preço, mais bem avaliados ou mais vendidos. A pesquisa não padrão é personalizada para retornar resultados específicos com as variantes corretas do produto. Por exemplo, para mostrar a variante mais barata ou mais cara ao classificar por preço.

• Aplicação automática de um filtro de relevância mais restrito para eventos do usuário não padrão.

• Ativação de controles ajustáveis de otimização/ocultação para ajustar os resultados da pesquisa.

Pesquisa de texto e pesquisa de navegação

A pesquisa oferece recursos de pesquisa por consulta de texto e por navegação.

No caso de uso de pesquisa por consulta de texto, um comprador pode inserir uma consulta de texto no seu site. A pesquisa retorna uma resposta com produtos que se encaixam nos parâmetros dos controles configurados, classificados por relevância e maximização de receita.

No caso de uso de navegação, um comprador pode acessar o menu do seu site e navegar até uma categoria de produto específica. A pesquisa escolhe automaticamente a ordem de classificação que maximiza a receita aprendendo com o comportamento e as tendências dos usuários. Os resultados da navegação podem ser refinados ainda mais pelos controles que você configurou.

As solicitações de pesquisa de texto e de navegação usam o método servingConfigs.search.

Pesquisas de consultas de texto

Quando um usuário insere uma consulta de texto para pesquisar no seu site, a pesquisa classifica os possíveis resultados com base na relevância, popularidade, capacidade de compra e personalização.

A Pesquisa considera uma solicitação servingConfigs.search como uma solicitação de pesquisa baseada em texto se ela tiver um campo query não vazio.

Ao fazer upload de eventos do usuário, envie eventos de pesquisa de consulta de texto gerados pela pesquisa como eventos do usuário search. Se o evento tiver um campo userEvent.searchQuery não vazio e um campo userEvent.pageCategories vazio, a pesquisa vai considerá-lo um evento de pesquisa baseada em texto.

Procurar pesquisas

A navegação usa a navegação do site para produzir resultados de pesquisa de igual relevância classificados por itens mais vendidos. A Pesquisa usa a IA para otimizar a classificação dos resultados da navegação considerando a popularidade, a capacidade de compra e a personalização.

Para receber os resultados corretos da pesquisa de navegação, considere o seguinte:

• Os valores de pageCategories e filter nas suas solicitações de pesquisa precisam corresponder exatamente aos valores de pageCategories e filter nos eventos do usuário enviados. Se os parâmetros nas solicitações não corresponderem aos parâmetros nos eventos, o modelo de reclassificação com base em cliques aprendido com os eventos não terá um bom desempenho para essa consulta específica e vai afetar negativamente a qualidade dos resultados.

• A Vertex AI Search para comércio categoriza um evento de usuário search como um evento de navegação se ele tiver um campo userEvent.searchQuery vazio e um campo userEvent.pageCategories não vazio. Por isso, é necessário enviar os eventos de navegação gerados pela Vertex AI para Pesquisa para Commerce como eventos do usuário search ao fazer o upload deles.

• Um filtro de navegação precisa ser válido e indicar para cada consulta de navegação quais produtos pertencem à categoria que o usuário está navegando. Para isso, o ID da categoria precisa ser definido nos campos filter e page_category. Por exemplo, se você quiser que os resultados da pesquisa sejam segmentados para "Casa e jardim". Primeiro, ter apenas um valor filter de "in-stock" não refina a pesquisa o suficiente para fornecer os melhores resultados de navegação. Para fornecer resultados de pesquisa restritos a casa e jardim, você precisa definir "Home \& Garden" na categoria da página e no filtro com categories: ANY("Home & Garden"). Se você não definir a categoria na parte do filtro, os resultados da navegação provavelmente serão muito amplos e incluirão muitos itens que não são de casa e jardim.

As solicitações e os eventos de serviço com um campo de consulta vazio e campos page_categories preenchidos são considerados solicitações de navegação e eventos do usuário. O campo page_categories especifica a própria página de navegação. Quando o método servingConfigs.search envia uma solicitação, a Pesquisa a considera uma solicitação de pesquisa de navegação se o campo query estiver vazio. Nesse caso, os resultados são baseados nos campos filter e pageCategories e, se disponível, mais otimização e personalização.

Você pode definir a categoria em ambos, como neste exemplo:

page_category: "Home & Garden"
filter: "(availability: ANY("IN_STOCK")) AND (categories: ANY("Home & Garden"))"

Caso contrário, como a navegação funciona com consultas de string vazias, os produtos de uma determinada categoria não serão exibidos automaticamente nos resultados de uma categoria de página específica. Em outras palavras, se o usuário final navegar sem especificar nada usando uma consulta de texto, o retorno da pesquisa poderá não gerar resultados efetivamente segmentados, mesmo que o usuário navegue até uma página de categoria.

Usar solicitações de pesquisa

Use solicitações de pesquisa para receber resultados de pesquisas de texto e de navegação. Para fazer uma solicitação de pesquisa, use o método servingConfigs.search.

Todas as solicitações de pesquisa exigem placement, que identifica o nome completo do recurso da configuração de exibição que será usada. A configuração de exibição determina quais configurações e controles associados afetam os resultados da pesquisa.

As solicitações de pesquisa de consulta de texto exigem um campo query não vazio.

As solicitações de pesquisa de navegação exigem um campo pageCategories não vazio.

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

public static void searchProducts(String query) throws IOException, InterruptedException {
  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .build();

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

Por padrão, um número razoável de resultados ordenados por relevância é retornado.

Para receber atributos de produto retornados com a resposta da pesquisa, forneça valores de atributo ao importar os dados do catálogo. O Product tem atributos de sistema predefinidos, como marca, cor e tamanho, para os quais você pode fornecer valores. Também é possível incluir atributos personalizados definidos com Product.attributes.

Tutorial de consultas

Neste tutorial, mostramos como enviar uma consulta de pesquisa baseada em texto para o serviço Vertex AI para Pesquisa de Comércio e analisar a resposta.

Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientação:

Orientações

Paginação

Use a paginação para diminuir o tempo de pesquisa e o tamanho das respostas enviadas.

Tutorial de paginação

Neste tutorial, mostramos como controlar a paginação em uma solicitação de pesquisa baseada em texto. Quando um comprador procura produtos em uma loja, ele pode melhorar a navegação pelos resultados da pesquisa. Por exemplo, eles podem limitar o número de itens na resposta da pesquisa usando o recurso de tamanho da página ou pular para a página preferida usando o recurso de deslocamento.

Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientação:

Orientações

Paginar

Para pular de uma página para outra, use page_token ou offset, de acordo com seu caso de uso.

Para acessar a próxima página, use page_token. Por exemplo, suponha que você envie a SearchRequest a seguir.

{
  placement: 'projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/placements/default_search'
  visitor_id: 'VISITOR_ID'
  query: 'shoes'
  page_size: 5
}

A partir de SearchResponse, é possível conseguir os produtos resultantes com cinco principais relevâncias, além de um next_page_token.

{
  results: [
    products{...}, products{...}, products{...}, products{...}, products{...}
  ]
  next_page_token: "wY4ETNkBDOlVjZ0YWLzUmM40SMhVjMtADMwATL5UGN5MGZlVDJaIQ5LaYsQUw9fC6lIwgE1EgC"
  total_size: 100
  search_token: "NtQKDAiXt4_3BRDCg_jnARABGiQ1ZWRjOTRlOC0wMDAwLTI1YTEtODJlMy1mNGY1ZTgwZDUxOGM"
}

Para conseguir os produtos de resultado com os próximos cinco valores (de 6º a 10º), você precisa definirpage_token usando o mesmoplacement ,visitor_id equery comonext_page_token da anteriorSearchResponse de dados.

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

public static void searchProducts_withNextPageToken(String query, int pageSize)
    throws IOException, InterruptedException {
  try (SearchServiceClient searchClient = SearchServiceClient.create()) {
    SearchRequest firstRequest = SearchRequest.newBuilder()
        .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
        .setBranch(DEFAULT_BRANCH_NAME)
        .setVisitorId(VISITOR_ID)
        .setQuery(query)
        .setPageSize(pageSize)
        .build();

    SearchResponse firstResponse = searchClient.search(firstRequest).getPage()
        .getResponse();
    System.out.println("First search response: " + firstResponse);

    SearchRequest secondRequest = SearchRequest.newBuilder()
        .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
        .setBranch(DEFAULT_BRANCH_NAME)
        .setVisitorId(VISITOR_ID)
        .setQuery(query)
        .setPageSize(pageSize)
        .setPageToken(firstResponse.getNextPageToken())
        .build();

    SearchResponse secondResponse = searchClient.search(secondRequest).getPage()
        .getResponse();
    System.out.println("Second search response: " + secondResponse);
  }
}

Neste exemplo, SearchRequest tem esta aparência:

{
  placement: 'projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/placements/default_search'
  visitor_id: 'VISITOR_ID'
  query: 'shoes'
  page_size: 5
  page_token: "wY4ETNkBDOlVjZ0YWLzUmM40SMhVjMtADMwATL5UGN5MGZlVDJaIQ5LaYsQUw9fC6lIwgE1EgC"
}

Em outros casos, em vez de navegar de uma página para outra ou de ver os resultados com maior relevância, você pode ir diretamente para uma posição específica com offset.

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

public static void searchProducts_withOffset(String query, int pageSize,
    int offset) throws IOException, InterruptedException {
  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .setPageSize(pageSize)
      .setOffset(offset)
      .build();

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

Por exemplo, se quiser a 10ª página dos resultados, quando o tamanho da página for 5, defina o offset como 45, que é calculado por (10 - 1) * 5.

{
  placement: 'projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/placements/default_search'
  visitor_id: 'VISITOR_ID'
  query: 'shoes'
  page_size: 5
  offset: 45
}

Níveis de performance da pesquisa

A Pesquisa oferece vários níveis de performance que melhoram cada vez mais seus resultados. Por exemplo, para casos de uso de pesquisa por consulta de texto, os resultados podem ser baseados apenas na relevância. À medida que você desbloqueia níveis de performance mais avançados, a pesquisa pode retornar resultados com base na relevância, popularidade, otimização de receita e personalização.

A pesquisa desbloqueia automaticamente níveis de desempenho mais altos quando você faz upload de dados de catálogo e eventos do usuário que atendem aos requisitos mínimos de cada nível.

Para mais informações sobre como usar essa página para ver a qualidade dos dados e os níveis de desempenho da pesquisa, consulte Desbloquear níveis de desempenho da pesquisa. A página Qualidade dos dados no console de pesquisa para comércio mostra uma avaliação de quais requisitos você atende em cada nível.

Avaliar os resultados da pesquisa de texto e da navegação

Antes de atualizar o código do site para solicitar resultados da pesquisa por texto ou da pesquisa de navegação, use a visualização para confirmar se a configuração de exibição está funcionando conforme o esperado.

Para mais informações sobre configurações de veiculação, consulte Sobre configurações de veiculação.

É possível visualizar os resultados da configuração de exibição na página Avaliar ou acessando a página Detalhes de uma configuração de exibição no console e clicando na guia Avaliar. As etapas a seguir mostram como fazer uma prévia na página Avaliar.

Para visualizar os resultados retornados pela configuração de veiculação:

Para ver a página Detalhes da configuração de exibição que você está visualizando, clique em Ver configuração de exibição no campo Selecionar configuração de exibição.