O Vertex AI Search for retail vai ser renomeado para Vertex AI Search for commerce. Estamos a atualizar o conteúdo para refletir o novo branding.

Esta página foi traduzida pela API Cloud Translation.

Obter resultados da pesquisa

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

Nunca colocar em cache resultados personalizados de um utilizador final e nunca devolver resultados personalizados a um utilizador final diferente.

Relevância no Vertex AI Search for retail

A relevância é diferente da correspondência. A correspondência consiste em encontrar produtos candidatos no índice que correspondam à consulta de pesquisa do utilizador. A relevância, por outro lado, é um grau de correspondência. Envolve classificar esses produtos de uma forma que satisfaça melhor a intenção e as necessidades do utilizador. A Vertex AI Search for retail usa técnicas para melhorar a correspondência e a relevância para uma melhor experiência de pesquisa geral para os utilizadores que satisfaz as necessidades dos retalhistas.

Pesquisa não predefinida

O Vertex AI Search for commerce usa a relevância na pesquisa por predefinição. No entanto, a pesquisa também é ajustada para apresentar itens marginalmente relevantes mais acima nos resultados da pesquisa, de modo a oferecer aos retalhistas resultados da pesquisa mais segmentados para aumentar o potencial de conversão dos eventos do utilizador.

Estas funcionalidades de pesquisa adicionadas otimizam o algoritmo de relevância predefinido, oferecendo funcionalidades não predefinidas ajustadas ao perfil de utilização de cada retalhista, incluindo:

Opções para ordenar os resultados, como por preço, itens com melhor classificação ou mais vendidos. A pesquisa não predefinida é personalizada para devolver resultados de pesquisa específicos com as variantes corretas do produto. Por exemplo, para mostrar a variante mais barata ou mais cara quando ordena por preço.
Aplicação automática de um filtro de relevância mais rigoroso para eventos de utilizador não predefinidos.
Ativar controlos de reforço/ocultação ajustáveis para otimizar os resultados da pesquisa.

Pesquisa de texto e pesquisa de navegação

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

No exemplo de utilização da pesquisa de consultas de texto, um comprador pode introduzir uma consulta baseada em texto no seu site. A pesquisa devolve uma resposta de pesquisa que contém produtos que se enquadram nos parâmetros dos controlos que configurou, ordenados por relevância e maximização da receita.

No exemplo de utilização de navegação, um comprador pode aceder ao menu do seu site e navegar para uma categoria de produtos específica. A pesquisa escolhe automaticamente a ordem de ordenação que maximiza a receita com base na aprendizagem do comportamento dos utilizadores e nas tendências. Os resultados da navegação podem ser refinados ainda mais pelos controlos que configurou.

Os pedidos de pesquisa de texto e de pesquisa por navegação usam o método servingConfigs.search.

Pesquisas de consultas de texto

Quando um utilizador introduz uma consulta de texto para pesquisar no seu site, a pesquisa ordena os potenciais resultados da pesquisa com base na relevância, popularidade, capacidade de compra e personalização.

A Pesquisa considera um pedido servingConfigs.search como um pedido de pesquisa baseado em texto se tiver um campo query não vazio.

Quando carregar eventos de utilizador, envie eventos de pesquisa de consultas de texto gerados pela pesquisa como searcheventos de utilizador. Se o evento tiver um campo userEvent.searchQuery não vazio e um campo userEvent.pageCategories vazio, a pesquisa considera-o um evento de pesquisa baseado em texto.

Procure pesquisas

A navegação usa a navegação do site para produzir resultados da pesquisa de igual relevância ordenados pelos artigos mais vendidos. A Pesquisa tira partido da IA para otimizar a forma como os resultados de navegação são ordenados, tendo em conta a popularidade, a possibilidade de compra e a personalização.

Para receber os resultados da pesquisa de navegação corretos, tenha em atenção o seguinte:

Os valores pageCategories e filter nos seus pedidos de pesquisa têm de corresponder exatamente aos valores pageCategories e filter nos seus eventos de utilizador carregados. Se os parâmetros nos pedidos não corresponderem aos parâmetros nos eventos, o modelo de reclassificação baseado em cliques aprendido com os eventos não terá um bom desempenho para esta consulta específica e terá um impacto negativo na qualidade dos resultados.
O Vertex AI Search for commerce categoriza um evento de utilizador search como um evento baseado na navegação se tiver um campo userEvent.searchQuery vazio e um campo userEvent.pageCategories não vazio. É por isso que tem de se certificar de que envia os eventos de navegação gerados pela Vertex AI Search for commerce como search eventos do utilizador quando os carregar.
Um filtro de navegação tem de ser válido e indicar, para cada consulta de navegação, os produtos que pertencem à categoria de produtos na qual o utilizador está a navegar. Para conseguir esta configuração, o ID da categoria tem de ser definido nos campos filter e page_category. Por exemplo, se quiser que os resultados da pesquisa sejam segmentados para a categoria Casa e jardim. Em primeiro lugar, ter apenas um valor filter de "in-stock" não refina a pesquisa o suficiente para fornecer resultados de navegação ideais. Para fornecer resultados da pesquisa restritos a Casa e jardim, não só tem de definir "Home \& Garden" na categoria da página, como também no filtro com categories: ANY("Home & Garden"). Se não definir a categoria na parte do filtro, os resultados da navegação podem ser demasiado abrangentes e incluir muitos artigos que não são da categoria Casa e jardim.

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

