Nesta página, listamos um conjunto de tutoriais interativos da Vertex AI para Pesquisa para varejo. Esses tutoriais incluem ações que podem ser executadas no editor do Google Cloud Shell. Com essa ferramenta, é possível programar, criar, testar, executar e depurar aplicativos nativos da nuvem diretamente do navegador.
Visão geral
Experimente tutoriais diferentes, dependendo do que você quer aprender:
Se você estiver iniciando um projeto, siga os tutoriais Importar informações do catálogo. Aqui, você aprende a importar produtos para o catálogo e testar, por exemplo, diferentes funcionalidades de pesquisa. Em seguida, consulte os tutoriais Importar eventos históricos de usuários. A Vertex AI para Pesquisa para varejo usa eventos do usuário para gerar recomendações iniciais e resultados da pesquisa. Em seguida, siga 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.
Para saber como a pesquisa funciona em geral, confira os tutoriais da Pesquisa.
Se você quiser aprender como definir a pesquisa com configurações e controles de exibição, tente os seguintes tutoriais:
Se for necessário atualizar as informações do catálogo, consulte os tutoriais Gerenciar informações do catálogo.
Se você quiser saber como atualizar o inventário, consulte os tutoriais Atualizar inventário para pesquisa.
Se você quiser aprender a gravar, ver 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 de importação e gerenciamento de catálogos e eventos do usuário.
Importar informações do catálogo
Estes tutoriais descrevem como importar as informações do seu catálogo e mantê-las atualizadas.
Importar dados do catálogo do BigQuery
Neste tutorial, mostramos como usar uma tabela do BigQuery para importar grandes quantidades de dados de catálogo sem limites.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Importar dados do catálogo do Cloud Storage
Neste tutorial, mostramos como importar um grande número de itens para um catálogo.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Importar dados do catálogo inline
Neste tutorial, mostramos como importar produtos para um catálogo inline.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Gerenciar informações do catálogo
Estes 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.
Aprenda a chamar a API com a linguagem que preferir.
Tutorial de criação, recebimento, atualização e exclusão de produtos
Neste tutorial, mostramos como usar métodos da API, que executam as seguintes ações:
- Criar um produto
- Receber um produto
- Atualizar um produto
- Excluir um produto
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de criação de produtos
Neste tutorial, mostramos como criar um único produto.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de recebimento de produtos
Neste tutorial, mostramos como recuperar um item de produto.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de atualização de produtos
Neste tutorial, mostramos como atualizar um produto em um catálogo.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de exclusão de produtos
Neste tutorial, mostramos como excluir um produto de um catálogo.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Importar eventos históricos do usuário
Estes tutoriais descrevem como importar em massa os dados de eventos do usuário de eventos anteriores. Modelos exigem dados de eventos do usuário para treinamento.
Tutorial de importação de eventos do Cloud Storage
Neste tutorial, mostramos como importar eventos de usuário do Cloud Storage.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de importação de eventos do BigQuery
Neste tutorial, mostramos como importar eventos de usuário do BigQuery.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de importação de eventos inline
Neste tutorial, mostramos como importar dados de eventos de usuário inline.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Registrar eventos do usuário em tempo real
Estes tutoriais descrevem como registrar, visualizar ou remover eventos do usuário em tempo real. A Vertex AI para Pesquisa para varejo usa eventos do usuário em tempo real para gerar recomendações e resultados de pesquisa. Registrar 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
Neste tutorial, mostramos como registrar eventos de usuário usando o
método
userEvents.write
.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de reintegração de eventos de usuário
Neste tutorial, mostramos como reintegrar eventos de usuário fazendo uma solicitação POST
para o
endpoint userEvents:rejoin
.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial para remover eventos de usuário
Neste tutorial, mostramos como limpar eventos do usuário.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Pesquisar tutoriais
O método search()
é usado para pesquisar no catálogo de acordo com a consulta de pesquisa e outros parâmetros, como filter, facet 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
Neste tutorial, mostramos como enviar uma consulta de pesquisa simples e analisar a resposta.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de paginação
Neste tutorial, mostramos como controlar a paginação na solicitação de pesquisa. Quando um comprador procura produtos em uma loja, ele pode melhorar a navegação nos resultados da pesquisa. Por exemplo, eles podem limitar o número de itens na resposta da pesquisa usando o recurso de tamanho de página ou ir para a página de sua preferência usando o recurso de deslocamento.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
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 a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de filtragem
Neste tutorial, demonstramos 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, 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 a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de ordenação
Neste tutorial, mostramos como ordenar itens em uma resposta de pesquisa. Quando um comprador procura um produto no seu site, você pode mostrar os 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 campos múltiplos. O comprador vê vestidos ordenados por preço e, para os vestidos com o mesmo preço, ordenados por desconto.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de otimização
Neste tutorial, mostramos alguns exemplos de otimização de produtos nos resultados da pesquisa. Com a otimização, é possível otimizar um produto para priorizar ou diminuir a prioridade dele nos resultados da pesquisa.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de controle de redirecionamento
Neste tutorial, mostramos como usar o controle de redirecionamento. Com o controle de redirecionamento, você pode especificar um URL para redirecionar os usuários quando eles fizerem uma consulta de pesquisa específica. Por exemplo, se um usuário solicitar "produtos de manufatura sustentáveis", você poderá redirecioná-lo para uma página que contenha as marcas ambientais com que você está trabalhando.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Atualizar inventário para pesquisa
Embora os métodos de criação, leitura, atualização e exclusão (CRUD, na sigla em inglês) Product
sejam usados para
modificar amplamente os atributos de um Product
, há um conjunto de métodos Product
que pode ser usado 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_info
Product.availability
Product.available_quantity
Product.fulfillment_info
Tutorial de adição de fulfillment
Neste tutorial, mostramos como atualizar as informações de fulfillment do produto usando o
método
AddFulfillmentPlaces
. Dessa forma, a pesquisa pode mostrar atualizações onde os produtos estão disponíveis e onde os pedidos podem ser atendidos. Por exemplo, um comprador está procurando jeans azuis em uma loja, mas eles estão esgotados. No momento em que os jeans voltarem ao estoque nesta ou em qualquer outra loja, o comprador verá as atualizações e poderá prosseguir com o pedido.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de remoção de fulfillment
Neste tutorial, mostramos como atualizar as informações de fulfillment do produto usando
o método RemoveFulfillmentPlaces
. Dessa forma, a pesquisa pode mostrar atualizações onde os produtos não estão disponíveis e os pedidos não podem ser atendidos. Por exemplo, um comprador está procurando jeans azuis em uma loja. Se o jeans se esgotar nessa loja, o comprador verá a informação e não poderá prosseguir com o pedido.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de configuração do inventário
Neste tutorial, mostramos como enviar atualizações de inventário usando o método SetInventory
em vez de atualizar todo o produto.
Para seguir a orientação passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientação: