Pré-requisitos de configuração

Antes de poder configurar o Vertex AI Search for commerce para um novo projeto, tem de:

  1. Crie um novo projeto ou configure o seu projeto existente
  2. Ative o Vertex AI Search para comércio
  3. Importe o seu catálogo de produtos e eventos do utilizador

Crie um Google Cloud projeto

  1. Na página Gerir recursos na Google Cloud consola, selecione ou crie um Google Cloud projeto.

    Aceda à página Gerir recursos

  2. Certifique-se de que a faturação está ativada para o seu projeto do Google Cloud. Saiba como verificar se a faturação está ativada num projeto.

Configure o Vertex AI Search para comércio

Para usar o Vertex AI Search for commerce, siga estes passos. Além disso, se ativar a Pesquisa da Vertex AI para comércio e usar recomendações, saiba que os custos baseiam-se no número de consultas. Para mais informações sobre os preços do Vertex AI Search for commerce, consulte o artigo Cobranças do Vertex AI Search for commerce.

Para o seu novo projeto

Para configurar o Vertex AI Search for commerce:

  1. Aceda à página Vertex AI Search para comércio na Google Cloud consola.

    Aceda à página de pesquisa de comércio

  2. Na página Configure o Vertex AI Search para comércio, clique em Ativar API.

  3. Quando o Vertex AI Search para comércio e o Recommendations AI forem apresentados como Ativado, clique em Continuar.

  4. Leia os termos de utilização de dados da Pesquisa Vertex AI para a indústria e clique em Aceitar se concordar com os termos de utilização de dados. Vai receber uma confirmação da Google Cloud consola assim que os termos forem aceites para a pesquisa.

  5. Se quiser usar o projeto apenas com recomendações, clique em Começar.

  6. Para ativar a pesquisa além das recomendações, faça o seguinte:

    1. Clique em Continuar e, de seguida, em Ativar na página Ativar pesquisa (opcional).
    2. Clique em Começar.

    A Google Cloud consola apresenta os componentes do Vertex AI Search for commerce que ativou. Agora, pode configurar as definições iniciais do seu projeto.

Para um projeto existente

Para continuar num projeto existente, conclua estes passos:

  1. Aceda à página Pesquisar comércio na Google Cloud consola do seu projeto.

    Aceda à página de pesquisa de comércio

  2. Na página Termos de utilização de dados, leia os termos de utilização de dados das soluções Discovery e clique em Aceitar se concordar com os termos.

  3. Se quiser usar o projeto apenas com recomendações, clique em Começar.

  4. Se quiser ativar a pesquisa além das recomendações, faça o seguinte:

    1. Clique em Continuar e, de seguida, em Ativar na página Ativar pesquisa (opcional).
    2. Clique em Começar.

Desative as funcionalidades de pesquisa

Se já não quiser usar a pesquisa, pode desativá-la enviando um pedido de apoio técnico.

Para definir o seu pedido para o componente correto, selecione os seguintes campos:

  • Categoria: aprendizagem automática
  • Componente: Vertex AI Search para comércio: pesquisa e navegação
  • Subcomponente: administração e faturação da conta

Para mais informações sobre como criar um pedido de apoio técnico, consulte o artigo Receber apoio técnico.

Desative o Vertex AI Search para comércio

Pode desativar o Vertex AI Search para comércio em qualquer altura. Esta ação desativa as recomendações e a pesquisa.

Para desativar o Vertex AI Search para comércio, conclua os seguintes passos:

  1. Aceda à página Detalhes da API/serviço Vertex AI Search for Retail na Google Cloud consola.

    Aceda à página de detalhes do serviço da API Vertex AI Search for commerce

  2. Clique em Desativar API.

  3. Na caixa Desativar a API Vertex AI Search for commerce?, clique em Desativar.

Comece a usar o Vertex AI Search para comércio

