User Deletion API – Übersicht

Dieses Dokument bietet einen allgemeinen Überblick über die Google Analytics User Deletion API.

Einleitung

Mit der Google Analytics User Deletion API können Kunden Daten löschen, die mit einer bestimmten User-ID verknüpft sind. Dieses Tool ist eines von mehreren verfügbaren Tools, mit denen Sie Ihre Daten schützen können.

Hinweis: Die Google Analytics User Deletion API ist sowohl mit Google Analytics 4-Properties (GA4) als auch mit Universal Analytics-Properties kompatibel.

Überblick

Mit der User Deletion API können Google Analytics-Kunden Daten für eine bestimmte User-ID aus einem Projekt oder einer Web-Property löschen. Anfragen zum Löschen von Nutzern können über Firebase-Projekte oder Google Analytics-Properties gestellt werden.

Löschen von Daten beantragen

Verwenden Sie die upsert-Methode, um das Löschen von Daten für einen bestimmten Nutzer anzufordern. Die Upsert-Methode verwendet eine Ressource für Löschanfragen für Nutzer als einzigen Parameter. Eine Anfrage zum Löschen von Daten kann entweder auf eine Google Analytics-Web-Property (angegeben mit dem Feld webPropertyId) oder auf eine GA4-Property(angegeben durch das Feld propertyId) angewendet werden. Um einen Nutzer anzugeben, dessen Daten gelöscht werden sollen, legen Sie eine der IDs im Feld id.userId fest. Der Typ der Kennung muss im Feld id.type angegeben werden. Unterstützte Nutzer-ID-Typen:

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

Bei jeder Anfrage zum Löschen von Daten wird nur die in dieser Anfrage angegebene ID verarbeitet. Wenn mehrere Kennungen demselben Nutzer zugeordnet sind, müssen Sie für jede dieser IDs separate Löschanfragen senden. Wenn Sie den BigQuery-Export verwenden, müssen Sie dort auch Ihre eigenen Löschvorgänge verarbeiten.

Weitere Informationen zu den User-ID- und Client-ID-Funktionen finden Sie in der Analytics-Hilfe.

Datenlöschung

Die Methode upsert gibt eine Löschanfrageressource für Nutzer mit einem festgelegten Feld deletionRequestTime zurück. Im Feld deletionRequestTime wird der Zeitpunkt angegeben, zu dem die Löschanfrage in Google Analytics eingegangen ist.

Der OAuth 2.0-Bereich https://www.googleapis.com/auth/analytics.user.deletion ist erforderlich, um die Methode upsert aufzurufen.

Sobald eine Löschanfrage gestellt wurde, werden Daten, die mit dieser 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 gelöscht. Die Löschvorgänge sind so geplant, dass sie ungefähr alle zwei Monate ausgeführt werden. Falls Sie diese Daten außerhalb von Google Analytics exportiert haben, sollten Sie sie dort zuerst löschen.

Auf zuvor aggregierten Daten (z. B. Nutzerzahlen im Bericht „Zielgruppenübersicht“) basierende Berichte sind davon nicht betroffen.