Esta é a documentação do Recommendations AI, da Pesquisa de varejo e do novo Console do Varejo. Para usar a pesquisa de varejo na fase GA restrita, entre em contato com a equipe de vendas do Cloud.

Se você estiver usando apenas o Recommendations AI, permaneça no Console do Recommendations e consulte a documentação do Recommendations AI.

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 veiculação estão disponíveis a partir do Recommendations AI v2 e da Pesquisa de varejo v2alpha.

Anteriormente, o Recommendations AI usava canais para determinar qual modelo era usado para retornar recomendações.

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

As configurações de exibição permitem editar as opções de diversidade e reclassificação de preços e fazer com que elas entrem em vigor quase em tempo real. Com as posições, as configurações de diversidade e de preço só podem ser alteradas a partir do modelo de recomendação para que a posição aponta.

As posições ainda são compatíveis, mas é recomendável usar as configurações de veiculaçã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
Nenhum Ilimitado
Baixa 3
Médio 2
Alta 1
Automático Depende do catálogo

Opções de pesquisa de varejo para configurações de veiculação

Atributos dinâmicos

Quando o atributo dinâmico está ativado, a pesquisa de varejo pode usar automaticamente os 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.

Quando o atributo dinâmico está ativado para uma configuração de disponibilização, um determinado atributo pode ser usado como um atributo por padrão é definido pela configuração de atributo no nível do produto na API Retail. As configurações de reconhecimento dinâmico na API podem ser substituídas por controles de atributos em todo o site no Console do Cloud. Consulte Controles para 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