A Vertex AI para Pesquisa no varejo vai substituir a plataforma Retail. Estamos atualizando o conteúdo para refletir o novo branding.

Esta página foi traduzida pela API Cloud Translation.

Navegação por blocos

Esta página apresenta o recurso de navegação por blocos da Vertex AI para Pesquisa para varejo.

Por que os blocos?

Como uma representação visual de pares de valores de atributos, os blocos são uma maneira diferente de apresentar as mesmas informações que as facetas dinâmicas, mostrando apenas os atributos mais usados para uma consulta específica, independentemente das famílias de facetas dinâmicas, que nem sempre são intuitivas para o comprador. O objetivo é aumentar o uso dos filtros, o que aumenta a receita por usuário. A navegação de blocos torna o uso do filtro em consultas HEAD fortes mais relevante, facilitando a previsão de receita mais precisa (por regressão).

A navegação por blocos funciona como parte do pacote de pesquisa guiada, beneficiando o cliente ao restringir as consultas do usuário mais rapidamente e com maior relevância para o usuário final. O recurso de navegação em blocos foi criado para resolver o problema de espaço das facetas dinâmicas, permitindo que o usuário encontre o que é mais relevante para ele com mais rapidez. A navegação por blocos também evita que o comprador precise procurar em todas as famílias de facetas em um painel de navegação à esquerda ou à direita para encontrar exatamente o produto que está procurando antes de confirmar a seleção de pesquisa restrita em um segundo clique em um botão de envio.

A navegação por blocos complementa os atributos dinâmicos

Os atributos dinâmicos são fornecidos no console da Pesquisa de varejo ao fazer upload do catálogo de produtos. Eles são filtros que restringem as consultas mudando a ordem dos filtros mostrados para que os filtros corretos fiquem no topo e tornem a pesquisa mais relevante a cada etapa.

As facetas dinâmicas classificam famílias de filtros, como Estilo, Manga para uma consulta de vestido para varejistas de moda ou Volume, Variedade ou Embalagem para leite para varejistas de alimentos. Muitas vezes, essas famílias de facetas dinâmicas são organizadas de uma maneira que não é sempre intuitiva para o usuário. Além disso, um painel suspenso para seleção de facetas dinâmicas ocupa muito espaço no site do produto e nem sempre é compatível com dispositivos móveis.

Então surgiu a necessidade de reduzir o espaço em sites de produtos e aumentar a receita do usuário por conversão de pesquisa.

Como os blocos funcionam?

A navegação por blocos leva o usuário a uma pesquisa mais específica mais rapidamente para aumentar o engajamento e a receita por pesquisa. Os blocos podem ser exibidos horizontalmente no site do produto, independentemente das famílias de facetas. O recurso de blocos controla os filtros de pesquisa de modo a colocar os filtros mais engajados individualmente na parte de cima da página, separando os resultados da pesquisa das famílias de atributos dinâmicos para oferecer uma visualização imediata. Dessa forma, a navegação por blocos oferece aos usuários um arranjo mais acessível do conteúdo das facetas dinâmicas.

Jornada do comprador

Quando um comprador faz uma pesquisa no site de um varejista com a navegação por blocos ativada, ele encontra até 20 blocos que mostram valores de filtro individuais com maior probabilidade de interação. Esses blocos são classificados pela probabilidade de uso, independentemente da família de atributos do produto. Cada bloco pode incluir uma imagem que representa um produto típico com o filtro aplicado. Se um cliente clicar em um bloco, ele vai funcionar como se o valor de faceta correspondente tivesse sido aplicado. Isso atualiza a lista de produtos para corresponder à consulta e ao filtro, e a faceta aplicada é mostrada. Além disso, os blocos exibidos são atualizados para refletir a nova taxa de engajamento esperada, excluindo os filtros que já foram aplicados.

Jornada do varejista

O varejista envia uma consulta para a Vertex AI para Pesquisa de varejo e recebe uma resposta de consulta padrão que inclui uma lista classificada de valores de blocos classificados em famílias de atributos de produtos e uma maneira de gerar uma imagem de bloco. Em seguida, o varejista renderiza os blocos com ou sem imagens. Se um cliente em potencial clicar em um bloco ou valor de faceta, o varejista vai enviar uma nova consulta ao Google com o filtro correspondente ao bloco ou faceta adicionado ao campo de filtro. O site do varejista também envia ao Google um evento para a segunda consulta com o filtro adicionado. A pesquisa da Vertex AI para resposta de varejo, a consulta enviada ao Google e os eventos enviados ao Google são os mesmos para "usuário clicou no filtro" e "usuário clicou no bloco".

Filtros mostrados nos blocos

Os filtros podem ser qualificados para blocos com base nas preferências que os varejistas podem definir no console da Pesquisa para varejo ou na API Vertex AI para Pesquisa para varejo para conteúdo, contagem de produtos e consultas quantitativas relacionadas.

Com base no conteúdo

