Nutzerereignisse verwalten

Auf dieser Seite wird beschrieben, wie Sie Nutzerereignisinformationen aufrufen und Nutzerereignisse dauerhaft löschen.

Informationen zum Aufzeichnen von Nutzerereignissen finden Sie unter Echtzeit-Nutzerereignisse aufzeichnen. Informationen zum Importieren von Nutzerereignisdaten aus früheren Ereignissen finden Sie unter Vergangene Nutzerereignisse importieren.

Zusammengefasste Nutzerereignisinformationen ansehen

Informationen zu aufgezeichneten Nutzerereignissen für Ihre App finden Sie in der Google Cloud Konsole auf dem Tab Ereignisse der Seite Daten Ihrer App.

Auf dieser Seite werden Informationen wie die Anzahl der aufgenommenen Ereignisse, die Anzahl der nicht verknüpften Ereignisse, die prozentuale Änderung der Anzahl der Ereignisse über einen Zeitraum und die durchschnittliche Anzahl von Ereignistypen pro Dokument angezeigt. Außerdem können Sie Messwerte für jeden Ereignistyp im Zeitverlauf sehen. Messwerte werden etwa 24 Stunden nach dem ersten Hochladen von Ereignissen angezeigt.

So rufen Sie Ihre Nutzerereignisinformationen auf:

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

    KI-Anwendungen

  2. Klicken Sie auf den Namen der App, für die Sie Nutzerereignisinformationen aufrufen möchten.

  3. Rufen Sie auf der Seite Daten den Tab Ereignisse auf. Auf diesem Tab werden Nutzerereignisinformationen angezeigt.

Nutzerereignisse dauerhaft löschen

Wenn Sie Nutzerereignisse haben, die nicht ordnungsgemäß aufgezeichnet wurden, und Sie sie entfernen müssen , können Sie die userEvents.purge API-Methode verwenden. Sie zeichnen zwar auf Standortebene auf und importieren auf Standortebene auf, müssen Nutzerereignisse aber auf Datenspeicherebene dauerhaft löschen.

Geben Sie die Ereignisse an, die Sie entfernen möchten, indem Sie einen Nutzerereignisfilter verwenden. Mit dem Nutzerereignisfilter können Sie die Ereignisse angeben, die Sie dauerhaft löschen möchten. Sie können nach den Feldern eventTime, eventType, visitorID und userID filtern.

In diesem Beispiel wird nach einem Zeitraum gefiltert, der das Datumsformat zu Zulu verwenden muss.

curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token)"" \
  -H "Content-Type: application/json; charset=utf-8" \
  --data '{
    "filter":"eventTime > \"2023-12-21T18:25:43.511Z\" eventTime < \"2023-12-21T18:30:43.511Z\"",
  }' \
  "https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/userEvents:purge"

Sie sollten ein Antwortobjekt ähnlich dem folgenden erhalten, wobei purge-user-events-54321 die Vorgangs-ID ist:

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/purge-user-events-54321"
}

In diesem Beispiel wird der Vorgangsstatus angefordert:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/operations/OPERATION_ID"

Beispiel für Vorgangsstatus: 

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.PurgeUserEventsResponse"
    "purgedEventsCount": "1"
  }
}

Nutzerereignisfilter verwenden

Sie können Nutzerereignisse filtern, die gelöscht werden sollen.

Der Filter ist ein String, der eine oder mehrere der folgenden Einschränkungen enthält:

  • eventTime: Stellt einen Zeitstempel zur Begrenzung der zu löschenden Ereignisse bereit. Dieser Filter kann einmal oder zweimal mit einem Symbol größer als (>) oder kleiner als (<) angegeben werden. Die angegebene Zeit muss ein einzelner zusammenhängender Block sein.

  • eventType: Beschränkt die zu löschenden Ereignisse auf einen einzelnen Ereignistyp.

  • visitorID: Beschränkt die zu löschenden Ereignisse auf eine einzelne Besucher-ID.

  • userID: Beschränken Sie die zu löschenden Ereignisse auf eine einzelne Nutzer-ID.

Nur Nutzerereignisse, die alle Einschränkungen erfüllen, werden gelöscht.

Um beispielsweise alle Nutzerereignisse vom Typ add-to-cart zu löschen, die am oder nach dem 1. Februar 2023 protokolliert wurden, geben Sie den folgenden Filterstring an:

eventTime > "2023-02-01T00:00:00Z" eventType = add-to-cart

Nächste Schritte