Configurar pré-requisitos

Antes de configurar a AI Commerce Search para um novo projeto, você precisa:

  1. Criar um projeto ou configurar um projeto atual
  2. Ativar a AI Commerce Search
  3. Importar o catálogo de produtos e os eventos do usuário

Crie um Google Cloud projeto do .

  1. Na página Gerenciar recursos do Google Cloud console, selecione ou crie um Google Cloud projeto.

    Acessar a página "Gerenciar recursos"

  2. Confira se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

Configurar a AI Commerce Search

Para usar a AI Commerce Search, siga estas etapas. Além disso, se você ativar a AI Commerce Search e usar recomendações, os custos serão baseados no número de consultas. Para mais informações sobre os preços da AI Commerce Search, consulte Taxas da AI Commerce Search.

Para seu novo projeto

Para configurar a AI Commerce Search:

  1. Acesse a página AI Commerce Search no Google Cloud console.

    Acessar a página AI Commerce Search in Gemini Enterprise for Customer Experience

  2. Na página Configurar a AI Commerce Search, clique em Ativar API.

  3. Quando AI Commerce Search e Recommendations AI aparecerem como Ativado, clique em Continuar.

  4. Leia os termos da Vertex AI para Pesquisa em E-commerce para uso de dados para uso de dados e clique em Aceitar se você concordar com os termos de uso de dados. Você vai receber uma confirmação do Google Cloud console quando os termos forem aceitos para a pesquisa.

  5. Se você 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 em Ativar na página Ativar pesquisa (opcional).
    2. Clique em Começar.

    O Google Cloud console mostra os componentes da AI Commerce Search que você ativou. Agora você pode configurar as configurações iniciais do projeto.

Para um projeto atual

Para continuar em um projeto atual, siga estas etapas:

  1. Acesse a página AI Commerce Search in Gemini Enterprise for Customer Experience no Google Cloud console do seu projeto.

    Acessar a página AI Commerce Search in Gemini Enterprise for Customer Experience

  2. Na página Termos de uso de dados, leia os termos de uso de dados das Soluções de Descoberta e clique em Aceitar se você concordar com os termos.

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

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

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

Desativar recursos de pesquisa

Se você não quiser mais usar a pesquisa, desative-a enviando um tíquete de suporte.

Para definir o tíquete para o componente correto, selecione os seguintes campos:

  • Categoria: aprendizado de máquina
  • Componente: AI Commerce Search: pesquisa e navegação
  • Subcomponente: administração de contas e faturamento

Para mais informações sobre como criar um tíquete de suporte, consulte Como receber suporte.

Desativar a AI Commerce Search

Você pode desativar a AI Commerce Search a qualquer momento. Isso desativa as recomendações e a pesquisa.

Para desativar a AI Commerce Search, siga estas etapas:

  1. Acesse a página AI Commerce Search API /Service Details no Google Cloud console.

    Acessar a página de detalhes do serviço da API AI Commerce Search

  2. Clique em Desativar API.

  3. Na caixa Desativar a API AI Commerce Search?, clique em Desativar.

Começar a usar a AI Commerce Search

Ao configurar a AI Commerce Search para um novo projeto, o Google Cloud console mostra os três painéis a seguir para ajudar você a configurar o projeto da AI Commerce Search:

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

  • Dados > Eventos: mostra os eventos do usuário e um link para importar eventos históricos do usuário.

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

Você pode usar esses painéis para importar seus dados e criar uma configuração inicial para o projeto da AI Commerce Search.

Importar seu catálogo de produtos

Para importar o catálogo de produtos, siga as etapas da sua fonte de dados. Para mais informações sobre catálogos de produtos, consulte Importar informações do catálogo.