Os filtros não podem ter sido aplicados em uma pesquisa anterior.
Somente os blocos que correspondem aos valores de atributos nos atributos do catálogo marcados como dinamicamente acessíveis.
O retorno da pesquisa (a resposta da Vertex AI para Pesquisa para varejo) precisa ter pelo menos um produto.
Nenhum bloco correspondente a filtros do sistema, como "instock = yes" ou "available for sale = yes", é mostrado.
Os blocos são classificados pela probabilidade de engajamento.

Com base na contagem de produtos

E se houver menos de 20 blocos classificáveis?
- Se houver entre 2 e 20, retorne o maior número possível de blocos.
- Se houver menos de 2 blocos disponíveis, não retorne nenhum.
Se houver mais de 20 blocos que podem ser classificados, retorne os 20 principais com base na probabilidade de engajamento.

Com base em consultas quantitativas

Os blocos oferecem suporte a "categórico" (cor = vermelho) e numérico (peso = "1kg - 2kg").
Intervalo de blocos numéricos:
- O agrupamento configurado usando controles para atributos específicos é respeitado. Por exemplo, se uma faceta for agrupada manualmente em pesos de 0 a 1, 1 a 3 e 3 a 6 libras, esses grupos serão usados nos blocos. Confira mais detalhes em Controles de Bloco e Faceta Dinâmica.
- Se uma faceta for agrupada automaticamente, os mesmos buckets serão usados nos blocos.

Quais são as novidades para a navegação de blocos na API Retail?

Não há uma nova API para o recurso de blocos. No entanto, novos campos foram adicionados à API principal (de consulta) do Vertex AI.

Solicitar tileNavigationSpec

Consulta

{
  "tile_navigation_requested": boolean,
  "applied_tiles": repeated
}

Campos (solicitações)
`tile_navigation_requested`	Esse campo booleano especifica se o cliente quer solicitar a navegação por blocos.
`applied_tiles`	Esse campo repetido especifica os blocos que já foram clicados.

Primeiro, defina o campo tileNavigationSpec. Chame o objeto productAttributeValue, que contém o nome e o valor do atributo, como name=color e value=red. Deixe todos os outros campos iguais.

Bloco de respostaNavigationResult

A API retorna até 20 blocos no campo tileNavigationResult, classificados pela probabilidade de uso. A resposta mostra os blocos de acordo com os valores dos atributos e uma imagem representativa correspondente:

Resposta

...
  "tileNavigationResult": {
    "tiles": [
      {
        "productAttributeValue": {
          "name": "sizes",
          "value": "large"
        },
        "representativeProductId": "xxxx"
      },
      {
        "productAttributeValue": {
          "name": "attributes.weight",
          "value": "light"
        },
        "representativeProductId": "xxxx"
      },
      {
        "productAttributeValue": {
          "name": "colors",
          "value": "black"
        },
        "representativeProductId": "xxxx"
      }
    ]
  }
  ...

Campos (resposta)
`tiles`	Esse campo repetido controla os blocos que são mostrados ao usuário no lado do cliente. O campo contém uma lista de blocos, em que cada bloco é um objeto que contém o `productAttributeValue` e o `representativeProductId`.

Não é necessário fazer mudanças na API atual, e as novas bibliotecas de cliente estão disponíveis no momento da disponibilidade geral e são publicadas na documentação da biblioteca pública.

O que os varejistas devem fazer com os resultados da pesquisa de blocos

Mostrar blocos:mostra os blocos retornados na ordem fornecida, sendo que o primeiro bloco na resposta é o primeiro bloco mostrado. ProductAttributeValue é um par de chave-valor que contém o valor do atributo, para que você saiba quais blocos mostrar. Nas solicitações de pesquisa subsequentes, o ProductAttributeValue precisa ser definido no campo appliedTiles e também no campo filter (por exemplo, filter = "attributes.weight:ANY(\"large\")"). A resposta vai ter produtos filtrados e um novo conjunto de blocos para mostrar.
Exibição de imagens:essas imagens podem ser acessadas referenciando o campo representativeProductId na resposta, que fornece o ID de um produto típico correspondente ao filtro aplicado. Em seguida, os varejistas procuram esse ID de produto representativo e selecionam uma imagem adequada para exibir no bloco. É importante usar o ID de produto representativo, e não o ID de produto principal, para garantir que a imagem reflita com precisão o atributo filtrado (por exemplo, mostrando uma variante vermelha para o filtro color = "red").

Configurar o comportamento do bloco no console

A seleção dos blocos que aparecem na tela de pesquisa é diretamente influenciada pelos atributos do catálogo, que são extraídos das informações que o varejista envia para o catálogo de produtos. Os blocos de candidatos são todos os valores nos atributos de todos os "atributos dinamicamente rotáveis" no catálogo de produtos.

Ativar atributos e blocos dinâmicos

As facetas são controladas por atributos de produtos, que são originados do catálogo e dos eventos do usuário. Os atributos e blocos dinâmicos são configurados para permitir que as consultas do usuário final correspondam aos atributos do produto.

Para controlar quais atributos são qualificados para os blocos e filtros dinâmicos:

