Рекламные форматы Unity


Баннеры

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

Для показа баннеров форматов 320x50, 300x250 и 728x90 в своем приложении необходимо создать экземпляр класса MyTargetView. Для создания экземпляра MyTargetView необходимо указать ваш slotId. Для задания формата, необходимо в метод инициализации передать одно из значений AdSize. По умолчанию устанавливается формат 320x50.
private MyTargetView _myTargetView;
private void Awake()
{
    UInt32 slotId = 0;
#if UNITY_ANDROID
    slotId = ANDROID_SLOT_ID;
#elif UNITY_IOS
    slotId = IOS_SLOT_ID;
#endif
     
    // Включение режима отладки
    // MyTargetView.IsDebugMode = true;
 
 
    // Создаем экземпляр MyTargetView, формат 320x50
    _myTargetView = new MyTargetView(slotId);
  
    // Создаем экземпляр MyTargetView, формат 300х250
    // _myTargetView = new MyTargetView(slotId, AdSize.Size300x250);
}

Загрузка и показ рекламных объявлений

Для получения уведомлений о событиях успешной загрузки, ошибке при загрузке, клика по рекламному объявлению необходимо установить обработчики соответствующих событий. Показ рекламного объявления возможен только после успешного выполнения загрузки данных.
private readonly Object _syncRoot = new Object();
private MyTargetView _myTargetView;
private void Awake()
{
    if (_myTargetView != null)
    {
        return;
    }  
    lock (_syncRoot)
    {
        if (_myTargetView != null)
        {
            return;
        }  
         
        // Создаем экземпляр MyTargetView
        _myTargetView = new MyTargetView(YOUR_SLOT_ID);
     
        // Устанавливаем обработчики событий
        _myTargetView.AdClicked += OnAdClicked;
        _myTargetView.AdLoadFailed += OnAdLoadFailed;
        _myTargetView.AdLoadCompleted += OnAdLoadCompleted;
        _myTargetView.AdShown += OnAdShown;
 
        // Запускаем загрузку данных
        _myTargetView.Load();
    }
}
  
private void OnAdClicked(Object sender, EventArgs eventArgs) { }
 
private void OnAdShown(Object sender, EventArgs eventArgs) { }
 
private void OnAdLoadFailed(Object sender, ErrorEventArgs errorEventArgs) { }
  
private void OnAdLoadCompleted(Object sender, EventArgs eventArgs)
{
    // Данные успешно загружены
     
    // Устанавливаем позицию на экране
    _myTargetView.X = 0;
    _myTargetView.Y = 0;
     
    // Запускаем показ объявлений
    _myTargetView.Start();
}
  
private void OnDestroy()
{
    if (_myTargetView == null)
    {
        return;
    }
    lock (_syncRoot)
    {
        if (_myTargetView == null)
        {
            return;
        }
        _myTargetView.Dispose();
        _myTargetView = null;
    }
}

Ротация

Рекламные объявления ротируются каждые 60 секунд. Вы можете отключить автоматическую ротацию объявлений при создании экземпляра MyTargetView, указав дополнительный параметр isRefreshAd. Ротируются только баннеры форматов 320х50 и 728x90, баннеры 300х250 не ротируются.
// Выключение автоматической ротации баннеров
_myTargetView = new MyTargetView(YOUR_SLOT_ID, AdSize.Size320x50, false)
Пример баннера 320x50

Полноэкранная реклама

myTarget SDK предоставляет возможность показывать полноэкранную рекламу в своем приложении. Возможны два способа показа полноэкранной рекламы - на отдельной странице или в диалоговом окне. Мы рекомендуем использовать показ на отдельной странице.

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

Для показа полноэкранных рекламных объявлений в своем приложении необходимо создать экземпляр класса InterstitialAd. Для создания экземпляра необходимо указать ваш slotId. Для каждой поддерживаемой платформы свой slotId.
private InterstitialAd CreateInterstitialAd()
{
    UInt32 slotId = 0;
#if UNITY_ANDROID
    slotId = ANDROID_SLOT_ID;
#elif UNITY_IOS
    slotId = IOS_SLOT_ID;
#endif
 
 
    // Включение режима отладки
    // InterstitialAd.IsDebugMode = true;
    // Создаем экземпляр InterstitialAd
    return new InterstitialAd(slotId);
}

Загрузка рекламных объявлений

Для получения уведомлений (окончание загрузки, клик по рекламному объявлению, скрытие баннера) необходимо установить обработчики на соответствующие события.
private InterstitialAd _interstitialAd;
 
