Bisherige Nutzerereignisse importieren

Auf dieser Seite wird gezeigt, wie Sie Nutzerereignisdaten aus früheren Ereignissen im Bulk importieren. Nutzerereignisse sind für Media-Apps erforderlich. Wenn Sie keine Media-Apps verwenden, ist der Import von Nutzerereignissen nicht erforderlich. Für Apps mit benutzerdefinierten Such- und Empfehlungsfunktionen wird jedoch empfohlen, Nutzerereignisse aufzuzeichnen.

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 sichtbar sind. 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 KI-Anwendungen automatisch mit diesem Dokument verknüpft. Durch das Verknüpfen können KI-Anwendungen 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). Bei Media-Apps erfolgt die Verknüpfung synchron. Bei KI-Anwendungen werden Nutzerereignisse mit Dokumenten verknüpft, während der Batch-Import noch läuft. Informationen dazu, wie Sie nicht verknüpfte Ereignismesswerte in der Konsole aufrufen, finden Sie unter Zusammengefasste Nutzerereignisinformationen ansehen.

Wenn Sie eine Such-App mit mehreren verknüpften Datenspeichern verwenden, importieren Sie Nutzerereignisse auf Standortebene statt auf Datenspeicherebene. So kann ein bestimmtes Nutzerereignis an den zugehörigen Datenspeicher gesendet werden. 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:

Bisherige Nutzerereignisse aus Cloud Storage importieren

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

Console

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

  1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

    KI-Anwendungen

  2. Klicken Sie auf der Seite Apps auf Ihre Media-App.

  3. 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.

  4. Klicken Sie auf den Tab Events (Ereignisse). Wenn Sie bereits Ereignisse importiert haben, werden Informationen dazu auf diesem Tab angezeigt.

  5. Klicken Sie auf Ereignisse importieren.

  6. Wählen Sie Cloud Storage als Datenquelle aus.

  7. Geben Sie den Cloud Storage-Speicherort Ihrer Nutzerereignisse ein oder wählen Sie ihn aus.

  8. Klicken Sie auf Importieren.

  9. Auf dem Tab Aktivität wird der Status des Imports angezeigt.

  10. 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 ansehen, um weitere Informationen im Bereich Details zum Aktivitätsprotokoll aufzurufen.

    2. Klicken Sie im Bereich Details zum Aktivitätslog auf Vollständige Fehlerlogs ansehen, um den Fehler im Log-Explorer aufzurufen.

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 AI Applications 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 hierher 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 Hauptkonten 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

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

Console

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

  1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

    KI-Anwendungen

  2. Klicken Sie auf der Seite Apps auf Ihre Media-App.

  3. 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.

  4. Klicken Sie auf den Tab Events (Ereignisse). Wenn Sie bereits Ereignisse importiert haben, werden Informationen dazu auf diesem Tab angezeigt.

  5. Klicken Sie auf Ereignisse importieren.

  6. Wählen Sie BigQuery als Datenquelle aus.

  7. Geben Sie den BigQuery-Pfad für Ihre Nutzerereignisse ein oder wählen Sie ihn aus.

  8. Klicken Sie auf Importieren.

  9. Auf dem Tab Aktivität wird der Status des Imports angezeigt.

  10. 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 ansehen, um weitere Informationen im Bereich Details zum Aktivitätsprotokoll aufzurufen.

    2. Klicken Sie im Bereich Details zum Aktivitätslog auf Vollständige Fehlerlogs ansehen, um den Fehler im Log-Explorer aufzurufen.

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 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:

  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.