Implementar o varejo

Nesta página, fornecemos orientações passo a passo para implementar a Retail API.

Introdução

Com a Recommendations AI ou a Pesquisa de varejo, você usa a API Retail para ingerir dados de eventos e catálogos do usuário e exibir previsões ou resultados da pesquisa no seu site.

A API Retail usa os mesmos dados para o Recommendations AI e o Retail Search. Portanto, se você usar ambos, não será necessário ingerir os mesmos dados duas vezes.

Consulte os requisitos e práticas recomendadas para eventos do usuário referentes aos dados de eventos do usuário usados pela Pesquisa de varejo e pelo varejo. Se você usa modelos do Recommendations AI, os requisitos de dados do evento do usuário listam outros requisitos dependendo do tipo de modelo e do objetivo de otimização. Esses requisitos ajudam a API Retail a gerar resultados de qualidade.

O tempo médio de integração da API Retail é de ordem de semanas. Para a pesquisa de varejo, a duração real depende muito da qualidade e da quantidade de dados a serem ingeridos.

Se você usa o Gerenciador de tags do Google ou o Google Merchant Center, pode implementar a API Retail com ferramentas do Google.

É possível usar a API Retail para ver resultados personalizados no seu site, mesmo que você não utilize outras ferramentas do Google. Se você não tiver, consulte Implementar a API Retail.

Nunca armazene em cache os resultados personalizados de um usuário final nem retorne-os para outro usuário final.

Implementar a API Retail com ferramentas do Google

Se você usa o Gerenciador de tags do Google e o Google Merchant Center, pode utilizar esses produtos para fornecer dados que a API Retail pode usar.

Etapa	Descrição
1. Configurar um projeto do Google Cloud	É possível usar um projeto atual do Google Cloud se você já tiver um.
2a. Importar seu catálogo de produtos usando o Merchant Center	Também é possível importar diretamente seu catálogo de produtos, mas vincular o Merchant Center reduz as etapas necessárias para importar seu catálogo. O Merchant Center não é compatível com o tipo de produto de coleções. Antes de importar, leia as limitações do Merchant Center para verificar se elas atendem às necessidades do seu catálogo.
2b. Configurar o Gerenciador de tags para registrar eventos do usuário	Os eventos do usuário rastreiam ações do usuário, como clicar em um produto, adicionar um item a um carrinho de compras ou comprar um item. Você pode começar a gravar eventos do usuário em paralelo à importação do catálogo. Depois que a importação do catálogo for concluída, volte aos eventos enviados antes da conclusão da importação.
3. Importar eventos históricos do usuário	Os modelos precisam de dados de treinamento suficientes para fornecer previsões precisas. Ao fornecer dados históricos de eventos do usuário, você pode iniciar o treinamento do modelo sem precisar esperar meses até que dados suficientes sejam coletados no seu site. Saiba mais.
4. Criar a configuração, o modelo e os controles 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 os resultados da pesquisa ou de recomendações. Ao criar uma configuração de exibição, é possível criar simultaneamente um modelo (somente para Recommendations AI) ou controles (somente para pesquisa de varejo). Também é possível criá-las separadamente. Se você usar o Recommendations AI, escolha um tipo de modelo com base no local da configuração de exibição e nos objetivos dela. Analise os tipos de recomendação, os objetivos de otimização e outras opções de ajuste de modelo disponíveis. para determinar as melhores opções para seus objetivos de negócios. Para as configurações de disponibilização de pesquisa de varejo, um modelo padrão é criado automaticamente pela API Retail.
5. Espere até o ajuste do modelo	A criação de um modelo inicia o treinamento do modelo. O treinamento e o ajuste do modelo inicial levam de 2 a 5 dias para serem concluídos.
6. Visualizar a configuração de exibição	Depois que seu modelo for ativado, visualize as recomendações ou os resultados da pesquisa da configuração de exibição para garantir que ela esteja funcionando conforme o esperado.
7. Configurar um experimento A/B (opcional)	Você pode usar um experimento A/B para comparar o desempenho do seu site ao usar a API Retail para uma versão de valor de referência que não usa a API Retail.
8. Avaliar a configuração	Avalie as métricas fornecidas pelo console para ajudar a determinar como a incorporação da API Retail está afetando seus negócios. Veja as métricas do seu projeto na página "Monitoramento e análise" do console.

Implementar a API Retail sem outras ferramentas do Google

Se você não usa o Gerenciador de tags e o Merchant Center, siga as etapas abaixo para integrar o varejo ao seu site.

Etapa	Descrição
1. Configurar um projeto do Google Cloud	Para usar a API Retail, crie um projeto do Google Cloud e crie credenciais de autenticação que incluam uma chave de API e um token OAuth (usando uma conta de usuário ou uma conta de serviço) para acessar o projeto.
2a. Importar seu catálogo de produtos	Para adicionar itens ao catálogo de produtos individualmente, use o método Products.create. Para catálogos de produtos grandes, recomendamos adicionar itens em massa usando o método Products.import.
2b. Registrar eventos do usuário	Os eventos do usuário rastreiam ações do usuário, como clicar em um produto, adicionar um item a um carrinho de compras, comprar um item e assim por diante. A API Retail depende dos dados de eventos do usuário para gerar resultados personalizados. Os eventos do usuário precisam ser ingeridos em tempo real para refletir com precisão o comportamento dos seus usuários. Você pode começar a gravar eventos do usuário em paralelo à importação do catálogo. Depois que a importação do catálogo for concluída, volte aos eventos enviados antes da conclusão da importação.
3. Importar eventos históricos do usuário	Os modelos precisam de dados de treinamento suficientes para fornecer previsões precisas. Ao fornecer dados históricos de eventos do usuário, você pode iniciar o treinamento do modelo sem precisar esperar meses até que dados suficientes sejam coletados no seu site. Saiba mais.
4. Criar a configuração, o modelo e os controles de exibição	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. Ao criar uma configuração de exibição, é possível criar simultaneamente um modelo ou controles, ou criá-los separadamente. No Recommendations AI, o local da sua configuração de exibição e os objetivos dela afetam o ajuste do modelo. Analise os tipos de recomendação, objetivos de otimização e outras opções de ajuste de modelo disponíveis para determinar as melhores opções para seus objetivos de negócios.
5. Reserve tempo para o treinamento	O treinamento começa com a criação do modelo ou da configuração de exibição. O treinamento e o ajuste do modelo inicial levam de 2 a 5 dias para serem concluídos.
6. Visualizar a configuração de exibição	Depois que a configuração for ativada, visualize 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.
7. Configurar um experimento A/B (opcional)	Você pode usar um experimento A/B para comparar o desempenho do seu site ao usar a API Retail para uma versão de valor de referência que não usa a API Retail.
8. Avaliar a configuração	Avalie as métricas fornecidas pelo console para ajudar a determinar como a incorporação da API Retail está afetando seus negócios. Veja as métricas do seu projeto na página "Monitoramento e análise" do console.

Termos de Serviço

O uso do produto está de acordo com os Termos e Condições do Google Cloud, e as informações do cliente serão usadas de acordo com a Política de Privacidade do Google.

Para garantir a qualidade, uma pequena amostra de consultas e resultados de pesquisa dos registros da API Retail é enviada para classificação humana a fornecedores terceirizados, incluindo a Cognizant Worldwide Limited.