Diese Seite wurde von der Cloud Translation API übersetzt.

Bisherige Nutzerereignisse importieren

Auf dieser Seite wird gezeigt, wie Sie Nutzerereignisdaten aus früheren Ereignissen im Bulk importieren. Für Medienempfehlungen sind Nutzerereignisse erforderlich. Wenn Sie keine Medienempfehlungen verwenden, ist der Import von Nutzerereignissen nicht erforderlich. Für Apps für Mediensuchen wird sie jedoch empfohlen.

Die importierbaren Nutzerereignistypen finden Sie im Feld eventType des Objekts userEvents. Wenn Sie Nutzerereignisse importieren, können Sie die Qualität Ihrer Empfehlungen sowie das Ranking Ihrer Suchergebnisse verbessern. Suchergebnisse mit höheren Klickraten werden hervorgehoben, während Ergebnisse mit niedrigeren Klickraten weniger gut sichtbar sind. Importieren Sie keine Nutzerereignisse für Dokumente, die Sie noch nicht importiert haben.

Wenn für ein Ereignis Dokumente in userEvents.Documents aufgeführt sind, werden sie in Vertex AI Search automatisch mit dem Ereignis verknüpft. Durch das Zusammenführen können Ereignisse wie Klicks und Aufrufe in Vertex AI Search dem richtigen Dokument in einem Suchergebnis oder einer Empfehlung zugeordnet werden. Bei Apps mit generischen Anwendungsfällen erfolgt die Zusammenführung asynchron, d. h., Nutzerereignisse werden erst nach Abschluss des Batch-Imports mit Dokumenten verknüpft (in der Regel innerhalb weniger Minuten). Bei Medien-Apps erfolgt die Zusammenführung synchron. Vertex AI Search beginnt damit, Nutzerereignisse mit Dokumenten zu verknüpfen, während der Batchimport noch läuft. Informationen zum Aufrufen von Messwerten für nicht verbundene Ereignisse in der Konsole finden Sie unter Zusammengefasste Nutzerereignisinformationen ansehen.

Informationen zum Importieren von Nutzerereignissen in Echtzeit finden Sie unter Nutzerereignisse in Echtzeit aufzeichnen.

Sie haben folgende Möglichkeiten, bisherige Ereignisse zu importieren:

Über Cloud Storage
Über BigQuery
Als lokale JSON-Daten

Die JSON-Darstellung für Nutzerereignisse finden Sie in der API-Referenz unter userEvents.

Hinweise

Bevor Sie Nutzerereignisse importieren, ist Folgendes zu beachten:

Erstellen Sie einen Datenspeicher und eine App.
Informationen zu den Anforderungen an Nutzerereignisse finden Sie unter Nutzerereignisse.

Bisherige Nutzerereignisse aus Cloud Storage importieren

Wenn Sie eine Medien-App haben, können Sie Nutzerereignisse über die Google Cloud Console oder die API importieren. Andere App-Typen können nur über die API importiert werden.

Console

So importieren Sie Nutzerereignisse für Medien-Apps über die Console:

Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

Zum Agent Builder
Klicken Sie auf der Seite Apps auf Ihre Medien-App.
Rufen Sie die Seite Daten auf.

Bei Apps für Medienempfehlungen werden auf dem Tab Anforderungen die Mediendokumente und Nutzerereignisse angezeigt, die Sie importieren müssen.
Klicken Sie auf den Tab Events (Ereignisse). Wenn Sie bereits Ereignisse importiert haben, werden auf diesem Tab Informationen zu diesen Ereignissen angezeigt.
Klicken Sie auf Ereignisse importieren.
Wählen Sie Cloud Storage als Datenquelle aus.
Geben Sie den Cloud Storage-Speicherort Ihrer Nutzerereignisse ein oder wählen Sie ihn aus.
Klicken Sie auf Importieren.
Auf dem Tab Aktivität wird der Status des Imports angezeigt.
Wenn Importfehler auftreten, gehen Sie auf dem Tab Aktivität so vor:
1. Maximieren Sie den Fehler in der Spalte Details und klicken Sie auf Details anzeigen, um weitere Informationen im Bereich Aktivitätsprotokolldetails aufzurufen.
2. Klicken Sie im Bereich Details zum Aktivitätsprotokoll auf Vollständige Fehlerprotokolle ansehen, um den Fehler im Log-Explorer aufzurufen.

REST

So importieren Sie Verlaufsnutzerereignisse im Bulk-Verfahren aus Cloud Storage:

Erstellen Sie eine oder mehrere Datendateien für die Eingabeparameter für den Import. Verwenden Sie das Objekt gcsSource, um auf Ihren Cloud Storage-Bucket zu verweisen.
```
{
"gcsSource": {
  "inputUris": ["INPUT_FILE_1", "INPUT_FILE_2"],
  "dataSchema": "user_event"
  },
  "errorConfig":{
      "gcsPrefix":"ERROR_DIRECTORY"
  }
}
```
- INPUT_FILE: Eine Datei in Cloud Storage, die Ihre Nutzerereignisdaten enthält. Jedes Nutzerereignis muss sich in einer eigenen Zeile ohne Zeilenumbruch befinden. Die JSON-Darstellung für Nutzerereignisse finden Sie in der API-Referenz unter userEvents. Die Felder der Eingabedatei müssen das Format gs://<bucket>/<path-to-file>/ haben.
- ERROR_DIRECTORY: Optional. Ein Cloud Storage-Verzeichnis für Fehlerinformationen zum Import, z. B. gs://<your-gcs-bucket>/directory/import_errors. Wir empfehlen, dieses Feld leer zu lassen, damit Vertex AI Agent Builder automatisch ein temporäres Verzeichnis erstellt.

