Nesta página, mostramos uma visão geral das etapas necessárias para implementar a API Retail no seu aplicativo de e-commerce.
Introdução
Ao usar a Recommendations ou a Retail Search, 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 site.
A API Retail usa os mesmos dados para Recomendações e Retail Search. Portanto, se você usar as duas, 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ê usar modelos de recomendações, os Requisitos de dados de eventos do usuário vão listar outros requisitos, dependendo do tipo do 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ê estiver usando o Gerenciador de tags do Google ou o Google Merchant Center, poderá implementar a API Retail com as ferramentas do Google.
Você pode usar a API Retail para receber resultados personalizados para seu site, esteja usando ou não outras ferramentas do Google. Caso contrário, consulte Implementar a API Retail.
Nunca armazene em cache resultados personalizados de um usuário final nem retorne resultados personalizados para outro usuário final.
Implementar a API Retail com as 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. Após a conclusão da importação do catálogo, reúna todos os eventos que foram 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. Crie 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 e, opcionalmente, controles. Eles são usados ao gerar os resultados da pesquisa ou recomendação. Ao criar uma configuração de exibição, é possível criar simultaneamente um modelo e controles (somente para recomendações). Também é possível criá-los separadamente. Se você usar a seção "Recomendações", escolha um tipo de modelo com base no local e nos objetivos da configuração de exibição. 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 veiculação da Retail Search, 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 iniciais do modelo levam de 2 a 5 dias para serem concluídos, mas podem demorar mais em grandes conjuntos de dados. |
6. Conferir 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 do Google Cloud para ajudar você a determinar como a incorporação da API Retail está afetando seu negócio. Veja as métricas do seu projeto na página Analytics do console do Google Cloud. |
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 a seguir para integrar o Retail 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. Após a conclusão da importação do catálogo, reúna todos os eventos que foram 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. Crie a configuração, o modelo e os controles de exibição |
Uma configuração de exibição é uma entidade de exibição que associa configurações a um modelo e, opcionalmente, controles. Eles são usados ao gerar os resultados da pesquisa ou recomendação. Ao criar uma configuração de exibição, é possível criar um modelo e controles simultaneamente ou separadamente. Em relação às recomendações, o local da configuração de disponibilizaçã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 |
A criação do modelo ou da configuração de exibição inicia o treinamento. O treinamento e o ajuste iniciais do modelo levam de 2 a 5 dias para serem concluídos, mas podem demorar mais em grandes conjuntos de dados. |
6. Conferir 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 do Google Cloud para ajudar você a determinar como a incorporação da API Retail está afetando seu negócio. Veja as métricas do seu projeto na página Analytics do console do Google Cloud. |
Termos de Serviço
O uso do produto está de acordo com os Termos e Condições do Google Cloud ou a variante off-line relevante. O Aviso de privacidade do Google Cloud explica como coletamos e processamos suas informações pessoais relacionadas ao uso do Google Cloud e de outros serviços do Google Cloud.
Para garantir a qualidade, um pequeno conjunto de consultas de pesquisa e resultados da pesquisa dos registros da API Retail, que incluem dados de clientes, são enviados para classificação humana a fornecedores de terceiros divulgados como subprocessadores de terceiros do Retail Search. Outros testes que usam consultas e resultados dos registros da Pesquisa Google que são conjuntos de dados coletados publicamente são enviados para classificação humana a diferentes fornecedores terceirizados para controle de qualidade. Os registros da Pesquisa Google não são categorizados como dados de clientes.