Importe eventos históricos do usuário

Nesta página, descrevemos como importar em massa os dados de eventos do usuário de eventos anteriores. Os eventos do usuário são necessários para apps de mídia. Se você não usa apps de mídia, não é necessário importar eventos de usuário. No entanto, é recomendável registrar eventos do usuário para apps de pesquisa personalizada e recomendações.

Para saber os tipos de eventos do usuário que podem ser importados, consulte o campo eventType do objeto userEvents. Ao importar eventos do usuário, você pode melhorar a qualidade dos resultados. Por exemplo, os eventos do usuário afetam a classificação dos resultados da pesquisa. Os resultados com taxas de cliques mais altas são promovidos, enquanto os resultados com taxas de cliques mais baixas são ocultados. Não importe eventos de usuário para documentos que ainda não foram importados.

Se um evento tiver documentos listados em userEvents.Documents, a Vertex AI Search vai associar automaticamente os eventos a esse documento. A junção permite que a Vertex AI para Pesquisa atribua eventos, como cliques e visualizações, ao documento correto em um resultado de pesquisa ou recomendação. Para apps de pesquisa personalizada e recomendações, a junção ocorre de forma assíncrona. Ou seja, os eventos do usuário são unidos aos documentos depois que a importação em lote é concluída (geralmente em minutos). Para apps de mídia, a junção ocorre de forma síncrona. A Vertex AI para Pesquisa começa a unir eventos do usuário a documentos enquanto a importação em lote ainda está em andamento. Para saber como ver métricas de eventos desconectados no console, consulte Como visualizar informações de eventos do usuário agregadas.

Se você estiver usando um app de pesquisa com vários repositórios de dados anexados, importe eventos do usuário no nível do local em vez do nível do repositório de dados. Isso permite que um determinado evento do usuário seja enviado ao repositório de dados associado a ele. Para importar eventos do usuário com documentos de diferentes dataStores no nível do local em vez do nível do repositório de dados, consulte userEvents.import.

Para importar eventos do usuário em tempo real, consulte Registrar eventos do usuário em tempo real.

É possível importar eventos históricos das seguintes maneiras:

• Do Cloud Storage
• Do BigQuery
• Como dados JSON locais

Para a representação JSON de eventos do usuário, consulte userEvents na referência da API.

Antes de começar

Antes de importar eventos do usuário:

• Crie um repositório de dados e um app.
• Consulte Sobre eventos de usuário de mídia ou Sobre eventos de usuário para saber os requisitos de eventos do usuário.

Importar eventos históricos de usuários do Cloud Storage

Se você tiver um app de mídia, poderá importar eventos do usuário usando o console ou a API Google Cloud . Para outros tipos de apps, só é possível importar usando a API.

Importar eventos históricos do usuário do BigQuery

Ao criar tabelas para eventos de usuário no BigQuery, use os esquemas documentados em Sobre eventos de usuário.

Configurar o acesso ao BigQuery

Se o conjunto de dados do BigQuery estiver em um projeto diferente do seu repositório de dados, siga estas etapas para configurar o acesso ao BigQuery.

1. Abra a página IAM e administrador no console Google Cloud .
2. Selecione o projeto que contém o repositório de dados em que você quer importar eventos do usuário.
3. Marque a caixa de seleção Incluir concessões de papel fornecidas pelo Google.
4. Encontre a conta de serviço com o nome Conta de serviço do Discovery Engine.
5. Se você ainda não iniciou uma operação de importação com o Discovery Engine, essa conta de serviço pode não estar listada. Se essa conta de serviço não for exibida, retorne à tarefa de importação e inicie a importação. Quando ela falhar devido a erros de permissão, volte aqui e conclua esta tarefa. A conta de serviço do Discovery Engine vai aparecer.
6. Copie o identificador da conta de serviço, que se parece com um endereço de e-mail, por exemplo, service-525@gcp-sa-discoveryengine.iam.gserviceaccount.com.
7. Alterne para seu projeto do BigQuery (na mesma página IAM e administrador) e clique em Conceder acesso.
8. Em Novos principais, insira o identificador da conta de serviço e selecione o papel BigQuery > Visualizador de dados do BigQuery.
9. Clique em Salvar.

Para mais informações sobre o acesso ao BigQuery, consulte Como controlar o acesso a conjuntos de dados na documentação do BigQuery.

Importar eventos do BigQuery

Se você tiver um app de mídia, poderá importar eventos do usuário usando o consoleGoogle Cloud ou a API. Para outros tipos de apps, só é possível importar usando a API.

Importar eventos históricos do usuário como dados JSON locais

É possível importar eventos do usuário incluindo dados JSON locais para os eventos na chamada ao método userEvents.import.

Para colocar dados de eventos de usuário em um arquivo JSON e especificar o arquivo em uma solicitação de API, siga estas instruções:

1. Crie um arquivo JSON com os dados de eventos do usuário. Para a representação JSON de eventos do usuário, consulte userEvents na documentação de referência da API.

   {
     "inlineSource": {
       "userEvents": [
         {
           USER_EVENT_1
         },
         {
           USER_EVENT_2
         }
       ]
     }
   }
   

2. Importe seus eventos fazendo uma solicitação POST para o método userEvents.import, fornecendo o nome do arquivo de dados.

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json; charset=utf-8" \
       --data @[JSON_FILE] \
     "https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/userEvents:import"
   

   Se você estiver importando eventos de usuário no nível do local, use o endpoint https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/userEvents:import.