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.

Preenchimento automático

Esta página apresenta o recurso de preenchimento automático e como usá-lo. A pesquisa de varejo fornece preenchimento automático para impulsionar as sugestões do tipo de caixa de pesquisa de varejistas.

O preenchimento automático é um recurso para prever o restante de uma consulta que o usuário está digitando, o que pode melhorar a experiência de pesquisa do usuário. Ele pode fornecer sugestões de tipo de acordo com o conjunto de dados de sugestão do BigQuery ou com base nas sugestões geradas pelos eventos do usuário fornecidos.

Visão geral

Quando um usuário final começa a digitar um termo de pesquisa no seu site, a Pesquisa de varejo pode fornecer uma lista de sugestões que o usuário pode querer. Por exemplo, "sapatos", "camisetas" pode ser sugerida quando o usuário digita sh.

A fonte de dados de previsões pode ser uma das seguintes:

  • Um conjunto de dados de conclusão enviado por upload usado para sugerir consultas. Consulte Importar dados de conclusão.

  • Um conjunto de dados de preenchimento automático com machine learning gerado pela pesquisa de varejo com base nos eventos de pesquisa dos usuários.

Tipo de dispositivo

O preenchimento automático da pesquisa de varejo é compatível com diferentes tipos de dispositivos, como MOBILE e DESKTOP. Você pode fazer upload ou receber sugestões diferentes com base nos tipos de dispositivo. Se device_type não for especificado em CompleteQuery, a sugestão será em todos os tipos de dispositivo.

Para um conjunto de dados de conclusão gerado com base nos eventos do usuário de pesquisa, defina user_agent em UserEvent.user_info para oferecer compatibilidade com diferentes tipos de dispositivos. Consulte user agent no wiki.

Conjunto de dados de sugestões

Você pode fazer upload de um conjunto de dados de conclusão ou fazer com que a pesquisa de varejo gere um com base nos eventos do usuário.

Conjunto de dados de conclusão enviado

Você pode fazer o upload do próprio conjunto de dados de conclusão. Veja instruções detalhadas em Importar dados de conclusão.

Conjunto de dados de conclusão gerado de eventos do usuário

A pesquisa de varejo pode usar eventos de usuários para gerar um conjunto de dados de preenchimento automático para você. Quanto mais eventos do usuário forem enviados para a Pesquisa de varejo, maior será a qualidade do preenchimento automático que a Pesquisa de varejo pode fornecer.

Entre em contato com a equipe de suporte do Cloud Retail para ativar o conjunto de dados gerado pela pesquisa de varejo.

Controles do conjunto de dados

Lista de permissões

A pesquisa de varejo realiza pós-processamento, como correção ortográfica, em sugestões de preenchimento automático. É possível criar uma lista de frases que a pesquisa de varejo precisa pular para o pós-processamento.

As frases na lista de permissões nunca são filtradas das sugestões. A lista de permissões funciona para conjuntos de dados de conclusão de upload e conjuntos de dados de conclusão gerados.

Exemplos: há alguns nomes de marca intencionalmente incorretos, como "loops froot" em vez de "fruta" ou "foot". Consulte as instruções detalhadas de upload em Importar dados de conclusão.

Lista de bloqueio

As frases em uma lista de bloqueio nunca aparecerão nas sugestões. Consulte as instruções detalhadas de upload em Importar dados de conclusão.

Concluir

Siga a API CompleteQuery para buscar as sugestões. Exemplo:

cURL

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog:completeQuery?query=sho&dataset=user-data&deviceType=DESKTOP&maxSuggestions=5"