Bisherige Nutzerereignisse importieren

Auf dieser Seite wird gezeigt, wie Sie Nutzerereignisdaten aus früheren Ereignissen im Bulk importieren.

Die Nutzerereignistypen, die Sie importieren können, finden Sie im Feld eventType des Objekts userEvents. Durch den Import von Nutzerereignissen können Sie die Qualität Ihrer Ergebnisse verbessern. Nutzerereignisse wirken sich beispielsweise auf das Ranking von Suchergebnissen aus. Ergebnisse mit höheren Klickraten werden hervorgehoben, während Ergebnisse mit niedrigeren Klickraten weniger prominent angezeigt werden. Importieren Sie nur Nutzerereignisse für Dokumente, die Sie bereits in Ihren Datenspeicher importiert haben.

Wenn für einen Termin Dokumente in userEvents.Documents aufgeführt sind, werden die Termine automatisch mit diesem Dokument verknüpft. Durch das Verknüpfen kann Gemini Enterprise Ereignisse wie Klicks und Aufrufe dem richtigen Dokument in einem Suchergebnis oder einer Empfehlung zuordnen. Bei benutzerdefinierten Apps für Suche und Empfehlungen erfolgt die Verknüpfung asynchron. Das bedeutet, dass Nutzerereignisse nach Abschluss des Batch-Imports mit Dokumenten verknüpft werden (in der Regel innerhalb von Minuten).

Wenn Sie eine Such-App mit mehreren verknüpften Datenspeichern verwenden, importieren Sie Nutzerereignisse auf Standort- statt auf Datenspeicherebene. So kann ein bestimmtes Nutzerereignis an den Datenspeicher gesendet werden, mit dem es verknüpft ist. Wenn Sie Nutzerereignisse mit Dokumenten aus verschiedenen dataStores auf Standortebene anstatt auf Datenspeicherebene importieren möchten, lesen Sie userEvents.import.

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

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

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

Hinweise

Vor dem Importieren von Nutzerereignissen 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

REST

So importieren Sie Verlaufsnutzerereignisse im Bulk aus Cloud Storage:

  1. 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"
  }
}

    Ersetzen Sie Folgendes:

    • 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. Google empfiehlt, dieses Feld leer zu lassen, damit Gemini Enterprise automatisch ein temporäres Verzeichnis erstellt.

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

    Wenn Sie Nutzerereignisse auf Standortebene importieren, verwenden Sie den Endpunkt https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/userEvents:import.

Bisherige Nutzerereignisse aus BigQuery importieren

Verwenden Sie beim Erstellen von Tabellen für Nutzerereignisse in BigQuery die in Nutzerereignisse dokumentierten Schemas.

BigQuery-Zugriff einrichten

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

  1. Öffnen Sie in der Google Cloud Console die Seite IAM & Verwaltung.
  2. Wählen Sie das Projekt aus, das den Datenspeicher enthält, in den Sie Nutzerereignisse importieren möchten.
  3. Klicken Sie auf das Kästchen Von Google bereitgestellte Rollenzuweisungen einschließen.
  4. Suchen Sie das Dienstkonto mit dem Namen Discovery Engine-Dienstkonto.
  5. Wenn Sie noch keinen Importvorgang mit 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.
  6. Kopieren Sie die ID des Dienstkontos, die wie eine E-Mail-Adresse aussieht (z. B. service-525@gcp-sa-discoveryengine.iam.gserviceaccount.com).
  7. Wechseln Sie zu Ihrem BigQuery-Projekt (auf der gleichen Seite IAM und Verwaltung) und klicken Sie auf Zugriff erlauben.
  8. Geben Sie für Neue Identitäten die Kennzeichnung für das Dienstkonto ein und wählen Sie die Rolle BigQuery > BigQuery-Datenbetrachter aus.
  9. Klicken Sie auf Speichern.

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

Ereignisse aus BigQuery importieren

REST

So importieren Sie Verlaufsnutzerereignisse im Bulk aus Cloud Storage:

  1. Importieren Sie die Nutzerereignisse, indem Sie eine POST-Anfrage an die Methode userEvents.import senden und 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.

    curl \
  -v \
  -X POST \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Authorization: Bearer "$(gcloud auth print-access-token)"" \
  "https://discoveryengine.googleapis.com/v1/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"
      }
    }'

    Wenn Sie Nutzerereignisse auf Standortebene importieren, verwenden Sie den Endpunkt https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/userEvents:import.

Verlaufsnutzerereignisse als lokale JSON-Daten importieren

Sie können Nutzerereignisse importieren, indem Sie lokale JSON-Daten für die Ereignisse in Ihren 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:

  1. 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
      }
    ]
  }
}

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

    Wenn Sie Nutzerereignisse auf Standortebene importieren, verwenden Sie den Endpunkt https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/userEvents:import.