Sincronização com o Merchant Center

  1. Clique em Importar catálogo de produtos para abrir o painel Importar dados.
  2. Escolha Catálogo de produtos.
  3. Selecione Merchant Center Sync como sua fonte de dados.
  4. Selecione sua conta do Merchant Center. Verifique o acesso do usuário se você não encontrar sua conta.
  5. Opcional: selecione Filtro de feeds do Merchant Center para importar apenas ofertas de feeds selecionados.

    Se não for especificado, as ofertas de todos os feeds serã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 e idiomas de venda do Merchant Center para filtrar.
  7. Selecione a ramificação para fazer o upload do 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 sua fonte de dados.
  3. Selecione a ramificação para fazer o upload do catálogo.
  4. Escolha Esquema de catálogos de produtos de varejo como o esquema.
  5. Insira o local dos seus dados no Cloud Storage.
  6. Se você não tiver a pesquisa ativada, selecione os níveis do produto.

    Você precisa selecionar os níveis do produto se esta for a primeira vez que você está importando o catálogo ou se estiver importando o catálogo novamente depois de limpá-lo. Saiba mais sobre os níveis de produto. Alterar os níveis de produto depois de importar todos os dados requer um esforço significativo.

    Importante: não é possível ativar a pesquisa para projetos com um catálogo de produtos que foi ingerido 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 sua fonte de dados.
  4. Selecione a ramificação para fazer o upload do catálogo.
  5. Escolha um dos seguintes esquemas:
  6. Insira a tabela do BigQuery em que seus dados estão localizados.
  7. Opcional: em Mostrar opções avançadas, insira o local de um bucket do Cloud Storage no projeto como um local temporário para seus dados.

    Se não for especificado, um local padrão será usado. Caso seja especificado, os buckets do BigQuery e do Cloud Storage precisam estar na mesma região.
  8. Se você não tiver a pesquisa ativada e estiver usando o esquema do Merchant Center, selecione o nível do produto.

    Você precisa selecionar o nível do produto se esta for a primeira vez que você está importando o catálogo ou se estiver importando o catálogo novamente depois de limpá-lo. Saiba mais sobre os níveis de produto. Alterar os níveis de produto depois de importar todos os dados requer um esforço significativo.

    Importante: não é possível ativar a pesquisa para projetos com um catálogo de produtos que foi ingerido como variantes.
  9. Clique em Importar.

Importar eventos históricos do usuário

Para importar eventos históricos do usuário, siga as etapas da sua fonte de dados. Para mais informações sobre eventos históricos do usuário, consulte Importar eventos históricos do usuário.

Cloud Storage

  1. Clique em Importar eventos do usuário para abrir o painel Importar dados.
  2. Escolha Eventos do usuário.
  3. Selecione Google Cloud Storage como a fonte de dados.
  4. Escolha Esquema de eventos do usuário de varejo como o esquema.
  5. Insira o local dos seus dados no Cloud Storage.
  6. Clique em Importar.

BigQuery

  1. Clique em Importar eventos do usuário para abrir o painel Importar dados.
  2. Escolha Eventos do usuário.
  3. Selecione BigQuery como a fonte de dados.

  4. Selecione o esquema de dados.

  5. Insira a tabela do BigQuery em que seus dados estão localizados.
  6. Opcional: insira o local de um bucket do Cloud Storage no projeto como um local temporário para seus dados.
    Se não for especificado, um local padrão será usado. Caso seja especificado, os buckets do BigQuery e do Cloud Storage precisam estar na mesma região.
  7. Opcional: em Mostrar opções avançadas, insira o local de um bucket do Cloud Storage no projeto como um local temporário para seus dados.

    Se não for especificado, um local padrão será usado. Caso seja especificado, os buckets do BigQuery e do Cloud Storage precisam estar na mesma região.
  8. Clique em Importar.

Criar uma configuração 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.

Para criar uma configuração de exibição, siga estas etapas:

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

    O nome precisa ter 1.024 caracteres ou menos e pode conter apenas caracteres alfanuméricos, sublinhados, hífens e espaços.
  4. Opcional: se necessário, atualize o ID.

    O ID é gerado a partir do nome fornecido e precisa ser exclusivo em todo o projeto. Ele precisa ter até 50 caracteres e não pode conter espaços.
  5. Clique em Continuar.
  6. Escolha se quer ativar o atributo dinâmico para essa configuração de exibição.
  7. Escolha ou crie controles de veiculação para otimizar suas pesquisas.

    Para mais informações sobre controles, consulte Criar e gerenciar controles.

Gerenciar recursos e monitorar atividades

Quando você concluir a configuração inicial do projeto, o Google Cloud painel do console vai mostrar o estado do sistema do projeto da AI Commerce Search. O painel do console permite gerenciar recursos e monitorar atividades.

Acessar o console da AI Commerce Search in Gemini Enterprise for Customer Experience

Criar uma chave de API

Uma chave de API é necessária se você usar um pixel JavaScript ou uma tag do Gerenciador de tags para capturar eventos do usuário dos navegadores dos usuários. Para mais informações sobre como capturar eventos do usuário, consulte Gravar eventos do usuário em tempo real.

Para criar uma chave de API para chamadas ao userEvents.Collect método, siga estas etapas:

  1. Acesse a Google Cloud página Credenciais do console.

  2. Na lista suspensa do projeto, na parte de cima da página do Google Cloud console, selecione o projeto (o projeto já pode estar selecionado).

  3. Clique em Criar credenciais e, em seguida, selecione Chave de API. Não adicione restrições de aplicativos da Web. Algumas configurações de privacidade do usuário costumam não passar o URL referenciador.

    • Anote a chave de API gerada, que será usada ao chamar o registro de eventos do usuário.

  4. Para reforçar a segurança, adicione uma restrição de API à sua chave de API para restringir o acesso ao serviço AI Commerce Search em https://retail.googleapis.com/*.

A seguir