Настройка конфиденциальности и сбора данных: различия между версиями
Новая страница: «= Настройка конфиденциальности и сбора данных = Ключ-АСТРОМ предоставляет настройки конфиденциальности, позволяющие контролировать объем собираемых данных от пользователей. Эти настройки помогают обеспечить соответствие нормативным актам по защит...» |
Нет описания правки |
||
| Строка 26: | Строка 26: | ||
'''Kotlin''' | '''Kotlin''' | ||
<pre> | <pre> | ||
import com.astromkey.android.agent. | import com.astromkey.android.agent.astromkey | ||
import com.astromkey.android.agent.conf.UserPrivacyOptions | import com.astromkey.android.agent.conf.UserPrivacyOptions | ||
import com.astromkey.android.agent.conf.DataCollectionLevel | import com.astromkey.android.agent.conf.DataCollectionLevel | ||
val privacyOptions = | val privacyOptions = astromkey.getUserPrivacyOptions() | ||
val updatedOptions = privacyOptions.newBuilder() | val updatedOptions = privacyOptions.newBuilder() | ||
.withDataCollectionLevel(DataCollectionLevel.PERFORMANCE) | .withDataCollectionLevel(DataCollectionLevel.PERFORMANCE) | ||
.build() | .build() | ||
astromkey.applyUserPrivacyOptions(updatedOptions) | |||
</pre> | </pre> | ||
'''Java''' | '''Java''' | ||
<pre> | <pre> | ||
import com.astromkey.android.agent. | import com.astromkey.android.agent.astromkey; | ||
import com.astromkey.android.agent.conf.UserPrivacyOptions; | import com.astromkey.android.agent.conf.UserPrivacyOptions; | ||
import com.astromkey.android.agent.conf.DataCollectionLevel; | import com.astromkey.android.agent.conf.DataCollectionLevel; | ||
UserPrivacyOptions privacyOptions = | UserPrivacyOptions privacyOptions = astromkey.getUserPrivacyOptions(); | ||
UserPrivacyOptions updatedOptions = privacyOptions.newBuilder() | UserPrivacyOptions updatedOptions = privacyOptions.newBuilder() | ||
.withDataCollectionLevel(DataCollectionLevel.PERFORMANCE) | .withDataCollectionLevel(DataCollectionLevel.PERFORMANCE) | ||
.build(); | .build(); | ||
astromkey.applyUserPrivacyOptions(updatedOptions); | |||
</pre> | </pre> | ||
| Строка 73: | Строка 73: | ||
'''Настройка плагина Gradle (Groovy)''' | '''Настройка плагина Gradle (Groovy)''' | ||
<pre> | <pre> | ||
astromkey{ | |||
configurations { | configurations { | ||
defaultConfig { | defaultConfig { | ||
| Строка 95: | Строка 95: | ||
'''Настройка запуска вручную (Kotlin)''' | '''Настройка запуска вручную (Kotlin)''' | ||
<pre> | <pre> | ||
astromkeyConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconURL>") | |||
.withUserOptIn(true) | .withUserOptIn(true) | ||
.buildConfiguration() | .buildConfiguration() | ||
| Строка 128: | Строка 128: | ||
'''Kotlin''' | '''Kotlin''' | ||
<pre> | <pre> | ||
import com.astromkey.android.agent. | import com.astromkey.android.agent.astromkey | ||
import com.astromkey.android.agent.conf.UserPrivacyOptions | import com.astromkey.android.agent.conf.UserPrivacyOptions | ||
val privacyOptions = | val privacyOptions = astromkey.getUserPrivacyOptions() | ||
val updatedOptions = privacyOptions.newBuilder() | val updatedOptions = privacyOptions.newBuilder() | ||
.withCrashReportingOptedIn(true) // Включить отчеты о сбоях | .withCrashReportingOptedIn(true) // Включить отчеты о сбоях | ||
.build() | .build() | ||
astromkey.applyUserPrivacyOptions(updatedOptions) | |||
</pre> | </pre> | ||
'''Java''' | '''Java''' | ||
<pre> | <pre> | ||
import com.astromkey.android.agent. | import com.astromkey.android.agent.astromkey; | ||
import com.astromkey.android.agent.conf.UserPrivacyOptions; | import com.astromkey.android.agent.conf.UserPrivacyOptions; | ||
UserPrivacyOptions privacyOptions = | UserPrivacyOptions privacyOptions = astromkey.getUserPrivacyOptions(); | ||
UserPrivacyOptions updatedOptions = privacyOptions.newBuilder() | UserPrivacyOptions updatedOptions = privacyOptions.newBuilder() | ||
.withCrashReportingOptedIn(true) // Включить отчеты о сбоях | .withCrashReportingOptedIn(true) // Включить отчеты о сбоях | ||
.build(); | .build(); | ||
astromkey.applyUserPrivacyOptions(updatedOptions); | |||
</pre> | </pre> | ||
| Строка 154: | Строка 154: | ||
'''Kotlin''' | '''Kotlin''' | ||
<pre> | <pre> | ||
import com.astromkey.android.agent. | import com.astromkey.android.agent.astromkey | ||
import com.astromkey.android.agent.conf.UserPrivacyOptions | import com.astromkey.android.agent.conf.UserPrivacyOptions | ||
import com.astromkey.android.agent.conf.DataCollectionLevel | import com.astromkey.android.agent.conf.DataCollectionLevel | ||
val privacyOptions = | val privacyOptions = astromkey.getUserPrivacyOptions() | ||
val updatedOptions = privacyOptions.newBuilder() | val updatedOptions = privacyOptions.newBuilder() | ||
.withDataCollectionLevel(DataCollectionLevel.USER_BEHAVIOR) | .withDataCollectionLevel(DataCollectionLevel.USER_BEHAVIOR) | ||
.withCrashReportingOptedIn(false) | .withCrashReportingOptedIn(false) | ||
.build() | .build() | ||
astromkey.applyUserPrivacyOptions(updatedOptions) | |||
</pre> | </pre> | ||
'''Java''' | '''Java''' | ||
<pre> | <pre> | ||
import com.astromkey.android.agent. | import com.astromkey.android.agent.astromkey; | ||
import com.astromkey.android.agent.conf.UserPrivacyOptions; | import com.astromkey.android.agent.conf.UserPrivacyOptions; | ||
import com.astromkey.android.agent.conf.DataCollectionLevel; | import com.astromkey.android.agent.conf.DataCollectionLevel; | ||
UserPrivacyOptions privacyOptions = | UserPrivacyOptions privacyOptions = astromkey.getUserPrivacyOptions(); | ||
UserPrivacyOptions updatedOptions = privacyOptions.newBuilder() | UserPrivacyOptions updatedOptions = privacyOptions.newBuilder() | ||
.withDataCollectionLevel(DataCollectionLevel.USER_BEHAVIOR) | .withDataCollectionLevel(DataCollectionLevel.USER_BEHAVIOR) | ||
.withCrashReportingOptedIn(false) | .withCrashReportingOptedIn(false) | ||
.build(); | .build(); | ||
astromkey.applyUserPrivacyOptions(updatedOptions); | |||
</pre> | </pre> | ||
Текущая версия от 16:33, 19 августа 2026
Настройка конфиденциальности и сбора данных
Ключ-АСТРОМ предоставляет настройки конфиденциальности, позволяющие контролировать объем собираемых данных от пользователей. Эти настройки помогают обеспечить соответствие нормативным актам по защите данных, таким как GDPR, и одновременно предоставляют ценную информацию о производительности приложения. ЕдиныйАгент поддерживает сбор данных с приоритетом конфиденциальности, предоставляя разработчикам контроль над уровнями сбора данных, отчетами о сбоях и параметрами конфиденциальности пользователей во время выполнения. Кроме того, ЕдиныйАгент позволяет удалять конфиденциальные данные из сообщаемых событий.
Уровни сбора данных
ЕдиныйАгент поддерживает три уровня сбора данных, определяемые параметром DataCollectionLevel.
| Уровень | Описание |
|---|---|
OFF |
Сбор данных не производится. |
PERFORMANCE |
Собирает данные, связанные с производительностью, такие как сбои приложений и ошибки ANR. |
USER_BEHAVIOR |
Собирает как данные о производительности, так и данные о поведении пользователей. |
На уровне производительности данные о производительности собираются по умолчанию, включая взаимодействия пользователей, веб-запросы, ошибки и последовательности экранов. Однако сбои и ошибки ANR регистрируются только в том случае, если отчетность о сбоях явно включена с помощью флага выбора режима отчетности о сбоях; если она отключена, данные о сбоях или ошибках ANR не собираются, несмотря на описание уровня. См. раздел «Включение или отключение отчетности о сбоях».
Установите уровень сбора данных
Настройте уровень сбора данных с помощью API applyUserPrivacyOptions.
Kotlin
import com.astromkey.android.agent.astromkey
import com.astromkey.android.agent.conf.UserPrivacyOptions
import com.astromkey.android.agent.conf.DataCollectionLevel
val privacyOptions = astromkey.getUserPrivacyOptions()
val updatedOptions = privacyOptions.newBuilder()
.withDataCollectionLevel(DataCollectionLevel.PERFORMANCE)
.build()
astromkey.applyUserPrivacyOptions(updatedOptions)
Java
import com.astromkey.android.agent.astromkey;
import com.astromkey.android.agent.conf.UserPrivacyOptions;
import com.astromkey.android.agent.conf.DataCollectionLevel;
UserPrivacyOptions privacyOptions = astromkey.getUserPrivacyOptions();
UserPrivacyOptions updatedOptions = privacyOptions.newBuilder()
.withDataCollectionLevel(DataCollectionLevel.PERFORMANCE)
.build();
astromkey.applyUserPrivacyOptions(updatedOptions);
Режим согласия пользователя
Функция согласия пользователя позволяет разработчикам соблюдать правила защиты конфиденциальности, явно получая согласие пользователя перед сбором данных или включением функции отправки отчетов об ошибках. Эта функция гарантирует, что пользователи контролируют свои данные и могут принимать обоснованные решения относительно своей конфиденциальности.
Как работает согласие пользователя
Если включена функция согласия пользователя, ЕдиныйАгент не собирает данные и не включает отчеты о сбоях до тех пор, пока пользователь явно не даст свое согласие. Разработчики могут использовать API applyUserPrivacyOptions для обновления настроек конфиденциальности в соответствии с предпочтениями пользователя.
Поведение по умолчанию
Когда включен режим подтверждения согласия пользователя, до того, как пользователь явно даст свое согласие, ЕдиныйАгент использует следующие настройки по умолчанию:
- Уровень сбора данных:
OFF(данные не собираются). - Система сообщений о сбоях:
false(отключена).
Используя режим согласия пользователя, разработчики могут обеспечить соблюдение правил конфиденциальности и предоставить пользователям больший контроль над своими данными.
Включить режим согласия пользователя
Режим согласия пользователя является необязательным. Без него ЕдиныйАгент по умолчанию собирает данные и сообщает о сбоях, не требуя согласия пользователя. При включении этого режима ваше приложение должно предоставлять пользователю интерфейс для подтверждения согласия; пока пользователь явно не даст согласие, сбор данных не производится, и отчеты о сбоях остаются отключенными. Чтобы включить режим согласия, обновите конфигурацию Gradle:
Настройка плагина Gradle (Groovy)
astromkey{
configurations {
defaultConfig {
userOptIn true
}
}
}
Настройка плагина Gradle (Kotlin)
configure<com.astromkey.tools.android.dsl.AstromkeyExtension> {
configurations {
create("defaultConfig") {
userOptIn(true)
}
}
}
Настройка запуска вручную (Kotlin)
astromkeyConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconURL>")
.withUserOptIn(true)
.buildConfiguration()
Настройка запуска вручную (Java)
new AstromkeyConfigurationBuilder("<YourApplicationID>", "<ProvidedBeaconURL>")
.withUserOptIn(true)
.buildConfiguration();
Внедрите диалоговое окно для получения согласия
Ключ-АСТРОМ не предоставляет пользовательский интерфейс для диалогового окна согласия. Вам необходимо реализовать собственный баннер или диалоговое окно согласия в вашем приложении (как описано в разделе «Настройка параметров конфиденциальности данных для мобильных приложений»). Диалоговое окно должно:
- Объяснить, какие данные будут собираться.
- Предоставить пользователям возможность выбирать предпочтительный уровень сбора данных.
- Предоставить пользователям возможность включать или отключать отправку отчетов о сбоях.
- Предоставить пользователям возможность изменить свои предпочтения позже.
API конфиденциальности
API applyUserPrivacyOptions позволяет динамически обновлять настройки конфиденциальности во время выполнения. Это полезно для реализации диалоговых окон согласия пользователя или экранов настройки конфиденциальности.
Включить или отключить отчеты о сбоях
Если режим с возможностью выбора отключен, отчеты о сбоях включены по умолчанию. Если режим с возможностью выбора включен, отчеты о сбоях отключены до тех пор, пока пользователь явно не даст на это согласие. Если этот режим включен, ЕдиныйАгент собирает данные о сбоях, чтобы помочь разработчикам диагностировать и устранять проблемы в своих приложениях.
Используйте API applyUserPrivacyOptions для включения или отключения отчетов о сбоях:
Kotlin
import com.astromkey.android.agent.astromkey
import com.astromkey.android.agent.conf.UserPrivacyOptions
val privacyOptions = astromkey.getUserPrivacyOptions()
val updatedOptions = privacyOptions.newBuilder()
.withCrashReportingOptedIn(true) // Включить отчеты о сбоях
.build()
astromkey.applyUserPrivacyOptions(updatedOptions)
Java
import com.astromkey.android.agent.astromkey;
import com.astromkey.android.agent.conf.UserPrivacyOptions;
UserPrivacyOptions privacyOptions = astromkey.getUserPrivacyOptions();
UserPrivacyOptions updatedOptions = privacyOptions.newBuilder()
.withCrashReportingOptedIn(true) // Включить отчеты о сбоях
.build();
astromkey.applyUserPrivacyOptions(updatedOptions);
Примените параметры конфиденциальности
Kotlin
import com.astromkey.android.agent.astromkey
import com.astromkey.android.agent.conf.UserPrivacyOptions
import com.astromkey.android.agent.conf.DataCollectionLevel
val privacyOptions = astromkey.getUserPrivacyOptions()
val updatedOptions = privacyOptions.newBuilder()
.withDataCollectionLevel(DataCollectionLevel.USER_BEHAVIOR)
.withCrashReportingOptedIn(false)
.build()
astromkey.applyUserPrivacyOptions(updatedOptions)
Java
import com.astromkey.android.agent.astromkey;
import com.astromkey.android.agent.conf.UserPrivacyOptions;
import com.astromkey.android.agent.conf.DataCollectionLevel;
UserPrivacyOptions privacyOptions = astromkey.getUserPrivacyOptions();
UserPrivacyOptions updatedOptions = privacyOptions.newBuilder()
.withDataCollectionLevel(DataCollectionLevel.USER_BEHAVIOR)
.withCrashReportingOptedIn(false)
.build();
astromkey.applyUserPrivacyOptions(updatedOptions);
Раздел «Безопасность данных» в Google Play
При использовании Ключ-АСТРОМ в приложении для Android, распространяемом через Google Play, необходимо добавить следующую информацию о конфиденциальности в Google Play.