O Retail está sendo renomeado para Vertex AI para Pesquisa para Retail. Estamos atualizando o conteúdo para refletir o novo branding.

Esta página foi traduzida pela API Cloud Translation.

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 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. Pesquisar automaticamente escolhe a ordem de classificação que mais maximiza a receita ao aprender com base no comportamento do usuário e tendências. Os resultados da navegação podem ser ainda mais refinados pelos controles definidos para cima.

Tanto as solicitações de pesquisa de texto quanto as de pesquisa 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 em seu site, pesquisar classifica os possíveis resultados da pesquisa 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, enviar eventos de pesquisa de consulta de texto gerados por pesquisar como eventos de usuário do search. Se o evento tiver um valor um campo userEvent.searchQuery e um campo userEvent.pageCategories vazio, o considera um evento de pesquisa baseado em texto.

Navegar pelas pesquisas

Normalmente, procurar produtos usando a navegação no site gera resultados com a mesma relevância ou classificados pelos 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. Quando esse é o caso, os resultados são baseados no filter e pageCategories, bem como otimização e personalização adicionais se disponíveis.

Ao fazer upload de um evento de usuário, envie eventos de pesquisa de navegação gerado pela pesquisa como eventos de usuário search. A pesquisa considera um evento de usuário search como um evento baseado em navegação se tiver um campo userEvent.searchQuery vazio e um não vazio userEvent.pageCategories.

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.

Pesquisar

Use as solicitações de pesquisa para obter resultados para 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 a resposta da pesquisa usando o recurso de tamanho de página ou ir para a resposta de 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, a melhorar seus resultados. Por exemplo, para casos de uso de pesquisa de consulta de texto, os resultados podem se basear unicamente na relevância. Conforme você tem acesso a mais recursos avançados níveis, a pesquisa pode retornar resultados com base na relevância, popularidade, otimização da 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 conferir 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 visualizar os resultados da configuração de veiculaçã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 partir do Avaliar.

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

Pesquisa de texto

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

Acessar a página "Avaliar"
Clique na guia Pesquisar.

Observação: a guia Pesquisar só estará disponível se você tiver pesquisa ativada. Para acessar instruções sobre como ativar o recurso, acesse Antes de começar.
Selecione a configuração de veiculação que você quer visualizar.
Selecione a ramificação do catálogo que contém o catálogo que você quer visualizar.
Opcional: insira um ID de visitante para visualizar os resultados da pesquisa desse usuário.
Opcional: insira um ID do usuário para visualizar os resultados da pesquisa.
Opcional: insira um horário de pesquisa para visualizar os resultados da pesquisa 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.
Opcional: selecione os atributos a serem exibidos ao lado dos resultados da pesquisa e clique OK para aplicá-las.

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 os filtros de atributos podem incluir outros atributos além daqueles selecionados nesta etapa, como os atributos dinâmicos.
Insira uma consulta de pesquisa baseada em texto para visualizar os resultados da pesquisa.
Clique em Visualização da pesquisa ou pressione Enter em qualquer campo de entrada para exibir resultados.

Os resultados da pesquisa são exibidos com as respectivas imagens em miniatura disponíveis.

Se a pesquisa acionar um controle de redirecionamento, um aviso vai aparecer o URI de redirecionamento.
Opcional: clique no ícone Grade ou Lista para alterar a forma como os resultados da pesquisa são exibidos na visualização.
Opcional: se você tiver selecionado atributos para aparecer com os resultados, selecione um ou mais valores da lista de atributos para filtrar os resultados por aqueles e a distribuição dos valores dos dados. 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 "ouro" como atributo, e também deve ter "algodão" ou "poliéster" como .

Procurar

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

Acessar a página "Avaliar"
Clique na guia Procurar.

Selecione a configuração de veiculação que você quer visualizar.
Selecione a ramificação do catálogo que contém o catálogo que você quer visualizar.
Opcional: insira um ID de visitante para visualizar os resultados desse usuário.
Opcional: insira um ID do usuário para visualizar os resultados desse usuário.
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 no Filter.
Opcional: insira um tempo de navegação para visualizar os resultados que seriam exibidos 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.
Insira a categoria de página para a qual você está testando os resultados de navegação.
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 atributos que aparecer em Adicionar atributos depois que você realizar a pesquisa inicial. Esses os filtros de atributos podem incluir outros atributos além daqueles selecionados nesta etapa, como os atributos dinâmicos.
Clique em Browse preview ou pressione Enter em qualquer campo de entrada para exibir resultados.

Os resultados são exibidos com as respectivas imagens de miniatura disponíveis.
Opcional: clique no ícone Grade ou Lista para alterar a forma como e os resultados são exibidos na visualização.
Opcional: se você tiver selecionado atributos para aparecer com os resultados, selecione um ou mais valores da lista de atributos para filtrar os resultados por aqueles e a distribuição dos valores dos dados. 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 veiculação que você está visualizando, clique em Veja a configuração de veiculação no campo Selecionar configuração de veiculação.