Se usó la API de Cloud Translation para traducir esta página.

Importa eventos históricos de usuarios

En esta página, se describe cómo importar datos de eventos de usuario de forma masiva desde eventos anteriores. Usuario los eventos son obligatorios para las recomendaciones de contenido multimedia. Si no usas recomendaciones de contenido multimedia, no es necesario importar eventos de usuario. Sin embargo, es recomendado para las apps de búsqueda de contenido multimedia.

Para conocer los tipos de eventos del usuario que puedes importar, consulta el campo eventType de la objeto userEvents. Si importas eventos de usuario, puedes mejorar la calidad de tus recomendaciones y las clasificaciones de tus resultados de la búsqueda. Los resultados de la búsqueda con tasas de clics más altas se muestran en primer lugar, mientras que los resultados con tasas de clics más bajas se ocultan. No importes eventos de usuario para los documentos que aún no hayas importado.

Si un evento tiene documentos enumerados en userEvents.Documents, Vertex AI Search une automáticamente los eventos con ese documento. La unión permite que Vertex AI Search atribuya eventos, como clics y vistas, al documento correcto en un resultado de la búsqueda o una recomendación. Para anuncios genéricos Apps de casos de uso, la unión se realiza de forma asíncrona; es decir, los eventos de usuario se unen a los documentos una vez que se completa la importación por lotes (suele ocurrir dentro de minutos). En el caso de las apps de música, la unión se produce de forma síncrona. Vertex AI Search comienza a unir los eventos del usuario a los documentos mientras la importación por lotes aún está en curso. Para ver las métricas de los eventos no unidos en la consola, consulta Consulta la información global de los eventos de usuarios.

Para importar eventos de usuario en tiempo real, consulta Registra eventos de usuario en tiempo real.

Puedes importar los eventos históricos de las siguientes maneras:

Desde Cloud Storage
Desde BigQuery
Como datos JSON locales

Para obtener la representación JSON de los eventos de usuario, consulta userEvents en la referencia de la API.

Antes de comenzar

Antes de importar eventos de usuario, haz lo siguiente:

Crea un almacén de datos y una app.
Consulta Acerca de los eventos de usuario para conocer los requisitos de los eventos de usuario.

Importa eventos históricos de usuarios desde Cloud Storage

Si tienes una app de música, puedes importar eventos del usuario con la consola de Google Cloud o la API. En otros tipos de apps, solo puedes importar con la API.

Console

Para importar eventos de usuario de apps de música con la consola, sigue estos pasos:

En la consola de Google Cloud, ve a la página Agent Builder.

Agent Builder
En la página Apps, haz clic en tu app de música.
Ve a la página Datos.

En el caso de las apps de recomendaciones de contenido multimedia, la pestaña Requisitos muestra los documentos multimedia y los eventos del usuario que debes importar.
Haz clic en la pestaña Eventos. Si ya importaste algún evento, información sobre ellos en esta pestaña.
Haz clic en Importar eventos.
Selecciona Cloud Storage como tu fuente de datos.
Ingresa o selecciona la ubicación de Cloud Storage de tus eventos de usuario.
Haga clic en Import.
En la pestaña Actividad se muestra el estado de la importación.
Si se producen errores de importación, haz lo siguiente en la pestaña Actividad:
1. Expande el error en la columna Detalles y haz clic en Ver detalles para puedes obtener más información en el panel Detalles del registro de actividad.
2. En el panel Detalles del registro de actividad, haz clic en Ver registros de errores completos para verás el error en el Explorador de registros.

REST

Sigue estos pasos para importar eventos de usuarios históricos de forma masiva desde Cloud Storage, pasos:

