Receber 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 e nunca retorne resultados personalizados para um usuário final diferente.

A relevância é diferente da 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 maneira que atenda melhor à intenção e às necessidades do usuário. A Vertex AI para Pesquisa para varejo usa técnicas para melhorar a correspondência e a relevância e oferecer uma experiência de pesquisa melhor para os usuários que atende às necessidades dos varejistas.

A Vertex AI para Pesquisa para varejo usa a relevância como padrão na pesquisa. No entanto, a pesquisa é ajustada para mostrar itens marginalmente relevantes mais acima nos resultados da pesquisa, oferecendo aos varejistas resultados de pesquisa 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, fornecendo recursos não padrão ajustados ao perfil de utilização de cada varejista, incluindo:

  • Opções para classificar os resultados, como por preço, itens mais bem avaliados ou mais vendidos. A pesquisa não padrão é personalizada para retornar resultados de pesquisa específicos com as variantes de produtos corretas. 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 que não são padrão.

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

Sobre a pesquisa de texto e a pesquisa de navegação com pesquisa

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

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

No caso 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 pesquisa podem ser refinados 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 ordena os resultados em potencial 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 um evento 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 considerar que ele é um evento de pesquisa baseado em texto.

Procurar pesquisas

A navegação do site é usada para produzir resultados de pesquisa de mesma relevância, classificados pelos itens mais vendidos. A Pesquisa usa a IA para otimizar a forma como os resultados da navegação são classificados, considerando popularidade, capacidade de compra e personalização.

As solicitações e os eventos de exibição com um campo de consulta vazio e campos page_categories não vazios são considerados solicitações de navegação e eventos do usuário. O campo page_categories especifica a página de navegação. Quando o método servingConfigs.search envia uma solicitação, a pesquisa considera que é 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, além de outras otimizações e personalizações, se disponíveis.

Para corrigir os resultados 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. valores 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 vai ter um bom desempenho para essa consulta específica e vai afetar negativamente a qualidade dos resultados.

  • O Vertex AI para Pesquisa para varejo categoriza um evento de usuário search como um evento baseado na 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 varejo como eventos de 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 fazer 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 de filter de "in-stock" não refina a pesquisa o suficiente para fornecer resultados de navegação ideais. Para fornecer resultados de pesquisa restritos a "Casa e jardim", você precisa definir "Home \& Garden" na categoria da página e também no filtro com categories: ANY("Home & Garden"). Se você não definir a categoria na parte do filtro, os resultados da pesquisa provavelmente serão muito amplos e vão incluir muitos itens que não são de casa e jardim.

É possível definir a categoria em ambos, como neste exemplo:

JSON

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 vão aparecer automaticamente nos resultados de uma determinada categoria de página. Em outras palavras, se o usuário final navegar sem especificar nada usando uma consulta de texto, o retorno da pesquisa pode não gerar resultados segmentados de forma eficaz, mesmo que o usuário navegue até uma página de categoria.

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á usado. 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.

Java

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 de pesquisa da Vertex AI para varejo 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 nos 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 de preferência 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.

JSON

