Como dito antes, o Retail Search usa a API Retail do GCP.
Os passos para se utilizar da API vão depender do seu uso das ferramentas do Google, caso as utilize, abaixo falaremos os principais passos para a implantação em cada cenário.
Cenário 1 - Não são utilizadas ferramentas do Google
Caso a empresa que deseja utilizar o retail search não venha utilizando as ferramentas do google, vamos precisar de:
- Configurar um projeto do GCP Para usar a API Retail é preciso de um projeto do Google Cloud com faturamento ativado, ativar Retail API no console de API’s e gerar credenciais de autenticação que incluam uma chave de API e token OAuth (usando uma conta de usuário ou uma conta de serviço) para acessar o projeto criado.
- Acesse a página Varejo no console do seu projeto Na página Termos de uso de dados, leia os termos de uso de dados de Soluções de Descoberta e clique em Aceitar se concordar com os termos. Ative a Retail Search.
- Importar seu catálogo de produtos É necessário adicionar itens ao catálogo de produtos, isso pode ser feito de maneira individual(1 por 1) usando o método Products.create da API, caso deseje importar um catálogo grande é possível carregar mais de um item por vez usando o método Products.import da api.
- Importar eventos do usuário É necessário que os eventos do usuário estejam importados, pois através deles é feito o rastreio de ações do usuário, como adicionar um item a um carrinho de compras ou até mesmo compra-lo.
- Importar eventos históricos do usuário Para que os modelos funcionem adequadamente precisamos de dados de treinamento suficientes. Se a empresa já tiver um histórico do cliente é possível iniciar o treinamento do modelo sem precisar esperar meses até que dados suficientes sejam coletados para isso.
- Criar a configuração, o modelo e os controles de exibição Devemos criar uma configuração de exibição (uma entidade de exibição que associa as configurações a um modelo ou um conjunto de controles usados para gerar os resultados da pesquisa ou recomendação), após criar uma configuração de exibição, é possível criar simultaneamente um modelo ou controles de exibição.
- Treinar o modelo Após a criação do modelo ou da configuração de exibição, é importante o treinamento inicial e o ajuste do modelo.
- Visualizar a configuração de exibição Depois que a configuração for ativada, devemos ver as recomendações da configuração de exibição ou os resultados da pesquisa para garantir que a configuração esteja funcionando conforme o esperado.
Após essas etapas é importante avaliar as métricas fornecidas pelo console para ajudar a determinar como a incorporação da API Retail está afetando o negócio do cliente.
Cenário 2 - São utilizados ferramentas do Google
Caso a empresa que deseja utilizar o retail search venha utilizando as ferramentas do google(Gerenciador de tags ou o Google Merchant Center), vamos precisar de:
- Configurar um projeto do GCP Para usar a API Retail é preciso de um projeto do Google Cloud com faturamento ativado, ativar Retail API no console de API’s e gerar credenciais de autenticação que incluam uma chave de API e token OAuth (usando uma conta de usuário ou uma conta de serviço) para acessar o projeto criado.
- Acesse a página Varejo no console do seu projeto Na página Termos de uso de dados, leia os termos de uso de dados de Soluções de Descoberta e clique em Aceitar se concordar com os termos. Ative a Retail Search.
- Importar o catálogo de produtos É importante realizar a importação catalogo, utilizar a vinculação pelo Merchant Center reduz as etapas necessárias para importar seu catálogo, mas é possível importar utilizando a API também com os métodos Products.create e Products.Import. **Observação:**O Merchant Center possui algumas limitações em relação ao tipo de produto, exemplo: ele não é compatível com o tipo de produto de coleções.
- Configurar o Gerenciador de tags para registrar eventos do usuário É necessário que os eventos do usuário estejam importados, pois através deles é feito o rastreio de ações do usuário, como adicionar um item a um carrinho de compras ou até mesmo compra-lo.
- Importar eventos históricos do usuário Para que os modelos funcionem adequadamente precisamos de dados de treinamento suficientes. Se a empresa já tiver um histórico do cliente é possível iniciar o treinamento do modelo sem precisar esperar meses até que dados suficientes sejam coletados para isso.
- Criar a configuração, o modelo e os controles de exibição Devemos criar uma configuração de exibição (uma entidade de exibição que associa as configurações a um modelo ou um conjunto de controles usados para gerar os resultados da pesquisa ou recomendação), após criar uma configuração de exibição, é possível criar simultaneamente um modelo ou controles de exibição.
- Treinar o modelo Após a criação do modelo ou da configuração de exibição, é importante o treinamento inicial e o ajuste do modelo.
- Visualizar a configuração de exibição Depois que a configuração for ativada, devemos ver as recomendações da configuração de exibição ou os resultados da pesquisa para garantir que a configuração esteja funcionando conforme o esperado.
Após essas etapas é importante avaliar as métricas fornecidas pelo console para ajudar a determinar como a incorporação da API Retail está afetando o negócio do cliente.
Referências:
https://cloud.google.com/retail/docs/features?_ga=2.268000334.-1973433394.1660651982&_gac=1.19264970.1659721447.Cj0KCQjw_7KXBhCoARIsAPdPTfhS9MjQJ_VT9cneLRn-mBVpf0at3EfkPqzpJar6kILTzKjhi_zSzDAaAv0kEALw_wcB
https://cloud.google.com/retail/docs/overview?hl=pt-br
https://cloud.google.com/retail/docs/how-to?authuser=2&_ga=2.200358894.-1973433394.1660651982&_gac=1.123073017.1659721447.Cj0KCQjw_7KXBhCoARIsAPdPTfhS9MjQJ_VT9cneLRn-mBVpf0at3EfkPqzpJar6kILTzKjhi_zSzDAaAv0kEALw_wcB
https://cloud.google.com/retail/docs/record-events?authuser=2&_ga=2.195125228.-1973433394.1660651982&_gac=1.94828910.1659721447.Cj0KCQjw_7KXBhCoARIsAPdPTfhS9MjQJ_VT9cneLRn-mBVpf0at3EfkPqzpJar6kILTzKjhi_zSzDAaAv0kEALw_wcB
