Configurar pré-requisitos

Antes de configurar a Pesquisa em E-commerce com IA para um novo projeto, você precisa:

1. Criar um projeto ou configurar um projeto atual
2. Ativar a Pesquisa em E-commerce com IA
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 Pesquisa em E-commerce com IA

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

**Importante**: aceite os termos da Vertex AI para Pesquisa em E-commerce para todos os projetos em que você quiser usar a Pesquisa em E-commerce com IA.

Para seu novo projeto

Para configurar a Pesquisa em E-commerce com IA:

1. Acesse a página Pesquisa em E-commerce com IA no Google Cloud console.

   Acessar a página Pesquisa em E-commerce com IA no Gemini Enterprise for Customer Experience

2. Na página Configurar a Pesquisa em E-commerce com IA, clique em Ativar API.

3. Quando Pesquisa em E-commerce com IA e Recommendations AI aparecerem como Ativado, clique em Continuar.

4. Leia os termos da Vertex AI para Pesquisa em E-commerce sobre o 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 depois em Ativar na página Ativar pesquisa (opcional).
   2. Clique em Começar.

   O Google Cloud console mostra os componentes da Pesquisa em E-commerce com IA 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 Pesquisa em E-commerce com IA no Gemini Enterprise for Customer Experience no Google Cloud console do seu projeto.

   Acessar a página Pesquisa em E-commerce com IA no 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 depois em Ativar na página Ativar pesquisa (opcional).
   2. Clique em Começar.

**Importante**: verifique se você tem o papel de administrador ou proprietário do Retail no seu projeto antes de aceitar os termos de uso de dados.

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: Pesquisa em E-commerce com IA: 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 Pesquisa em E-commerce com IA

Você pode desativar a Pesquisa em E-commerce com IA a qualquer momento. Isso desativa as recomendações e a pesquisa.

Para desativar a Pesquisa em E-commerce com IA, siga estas etapas:

1. Acesse a página API /Detalhes do serviço da Pesquisa em E-commerce com IA no Google Cloud console.

   Acessar a página de detalhes do serviço da API Pesquisa em E-commerce com IA

2. Clique em Desativar API.

3. Na caixa Desativar a API Pesquisa em E-commerce com IA?, clique em Desativar.

Observação: quando você desativa a API Pesquisa em E-commerce com IA, leva várias horas para que os termos da Vertex AI para Pesquisa em E-commerce sobre o uso de dados sejam desativados para o projeto.

Começar a usar a Pesquisa em E-commerce com IA

Ao configurar a Pesquisa em E-commerce com IA para um novo projeto, o Google Cloud console mostra os três painéis a seguir para ajudar você a configurar o projeto:

• 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 Pesquisa em E-commerce com IA.

Importar o catálogo de produtos

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

**Descontinuado** :o conector do Merchant Center foi descontinuado e está disponível apenas para usuários atuais. Novos usuários precisam usar a API Catalog ou o BigQuery para importar catálogos.

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 Sincronização com o Merchant Center como sua origem 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 de venda e idiomas 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 origem 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.
   
   É necessário 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 origem de dados.
4. Selecione a ramificação para fazer o upload do catálogo.
5. Escolha um dos seguintes esquemas:
   • Esquema de catálogos de produtos de varejo: o esquema de produtos para a Pesquisa em E-commerce com IA
   • Merchant Center: o esquema usado para importação em massa do Merchant Center
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.
   
   É necessário 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 o conjunto de etapas da sua origem de dados. Para mais informações sobre eventos históricos do usuário, consulte Importar eventos históricos do usuário.

Observação: também é possível gravar eventos do usuário em tempo real para gerar recomendações e resultados de pesquisa. Para mais informações, consulte Gravar eventos do usuário em tempo real.

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 origem 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 origem de dados.

4. Selecione o esquema de dados.

   • Google Analytics 4: use para eventos do Google Analytics 4.
   • Google Analytics 360: use para eventos do Google Analytics 360, a menos que você esteja importando eventos apenas de visualizações de página inicial do Google Analytics 360 (nesse caso, use o Esquema de eventos do usuário de varejo).
   • Esquema de eventos do usuário de varejo: use para importar eventos de origens diferentes do Google Analytics e para importar eventos apenas de visualizações de página inicial do Google Analytics 360.
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.

**Observação**: a Pesquisa em E-commerce com IA cria uma configuração de veiculação padrão. Portanto, esse procedimento é opcional se você quiser criar uma configuração de veiculação personalizada.

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 Pesquisa em E-commerce com IA. O painel do console permite gerenciar recursos e monitorar atividades.

Acessar o console da Pesquisa em E-commerce com IA no 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 aplicativo de site. 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 da Pesquisa em E-commerce com IA em https://retail.googleapis.com/*.

Observação: a chave de API é apenas para autenticar o método userEvents.Collect. Outros métodos de API exigem o OAuth 2.0 por meio de uma conta de serviço ou de usuário.

A seguir

• Restringir chaves de API
• Autenticar na Pesquisa em E-commerce com IA
• Identity and Access Management (IAM)
• Implementar a Pesquisa em E-commerce com IA