{
  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.

JSON

{
  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.

Java

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:

JSON

{
  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.

Java

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.

JSON

{
  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 desempenho da pesquisa

A pesquisa oferece vários níveis de desempenho que melhoram cada vez mais seus resultados. Por exemplo, para casos de uso de pesquisa de 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 performance mais altos quando você faz o upload de dados de catálogo e eventos do usuário que atendem aos requisitos mínimos de cada nível.

A página Qualidade de dados no console de Pesquisa para varejo mostra uma avaliação dos requisitos que você cumpriu para cada nível. Para mais informações sobre como usar essa página para conferir a qualidade dos dados e os níveis de desempenho da pesquisa, consulte Desbloquear níveis de desempenho da pesquisa.

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

Antes de atualizar o código do site para solicitar a pesquisa de texto ou navegar pelos resultados da pesquisa, visualize os resultados para confirmar se a configuração de exibição está funcionando conforme o esperado.

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

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

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

Pesquisa de texto

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

    Acessar a página "Avaliar"

  2. Clique na guia Pesquisar.

  3. Selecione a configuração de veiculação que você quer visualizar.

  4. Selecione a ramificação que contém o catálogo que você quer visualizar.

  5. Opcional: insira um ID de visitante para visualizar os resultados da pesquisa desse usuário.

  6. Opcional: insira um ID do usuário para conferir os resultados da pesquisa desse usuário.

  7. Opcional: insira um horário de pesquisa para visualizar os resultados que apareceriam no horário especificado.

    Por exemplo, se você tiver promovido determinados produtos para a Black Friday, os resultados vão aparecer como se fossem mostrados nesse dia.

  8. Opcional: selecione os atributos que serão exibidos ao lado dos resultados da pesquisa e clique em OK para aplicá-los.

    Os atributos selecionados são usados para gerar uma lista de filtros de atributo que aparecem em Adicionar atributos depois que você realiza a pesquisa inicial. Esses filtros podem incluir outros atributos além dos selecionados nesta etapa, como atributos dinâmicos.

  9. Insira uma consulta de pesquisa de texto para conferir os resultados dessa pesquisa.

  10. Clique em Visualização da pesquisa ou pressione Enter em qualquer campo de entrada para ver os resultados.

    Os resultados da pesquisa são mostrados com as imagens de miniatura disponíveis.

    Se a pesquisa acionar um controle de redirecionamento, uma notificação vai aparecer mostrando o URI de redirecionamento.

  11. Opcional: clique no ícone Grade ou Lista para mudar a forma como os resultados da pesquisa são mostrados na visualização.

  12. Opcional: se você selecionou atributos para aparecer com seus resultados, selecione um ou mais valores de atributo da lista para filtrar os resultados por esses valores. Os resultados são atualizados automaticamente após a seleção.

    Quando você seleciona vários valores do mesmo atributo, eles são aplicados como um operador OR, e os valores de diferentes atributos são aplicados como um operador AND. Por exemplo, depois de selecionar as facetas cor e os valores "azul" e "dourado" e os valores material "algodão" e "poliéster". Os resultados da pesquisa precisam ter "azul" ou "dourado" como atributo e também "algodão" ou "poliéster" como atributo.

Procurar

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

    Acessar a página "Avaliar"

  2. Clique na guia Procurar.

  1. Selecione a configuração de veiculação que você quer visualizar.

  2. Selecione a ramificação que contém o catálogo que você quer visualizar.

  3. Opcional: insira um ID de visitante para conferir os resultados desse usuário.

  4. Opcional: insira um ID do usuário para conferir os resultados dele.

  5. Para conferir como os resultados ficariam com um filtro específico adicionado, insira uma string de filtro. Use a sintaxe da expressão de filtro especificada na documentação de filtros.

  6. Opcional: insira um horário de navegação para conferir os resultados que apareceriam no horário especificado.

    Por exemplo, se você tiver promovido determinados produtos para um evento de vendas de pico, é possível conferir os resultados como eles apareceriam nesse dia.

  7. Insira a categoria de página para a qual você está testando os resultados da pesquisa.

  8. Opcional: selecione os atributos que serão exibidos com os resultados e clique em OK para aplicá-los.

    Os atributos selecionados são usados para gerar uma lista de filtros de atributo que aparecem em Adicionar atributos depois que você realiza a pesquisa inicial. Esses filtros podem incluir outros atributos além dos selecionados nesta etapa, como atributos dinâmicos.

  9. Clique em Prévia de navegação ou pressione Enter em qualquer campo de entrada para ver os resultados.

    Os resultados são mostrados com as imagens de miniatura disponíveis.

  10. Opcional: clique no ícone Grade ou Lista para mudar a forma como os resultados são mostrados na visualização.

  11. Opcional: se você selecionou atributos para aparecer com seus resultados, selecione um ou mais valores de atributo da lista para filtrar os resultados por esses valores. Os resultados são atualizados automaticamente após a seleção.

    Quando você seleciona vários valores do mesmo atributo, eles são aplicados como um operador OR, e os valores de diferentes atributos são aplicados como um operador AND. Por exemplo, depois de selecionar as facetas cor e material, você pode filtrar os resultados da pesquisa selecionando os valores de cor "azul" e "dourado" e os valores de material "algodão" e "poliéster". Seus resultados precisam ter "blue" ou "gold" como um atributo e também precisam ter "cotton" ou "polyester" como um atributo.

Para acessar 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.