Общие сведения
Vungle поддерживает следующие три размера рекламных баннеров и стандартный размер MREC.
VungleBannerSize |
Размеры |
|
320,0 футов х 50,0 футов |
|
300,0 футов х 50,0 футов |
|
728,0 футов х 90,0 футов (для планшетов) |
|
300,0 футов х 250,0 футов (MREC) |
О рекламных баннерах
Рекламный баннер Vungle в настоящее время находится на стадии активного бета-тестирования и отладки. Обратитесь, пожалуйста, непосредственно к своему менеджеру по работе с заказчиками, чтобы получить доступ для обеспечения успешного запуска.
Подключаемый модуль Vungle Unity поддерживает рекламные объявления в формате баннера и MREC, начиная с SDK Vungle версии Unity 6.7.0.0. Для рекламных объявлений этого формата не требуется полный экран; вместо этого публикатор определяет местоположение рекламного контейнера в своем приложении. Однако размер контейнера для баннеров должен составлять 320x50, 300x50 или 728x90 (для планшетов). Вы можете устанавливать рекламный баннер в любом месте на экране, а пользователь может продолжать пользоваться приложением во время демонстрации этого рекламного объявления. Перечень различных размеров баннеров можно найти в файле VungleSDK.h
(они также представлены ниже в таблице).
Количество не полноэкранных рекламных объявлений в любой момент времени не ограничивается, но подключаемый модуль не выполняет проверку на предмет недопущения демонстрации нескольких рекламных объявлений в одной и той же позиции. Убедитесь, что вы вызываете только одно рекламное объявление на любую позицию, предоставленную нашим подключаемым модулем, а также, что они не перекрывают друг друга, если вы демонстрируете больше одного объявления в одно и то же время.
VungleBannerPosition |
Местоположение рекламного объявления на дисплее |
|
Верхний левый угол |
|
Вверху посередине |
|
Верхний правый угол |
|
Центр |
|
Нижний левый угол |
|
Внизу посередине |
|
Нижний правый угол |
Символ размещения рекламных баннеров должен быть обозначен как «Banner» на панели Vungle. Без колебаний обращайтесь к своему менеджеру по работе с заказчиками, чтобы активировать размещение баннеров на панели.
О рекламных объявлениях в формате MREC
Начиная с версии 6.4.3 пакета SDK для Vungle, Vungle поддерживает воспроизведение рекламных видеообъявлений в формате MREC. MREC – это сокращенное обозначение рекламных объявлений в формате «прямоугольник среднего размера». В отличие от рекламных видеовставок рекламным объявлениям MREC не требуется полный экран. Как и рекламные баннеры, видеообъявления MREC представляют собой прямоугольные рекламные объявления, располагающиеся в любом месте компоновки приложения. Обычно они располагаются вверху или внизу экрана, чтобы пользователь мог продолжать взаимодействовать с приложением во время демонстрации рекламного объявления. Размер контейнера для демонстрации MREC является стандартным для этой сферы деятельности: 300x250.
Шаг 1. Выполнить базовую интеграцию подключаемого модуля
Для того, чтобы интегрировать рекламные баннеры и MREC в ваше приложение Unity, начните с выполнения инструкций из статьи по базовой интеграции подключаемого модуля . Эта статья содержит дополнительную информацию. Предполагается, что вы выполнили базовую интеграцию.
Шаг 2. Реализовать обработчики событий (не обязательно)
Вы можете настроить обработчики событий для всех пяти событий пакета SDK Vungle, связанных с показом рекламы.
- Когда SDK начинает воспроизводить видеорекламу, запускается следующее событие. Это подходящий момент, чтобы приостановить игру, воспроизведение звуковых эффектов, анимации и т. д.
public static event Action onAdStartedEvent;
- Когда SDK закрывает рекламу, запускается следующее событие. Это подходящий момент, чтобы вознаградить пользователей и возобновить игру, звуковые эффекты, анимацию и т. д.
public static event Action<string, AdFinishedEventArgs> onAdFinishedEvent;
AdFinishedEventArgs
состоит из следующих свойств, которые позволяют вам просмотреть результат воспроизведения рекламы:public class AdFinishedEventArgs : EventArgs { //Represents a BOOL whether or not the user clicked the download button. public bool WasCallToActionClicked{ get; set;} //Represents a bool whether or not the video can be considered a completed view. public bool IsCompletedView{ get; set;} }
- Когда SDK изменит статус доступности рекламы, запускается следующее событие. Логическое значение
isAdPlayable
обозначает новую возможность воспроизведения для конкретного идентификатора размещенияplacementID
.public static event Action<string, bool> adPlayableEvent;
- После успешной инициализации SDK запускается следующее событие.
public static event Action onInitializeEvent;
Пример кода:
void initializeEventHandlers()
{
Vungle.onAdStartedEvent += (placementID) => {
DebugLog ("Ad " + placementID + " is starting! Pause your game animation or sound here.");
};
Vungle.onAdFinishedEvent += (placementID, args) => {
DebugLog ("Ad finished - placementID " + placementID + ", was call to action clicked:" + args.WasCallToActionClicked + ", is completed view:"
+ args.IsCompletedView);
};
Vungle.adPlayableEvent += (placementID, adPlayable) => {
DebugLog ("Ad's playable state has been changed! placementID " + placementID + ". Now: " + adPlayable);
};
Vungle.onInitializeEvent += () => {
adInited = true;
DebugLog ("SDK initialized");
};
}
Шаг 3. Загрузить, воспроизвести и закрыть рекламное объявление
Загрузить рекламное объявление
Загрузка неполноэкранных рекламных объявлений осуществляется не так, как загрузка полноэкранных, а с использованием особого loadBanner
API. Вы должны указать размер и местоположение неполноэкранного рекламного объявления, которое хотите загрузить, а SDK будет автоматически актуализировать его с периодичностью, которую вы зададите на информационной панели. Вы должны использовать те местоположения, которые созданы специально для рекламных баннеров или объявлений в формате MREC.
Загрузите неполноэкранное рекламное объявление, вызвав loadBanner
метод:
Vungle.loadBanner("PLACEMENT_ID", Vungle.VungleBannerSize.VungleAdSizeBanner, Vungle.VungleBannerPosition.BottomCenter);
Воспроизведите рекламное объявление
Неполноэкранные рекламные объявления будут воспроизводиться в том положении и с тем размером, какие вы указали при вызове loadBanner
, когда вызывали showBanner
.
Vungle.showBanner("PLACEMENT_ID");
Мы рекомендуем, чтобы вы проверили доступность рекламного объявления, прежде чем попытаетесь воспроизвести какое-либо рекламное объявление, и isAdvertAvailable
может использоваться как полноэкранное рекламное объявление. Однако для неполноэкранных рекламных объявлений вам потребуется пройти VungleBannerSize
в дополнение к идентификатору размещения объявления, которое вы намереваетесь воспроизводить.
Vungle.isAdvertAvailable("PLACEMENT_ID", Vungle.VungleBannerSize.VungleAdSizeBanner);
Закройте рекламное объявление
Вы можете вызвать closeBanner
, когда захотите закрыть неполноэкранное рекламное объявление.
Vungle.closeBanner("PLACEMENT_ID");