Экран пользовательского согласия

Библиотека для демонстрации готового экрана сбора согласия на сбор, обработку и использования данных о пользователе.

Версия релиза 1.2.1 | Дата релиза 15.07.2024

Минимальные требования:

  • Используйте Android API level 22 (Android OS 5.1) и выше.

Общая информация

Для соответствия требованиям магазина приложений и законов, регулирующих сбор, обработку и использование персональных данных пользователя, требуется получение его согласия на вышеуказанные действия. При получении отказа следует не собирать никаких данных о пользователе.

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

Получения однозначного согласия на сбор, обработку и использование пользовательских данных требуют большинство стран. Вот несколько основных документов, описывающих данный процесс:

  • Федеральный закон от 27 июля 2006 г. N 152-ФЗ "О персональных данных"

  • GDPR (General Data Protection Regulation, Постановление (Европейский союз) 2016/679)

  • COPPA (Children's Online Privacy Protection Rule)

  • CCPA (California Consumer Privacy Act)

Обычно получение согласия пользователя происходит на специальном экране при первом запуске приложения — consent-screen.

В Yabbi SDK реализован такой экран, вы можете добавить и настроить его с помощью работы с библиотекой Consent Manager. Вы можете использовать его, чтобы не создавать Consent Screen самостоятельно.

Демо-приложение

Используйте наше демо-приложение в качестве примера.

Установка

Подготовьте Gradle

  1. Установите Yabbi SDK. Подробно процесс установки описан в соответствующем разделе.

  2. Добавьте в файл build.gradle зависимость для установки Consent manager.

    dependencies {
        // ... other dependencies
        
        // подключение зависимости Consent Manager SDK
        implementation 'sspnet.tech.consent:yabbi:1.2.1'
    }
  3. Cохраните файл и нажмите Gradle sync.

Перед использование экрана пользовательского согласия необходимо настроить его.

Для того, чтобы задать параметры, вызывайте методы переменной builder. Ниже представлен список всех доступных настроек:

  • appendPolicyURL - устанавливает ссылку на политику конфиденциальности вашего приложения. Рекомендуем вам относиться к этому параметру как к обязательному. Ссылки на политики конфиденциальности Yabbi и наших партнёров уже добавлены на экран согласия.

  • appendBundle - устанавливает кастомный Bundle. Он используется для установки иконки приложения в TopBar экрана пользовательского согласия. Если параметр не заполнен, то отобразится существующая иконка приложения.

  • appendName - устанавливает имя вашего приложения в TopBar экрана пользовательского согласия. Если параметр не заполнен, то отобразится существующее название приложения.

  • appendGDPR - добавляет кнопку отказа от сбора данных. Consent screen с одной кнопкой, возможность отказа от сбора данных доступна пользователю только через ограничение настроек устройства.

    Consent screen с двумя кнопками, возможность отказа от сбора данных доступна пользователю по тапу на кнопку "Нет".

Взгляните на полный пример заполнения параметров:

final ConsentBuilder builder = new ConsentBuilder()
        .appendPolicyURL("https://yabbi.me/privacy-policies")
        .appendGDPR(true)
        .appendBundle("me.yabbi.ads.app")
        .appendName("Example name");
        
consentManager.registerCustomVendor(builder);

Инициализация

Создайте в вашей Activity переменную ConsentManager.

final ConsentManager consentManager = new ConsentManager();

Мы рекомендуем вызывать инициализацию SDK в вашей MainActivity - в onCreate методе.

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    
    consentManager.loadManager();
}

Показ экрана с запросом разрешений

Чтобы показать экран, необходимо вызывать метод showConsentWindow.

consentManager.showConsentWindow();

Узнать статус согласия пользователя

Если пользователь дал согласие на сбор данных, метод вернёт true:

consentManager.hasConsent(this);

Если метод возвращает false, настоятельно рекомендуем не собирать никакие данные об этом пользователе.

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

Для обновления статуса согласия в Yabbi SDK (для работы с рекламой) используется метод setUserConsent.

Yabbi.setUserConsent(consentManager.hasConsent(this));

С остальными методами Yabbi SDK (для работы с рекламой) вы можете ознакомиться в соответствующем разделе.

Режим отладки

Если вам требуется логирование ошибок и событий, включите режим отладки. По умолчанию он выключен.

Для включения режима отладки воспользуйтесь методом enableDebug.

consentManager.enableDebug(true);

Отслеживание событий

Consent Manager позволяет вам отслеживать события, связанные с согласием пользователя на сбор данных.

Для отслеживания событий необходимо предоставить класс для работы.

Ниже представлен пример установки рекламных событий.

consentManager.setListener(new ConsentListener() {
    @Override
    public void onConsentManagerLoaded() {
        // Вызывается когда менеджер готов к показу
    }

    @Override
    public void onConsentManagerLoadFailed(String error) {
        // Вызывется если при загрузке произошла ошибка
    }

    @Override
    public void onConsentWindowShown() {
        // Вызывается при показе экрана
    }

    @Override
    public void onConsentManagerShownFailed(String error) {
        // Вызывется если при показе экрана произошла ошибка
    }

    @Override
    public void onConsentWindowClosed(boolean hasConsent) {
        // Вызывается при закрытии экрана
        // hasConsent - определяет дал ли пользователь согласие
    }
});

Last updated

Was this helpful?