Configurar pré-requisitos

Antes de configurar a Vertex AI para Pesquisa para varejo em um novo projeto, você precisa:

  1. Crie um novo projeto ou configure o projeto atual
  2. Ativar a Vertex AI para Pesquisa para varejo
  3. Importar seu catálogo de produtos e eventos do usuário

Criar um projeto do Google Cloud

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

    Acessar a página "Gerenciar recursos"

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

Configurar a Vertex AI para Pesquisa para varejo

Para usar a Vertex AI para Pesquisa para varejo, siga estas etapas. Além disso, se você ativar a Vertex AI Search para varejo e usar recomendações, saiba que os custos são baseados no número de consultas. Para mais informações sobre os preços da Vertex AI para Pesquisa para varejo, consulte Custos da Vertex AI para Pesquisa para varejo.

Para seu novo projeto

Para configurar a Vertex AI para Pesquisa para varejo:

  1. Acesse a página Vertex AI Search for retail no console do Google Cloud.

    Acessar a página "Pesquisa de varejo"

  2. Na página Configurar a Vertex AI para Pesquisa para varejo, clique em Ativar a API.

  3. Quando a Vertex AI para Pesquisa para varejo e a Recommendations AI aparecerem como Ativado, clique em Continuar.

  4. Leia os termos de uso de dados da Vertex AI para Pesquisa para indústria e clique em Aceitar se concordar com eles. Você vai receber uma confirmação do console do Google Cloud quando os termos forem aceitos para 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 a pesquisa (opcional).
    2. Clique em Primeiros passos.

    O console do Google Cloud mostra os componentes da Vertex AI para Pesquisa de varejo que você ativou. Agora você pode configurar as configurações iniciais do projeto.

Para um projeto atual

Para continuar em um projeto existente, siga estas etapas:

  1. Acesse a página Pesquisar para varejo no console do Google Cloud do seu projeto.

    Acessar a página "Pesquisa de varejo"

  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 concordar com eles.

  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 a pesquisa (opcional).
    2. Clique em Primeiros passos.

Desativar recursos de pesquisa

Se você não quiser mais usar a pesquisa, envie um tíquete de suporte para desativá-la.

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

  • Categoria: aprendizado de máquina
  • Componente: Vertex AI para Pesquisa para varejo: pesquisar e navegar
  • Subcomponente: administração e faturamento da conta

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

Desative a Vertex AI para Pesquisa para varejo

Você pode desativar a Vertex AI para Pesquisa para Retail a qualquer momento. Isso desativa as recomendações e a pesquisa.

Para desativar a Vertex AI para Pesquisa para varejo, siga estas etapas:

  1. Acesse a página Detalhes da API/serviço da Vertex AI Search for Retail no console do Google Cloud.

    Acesse a página "Detalhes do serviço da API Vertex AI para Pesquisa para varejo"

  2. Clique em Desativar API.

  3. Na caixa Desativar a API Vertex AI para Pesquisa para varejo?, clique em Desativar.

Introdução à Vertex AI para Pesquisa no varejo

Quando você configura a Vertex AI para Pesquisa para varejo em um novo projeto, o console do Google Cloud mostra os três painéis a seguir para ajudar a configurar seu projeto da Vertex AI para Pesquisa para varejo:

  • Dados > Catálogo: mostra seu catálogo de produtos e um link para importá-lo.

  • Dados > Eventos: mostra seus 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.

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

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 Como importar informações de 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 Acesso do usuário se 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, abra Mostrar opções avançadas e selecione os países de venda e os 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 a 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 a pesquisa não estiver 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 você 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 a 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, o bucket do BigQuery e do Cloud Storage precisam estar na mesma região.
  8. Se a pesquisa não estiver ativada e você estiver usando o esquema do Merchant Center, selecione o nível do produto.

    Selecione 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 o 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 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 seu 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, o bucket do BigQuery e do Cloud Storage precisam estar na mesma região.
  8. Clique em Importar.

Criar uma configuração de veiculação

Uma config 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 recomendação.

Para criar uma configuração de veiculaçã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 exibição, escolha Pesquisa como o produto em que a configuração de exibição será usada.
  3. Dê um nome à 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 com base no 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 painel do console do Google Cloud vai mostrar o estado do sistema do seu projeto da Vertex AI Search for Retail. O painel do console permite gerenciar recursos e monitorar a atividade.

Acessar o console da Pesquisa para varejo

crie uma chave de API

Uma chave de API é necessária se você usa um pixel JavaScript ou uma tag do Gerenciador de tags para capturar eventos do usuário nos navegadores deles. 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 para o método userEvents.Collect, siga estas etapas:

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

  2. Na lista suspensa do projeto, na parte de cima da página do console do Google Cloud, selecione seu projeto (ele 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 não transmitem o URL de referência.

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

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

A seguir