Pode 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, uma vez que a navegação funciona com consultas de strings vazias, os produtos numa determinada categoria não são apresentados automaticamente nos resultados de uma determinada categoria de página. Por outras palavras, se o utilizador final navegar sem especificar nada através de uma consulta de texto, a pesquisa pode não gerar resultados eficazmente segmentados, mesmo que o utilizador navegue para uma página de categoria.

Use pedidos de pesquisa

Use pedidos de pesquisa para obter resultados de pesquisas de texto e de navegação. Para fazer um pedido de pesquisa, use o método servingConfigs.search.

Todos os pedidos de pesquisa requerem placement, que identifica o nome completo do recurso da configuração de publicação que vai ser usada. A configuração de publicação determina que definições e controlos associados afetam os resultados da pesquisa.

Os pedidos de pesquisa de consultas de texto requerem um campo query não vazio.

Os pedidos de pesquisa de navegação requerem 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 predefinição, é devolvido um número razoável de resultados ordenados por relevância.

Para receber atributos de produtos com a resposta da pesquisa, certifique-se de que fornece valores de atributos quando importa os dados do catálogo. Product tem atributos do sistema predefinidos, como marca, cor e tamanho, para os quais pode fornecer valores. Também pode incluir atributos personalizados que define com Product.attributes.

Tutorial de consultas

Este tutorial mostra como enviar uma consulta de pesquisa baseada em texto para o serviço Vertex AI Search for commerce e analisar a resposta.

Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:

Visita guiada

Paginação

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

Tutorial de paginação

Este tutorial mostra como controlar a paginação num pedido de pesquisa baseado em texto. Quando um comprador procura produtos numa loja, pode melhorar a navegação através dos resultados da pesquisa. Por exemplo, podem limitar o número de itens na resposta de pesquisa através da funcionalidade de tamanho da página ou aceder à página preferida através da funcionalidade de deslocamento.

Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:

Visita guiada

Paginação

Para saltar de uma página para outra, use page_token ou offset, consoante o seu exemplo de utilização.

Para avançar para a página seguinte, pode usar page_token. Por exemplo, suponha que envia o seguinte SearchRequest.

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, pode obter os produtos resultantes com os 5 principais níveis de relevância, juntamente com um next_page_token.

JSON

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

Para obter os produtos de resultados com os 5 níveis de relevância seguintes (do 6.º ao 10.º), deve definir page_token com os mesmos placement, visitor_id e query que next_page_token do SearchResponse anterior.

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 o seguinte aspeto:

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"
}

Noutros casos, em vez de navegar de página em página ou obter resultados com a maior relevância, pode saltar 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 décima página dos resultados quando o tamanho da página for 5, pode definir 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 de pesquisa que melhoram cada vez mais os seus resultados. Por exemplo, para exemplos de utilização de pesquisa de consultas de texto, os resultados podem basear-se apenas na relevância. À medida que desbloqueia níveis de desempenho mais avançados, a pesquisa pode devolver resultados baseados na relevância, na popularidade, na otimização da receita e na personalização.

A Pesquisa desbloqueia automaticamente níveis de desempenho mais elevados quando carrega dados de eventos de utilizadores e do catálogo que cumprem os requisitos mínimos de cada nível.

Para mais informações sobre como usar esta página para ver a qualidade dos dados e os níveis de desempenho da pesquisa, consulte o artigo Desbloqueie os níveis de desempenho da pesquisa. A página Qualidade de dados na consola de pesquisa para comércio fornece uma avaliação dos requisitos que cumpriu para cada nível.

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

Antes de atualizar o código do seu Website para pedir resultados de pesquisa de texto ou de navegação, pode pré-visualizar os resultados para confirmar que a configuração de publicação está a funcionar como esperado.

Para mais informações sobre as configurações de publicação, consulte o artigo Acerca das configurações de publicação.

Pode pré-visualizar os resultados da configuração de publicação na página Avaliar ou acedendo à página Detalhes de uma configuração de publicação na consola e clicando no separador Avaliar. Os passos seguintes mostram como fazer uma pré-visualização a partir da página Avaliar.

Para pré-visualizar os resultados devolvidos pela configuração de publicação:

Pesquisa de texto

Aceda à página Avaliar na consola de pesquisa para comércio.

Aceda à página Avaliar
Clique no separador Pesquisa.

