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

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

Версия релиза 1.2.3 | Дата релиза 29.09.2025

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

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

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

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

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

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

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

• Федеральный закон от 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 и Consent Manager

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

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

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

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

GitHub - YabbiSDKTeam/yabbi-android-demoGitHub

Установка

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

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

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

   dependencies {
       // ... other dependencies
       
       // подключение зависимости Consent Manager SDK
       implementation 'sspnet.tech.consent:yabbi:1.2.3'
   }

3. Cохраните файл и нажмите Gradle sync.

Настройка библиотеки Consent Manager

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

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

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

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

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

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

  

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

  

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

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

Работа с библиотекой Consent Manager

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

Создайте в вашей 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 - определяет дал ли пользователь согласие
    }
});