Quando configura o Vertex AI Search para comércio para um novo projeto, a Google Cloud consola apresenta os três painéis seguintes para ajudar a configurar o seu projeto do Vertex AI Search para comércio:

  • Dados > Catálogo: apresenta o catálogo de produtos e um link para importar o seu catálogo.

  • Dados > Eventos: apresenta os eventos do utilizador e um link para importar eventos do utilizador históricos.

  • Configurações de publicação: contém detalhes sobre a configuração de publicação e um link para criar uma nova configuração de publicação.

Pode usar estes painéis para importar os seus dados e criar uma configuração inicial para o seu projeto do Vertex AI Search para comércio.

Importe o seu catálogo de produtos

Para importar o catálogo de produtos, conclua o conjunto de passos para a sua origem de dados. Para mais informações sobre catálogos de produtos, consulte o artigo Importar informações do catálogo.

Sincronização do Merchant Center

  1. Clique em Importar catálogo de produtos para abrir o painel Importar dados.
  2. Escolha Catálogo de produtos.
  3. Selecione Sincronização do Merchant Center como origem de dados.
  4. Selecione a sua conta do Merchant Center. Verifique o acesso do utilizador se não vir a sua conta.
  5. Opcional: selecione o filtro de feeds do Merchant Center para importar apenas ofertas de feeds selecionados.

    Se não for especificado, as ofertas de todos os feeds são importadas (incluindo feeds futuros).
  6. Opcional: para importar apenas ofertas segmentadas para determinados países ou idiomas, expanda Mostrar opções avançadas e selecione os países de venda e os idiomas do Merchant Center para filtrar.
  7. Selecione a filial para a qual vai carregar o catálogo.
  8. Clique em Importar.

Cloud Storage

  1. Clique em Importar catálogo de produtos para abrir o painel Importar dados.
  2. Escolha Catálogo de produtos como origem de dados.
  3. Selecione a filial para a qual vai carregar o catálogo.
  4. Escolha Esquema de catálogos de produtos de retalho como esquema.
  5. Introduza a localização do Cloud Storage dos seus dados.
  6. Se não tiver a pesquisa ativada, selecione os níveis de produtos.

    Tem de selecionar os níveis de produtos se estiver a importar o catálogo pela primeira vez ou se estiver a reimportar o catálogo depois de o limpar. Saiba mais acerca dos níveis dos produtos. Alterar os níveis dos produtos depois de importar dados requer um esforço significativo.

    Importante: não pode ativar a pesquisa de projetos com um catálogo de produtos que tenha sido carregado como variantes.
  7. Clique em Importar.

BigQuery

  1. Clique em Importar catálogo de produtos para abrir o painel Importar dados.
  2. Escolha Catálogo de produtos.
  3. Selecione BigQuery como origem de dados.
  4. Selecione a filial para a qual vai carregar o catálogo.
  5. Escolha um dos seguintes esquemas:
  6. Introduza a tabela do BigQuery onde os seus dados se encontram.
  7. Opcional: em Mostrar opções avançadas, introduza a localização de um contentor do Cloud Storage no seu projeto como uma localização temporária para os seus dados.

    Se não for especificado, é usada uma localização predefinida. Se especificado, o BigQuery e o contentor do Cloud Storage têm de estar na mesma região.
  8. Se não tiver a pesquisa ativada e estiver a usar o esquema do Merchant Center, selecione o nível do produto.

    Tem de selecionar o nível do produto se esta for a primeira vez que importa o catálogo ou se estiver a reimportar o catálogo depois de o limpar. Saiba mais acerca dos níveis dos produtos. Alterar os níveis dos produtos depois de importar dados requer um esforço significativo.

    Importante: não pode ativar a pesquisa de projetos com um catálogo de produtos que tenha sido carregado como variantes.
  9. Clique em Importar.

Importe os seus eventos de utilizadores históricos

Para importar os eventos do histórico de utilizadores, conclua o conjunto de passos para a sua origem de dados. Para mais informações sobre eventos de utilizadores históricos, consulte o artigo Importar eventos de utilizadores históricos.