Nota: o separador Pesquisa só está disponível se tiver a pesquisa ativada. Para ver instruções sobre como ativá-lo, aceda a Antes de começar.
Selecione a configuração de publicação que quer pré-visualizar.
Selecione a ramificação do catálogo que contém o catálogo que quer pré-visualizar.
Opcional: introduza um ID do visitante para pré-visualizar os resultados da pesquisa desse utilizador.
Opcional: introduza um ID do utilizador para pré-visualizar os resultados da pesquisa para esse utilizador.
Opcional: introduza uma hora de pesquisa para pré-visualizar os resultados da pesquisa que seriam apresentados à hora especificada.

Por exemplo, se tiver promovido determinados produtos para uma venda especial, pode ver os resultados tal como apareceriam nesse dia.
Opcional: selecione atributos para apresentar juntamente com os resultados da pesquisa e clique em OK para os aplicar.

As facetas que selecionar são usadas para gerar uma lista de filtros de facetas que aparecem em Adicionar facetas depois de realizar a pesquisa inicial. Estes filtros de facetas podem incluir facetas diferentes das que seleciona neste passo, como facetas dinâmicas.
Introduza uma consulta de pesquisa baseada em texto para pré-visualizar os resultados da pesquisa para essa consulta.
Clique em Pré-visualização da pesquisa ou prima Enter em qualquer campo de entrada para ver os resultados.

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

Se a sua pesquisa acionar um controlo de redirecionamento, é apresentada uma nota que apresenta o URI de redirecionamento.
Opcional: clique no ícone Grelha ou no ícone Lista para alterar a forma como os resultados da pesquisa são apresentados na pré-visualização.
Opcional: se selecionou atributos para aparecerem junto aos resultados, selecione um ou mais valores de atributos na lista de atributos para filtrar os resultados por esses valores. Os resultados são atualizados automaticamente após a seleção.

Quando seleciona vários valores da mesma faceta, estes são aplicados como se fosse um operador OU, e os valores de diferentes facetas são aplicados como se fosse um operador E. 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 têm de ter "azul" ou "dourado" como atributo e também têm de ter "algodão" ou "poliéster" como atributo.

Procurar

Aceda à página Avaliar na consola de pesquisa para comércio.

Aceda à página Avaliar
Clique no separador Procurar.

Selecione a configuração de publicação que quer pré-visualizar.
Selecione a ramificação do catálogo que contém o catálogo que quer pré-visualizar.
Opcional: introduza um ID do visitante para pré-visualizar os resultados desse utilizador.
Opcional: introduza um ID do utilizador para pré-visualizar os resultados desse utilizador.
Para pré-visualizar o aspeto dos resultados com um filtro específico adicionado, introduza uma string de filtro. Use a sintaxe de expressão de filtro especificada na documentação do Filtro.
Opcional: introduza uma hora de navegação para pré-visualizar os resultados que seriam apresentados à hora especificada.

Por exemplo, se tiver promovido determinados produtos para um evento de vendas de pico, pode ver os resultados tal como apareceriam nesse dia.
Introduza a categoria da página para a qual está a testar os resultados de navegação.
Opcional: selecione atributos para apresentar juntamente com os resultados e clique em OK para os aplicar.

As facetas que selecionar são usadas para gerar uma lista de filtros de facetas que aparecem em Adicionar facetas depois de realizar a pesquisa inicial. Estes filtros de facetas podem incluir facetas diferentes das que seleciona neste passo, como facetas dinâmicas.
Clique em Procurar pré-visualização ou prima Enter em qualquer campo de entrada para ver os resultados.

Os resultados são apresentados com as respetivas imagens de miniaturas disponíveis.
Opcional: clique no ícone Grelha ou no ícone Lista para alterar a forma como os resultados são apresentados na pré-visualização.
Opcional: se selecionou atributos para aparecerem junto aos resultados, selecione um ou mais valores de atributos na lista de atributos para filtrar os resultados por esses valores. Os resultados são atualizados automaticamente após a seleção.

Quando seleciona vários valores da mesma faceta, estes são aplicados como se fosse um operador OU, e os valores de diferentes facetas são aplicados como se fosse um operador E. Por exemplo, depois de selecionar as facetas cor e material, pode filtrar os resultados da pesquisa selecionando os valores de cor "azul" e "dourado" e os valores de material "algodão" e "poliéster". Os resultados têm de ter "azul" ou "dourado" como atributo e também têm de ter "algodão" ou "poliéster" como atributo.

Para ver a página Detalhes da configuração de publicação em pré-visualização, clique em Ver configuração de publicação no campo Selecionar configuração de publicação.

Obter resultados da pesquisa Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Relevância no Vertex AI Search for retail

Pesquisa não predefinida

Pesquisa de texto e pesquisa de navegação

Pesquisas de consultas de texto

Procure pesquisas

JSON

Use pedidos de pesquisa

Java

Tutorial de consultas

Paginação

Tutorial de paginação

Paginação

JSON

JSON

Java

JSON

Java

JSON

Níveis de desempenho de pesquisa

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

Pesquisa de texto

Procurar

Obter resultados da pesquisa