Implemente o varejo

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