Defina os controles de blocos na guia Controles de atributo na página "Controles" do console de Pesquisa para varejo. Acessar a página "Controles"
Para modificar os controles de atributo, clique em Modificar controles ao lado de Atributos e defina os controles de cada atributo como Verdadeiro ou Falso.

Texto alternativo

As colunas 3 e 4 (Indexable e Dynamic faceting) são essenciais para controlar os blocos. Para cada linha de atributo, as duas colunas precisam ser marcadas como Verdadeiro para que os Blocos funcionem. Indexável permite que a Vertex AI para Pesquisa para Retail filtre usando o atributo. Com os filtros dinâmicos ativados, a Pesquisa de varejo pode usar automaticamente um atributo como um filtro dinâmico com base no comportamento anterior do usuário, como cliques e visualizações.

Para saber como fazer isso na API, consulte a seção Controle de blocos na API.

Controles de blocos individuais

Com os controles de atributo, você pode gerenciar o comportamento das suas facetas sem alterar o catálogo e afetar o comportamento de pesquisa em todo o site.

O controle Remover atributos remove um atributo inteiro dos resultados de atributos dinâmicos para determinadas consultas. Ele também impede que os blocos de membros dessa faceta sejam retornados como blocos.

Os seguintes controles de valor de facetas sinalizados com Agrupamento e divisão dinâmicos no nível do catálogo também afetam os blocos:

Ignorar valores de atributo: impede que o bloco apareça e remove o atributo dinâmico nos resultados da pesquisa.
Substituir valores de atributo: permite que o varejista mude o valor do atributo (por exemplo, para o atributo color, mude navy blue para blue) em consultas específicas em blocos e atributos dinâmicos.
Definir intervalos numéricos: permite que o varejista especifique os tamanhos de bucket para gerar uma resposta de pesquisa em um determinado intervalo dinâmico, tanto em facetas quanto em blocos dinâmicos.

Os três últimos tipos de controle de atributo dinâmico no menu suspenso de tipos de controle de atributo não afetam os blocos:

Forçar o retorno de atributos
Reclassificar atributos dinâmicos
Mesclar atributos

Para mais informações sobre como controlar o valor e o comportamento de um atributo específico em cada controle, consulte Controles de atributos.

Controle de blocos na API

Esta seção descreve como controlar o comportamento do Bloco na API Vertex AI Search for Retail.

Controles de atributos

Para pesquisa e recomendações, você vai encontrar a API no nível do catálogo no recurso REST: projects.locations.catalogs.attributesConfig. Essa API oferece métodos para adicionar, remover e substituir atributos no nível do catálogo e do produto. O campo catalogAttributes pode ser mapeado para indexação, pesquisa e dynamicFacetable. dynamicFacetable se aplica ao comportamento do bloco se as facetas estiverem qualificadas para divisão em blocos.

AttributesConfig

Configuração de atributo no nível do catálogo.

Campo relevante para o bloco
`catalogAttributes`	`map` Ativa a configuração de atributos no nível do catálogo, que contém informações sobre se ele pode ser pesquisado, dinamicamente acessível e muito mais, mapeando o nome de um atributo para um valor, que é um objeto acionável, `CatalogAttribute`.

CatalogAttribute

O recurso attributesConfig fornece CatalogAttribute, um objeto no nível do catálogo. Dois dos campos desse objeto geram controles sobre quais atributos aparecem como blocos. Isso significa que todos os atributos em todos os "atributos com blocos" do catálogo de produtos podem ser candidatos para blocos:

Campos relevantes para o bloco
`DynamicFacetableOption`	Campo de controle global `enum` que precisa ser especificado como ativado ou desativado. Isso ativa ou desativa as facetas dinâmicas, que, por sua vez, afetam os blocos. Ela é definida em "Controles de atributo" no console do Google Cloud.
`facetConfig`	objeto que contém opções para valores de facetas individuais. Esse campo é um controle de faceta.

FacetConfig

Um objeto que contém opções de faceta para tornar os valores de faceta individuais dinâmicos e, portanto, potencialmente compartilháveis. É um campo da configuração CatalogAttribute no nível do catálogo.

O objeto contém campos já existentes cujo impacto agora se estende aos blocos:

Exemplo de JSON

  "facetIntervals": [
    {
      object (Interval)
    }
  ],
  "ignoredFacetValues": [
    {
      object (IgnoredFacetValues)
    }
  ]

Campos relevantes para o bloco
`ignoredFacetValues`	Esse campo de mensagem no `FacetConfig` contém valores de facetas a serem ignorados para o nome do atributo atual em um determinado período e apenas na faceta, sem afetar as descrições do produto no catálogo.
`facetIntervals`	Isso permite que o varejista especifique os tamanhos de bucket para uma entrada numérica. Isso também funciona da mesma forma para os blocos: se um varejista define intervalos numéricos específicos para uma faceta dinâmica, ele precisa usar os mesmos intervalos numéricos para os blocos.
`removeFacetValue`	Remove os valores de atributos de chaves específicas. Eles são mapeados para valores de atributo.

Saiba como criar esses controles individuais no console.