Crea uno o más archivos de datos para los parámetros de entrada de la importación. Usa el objeto gcsSource para que apunte a tu bucket de Cloud Storage.
```
{
"gcsSource": {
  "inputUris": ["INPUT_FILE_1", "INPUT_FILE_2"],
  "dataSchema": "user_event"
  },
  "errorConfig":{
      "gcsPrefix":"ERROR_DIRECTORY"
  }
}
```
- INPUT_FILE: Es un archivo en Cloud Storage que contiene al usuario. los datos de eventos de la empresa. Asegúrate de que cada evento de usuario esté en su propia línea única, sin saltos de línea. Si quieres obtener información sobre la representación JSON para eventos de usuario, consulta la siguiente información: userEvents en la API referencia. Los campos del archivo de entrada deben tener el siguiente formato: gs://<bucket>/<path-to-file>/
- ERROR_DIRECTORY: Opcional Un directorio de Cloud Storage para obtener información sobre los errores de la importación (por ejemplo, gs://<your-gcs-bucket>/directory/import_errors). Google recomienda dejar este campo vacío para permitir que Vertex AI Agent Builder cree automáticamente un directorio temporal.

Importa tus eventos realizando una solicitud POST al userEvents:import, que proporciona el nombre de la en un archivo de datos.

export GOOGLE_APPLICATION_CREDENTIALS=/tmp/my-key.json

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

Importa eventos de usuario históricos desde BigQuery

Cuando crees tablas para eventos de usuario en BigQuery, usa los esquemas según se indica en Acerca de los eventos de usuario.

Configura el acceso a BigQuery

Si tu conjunto de datos de BigQuery está en un proyecto diferente al de tu y almacén de datos de Google, sigue estos pasos para configurar el acceso a BigQuery.

Abre la página IAM y administración en la consola de Google Cloud.
Selecciona el proyecto que contiene el almacén de datos que quieres importar al usuario eventos.
Selecciona la casilla de verificación Incluir asignaciones de funciones proporcionadas por Google.
Busca la cuenta de servicio con el nombre Cuenta de servicio de Discovery Engine.
Si no iniciaste una operación de importación con Discovery Engine, es posible que esta cuenta de servicio no aparezca en la lista. Si no ves esta cuenta de servicio, regresa a la tarea de importación para iniciar la importación. Cuando falle debido a errores de permisos, regresa aquí y completa esta tarea. Se mostrará la cuenta de servicio de Discovery Engine.
Copia el identificador para la cuenta de servicio, que se parece a una dirección de correo electrónico (por ejemplo, service-525@gcp-sa-discoveryengine.iam.gserviceaccount.com).
Cambia a tu proyecto de BigQuery (en la misma página de IAM y administración). y haz clic en Otorgar acceso.
En Principales nuevos, ingresa el identificador de la cuenta de servicio y selecciona el rol BigQuery > Visualizador de datos de BigQuery.
Haz clic en Guardar.

Para obtener más información sobre el acceso a BigQuery, consulta Controla el acceso a los conjuntos de datos en la documentación de BigQuery.

Importa eventos desde BigQuery

Si tienes una app de música, puedes importar eventos del usuario con la consola de Google Cloud o la API. En el caso de otros tipos de apps, solo puedes realizar la importación con la API.

Console

Para importar eventos de usuario de apps de música con la consola, sigue estos pasos:

En la consola de Google Cloud, ve a la página Agent Builder.

Agent Builder
En la página Apps, haz clic en tu app de música.
Ve a la página Datos.

En el caso de las apps de recomendaciones de contenido multimedia, la pestaña Requisitos muestra los documentos multimedia y los eventos del usuario que debes importar.
Haz clic en la pestaña Eventos. Si ya importaste algún evento, información sobre ellos en esta pestaña.
Haz clic en Importar eventos.
Selecciona BigQuery como tu fuente de datos.
Ingresa o selecciona la ruta de BigQuery para tus eventos de usuario.
Haga clic en Import.
En la pestaña Actividad se muestra el estado de la importación.
Si se producen errores de importación, haz lo siguiente en la pestaña Actividad:
1. Expande el error en la columna Detalles y haz clic en Ver detalles para puedes obtener más información en el panel Detalles del registro de actividad.
2. En el panel Detalles del registro de actividad, haz clic en Ver registros de errores completos para verás el error en el Explorador de registros.

REST

Sigue estos pasos para importar eventos de usuarios históricos de forma masiva desde Cloud Storage, pasos:

Importa tus eventos de usuario mediante una solicitud POST al userEvents:import, que proporciona el nombre de la Proyecto de BigQuery, ID del conjunto de datos y, también, ID de la tabla.

Cuando importes tus eventos, usa el valor user_event para dataSchema.

export GOOGLE_APPLICATION_CREDENTIALS=/tmp/my-key.json

curl \
  -v \
  -X POST \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Authorization: Bearer "$(gcloud auth print-access-token)"" \
  "https://discoveryengine.googleapis.com/v1beta/projects/[PROJECT_NUMBER]/locations/global/dataStores/DATA_STORE_ID/userEvents:import" \
  --data '{
      "bigquerySource": {
          "projectId":"PROJECT_ID",
          "datasetId": "DATASET_ID",
          "tableId": "TABLE_ID",
          "dataSchema": "user_event"
      }
    }'

Importa eventos históricos de usuarios como datos JSON locales

Puedes importar eventos de usuario si incluyes datos JSON locales para los eventos en tu llamada al método userEvents:import.

Para colocar datos de eventos de usuario en un archivo JSON y especificar el archivo en una solicitud a la API, haz lo siguiente: sigue estas instrucciones:

Crea un archivo JSON que contenga los datos de tus eventos de usuario. Para obtener la representación JSON de los eventos del usuario, consulta userEvents en la documentación de referencia de la API.
```
{
  "inlineSource": {
    "userEvents": [
      {
        USER_EVENT_1
      },
      {
        USER_EVENT_2
      }
    ]
  }
}
```

Para importar tus eventos, realiza una solicitud POST al método userEvents:import y proporciona el nombre del archivo de datos.

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/v1beta/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/userEvents:import"