API удаления пользователей — обзор

В этом документе представлен общий обзор API удаления пользователей Google Analytics.

Введение

API удаления пользователей Google Analytics позволяет клиентам обрабатывать удаление данных, связанных с данным идентификатором пользователя. Этот инструмент является одним из нескольких инструментов, которые помогут вам защитить ваши данные .

Примечание . API удаления пользователей Google Analytics совместим как с ресурсами Google Analytics 4 (GA4), так и с ресурсами Universal Analytics.

Обзор

API удаления пользователей позволяет клиенту Google Analytics удалять данные для определенного идентификатора пользователя из проекта или веб-ресурса. Запросы на удаление пользователей можно делать с использованием проектов Firebase или свойств Google Analytics.

Запрос на удаление данных

Используйте метод upsert , чтобы запросить удаление данных для данного пользователя. Метод upsert принимает ресурс запроса на удаление пользователя в качестве единственного параметра. Запрос на удаление данных можно применить либо к веб-ресурсу Google Analytics (указанному в поле webPropertyId ), либо к ресурсу GA4 (указанному в поле propertyId ). Пользователя, данные которого будут удалены, можно указать, задав один из идентификаторов внутри поля id.userId . Тип идентификатора должен быть указан внутри поля id.type . Поддерживаемые типы идентификаторов пользователей:

• CLIENT_ID : идентификатор клиента Google Analytics (поддерживается только в том случае, если установлено поле webPropertyId или propertyId ).
• USER_ID : идентификатор пользователя Google Analytics (поддерживается только в том случае, если установлено поле webPropertyId или propertyId ).
• APP_INSTANCE_ID : идентификатор экземпляра приложения Firebase (поддерживается только в том случае, если установлено поле firebaseProjectId или propertyId ).

Каждый запрос на удаление данных обрабатывает только идентификатор, представленный в этом запросе. Если у вас есть несколько идентификаторов, связанных с одним и тем же пользователем, вы должны отправить отдельные запросы на удаление для каждого идентификатора, связанного с этим пользователем. Если вы используете экспорт BigQuery, вам также придется обрабатывать собственные удаления там.

Дополнительную информацию о функциях User ID и Client ID можно найти в Справочном центре Analytics .

Удаление данных

Метод upsert возвращает ресурс запроса на удаление пользователя с установленным полем deleteRequestTime . Поле deletionRequestTime отмечает момент времени, когда запрос на удаление был получен Google Analytics.

Для вызова метода upsert необходима https://www.googleapis.com/auth/analytics.user.deletion область OAuth 2.0.

После запроса на удаление данные, связанные с этим идентификатором пользователя, будут удалены из отчета об отдельных пользователях в течение 72 часов, а затем удалены с серверов аналитики во время следующего процесса удаления. Процессы удаления запланированы примерно каждые два месяца. Если вы экспортировали эти данные за пределы Google Analytics, мы рекомендуем сначала удалить их там.

Обратите внимание, что отчеты, основанные на ранее агрегированных данных (например, количестве пользователей в отчете с обзором аудитории), не будут затронуты.