Importieren Sie Ihre Ereignisse, indem Sie eine POST-Anfrage an die Methode userEvents:import senden und den Namen der Datendatei angeben.

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"

Bisherige Nutzerereignisse aus BigQuery importieren

Verwenden Sie beim Erstellen von Tabellen für Nutzerereignisse in BigQuery die Schemas, die unter Nutzerereignisse beschrieben sind.

BigQuery-Zugriff einrichten

Wenn sich Ihr BigQuery-Dataset in einem anderen Projekt als Ihrem Datenspeicher befindet, führen Sie die folgenden Schritte aus, um den Zugriff auf BigQuery einzurichten.

Öffnen Sie in der Google Cloud Console die Seite IAM & Verwaltung.
Wählen Sie das Projekt aus, das den Datenspeicher enthält, in den Sie Nutzerereignisse importieren möchten.
Klicken Sie auf das Kästchen Von Google bereitgestellte Rollenzuweisungen einschließen.
Suchen Sie das Dienstkonto mit dem Namen Discovery Engine Service Account.
Wenn Sie noch keinen Importvorgang mit der Discovery Engine initiiert haben, ist dieses Dienstkonto möglicherweise nicht aufgeführt. Wenn dieses Dienstkonto nicht angezeigt wird, kehren Sie zur Importaufgabe zurück und initiieren den Import. Wenn der Vorgang aufgrund von Berechtigungsfehlern fehlschlägt, kehren Sie hier zurück und führen Sie diese Aufgabe aus. Das Discovery Engine-Dienstkonto wird aufgeführt.
Kopieren Sie die ID des Dienstkontos, die wie eine E-Mail-Adresse aussieht (z. B. service-525@gcp-sa-discoveryengine.iam.gserviceaccount.com).
Wechseln Sie zu Ihrem BigQuery-Projekt (auf der gleichen Seite IAM und Verwaltung) und klicken Sie auf Zugriff gewähren.
Geben Sie unter Neue Hauptkonten die Kennzeichnung für das Dienstkonto ein und wählen Sie die Rolle BigQuery > BigQuery-Datenbetrachter aus.
Klicken Sie auf Speichern.

Weitere Informationen zum BigQuery-Zugriff finden Sie unter Zugriff auf Datasets steuern in der BigQuery-Dokumentation.

Ereignisse aus BigQuery importieren

Wenn Sie eine Medien-App haben, können Sie Nutzerereignisse über die Google Cloud Console oder die API importieren. Bei anderen App-Typen ist nur der Import über die API möglich.

Console

So importieren Sie Nutzerereignisse für Medien-Apps über die Console:

Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

Zum Agent Builder
Klicken Sie auf der Seite Apps auf Ihre Medien-App.
Rufen Sie die Seite Daten auf.

Bei Apps für Medienempfehlungen werden auf dem Tab Anforderungen die Mediendokumente und Nutzerereignisse angezeigt, die Sie importieren müssen.
Klicken Sie auf den Tab Events (Ereignisse). Wenn Sie bereits Ereignisse importiert haben, werden auf diesem Tab Informationen zu diesen Ereignissen angezeigt.
Klicken Sie auf Ereignisse importieren.
Wählen Sie BigQuery als Datenquelle aus.
Geben Sie den BigQuery-Pfad für Ihre Nutzerereignisse ein oder wählen Sie ihn aus.
Klicken Sie auf Importieren.
Auf dem Tab Aktivität wird der Status des Imports angezeigt.
Wenn Importfehler auftreten, gehen Sie auf dem Tab Aktivität so vor:
1. Maximieren Sie den Fehler in der Spalte Details und klicken Sie auf Details anzeigen, um weitere Informationen im Bereich Aktivitätsprotokolldetails aufzurufen.
2. Klicken Sie im Bereich Details zum Aktivitätsprotokoll auf Vollständige Fehlerprotokolle ansehen, um den Fehler im Log-Explorer aufzurufen.

REST

So importieren Sie Verlaufsnutzerereignisse im Bulk-Verfahren aus Cloud Storage:

Importieren Sie die Nutzerereignisse, indem Sie eine POST-Anfrage an die Methode userEvents:import senden und dabei den Namen des BigQuery-Projekts, die Dataset-ID und die Tabellen-ID angeben.

Verwenden Sie beim Importieren Ihrer Ereignisse den Wert user_event für 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"
      }
    }'

Verlaufsnutzerereignisse als lokale JSON-Daten importieren

Sie können Nutzerereignisse importieren, indem Sie lokale JSON-Daten für die Ereignisse in den Aufruf der Methode userEvents:import aufnehmen.

So fügen Sie Nutzerereignisdaten in eine JSON-Datei ein und geben die Datei in einer API-Anfrage an:

Erstellen Sie eine JSON-Datei mit Ihren Nutzerereignisdaten. Die JSON-Darstellung für Nutzerereignisse finden Sie in der API-Referenzdokumentation unter userEvents.
```
{
  "inlineSource": {
    "userEvents": [
      {
        USER_EVENT_1
      },
      {
        USER_EVENT_2
      }
    ]
  }
}
```

Importieren Sie Ihre Ereignisse, indem Sie eine POST-Anfrage an die Methode userEvents:import senden und den Namen der Datendatei angeben.

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"