Nutzerereignisse verwalten

Auf dieser Seite wird beschrieben, wie Sie Informationen zu Nutzerereignissen aufrufen und Nutzerereignisse löschen.

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

Zusammengefasste Nutzerereignisinformationen ansehen

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

Auf dieser Seite finden Sie Informationen wie die Anzahl der aufgenommenen Ereignisse, die Anzahl der nicht zusammengeführten Ereignisse, die prozentuale Änderung der Ereignisanzahl über einen bestimmten Zeitraum und die durchschnittliche Anzahl des Ereignistyps pro Dokument. Außerdem können Sie Messwerte für jeden Ereignistyp im Zeitverlauf sehen. Die Messwerte werden etwa 24 Stunden nach dem ersten Hochladen von Ereignissen in „Empfehlungen für Medien“ angezeigt.

So rufen Sie Ihre Nutzerereignisinformationen auf:

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

    Zum Agent Builder

  2. Klicken Sie auf den Namen der App, für die Sie Informationen zu Nutzerereignissen sehen möchten.

  3. Wechseln Sie auf der Seite Daten zum Tab Ereignisse. Auf diesem Tab werden Informationen zu Nutzerereignissen angezeigt.

Nutzerereignisse dauerhaft löschen

Wenn Sie Nutzerereignisse haben, die nicht ordnungsgemäß aufgezeichnet wurden, und Sie sie entfernen müssen, können Sie die API-Methode userEvents.purge verwenden.

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 löschen möchten. Sie können mit den Feldern eventTime, eventType, visitorID und userID filtern.

Da Sie die Bereinigung nicht rückgängig machen können, testen Sie Ihre Filter, indem Sie einen Probelauf ausführen, bevor Sie Nutzerereignisse löschen. Das Feld force ist standardmäßig auf false gesetzt. Diese Einstellung gibt die Anzahl der zu löschenden Ereignisse zurück, ohne sie tatsächlich zu löschen. Wenn Sie bereit sind, die Nutzerereignisse zu löschen, setzen Sie das Feld force auf true.

In diesem Beispiel wird nach einem Zeitraum gefiltert, der das Datumsformat zu Zulu verwenden muss. Das Feld force ist auf false gesetzt.

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\"",
    "force":"false"
  }' \
  "https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/userEvents:purge"

Sie sollten ein Antwortobjekt erhalten, das in etwa so aussieht, 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"
  }
}

Wenn Sie das Feld force auf true setzen, wird der Löschvorgang erzwungen.

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\"",
    "force":"true"
  }' \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/userEvents:purge"

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änken Sie die zu löschenden Ereignisse auf einen einzelnen Ereignistyp.

  • visitorID: Beschränken Sie 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.

Wenn Sie beispielsweise alle Nutzerereignisse vom Typ add-to-cart löschen möchten, 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