Cloud Storage

  1. Clique em Importar eventos de utilizadores para abrir o painel Importar dados.
  2. Escolha Eventos do utilizador.
  3. Selecione Google Cloud Storage como a origem de dados.
  4. Escolha Esquema de eventos de utilizadores de retalho como esquema.
  5. Introduza a localização do Cloud Storage dos seus dados.
  6. Clique em Importar.

BigQuery

  1. Clique em Importar eventos de utilizadores para abrir o painel Importar dados.
  2. Escolha Eventos do utilizador.
  3. Selecione BigQuery como origem de dados.

  4. Selecione o esquema de dados.

  5. Introduza a tabela do BigQuery onde os seus dados se encontram.
  6. Opcional: introduza a localização de um contentor do Cloud Storage no seu projeto como uma localização temporária para os seus dados.
    Se não for especificado, é usada uma localização predefinida. Se especificado, o BigQuery e o contentor do Cloud Storage têm de estar na mesma região.
  7. Opcional: em Mostrar opções avançadas, introduza a localização de um contentor do Cloud Storage no seu projeto como uma localização temporária para os seus dados.

    Se não for especificado, é usada uma localização predefinida. Se especificado, o BigQuery e o contentor do Cloud Storage têm de estar na mesma região.
  8. Clique em Importar.

Crie uma configuração de publicação

Uma configuração de publicação é uma entidade de publicação que associa um modelo ou um conjunto de controlos usados para gerar os resultados da pesquisa ou da recomendação.

Para criar uma configuração de publicação, conclua os passos seguintes:

  1. No painel Configurações de publicação, clique em Criar configuração de publicação.
  2. Na página Criar configuração de publicação, escolha Pesquisa como o produto para o qual a configuração de publicação vai ser usada.
  3. Indique um nome para a configuração de publicação.

    O nome tem de ter, no máximo, 1024 carateres e só pode conter carateres alfanuméricos, sublinhados, hífenes e espaços.
  4. Opcional: se necessário, atualize o ID.

    O ID é gerado a partir do nome que indicar e tem de ser exclusivo no seu projeto. Tem de ter 50 carateres ou menos e não pode conter espaços.
  5. Clique em Continuar.
  6. Escolha se quer ativar a segmentação dinâmica para esta configuração de publicação.
  7. Escolha ou crie controlos de publicação para otimizar as suas pesquisas.

    Para mais informações sobre os controlos, consulte o artigo Criar e gerir controlos.

Faça a gestão dos recursos e monitorize a atividade

Quando tiver concluído a configuração inicial do seu projeto, o painel de controlo da consola apresenta o estado do sistema do seu projeto do Vertex AI Search for commerce.Google Cloud O painel de controlo da consola permite-lhe gerir recursos e monitorizar a atividade.

Aceda à consola de pesquisa para comércio

Crie uma chave da API

É necessária uma chave da API se usar um píxel JavaScript ou uma etiqueta do Gestor de Etiquetas para captar eventos do utilizador a partir dos navegadores dos utilizadores. Para mais informações sobre formas de captar eventos do utilizador, consulte o artigo Registe eventos do utilizador em tempo real.

Para criar uma chave da API para chamadas ao método userEvents.Collect, siga estes passos:

  1. Aceda à página Google Cloud Credenciaisda consola.

  2. No menu pendente do projeto na parte superior da Google Cloud página da consola, selecione o seu projeto (o projeto pode já estar selecionado).

  3. Clique em Criar credenciais e, de seguida, selecione Chave de API. Não adicione restrições de aplicações de Websites. Sabe-se que algumas definições de privacidade do utilizador não transmitem o URL do referenciador.

    • Tome nota da chave da API gerada, que usa quando chama o registo de eventos do utilizador.

  4. Para aumentar a segurança, adicione uma restrição da API à sua chave da API para restringir o acesso ao serviço Vertex AI Search para comércio em https://retail.googleapis.com/*.

O que se segue?