Esta página lista um conjunto de tutoriais interativos para a Pesquisa de comércio com IA. Esses tutoriais incluem ações que podem ser executadas no editor do Google Cloud Shell. Com essa ferramenta, é possível escrever, criar, testar, executar e depurar aplicativos nativos da nuvem diretamente do navegador.
Visão geral
Confira diferentes tutoriais dependendo do que você quer aprender:
Se você estiver começando um projeto, tente os tutoriais Importar informações do catálogo. Neles, você aprende a importar produtos para o catálogo e, por exemplo, testar diferentes funcionalidades de pesquisa. Em seguida, confira os tutoriais Importar eventos históricos do usuário. A Pesquisa de comércio com IA usa eventos do usuário para gerar recomendações iniciais e resultados de pesquisa. Depois, tente os tutoriais Gravar eventos do usuário em tempo real. Os eventos do usuário em tempo real fornecem resultados relevantes e de alta qualidade.
Se você quiser saber como a pesquisa funciona em geral, tente os tutoriais de pesquisa.
Se você quiser aprender a configurar a pesquisa com configurações e controles de veiculação, tente os seguintes tutoriais:
Se você precisar atualizar as informações do catálogo, consulte os tutoriais Gerenciar informações do catálogo.
Se você quiser aprender a atualizar o inventário, consulte os tutoriais Atualizar inventário para pesquisa.
Se você quiser aprender a gravar, visualizar ou remover eventos do usuário em tempo real, consulte os tutoriais Gravar eventos do usuário em tempo real.
Se você planeja usar recomendações, consulte os tutoriais para importar e gerenciar catálogos e eventos do usuário.
Importar informações do catálogo
Esses tutoriais descrevem como importar as informações do catálogo e mantê-las atualizadas.
Importar dados do catálogo do BigQuery
Este tutorial mostra como usar uma tabela do BigQuery para importar grandes quantidades de dados de catálogo sem limites.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Importar dados do catálogo do Cloud Storage
Este tutorial mostra como importar um grande número de itens para um catálogo.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Importar dados do catálogo in-line
Este tutorial mostra como importar produtos para um catálogo in-line.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Gerenciar informações do catálogo
Esses tutoriais descrevem como gerenciar as informações do produto depois de importar um catálogo. É possível ler, gravar e excluir produtos no seu catálogo.
Saiba como chamar a API com a linguagem que você preferir.
Tutorial de criação, recebimento, atualização e exclusão de produtos
Este tutorial mostra como usar métodos de API, que executam as seguintes ações:
- Criar um produto
- Receber um produto
- Atualizar um produto
- Excluir um produto
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de criação de produtos
Este tutorial mostra como criar um único produto.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de recebimento de produtos
Este tutorial mostra como recuperar um item de produto.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de atualização de produtos
Este tutorial mostra como atualizar um produto em um catálogo.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de exclusão de produtos
Este tutorial mostra como excluir um produto de um catálogo.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Importar eventos históricos do usuário
Esses tutoriais descrevem como importar dados de eventos do usuário de eventos anteriores em massa. Os modelos exigem dados de eventos do usuário para treinamento.
Tutorial de importação de eventos do Cloud Storage
Este tutorial mostra como importar eventos do usuário do Cloud Storage.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de importação de eventos do BigQuery
Este tutorial mostra como importar eventos do usuário do BigQuery.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de importação de eventos in-line
Este tutorial mostra como importar dados de eventos do usuário in-line.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Gravar eventos do usuário em tempo real
Esses tutoriais descrevem como gravar, visualizar ou remover eventos do usuário em tempo real. A Pesquisa de comércio com IA usa eventos do usuário em tempo real para gerar recomendações e resultados de pesquisa. Gravar o maior número possível de tipos de eventos do usuário com informações válidas do produto aumenta a qualidade dos resultados.
Tutorial para criar eventos de usuário
Este tutorial mostra como gravar eventos do usuário usando o
userEvents.write
método.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de reintegração de eventos de usuário
Este tutorial mostra como reintegrar eventos do usuário fazendo uma solicitação POST para o
userEvents:rejoin endpoint.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial para remover eventos de usuário
Este tutorial mostra como limpar eventos de usuário.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutoriais de pesquisa
O método search() é usado para pesquisar no catálogo de acordo com a consulta de pesquisa e outros parâmetros, como filtro, atributo ou order_by.
Por padrão, a resposta da pesquisa contém um número razoável de resultados ordenados por relevância.
Tutorial de consultas
Este tutorial mostra como enviar uma consulta de pesquisa simples e analisar a resposta.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de paginação
Este tutorial mostra como controlar a paginação na solicitação de pesquisa. Quando um comprador procura produtos em uma loja, ele pode melhorar a navegação pelos resultados da pesquisa. Por exemplo, é possível limitar o número de itens na resposta da pesquisa usando o recurso de tamanho da página ou pular para a página preferida usando o recurso de deslocamento.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de expansão de consulta
Este tutorial mostra como ativar o recurso de expansão de consulta. Quando um comprador usa uma frase de pesquisa ambígua ou com várias palavras, ele pode receber uma resposta vazia. Depois de ativar a expansão de consulta, a solicitação é analisada e o que é retornado é a lista expandida de produtos com base na consulta de pesquisa analisada.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de filtragem
Este tutorial demonstra o recurso de filtragem. Ele permite ajustar as solicitações de pesquisa de acordo com as suas necessidades ou as de clientes. É possível filtrar por um ou vários campos, por campos de texto ou numéricos ou ambos. Você pode usar uma linguagem de expressão para construir um predicado para cada campo ou combinar diferentes expressões usando operadores lógicos. Por exemplo, um comprador que procura sapatos pode usar filtros para restringir a pesquisa à marca e cor preferidas.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de ordenação
Este tutorial mostra como ordenar itens em uma resposta de pesquisa. Quando um comprador procura um produto no seu site, é possível mostrar resultados ordenados por vários campos. Por exemplo, um comprador está procurando um vestido com o melhor preço e desconto. Preço e desconto são vários campos aqui. O comprador recebe vestidos ordenados por preço e, para os vestidos com o mesmo preço, ordenados por desconto.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de otimização
Este tutorial mostra alguns exemplos de otimização de produtos nos resultados da pesquisa. Com a otimização, é possível aplicar um reforço a um produto para priorizá-lo ou remover a prioridade dele nos resultados da pesquisa.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de controle de redirecionamento
Este tutorial mostra como usar o controle de redirecionamento. O controle de redirecionamento permite especificar um URL para o qual você pode redirecionar os usuários quando eles usam uma consulta de pesquisa específica. Por exemplo, se um usuário solicitar "produtos de fabricação sustentável", você poderá redirecioná-lo para uma página que contenha as marcas ambientais com que você trabalha.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Atualizar inventário para pesquisa
Embora os métodos de criação, leitura, atualização e exclusão (CRUD, na sigla em inglês) de Product sejam usados para modificar amplamente os atributos de um Product, há um conjunto de métodos Product que podem ser usados para atualizar campos específicos de inventário com níveis diferentes de granularidade. Os campos Product a seguir são considerados campos de inventário:
Product.price_infoProduct.availabilityProduct.available_quantityProduct.fulfillment_info
Tutorial de adição de fulfillment
Este tutorial mostra como atualizar as informações de fulfillment do produto usando o
AddFulfillmentPlaces
método. Dessa forma, a pesquisa pode mostrar atualizações de onde os produtos estão disponíveis e os pedidos podem ser atendidos. Por exemplo, um comprador está procurando calças jeans azuis em uma loja, mas elas estão esgotadas. No momento em que as calças jeans estiverem em estoque novamente nessa ou em qualquer outra loja, o comprador verá as atualizações e poderá prosseguir com o pedido.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de remoção de fulfillment
Este tutorial mostra como atualizar as informações de fulfillment do produto usando
o RemoveFulfillmentPlaces método. Dessa forma, a pesquisa pode mostrar atualizações de onde os produtos não estão disponíveis e os pedidos não podem ser atendidos. Por exemplo, um comprador está procurando calças jeans azuis em uma loja. Se as calças jeans ficarem esgotadas nessa loja, o comprador verá isso e não poderá prosseguir com o pedido.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações:
Tutorial de configuração do inventário
Este tutorial mostra como enviar atualizações do inventário usando o
SetInventory
método em vez de atualizar todo o produto.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientações: