Esta página apresenta um conjunto de tutoriais interativos para o Vertex AI Search for commerce. Estes tutoriais incluem ações que podem ser executadas no editor do Google Cloud Shell. Com esta ferramenta, pode escrever, criar, testar, executar e depurar aplicações nativas da nuvem diretamente a partir do navegador.
Vista geral
Experimente diferentes tutoriais consoante o que quer aprender:
Se estiver a iniciar um projeto, experimente os tutoriais de importação de informações do catálogo. Aqui, fica a saber como importar produtos para o catálogo para poder, por exemplo, experimentar diferentes funcionalidades de pesquisa. Em seguida, consulte os tutoriais Importe eventos de utilizadores históricos. O Vertex AI Search for commerce usa eventos do utilizador para gerar recomendações e resultados da pesquisa iniciais. Em seguida, experimente os tutoriais Registar eventos de utilizadores em tempo real. Os eventos do utilizador em tempo real fornecem resultados relevantes e de alta qualidade.
Se tiver interesse em saber como funciona a pesquisa em geral, experimente os tutoriais de pesquisa.
Se quiser saber como configurar a pesquisa com configurações e controlos de publicação, experimente os seguintes tutoriais:
Se precisar de atualizar as informações do catálogo, consulte os tutoriais de gestão das informações do catálogo.
Se quiser saber como atualizar o inventário, consulte os tutoriais de atualização do inventário para a pesquisa.
Se quiser saber como registar, ver ou remover eventos de utilizadores em tempo real, consulte os tutoriais Registe eventos de utilizadores em tempo real.
Se planeia usar recomendações, consulte os tutoriais para importar e gerir catálogos e eventos do utilizador.
Importe informações do catálogo
Estes tutoriais descrevem como importar as informações do catálogo e mantê-las atualizadas.
Importe dados do catálogo do BigQuery
Este tutorial mostra como usar uma tabela do BigQuery para importar grandes quantidades de dados do catálogo sem limites.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Importe dados do catálogo a partir do Cloud Storage
Este tutorial mostra como importar um grande número de artigos para um catálogo.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Importe dados do catálogo inline
Este tutorial mostra como importar produtos para um catálogo inline.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Faça a gestão das informações do catálogo
Estes tutoriais descrevem como gerir as informações sobre os produtos depois de ter importado um catálogo. Pode ler, escrever e eliminar produtos no seu catálogo.
Saiba como chamar a API com o idioma da sua escolha.
Criar/obter/atualizar/eliminar tutorial de produtos
Este tutorial mostra como usar métodos da API, que realizam as seguintes ações:
- Crie um produto
- Obtenha um produto
- Atualize um produto
- Elimine um produto
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Crie um tutorial de produto
Este tutorial mostra como criar um único produto.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Aceda ao tutorial do produto
Este tutorial mostra como obter um artigo do produto.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Atualize o tutorial do produto
Este tutorial mostra como atualizar um produto num catálogo.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Tutorial Eliminar produto
Este tutorial mostra-lhe como eliminar um produto de um catálogo.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Importe eventos de utilizadores históricos
Estes tutoriais descrevem como importar dados de eventos do utilizador de eventos anteriores em massa. Os modelos requerem dados de eventos do utilizador para a preparação.
Tutorial de importação de eventos do Cloud Storage
Este tutorial mostra como importar eventos de utilizadores do Cloud Storage.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Tutorial de importação de eventos do BigQuery
Este tutorial mostra como importar eventos do utilizador do BigQuery.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Tutorial inline sobre a importação de eventos
Este tutorial mostra como importar dados de eventos do utilizador incorporados.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Registe eventos de utilizador em tempo real
Estes tutoriais descrevem como registar, ver ou remover eventos de utilizadores em tempo real. O Vertex AI Search for commerce usa eventos de utilizadores em tempo real para gerar recomendações e resultados da pesquisa. Registar o maior número possível de tipos de eventos do utilizador com informações válidas sobre o produto aumenta a qualidade dos seus resultados.
Tutorial sobre como escrever eventos do utilizador
Este tutorial mostra como registar eventos do utilizador através do método
userEvents.write
.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Tutorial sobre como voltar a juntar eventos de utilizadores
Este tutorial mostra como juntar novamente eventos do utilizador fazendo um pedido POST
ao ponto final userEvents:rejoin
.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Tutorial sobre a remoção de eventos de utilizadores
Este tutorial mostra como remover completamente eventos de utilizadores.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
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 filter, facet ou order_by.
Por predefinição, a resposta de 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 orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Tutorial de paginação
Este tutorial mostra como controlar a paginação no pedido de pesquisa. Quando um comprador procura produtos numa loja, pode melhorar a navegação através dos resultados da pesquisa. Por exemplo, podem limitar o número de itens na resposta de pesquisa através da funcionalidade de tamanho da página ou aceder à página preferida através da funcionalidade de deslocamento.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Tutorial de expansão de consultas
Este tutorial mostra como ativar a funcionalidade de expansão de consultas. Quando um comprador usa uma expressão de pesquisa ambígua ou com várias palavras, pode receber uma resposta vazia. Depois de ativar a expansão de consultas, o pedido é analisado e o que é devolvido é a lista expandida de produtos com base na consulta de pesquisa analisada.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Tutorial de filtragem
Este tutorial demonstra a funcionalidade de filtragem. Permite-lhe ajustar as solicitações de pesquisa de acordo com as suas necessidades ou as do seu cliente. Pode filtrar por um ou vários campos, filtrar por campos de texto ou numéricos, ou ambos. Pode usar uma linguagem de expressão para criar um predicado para cada campo ou combinar diferentes expressões através de operadores lógicos. Por exemplo, um comprador à procura de sapatos pode usar filtros para restringir a pesquisa à sua marca e cor preferidas.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Tutorial de ordenação
Este tutorial mostra como ordenar itens numa resposta de pesquisa. Quando um comprador procura um produto no seu site, pode apresentar resultados ordenados por vários campos. Por exemplo, um comprador está a pesquisar um vestido com o melhor preço e desconto. O preço e o desconto são vários campos aqui. O comprador vê vestidos ordenados por preço e, para os vestidos com o mesmo preço, ordenados por desconto.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Tutorial de amplificação
Este tutorial mostra alguns exemplos de aumento da visibilidade de produtos nos resultados da pesquisa. Com a otimização, pode aplicar uma otimização a um produto para lhe dar prioridade ou retirar-lhe prioridade nos resultados da pesquisa.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Tutorial de controlo de redirecionamento
Este tutorial mostra-lhe como usar o controlo de redirecionamento. O controlo de redirecionamento permite-lhe especificar um URL para o qual pode redirecionar os utilizadores quando utilizam uma consulta de pesquisa específica. Por exemplo, se um utilizador pedir "produtos de fabrico sustentável", pode redirecioná-lo para uma página que contenha as marcas ambientais com as quais está a trabalhar.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Atualize o inventário para a pesquisa
Embora os métodos de criação, leitura, atualização e eliminação (CRUD) sejam usados para modificar amplamente os atributos de um Product
, existe um conjunto de métodos Product
que podem ser usados para atualizar campos específicos do inventário com vários níveis de detalhe.Product
Os seguintes campos Product
são considerados campos de inventário:
Product.price_info
Product.availability
Product.available_quantity
Product.fulfillment_info
Adicione um tutorial de processamento
Este tutorial mostra como atualizar as informações de processamento de produtos através do método
AddFulfillmentPlaces
. Desta forma, a pesquisa pode mostrar atualizações sobre a disponibilidade dos produtos e o processamento das encomendas. Por exemplo, um comprador está à procura de calças de ganga azuis numa loja, mas estão esgotadas. No momento em que os jeans estiverem novamente em stock nesta ou noutra loja, o comprador vê as atualizações e pode avançar com a encomenda.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Remova o tutorial de processamento
Este tutorial mostra como atualizar as informações de processamento de produtos através do método RemoveFulfillmentPlaces
. Desta forma, a pesquisa pode apresentar atualizações quando os produtos não estão disponíveis e não é possível processar as encomendas. Por exemplo, um comprador está à procura de calças de ganga azuis numa loja. Se as calças de ganga ficarem esgotadas nesta loja, o comprador vê esta informação e não pode avançar com a encomenda.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:
Tutorial de definição do inventário
Este tutorial mostra como enviar atualizações de inventário através do método
SetInventory
em vez de atualizar o produto completo.
Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me: