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

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

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

  • Используйте Unity 2018.3+ версии.

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

  • Используйте iOS 13.0 и выше.

  • Используйте Xсode 13 или выше.

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

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

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

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

  • Федеральный закон от 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 самостоятельно.

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

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

Установка

Скачайте плагин

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

  2. Consent Manager поставляется в плагине. Никаких допольнительных действий для установки не нужно.

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

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

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

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

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

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

    Android
    iOS

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

    Android
    iOS

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

var builder = new ConsentBuilder()
        .AppendPolicyURL("https://yabbi.me/privacy-policies")
        .AppendGdpr(true)
        .AppendBundle("me.yabbi.ads.app")
        .AppendName("Example name");
        
consentManager.RegisterCustomVendor(builder);

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

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

private ConsentManager consentManager = new();

Мы рекомендуем вызывать инициализацию SDK в Start методе.

private void Start()
{
    consentManager.LoadManager();
}

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

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

consentManager.ShowConsentWindow();

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

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

consentManager.HasConsent();

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

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

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

Yabbi.SetUserConsent(consentManager.HasConsent());

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

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

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

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

consentManager.EnableLog(true);

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

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

Для отслеживания событий необходимо:

  1. Наследуйте класс который будет работать с рекламными событиями от интерфейса для отлеживания событий.

class YourClassName : IConsentListener {
    public void OnConsentManagerLoaded()
    {
        // Вызывается когда менеджер готов к показу
    }
    
    public void OnConsentManagerLoadFailed(string error)
    {
        // Вызывется если при загрузке произошла ошибка
    }
    
    public void OnConsentWindowShown()
    {
        // Вызывается при показе экрана
    }
    
    public void OnConsentManagerShownFailed(string error)
    {
        // Вызывется если при показе экрана произошла ошибка
    }
    
    public void OnConsentWindowClosed(bool hasConsent)
    {
        // Вызывается при закрытии экрана
        // hasConsent - определяет дал ли пользователь согласие
    }
}
  1. Свяжите ваш класс для отслеживания событий с Consent Manager SDK. Обычно класс, который работает с рекламой, одновременно является и классом для отслеживания событий, поэтому в качестве свойства делегата можно указать this.

consentManager.SetListener(self);

Last updated

Was this helpful?