Antes de começar

Criar um projeto do Google Cloud

  1. Na página Gerenciar recursos no console do Google Cloud, selecione ou criar 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 Retail

Para usar a Vertex AI para Pesquisa para Retail, além das recomendações, você precisa ativar na Vertex AI para Pesquisa para Retail e aceitem Vertex AI para Pesquisa para termos do setor sobre dados usar. Se você também usa a pesquisa, precisa ativá-la. O uso da pesquisa incorre em custos adicionais com base em o número de consultas. Para mais informações, consulte Pesquisa cobranças.

Para configurar a Vertex AI para Pesquisa para Retail, siga estas etapas:

  1. Acesse a página da Vertex AI para Pesquisa para varejo no console do Google Cloud.

    Acessar a página "Pesquisa de varejo"

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

  3. Quando Vertex AI para Pesquisa para Retail e Recommendations AI aparecem como Ativado, clique Continuar.

  4. Leia os Termos da Vertex AI para Pesquisa para o setor para uso de dados e clique em Aceitar se concordar com os termos de uso de dados.

    Quando você aceita os termos de uso de dados, o console do Google Cloud indica que os termos de uso da Vertex AI para Pesquisa para Retail sejam aceitos.

  5. Se você quiser usar o projeto apenas com recomendações, clique em Primeiros passos.

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

    1. Clique em Continuar e depois em Ativar no botão Ativar Search (opcional).
    2. Clique em Primeiros passos.

O console do Google Cloud exibe os componentes da Vertex AI para Pesquisa para varejo que que você tenha ativado. Agora é possível defina as configurações iniciais do seu projeto.

Configurar para um projeto atual

Se você configurar a Vertex AI para Pesquisa para Retail em um projeto do Google Cloud antes do de uso de dados entrarem em vigor em 4 de abril de 2022, é necessário aceite os termos da Vertex AI para Pesquisa para o setor para continuar usando a Vertex AI para Pesquisa para Retail com esse projeto. Você também precisa ativar a pesquisa para esse projeto, se obrigatórios.

Para aceitar os termos da Vertex AI para Pesquisa para o setor de um projeto atual, preencha as seguintes etapas:

  1. Acesse a página Pesquisa de 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 as Soluções de descoberta de uso de dados e clique em Aceitar se você concordar com eles.

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

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

    1. Clique em Continuar e depois em Ativar no botão Ativar Search (opcional).
    2. Clique em Primeiros passos.

Desativar a pesquisa ou a Vertex AI para Pesquisa para Retail

Desativar a pesquisa

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

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

  • Categoria: aprendizado de máquina
  • Componente: Vertex AI para Pesquisa para Retail: pesquisa e navegar
  • Subcomponente: administração da conta e Faturamento

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

Desativar a Vertex AI para Pesquisa para Retail

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

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

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

    Acesse a página de detalhes de 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 Retail?, clique em Desativar.

.

Introdução à Vertex AI para Pesquisa para Retail

Quando você configura a Vertex AI para Pesquisa para Retail em um novo projeto, O console do Google Cloud exibe os três painéis a seguir para ajudar você a configurar Projeto da Vertex AI para Pesquisa para Retail:

  • Dados > Catálogo: mostra seu catálogo de produtos e um link para importação. seu catálogo.

  • Dados > Eventos: exibe os eventos do usuário e um link para importação. eventos históricos do usuário.

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

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

Importar seu catálogo de produtos

Para importar o catálogo de produtos, conclua as etapas referentes à 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 o filtro de feeds do Merchant Center para importar somente ofertas de feeds selecionados.

    Se essa opção não for especificada, as ofertas de todos os feeds serão importadas, incluindo feeds futuros.
  6. Opcional: para importar somente 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 que você quer 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 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.

    Você precisa selecione os níveis do produto se esta for a primeira vez que você importa seu catálogo ou se estiver reimportar o catálogo depois de limpá-lo. Saiba mais. sobre os níveis dos produtos. Alterando níveis de produto após a importação dos dados exige um esforço significativo.

    Importante:não é possível ativar a pesquisa de projetos com do 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, digite a localização de um bucket do Cloud Storage no projeto como um local temporário para os dados.

    Se não for especificado, um local padrão será usado. Se especificado, as instâncias do BigQuery O bucket do Cloud Storage precisa estar na mesma região.
  8. Se a pesquisa não estiver ativada e você estiver usando esquema do Merchant Center, selecione o nível do produto.

    Você precisa selecione o nível do produto se esta for a primeira vez que você importa seu catálogo ou se estiver reimportar o catálogo depois de limpá-lo. Saiba mais. sobre os níveis dos produtos. Alterando níveis de produto após a importação dos dados exige um esforço significativo.

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

Importar o histórico de eventos do usuário

Para importar o histórico de eventos do usuário, conclua as etapas da sua fonte de dados. Para mais informações sobre os eventos históricos do usuário, consulte Como 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 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 em seu projeto como um local temporário para seus dados.
    Se não for especificado, um local padrão é usados. Se especificado, os buckets do BigQuery e do Cloud Storage na mesma região.
  7. Opcional: em Mostrar opções avançadas, digite a localização de um bucket do Cloud Storage no projeto como um local temporário para os dados.

    Se não for especificado, um local padrão será usado. Se especificado, as instâncias do BigQuery O bucket do Cloud Storage precisa estar na mesma região.
  8. Clique em Importar.

Criar uma configuração de veiculação

Uma configuração de veiculação é uma entidade de exibição que associa um modelo ou um conjunto de controles que são usados para gerar seus resultados de pesquisa ou recomendação.

Para criar uma configuração de veiculação, conclua as etapas a seguir:

  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 da configuração de exibição será usado.
  3. Forneça um nome para sua configuração de exibição.

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

    Ele é gerado com base no nome fornecido e precisa ser único em seu projeto. Deve ser 50 caracteres ou menos e não pode conter espaços.
  5. Clique em Continuar.
  6. Escolha se você quer ativar os atributos dinâmicos 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 Como criar e gerenciar controles.

O painel

Quando você concluir a configuração inicial do projeto, o O Search for Retail mostra o estado do sistema do Projeto da Vertex AI para Pesquisa para Retail. O console permite gerenciar recursos e e monitorar a atividade.

Acesse o console do Search for Retail

Criar uma chave de API

É necessário ter uma chave de API para usar um pixel JavaScript ou uma tag do Gerenciador de tags para capturar eventos dos usuários navegadores da Web. Para mais informações sobre maneiras de capturar eventos do usuário. Consulte Registrar eventos do usuário em tempo real.

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

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

  2. No menu suspenso do projeto na parte de cima da página do console do Google Cloud, selecione seu projeto (o projeto pode já estar selecionado).

  3. Clique em Criar credenciais e, em seguida, selecione Chave de API. Não adicione restrições de aplicativos de sites. Um pouco de privacidade do usuário as configurações não transmitem o URL do referenciador.

    • Anote a chave de API gerada, que você usa ao chamar a geração de registros de eventos do usuário.

  4. Para reforçar a segurança, adicione um Restrição de API à sua chave de API para restringir o acesso ao serviço Vertex AI para Pesquisa para Retail às https://retail.googleapis.com/*.

.

A seguir