Esta é a documentação do Recommendations AI, da Pesquisa de varejo e do novo Console do Retail.

Configurações de disponibilização

Nesta página, descrevemos as configurações de exibição. Uma configuração de exibição é uma entidade de exibição que associa um modelo ou um conjunto de controles usados para gerar a recomendação ou os resultados da pesquisa.

Relação com modelos e controles

Ao criar uma configuração de exibição, você seleciona um modelo (para Recommendations AI) ou controles (para Pesquisa de varejo) para anexar. As configurações de exibição são invocadas pelo site ao mostrar recomendações ou resultados da pesquisa. A API Retail faz referência ao modelo ou aos controles associados à configuração de exibição no momento da exibição para determinar as recomendações ou os resultados da pesquisa que serão gerados.

Modelos

Um Recommendations AI pode ter um único modelo associado a ele. No entanto, qualquer modelo pode ser associado a várias configurações de exibição, permitindo que você implante o mesmo modelo em páginas diferentes por meio de configurações de exibição diferentes.

Controles

As configurações de veiculação de pesquisa de varejo têm diversos relacionamentos com controles. É possível adicionar vários controles a uma configuração de exibição, e um único controle pode ser associado a várias configurações de exibição.

É possível criar controles e, em seguida, adicioná-los ou trocá-los em uma configuração de exibição ativa da Pesquisa de varejo.

Recurso e permissões da API

Uma configuração de exibição é transmitida para a API Retail usando o recurso placements:

  • O Recommendations AI usa o URL projects/PROJECT_ID/locations/global/catalogs/default_catalog/placements/SERVING_CONFIG_ID:predict.
  • A pesquisa de varejo usa o URL projects/PROJECT_ID/locations/global/catalogs/default_catalog/placements/SERVING_CONFIG_ID:search.

As permissões usadas nesses recursos são as permissões placements.search e placements.predict.

Suporte para posições na API Retail

As configurações de exibição estão disponíveis a partir das recomendações da v2 e da Pesquisa de varejo v2alpha, usando a API Retail.

O recurso servingConfig está disponível nas versões da API Retail v2beta e v2alpha. Use esse recurso para criar, visualizar, editar e remover configurações de exibição.

Se você tiver posições ou criar novas posições, a API Retail criará automaticamente uma configuração de veiculação associada a cada posição. Criar uma configuração de exibição não cria uma posição correspondente.

Excluir uma configuração de exibição exclui a veiculação correspondente. A exclusão de uma veiculação exclui a configuração de exibição correspondente.

As configurações de exibição permitem que você edite opções de reclassificação de diversidade e preços e as aplique quase em tempo real. Com as posições, as configurações de diversidade e preços só podem ser alteradas no modelo de recomendação direcionado a elas.

As posições ainda são compatíveis, mas recomendamos usar a configuração de exibição.

Opções do Recommendations AI para configurações de exibição

As opções a seguir permitem alterar o comportamento de uma configuração de exibição do Recommendations AI.

Antes, essas opções estavam disponíveis ao criar modelos; Eles agora estão associados a configurações de exibição.

Reclassificação de preços

A reclassificação de preços organiza, por ordem decrescente de preço, os itens recomendados do catálogo que têm probabilidade similar de serem pedidos. A reclassificação de preços é desativada por padrão.

Ativar a reclassificação de preços ajuda a equilibrar as taxas de conversão e os valores médios dos pedidos. Como a relevância também é usada para ordenar os itens retornados, ativar a reclassificação de preços não é o mesmo que classificar por preço.

Essa opção pode ser editada após a criação de uma configuração de disponibilização.

Diversificação

Se você quiser garantir que os resultados retornados de uma única solicitação de previsão sejam de categorias diferentes do catálogo de produtos, ative a diversificação. Essa opção pode ser editada após a criação de uma configuração de exibição. Ela fica desativada por padrão.

A diversidade reduz a probabilidade de que itens do catálogo similares sejam mostrados no painel de recomendações, com o risco de remover algumas boas recomendações. A diversificação é configurada por nível, com níveis mais altos de diversificação, fazendo com que menos itens sejam exibidos por categoria.

Nível de diversificação Número máximo de itens por categoria
None Ilimitado
Baixa 3
Médio 2
Alto 1
Automático Depende do catálogo

Correspondência de categoria

Se a configuração de exibição incluir um modelo de itens semelhantes para o Recommendations AI, ative a correspondência de categorias. Quando a correspondência de categoria é usada, a API Retail retorna apenas resultados de produtos que compartilham pelo menos uma categoria com o produto de contexto.

Se as categorias tiverem hierarquias profundamente aninhadas, a API Retail as truncará usando a heurística para melhorar a possibilidade de uma correspondência. Por exemplo, se as categorias de produtos de contexto forem a > b > c > d > e >f, a API Retail poderá retornar resultados com categorias a > b > c.

A correspondência de categoria pode ser usada com outras opções de filtragem, como preço, disponibilidade e tags de filtro. Por exemplo, se você usar a tag de filtro fall_Sale e tiver a correspondência de categoria ativada, a API Retail retornará resultados que têm a tag obrigatória e uma correspondência de categoria.

Essa opção pode ser editada após a criação de uma configuração de disponibilização. Por padrão, a correspondência de categoria fica desativada.

Atributos dinâmicos

É possível ativar o atributo dinâmico ao criar ou editar uma configuração de disponibilização.

Quando o atributo dinâmico é ativado para uma configuração de exibição, a Pesquisa de varejo pode usar automaticamente atributos como atributos dinâmicos nos resultados da pesquisa para essa configuração, com base no comportamento anterior do usuário, como cliques e visualizações de atributos. Se um determinado atributo pode ser usado como um atributo é definido por padrão pela configuração do atributo no nível do produto na API Retail. As configurações de atributos dinâmicos na API podem ser substituídas por controles de atributos em todo o site no Console do Cloud. Consulte Controles em todo o site.

Os atributos dinâmicos podem ser criados com base em dados precisos do catálogo de produtos. No entanto, para que o recurso funcione de maneira ideal para seu site, os modelos de atributos precisam aprender com a atividade no site. Para isso, é necessário definir os campos de consulta, categoria e filtro nos uploads de eventos search com precisão.

Próximas etapas