Начните с выполнения инструкций из статьи по базовой интеграции подключаемого модуля, а затем выполните инструкции по всем форматам рекламных объявлений, которые вы хотите интегрировать (видеовставки и объявления с вознаграждением, рекламные объявления в формате баннера или MREC). Эта статья содержит дополнительную информацию и предназначена для использования при условии, что вы выполнили базовую интеграцию.
Добавив код для функций onPause
и onResume
, можно возобновлять воспроизведение рекламы, приостановленной при переходе приложения в фоновый режим.
void OnApplicationPause(bool pauseStatus) {
if (pauseStatus) {
Vungle.onPause();
}
else {
Vungle.onResume();
}
}
С 1 июля 2020 г. вступил в силу Закон Калифорнии о защите персональных данных потребителей (CCPA), и издатели должны выполнить обновление до подключаемого модуля Unity Plugin 6.7.0.0 для приведения в соответствие с CCPA.
Используйте updateCCPAStatus
, чтобы указать отказ потребителя дать согласие посредством перехода к Consent.DENIED
. И используйте getCCPAStatus
, чтобы получить текущий статус по CCPA для конкретного пользователя.
public static void updateCCPAStatus(Consent consent)
public static Consent getConsentStatus()
Пример кода
Vungle.updateCCPAStatus(Vungle.Consent.Denied);
Vungle.Consent CurrentCCPAStatus = Vungle.getCCPAStatus();
Варианты конфигурации рекламных объявлений
Метод playAd
может также принимать словарь параметров, позволяющий настроить воспроизведение рекламы в соответствии с индивидуальными предпочтениями.
public static void playAd(Dictionary<string,object> options, string placementID);
Примечание. Рекламные объявления с вознаграждением в некоторых случаях называются рекламными объявлениями со стимулом, оба термина всегда относятся к одному и тому же типу рекламных объявлений. В коде SDK и нашем интерфейсе Reporting API мы используем термин «incentivized» (со стимулом).
В словаре вариантов могут содержаться следующие ключи:
Ключ | Описание | |||||||||||||||||||||||||||
orientation |
Задает ориентацию рекламных объявлений
|
|||||||||||||||||||||||||||
userTag |
Строка пользователя, которая передается для идентификации пользователей в вызове S2S (при наличии). | |||||||||||||||||||||||||||
alertTitle |
Строка, которая появляется при преждевременном закрытии пользователем рекламного объявления со стимулами. | |||||||||||||||||||||||||||
alertText |
Строка, которая появляется как основной текст предупреждающего диалога при преждевременном закрытии пользователем рекламного объявления со стимулами. | |||||||||||||||||||||||||||
closeText |
Строка заголовка кнопки, закрывающей окно предупреждения, которое появляется при преждевременном закрытии пользователем рекламного объявления со стимулами. | |||||||||||||||||||||||||||
continueText |
Строка заголовка кнопки, закрывающей окно предупреждения, которое появляется при преждевременном закрытии пользователем рекламного объявления со стимулами. |
Минимальное пространство на диске
Минимальная конфигурация дискового пространства была введена в версии 6.4.0 для определения предельных размеров доступного пространства на пользовательском устройстве до инициализации пакета SDK Vungle и подачи рекламы. Значение по умолчанию для SetMinimumDiskSpaceForInitialization
составляет 51 МБ, а для SetMinimumDiskSpaceForAd
составляет 50 МБ. Размер памяти вводится в байтах (не МБ).
Vungle.SetMinimumDiskSpaceForInitialization(minValue);
Vungle.SetMinimumDiskSpaceForAd(minValue);
Vungle.init(appID);
Отключить идентификатор оборудования
Начиная с версии 6.4.0 пакетов SDK, издатели могут запрещать передачу идентификатора оборудования с устройства в пакет SDK.
//Set false to opt in for Hardware ID collection by SDK or true to opt out
Vungle.EnableHardwareIdPrivacy(m_disableHardwareID);
Рекомендованные инструкции по реализации GDPR
25 мая 2019 года в Европейском Союзе вступил в силу Общий регламент по защите данных (General Data Protection Regulation, GDPR). Разработчикам доступно два варианта соблюдения его требований.
- Вариант 1 (рекомендуемый): Дайте возможность модулю Vungle разобраться с этими требованиями. Прежде чем продемонстрировать рекламное объявление для европейского потребителя, Vungle выведет диалог для получения согласия и запомнит принятое данным потребителем решение – согласие или отказ – для последующих рекламных объявлений.
- Вариант 2: Публикатор контролирует процесс дачи согласия по GDPR на уровне потребителя, а затем сообщает о решении потребителя модулю Vungle. Чтобы сделать это, разработчики могут получать согласие потребителя, пользуясь своим собственным механизмом, а затем использовать API Vungle для обновления или запроса статуса согласия пользователя. Для получения подробной информации обратитесь к представленному ниже примеру кода.
Чтобы использовать API Vungle для обновления или запроса статуса согласия пользователя, как рекомендовано в Варианте 1, используйте нумератор Vungle.Consent
и укажите текущее значение для двух следующих функций.
// The Consent enum is used to represent the user's current GDPR opt-in status
public enum Consent {
Undefined = 0,
Accepted = 1,
Denied = 2
}
// Sets the user's consent status
void updateConsentStatus(Vungle.Consent consent);
// Sets the user's consent status and also sets a string to track GDPR version
void updateConsentStatus(Vungle.Consent consent, string consentMessageVersion);
// Gets the user's consent status
Vungle.Consent getConsentStatus();