Nutzerdaten löschen

In diesem Dokument wird erläutert, wie Sie mit der Google Analytics User Deletion API Daten löschen, die mit einer bestimmten Nutzer-ID verknüpft sind. Dieses Tool ist eines von mehreren Tools, mit denen Sie Ihre Daten schützen können.

Weitere Informationen finden Sie in der Referenzdokumentation.

Sie können Firebase-Projekte oder Google Analytics-Properties verwenden, um API-Anfragen zum Löschen von Nutzerdaten zu senden. Für die Anfragen in dieser Anleitung ist der OAuth 2.0-Bereich https://www.googleapis.com/auth/analytics.user.deletion erforderlich.

Löschanfrage senden

Verwenden Sie die Methode upsert, um das Löschen der Daten für einen bestimmten Nutzer anzufordern. Die Methode upsert nimmt einen userDeletionRequest als einzigen Parameter an.

Geben Sie den Nutzer an, dessen Daten Sie löschen möchten, indem Sie eine der IDs im Feld id.userId festlegen. Der Typ der ID muss im Feld id.type angegeben werden.

Hier ist eine Liste der unterstützten Nutzer-ID-Typen:

  • CLIENT_ID: Google Analytics-Client-ID (wird nur unterstützt, wenn das Feld propertyId festgelegt ist).
  • USER_ID: Google Analytics-User-ID (wird nur unterstützt, wenn das Feld propertyId festgelegt ist).
  • APP_INSTANCE_ID: Firebase-Anwendungs-Instanz-ID (nur unterstützt, wenn das Feld firebaseProjectId oder propertyId festgelegt ist).

Bei jeder Löschanfrage für Daten wird nur die in der Anfrage angegebene ID verarbeitet.

Wenn einem Nutzer mehrere IDs zugeordnet sind, musst du für jede ID, die diesem Nutzer zugeordnet ist, eine separate Löschanfrage senden. Wenn Sie den BigQuery-Export verwenden, müssen Sie Ihre eigenen Löschungen auch dort verarbeiten.

Weitere Informationen zu User-IDs

Löschzeitachse

Die Methode upsert gibt eine Ressource für die Anfrage zum Löschen eines Nutzers mit dem festgelegten Feld deletionRequestTime zurück. Im Feld deletionRequestTime ist der Zeitpunkt angegeben, zu dem die Löschanfrage bei Google Analytics empfangen wurde.

Sobald eine Löschung angefordert wird, werden Daten, die mit der User-ID verknüpft sind, innerhalb von 72 Stunden aus dem Bericht zu einzelnen Nutzern entfernt. Sie werden dann beim nächsten Löschvorgang von den Analytics-Servern entfernt. Die Löschvorgänge sind so geplant, dass sie alle zwei Monate ausgeführt werden. Falls Sie die Nutzerdaten außerhalb von Google Analytics exportiert haben, sollten Sie sie dort zuerst löschen.