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
|
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.