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.

Navegação por blocos

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

Por que 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 com frequência 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 de filtros, o que, por sua vez, 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 em blocos funciona como parte do pacote de pesquisa guiada, beneficiando o cliente ao restringir as consultas dos usuários 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 do Search for Retail com o upload do catálogo de produtos. São filtros que restringem as consultas, alterando a ordem dos filtros exibidos para que os filtros corretos fiquem na parte superior e torne a pesquisa mais relevante a cada retorno de pesquisa.

Os atributos dinâmicos ordenam as famílias de filtros, como Estilo, Manga para vestidos para lojas de moda, Volume, Variedade ou Contêiner para leite para varejistas de supermercado. 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 a seleção dinâmica de atributos ocupa muito espaço no site do produto e, da mesma forma, 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 rápido 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, independente 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 à Vertex AI para Pesquisa para varejo e recebe uma resposta de consulta padrão que inclui uma lista classificada de valores de blocos classificados nas famílias de atributos do produto e uma maneira de gerar uma imagem de bloco. 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 resposta da Vertex AI para Pesquisa para Retail, a consulta enviada ao Google e os eventos enviados ao Google são os mesmos para "o usuário clicou no filtro" e "o usuário clicou no bloco".

Filtros mostrados em blocos

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

Com base no conteúdo

Os filtros não podem ter sido aplicados em uma pesquisa anterior.
Somente blocos que correspondem a valores de atributos em atributos de catálogo marcados como atributos dinâmicos.
O retorno da pesquisa (a resposta da Vertex AI para Pesquisa para Retail) 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 < 20 blocos classificáveis?
- Se houver entre 2 e 20, retorne o maior número possível de blocos.
- Se houver < Dois blocos disponíveis, nenhum bloco é retornado.
Se > 20 blocos com classificação que retornam os 20 principais com base na probabilidade de engajamento.

Com base em consultas quantitativas

Os Blocos oferecem suporte a "categóricos" (cor = vermelho) e numérico (peso = "1 lb - 2 lb").
Agrupamento de blocos numéricos:
- O agrupamento por classes configurado com controles para atributos específicos é respeitado. Por exemplo, se um atributo for segmentado manualmente em pesos de 0-1, 1-3 lbs e 3-6 lbs, esses buckets serão usados nos blocos. Confira mais detalhes em Controles de Bloco e Faceta Dinâmica.
- Se um atributo for segmentado automaticamente, os mesmos buckets devem ser usados em blocos.

Quais são as novidades da 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 (consulta) da Vertex AI.

Solicitar tileNavigationSpec

Consulta

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

Campos (solicitação)
`tile_navigation_requested`	Este campo booleano especifica se o cliente gostaria de solicitar a navegação em 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 por probabilidade de uso. A resposta exibe os blocos de acordo com seus valores de atributo 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 gera 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 a `productAttributeValue` e a `representativeProductId`.

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

O que os varejistas precisam fazer com os resultados da pesquisa com 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, ProductAttributeValue deve ser definido no campo appliedTiles e também no campo filter (por exemplo, filter = "attributes.weight:ANY(\"large\")"). A resposta terá produtos filtrados e um novo conjunto de blocos para mostrar.
Exibição de imagens:essas imagens podem ser encontradas referenciando o campo representativeProductId na resposta, que fornece o ID de um produto típico que corresponde 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 do produto representativo, em vez do ID do produto principal, para garantir que a imagem reflita com precisão o atributo filtrado (por exemplo, exibindo 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 é definida diretamente pelos atributos do catálogo, que, por sua vez, são extraídos das informações que o varejista envia ao 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 dinâmicos e agrupamento

As facetas são controladas pelos atributos do produto, que se originam do catálogo e dos eventos do usuário. A divisão e os atributos dinâmicos estão configurados para permitir que as consultas do usuário final correspondam aos atributos do produto.

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

Defina seus controles de blocos na guia Controles de atributo da página "Controles" no console do Search for Retail. Acessar a página "Controles"
Para modificar os controles de atributos, clique em Modificar controles ao lado de Atributos e defina os controles de cada atributo como True ou False.

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 individuais de blocos

Os controles de atributos permitem que você gerencie o comportamento de suas facetas sem alterar seu catálogo e impactar o comportamento de pesquisa em seu site.

O controle Remover atributos remove um atributo inteiro dos resultados para atributos dinâmicos de determinadas consultas. Além disso, remove os blocos de membro desse atributo para que não possam ser retornados como blocos.

Os seguintes controles value de atributo são sinalizados com Atributos dinâmicos e os blocos 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 altere o valor do atributo (por exemplo, para o atributo color, altere navy blue para blue) para consultas específicas em blocos e atributos dinâmicos.
Definir intervalos numéricos: permite que o varejista especifique tamanhos de bucket para gerar uma resposta de pesquisa em um determinado intervalo dinâmico, tanto em atributos dinâmicos quanto em blocos.

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 atributos de retorno
Reclassificar atributos dinâmicos
Mesclar atributos

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

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 indexável, pesquisável e dynamicFacetable. dynamicFacetable se aplica ao comportamento do bloco se as facetas estiverem qualificadas para blocos.

AttributesConfig

Configuração do 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 de nível de catálogo. Dois campos desse objeto geram controles para os atributos que aparecem como blocos. Isso significa que todos os atributos em todos os "atributos com blocos" do catálogo de produtos podem ser candidatos a 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. Ele é definido em "Controles de atributos" no console do Google Cloud.
`facetConfig`	objeto que contém opções para valores de facetas individuais. Este campo é um controle de atributo.

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 já contém campos 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 dos produtos no catálogo.
`facetIntervals`	Isso permite que o varejista especifique os tamanhos de bucket para uma entrada numérica. Isso deve funcionar da mesma forma para blocos: se um varejista definir intervalos numéricos específicos para um atributo dinâmico, ele deverá usar os mesmos intervalos numéricos para 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.