Receber resultados da pesquisa

Esta página descreve consultas básicas com pesquisa, incluindo texto pesquisar consultas, procurar pesquisas, paginação, otimização e resultados personalizados.

Nunca armazenar em cache resultados personalizados de um usuário final, nunca retornar resultados personalizados para um usuário final diferente.

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

A pesquisa oferece tanto a pesquisa de consulta de texto quanto a navegação recursos de pesquisa.

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 que contém produtos que se encaixam nos parâmetros dos controles que você configurou, classificados por relevância e maximização da receita.

No caso de uso de navegação, um comprador pode acessar o menu do seu site e navegar até uma categoria específica de produtos. 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 ainda mais refinados pelos controles definidos para cima.

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

Pesquisas de consulta 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 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

Normalmente, a navegação por produtos usando a navegação do site produz resultados de igual relevância ou classificados por itens mais vendidos. A Pesquisa usa IA para otimizar os resultados da navegação são ordenados por popularidade, compra e personalização.

Quando o método servingConfigs.search enviar uma solicitação, pesquise 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, além de outras otimizações e personalizações, se disponíveis.

Ao fazer upload de um evento do usuário, envie os eventos de pesquisa de navegação gerados pela pesquisa como eventos do usuário search. A pesquisa considera 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.

Para obter os resultados corretos da pesquisa do navegador, pageCategories e filter valores em suas solicitações de pesquisa devem corresponder exatamente a pageCategories e filter valores nos eventos do usuário enviados. Se eles não forem exatamente iguais, os dados nas solicitações de pesquisa podem não ser reconhecidos, o que pode prejudicar afetar a qualidade dos resultados. A pesquisa de navegação reconhece apenas o primeiro valor de categoria em pageCategories.

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 veiculação que será usada. A configuração de veiculação determina e os 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

Este tutorial mostra como enviar uma consulta de pesquisa baseada em texto para o Vertex AI para Pesquisa para serviço de varejo e análise da 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 da 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 de 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 desempenho mais altos quando você fazer o upload dos dados do catálogo e de eventos do usuário que atendam aos requisitos mínimos de cada camada de armazenamento.

A página Qualidade de dados em o console do Search for Retail mostra uma avaliação requisitos atendidos para cada nível. Para mais informações sobre como usar para visualizar a qualidade dos dados e os níveis de desempenho da pesquisa, consulte Desbloquear pesquisa níveis de desempenho.

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

Antes de atualizar o código do seu site para solicitar pesquisa de texto ou navegação resultados, visualize os resultados para confirmar se a configuração de veiculação funcionando conforme o esperado.

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

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

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

Pesquisa de texto

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

    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 do catálogo que contém o catálogo que você quer visualizar.

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

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

  7. Opcional: insira um horário de pesquisa para visualizar os resultados da pesquisa 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 atributos que aparecer em Adicionar atributos depois que você realizar a pesquisa inicial. Esses filtros podem incluir outras facetas além das selecionadas nesta etapa, como facetas dinâmicas.

  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 exibir 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 alterar a forma como os resultados da pesquisa são exibidos na visualização.

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

    Quando você seleciona diversos valores do mesmo atributo, eles são aplicados como um operador OR seria, e os valores em diferentes atributos são aplicados como seria um operador AND. Por exemplo, depois de selecionar as facetas "cor" e os valores "blue" e "ouro", e os valores de 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 visualizar os resultados desse usuário.

  4. Opcional: insira um ID do usuário para visualizar os resultados desse usuário.

  5. Para visualizar como ficariam os resultados 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ê promoveu determinados produtos para a Black Friday, possam ver os resultados na forma como seriam naquele dia.

  7. Insira a categoria de página para a qual você está testando os resultados de navegação.

  8. Opcional: selecione os atributos a serem exibidos com os resultados e clique OK para aplicá-las.

    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 os filtros de atributos podem incluir outros atributos além daqueles selecionados nesta etapa, como os atributos dinâmicos.

  9. Clique em Browse preview ou pressione Enter em qualquer campo de entrada para exibir resultados.

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

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

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

    Quando você seleciona diversos valores do mesmo atributo, eles são aplicados como um operador OR seria, e os valores em diferentes atributos são aplicados como seria um operador AND. Por exemplo, depois de selecionar as facetas "cor" e "material", poderá filtrar os resultados de pesquisa selecionando o valores de cor "azul" e "ouro", e os valores de material "algodão" e "poliéster". Seus resultados devem ter "azul" ou "ouro" como atributo, e também deve ter "algodão" ou "poliéster" como .

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.