Esta é a documentação do Recommendations AI, da Pesquisa de varejo e do novo Console do Varejo. Para usar a pesquisa de varejo na fase GA restrita, entre em contato com a equipe de vendas do Cloud.

Se você estiver usando apenas o Recommendations AI, permaneça no Console do Recommendations e consulte a documentação do Recommendations AI.

Implementação do Retail

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

Introdução

Ao usar o Recommendations AI ou a Pesquisa de varejo, você usará a API Retail para ingerir dados de eventos e catálogos dos usuários 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 o marketing do Google.

É possível usar a API Retail para ver resultados personalizados no seu site mesmo que você não use as ferramentas de marketing do Google. Caso contrário, consulte Como implementar a API Retail.

Implementação da API Retail com o marketing do Google

Se você utiliza a pilha de marketing do Google (Gerenciador de tags do Google e Google Merchant Center), é possível utilizar esses produtos para fornecer dados úteis para a API Retail.

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. Quando a importação do catálogo estiver concluída, reconecte-se a qualquer evento que tenha sido enviado 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 do Cloud para ajudar você 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 do Cloud.

Como implementar a API Retail

Siga as etapas abaixo para integrar a API 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. Quando a importação do catálogo estiver concluída, reconecte-se a qualquer evento que tenha sido enviado 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

A criação do modelo ou da configuração de exibição inicia o treinamento. 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 do Cloud para ajudar você 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 do Cloud.

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.