Pesquisar e navegar

Este documento tem como objetivo esclarecer as distinções entre as funcionalidades de pesquisa e navegação na Vertex AI Search for commerce para mostrar como configurar cada uma delas de maneira eficaz e aproveitar ao máximo.

Entenda as principais diferenças

Embora a pesquisa e a navegação ajudem os clientes a encontrar produtos, elas atendem a diferentes jornadas do usuário e exigem configurações distintas.

Impulsionada pela intenção do usuário, em que um comprador insere uma consulta específica, como tênis de corrida vermelhos. A Vertex AI para Pesquisa para e-commerce analisa essa consulta para entender as necessidades do usuário e retorna produtos relevantes otimizados para receita.

Em resumo, para a pesquisa, a Vertex AI para Pesquisa no comércio é responsável pela relevância dos produtos e pela classificação deles (otimizada para receita).

Procurar

Guiada por categorias predefinidas, em que um comprador navega pelas informações de produtos organizadas por atributos como marca, categoria ou promoções, como Camisas na categoria Roupas masculinas. Você define essas categorias e mostra os produtos nelas.

Você é responsável pela relevância dos produtos listados (por filtros), e a Vertex AI para Pesquisa no comércio é responsável pelo ranking (otimizado para receita).

Configurar a pesquisa e a navegação

A beleza da Vertex AI para Pesquisa para Commerce está na API unificada para solicitações de pesquisa e navegação.

Configurar a pesquisa

Os eventos de usuário para pesquisa precisam ter estes campos, além de outros campos obrigatórios padrão para eventos de usuário (eventType = "search"):

  • Consulta de texto: o núcleo de uma solicitação de pesquisa. Ela captura a intenção de pesquisa do usuário.
  • Filtros (opcional): permitem que os usuários refinem os resultados da pesquisa aplicando atributos como marca, faixa de preço ou cor.

  • Classificação e personalização: a Vertex AI para Pesquisa no comércio otimiza automaticamente a classificação dos resultados da pesquisa com base na relevância e na receita potencial. A personalização adapta ainda mais os resultados com base no comportamento individual do usuário.

    # Construct the search request
search_request = {
  "query": "red running shoes", # User's search query
  "filter": "brand:ANY('Nike')", # Optional filter
  "page_size": 10 # Number of results per page
}

# Send the request to the VAIS:Commerce API
search_response = client.search(search_request)

# Process the search results
for product in search_response.results:
  print(product.title, product.price)

Para consultas básicas com pesquisa, incluindo pesquisas de consultas de texto, pesquisas de navegação, paginação, otimização e resultados personalizados, consulte Receber resultados da pesquisa.

Configurar a navegação

Os eventos de usuário para navegação precisam ter estes campos, além de outros campos obrigatórios padrão para eventos de usuário (eventType = "search" para eventos de navegação também):

  • Categoria da página: representa a categoria ou o banner em que os produtos aparecem.
  • Filtro obrigatório: define os critérios para que os produtos sejam incluídos nos resultados da navegação. Isso garante que apenas produtos relevantes apareçam na categoria.

  • Filtro adicional usando a seleção de facetas (opcional): permite que os usuários filtrem ainda mais os produtos na categoria.

    # Construct the browse request
browse_request = {
  "page_category": "Men's > Clothing > Shirts", # Browse category
  "filter": "category:ANY('Shirts') AND gender: ANY('Male')", # Compulsory filter
  "page_size": 10 # Number of results per page
}

# Send the request to the VAIS:Commerce API
browse_response = client.search(browse_request)

# Process the browse results
for product in browse_response.results:
  print(product.title, product.price)

Consulte Receber recomendações para saber como solicitar recomendações de produtos para um usuário e um evento de usuário específicos.