private void InitAd()
{
    // Создаем экземпляр InterstitialAd
    _interstitialAd = CreateInterstitialAd();
     
    // Устанавливаем обработчики событий
    _interstitialAd.AdLoadCompleted += OnLoadCompleted;
    _interstitialAd.AdDismissed += OnAdDismissed;
    _interstitialAd.AdDisplayed += OnAdDisplayed;
    _interstitialAd.AdVideoCompleted += OnAdVideoCompleted;
    _interstitialAd.AdClicked += OnAdClicked;
    _interstitialAd.AdLoadFailed += OnAdLoadFailed;
     
    // Запускаем загрузку данных
    _interstitialAd.Load();
}
 
private void OnLoadCompleted(Object sender, EventArgs e)
{
     
}
 
private void OnAdDismissed(Object sender, EventArgs e)
{
     
}
 
private void OnAdDisplayed(Object sender, EventArgs e)
{
     
}
 
private void OnAdVideoCompleted(Object sender, EventArgs e)
{
 
}
  
private void OnAdClicked(Object sender, EventArgs e)
{
          
}
  
private void OnAdLoadFailed(Object sender, ErrorEventArgs e)
{
    Debug.Log("OnAdLoadFailed: " + e.Message);
}

Показ рекламных объявлений

После успешной загрузки данных вы можете запустить показ полноэкранной рекламы.

private void OnLoadCompleted(Object sender, EventArgs e)
{
    // на отдельной странице
    _interstitialAd.Show();
 
    // или в диалоговом окне
    // _interstitialAd.ShowDialog();
}
Пример полноэкранного баннера

Полноэкранная реклама с вознаграждением (Rewarded видео)

myTarget SDK предоставляет возможность показывать видеорекламу в своем приложении. Возможны два способа показа полноэкранной рекламы — на отдельной странице или в диалоговом окне. Мы рекомендуем использовать показ на отдельной странице.

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

Для показа полноэкранных рекламных объявлений в своем приложении необходимо создать экземпляр класса InterstitialAd. Для создания экземпляра необходимо указать ваш slotId. Для каждой поддерживаемой платформы свой slotId.
private InterstitialAd CreateInterstitialAd()
{
    UInt32 slotId = 0;
#if UNITY_ANDROID
    slotId = ANDROID_SLOT_ID;
#elif UNITY_IOS
    slotId = IOS_SLOT_ID;
#endif
    // Включение режима отладки
    // InterstitialAd.IsDebugMode = true;
    // Создаем экземпляр InterstitialAd
    return new InterstitialAd(slotId);
}

Загрузка рекламных объявлений

Для получения уведомлений (окончание загрузки, клик по рекламному объявлению, скрытие баннера) необходимо установить обработчики на соответствующие события.
private InterstitialAd _interstitialAd;
 
private void InitAd()
{
    // Создаем экземпляр InterstitialAd
    _interstitialAd = CreateInterstitialAd();
     
    // Устанавливаем обработчики событий
    _interstitialAd.AdLoadCompleted += OnLoadCompleted;
    _interstitialAd.AdDisplayed += OnAdDisplayed;
    _interstitialAd.AdDismissed += OnAdDismissed;
    _interstitialAd.AdVideoCompleted += OnAdVideoCompleted;
    _interstitialAd.AdClicked += OnAdClicked;
    _interstitialAd.AdLoadFailed += OnAdLoadFailed;
     
    // Запускаем загрузку данных
    _interstitialAd.Load();
}
 
private void OnLoadCompleted(Object sender, EventArgs e)
{
     
}
private void OnAdDisplayed(Object sender, EventArgs e)
{
     
}
 
private void OnAdDismissed(Object sender, EventArgs e)
{
     
}
  
private void OnAdVideoCompleted(Object sender, EventArgs e)
{
 
}
 
private void OnAdClicked(Object sender, EventArgs e)
{
          
}
 
private void OnAdLoadFailed(Object sender, ErrorEventArgs e)
{
    Debug.Log("OnAdLoadFailed: " + e.Message);
}

Показ рекламных объявлений

После успешной загрузки данных вы можете запустить показ полноэкранной рекламы.
private void OnLoadCompleted(Object sender, EventArgs e)
{
    // на отдельной странице
    _interstitialAd.Show();
 
    // или в диалоговом окне
    // _interstitialAd.ShowDialog();
}
Пример rewarded video

Пользовательские данные

Для задания пользовательских данных вам нужно воспользоваться свойством CustomParams созданного экземпляра API.
private InterstitialAd _ad;
 
private void InitAd()
{
    // Создаем экземпляр InterstitialAd
    _ad = new InterstitialAd(YOUR_SLOT_ID);
 
    // Задаем возраст
    _ad.CustomParams.Age = 23;
    // Задаем пол
    _ad.CustomParams.Gender = CustomParams.GenderEnum.Male;    
}

Примеры

Примеры входят в unitypackage.
Вам помогла эта статья?
Да
Нет