iOS SDK: Rewarded видео


myTarget SDK предоставляет возможность показывать rewarded video (видео за награду, RV) в приложении.

Короткие (до 30 сек) non-skippable (без возможности пропустить) ролики —премиальный формат с самыми высокими CPM.

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

Для показа видеорекламы в своем приложении необходимо создать экземпляр класса MTRGInterstitialAd. Для создания экземпляра необходимо указать ваш slotId.
@interface YourViewController : UIViewController
@end
 
@implementation YourViewController
{
  MTRGInterstitialAd *_ad;
}
 
- (void)initAd
{
    // Включение режима отладки
    // [MTRGInterstitialAd setDebugMode:YES];
    // Создаем экземпляр MTRGInterstitialAd
    _ad = [MTRGInterstitialAd interstitialAdWithSlotId:YOUR_SLOT_ID];
}

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

Для получения уведомлений (таких как успешная загрузка данных или ошибка загрузки, клик по рекламному объявлению) необходимо установить созданному экземпляру MTRGInterstitialAd делегат, реализующий протокол MTRGInterstitialAdDelegate, после чего можно запустить загрузку данных.
@interface YourViewController : UIViewController <MTRGInterstitialAdDelegate>
@end
 
@implementation YourViewController
{
  MTRGInterstitialAd *_ad;
}
 
- (void)initAd
{
    // Создаем экземпляр MTRGInterstitialAd
    _ad = [MTRGInterstitialAd interstitialAdWithSlotId:YOUR_SLOT_ID];
     
    // Устанавливаем делегат
    _ad.delegate = self;
     
    // Запускаем загрузку данных
    [_ad load];
}
 
- (void)onLoadWithInterstitialAd:(MTRGInterstitialAd *)interstitialAd
{
}
  
- (void)onNoAdWithReason:(NSString *)reason interstitialAd:(MTRGInterstitialAd *)interstitialAd
{
}
- (void)onDisplayWithInterstitialAd:(MTRGInterstitialAd *)interstitialAd
{
}
 
- (void)onClickWithInterstitialAd:(MTRGInterstitialAd *)interstitialAd
{
}
 
- (void)onCloseWithInterstitialAd:(MTRGInterstitialAd *)interstitialAd
{
}
- (void)onVideoCompleteWithInterstitialAd:(MTRGInterstitialAd *)interstitialAd
{
   // Используется для начисления награды пользователю
}
- (void)onLeaveApplicationWithInterstitialAd:(MTRGInterstitialAd *)interstitialAd
{
}

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

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

- (void)onLoadWithInterstitialAd:(MTRGInterstitialAd *)interstitialAd
{
    [_ad showWithController:self];
}
Пример rewarded video
Пример rewarded video

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

Для лучшего подбора рекламных объявлений, вы можете дополнительно задать пол и возраст пользователя. Если ваше приложение использует собственную модель локализации, вы также можете указать язык выбранной локализации в формате ISO 639-1 ("ru", "en", "fr" и т.д.).

Для задания пользовательских данных вам нужно воспользоваться свойством customParams.
@interface YourViewController : UIViewController
@end
 
@implementation YourViewController
{
  MTRGInterstitialAd *_ad;
}
 
- (void)initAd
{
    // Создаем экземпляр MTRGInterstitialAd
    _ad = [MTRGInterstitialAd interstitialAdWithSlotId:YOUR_SLOT_ID];
  
    // Задаем возраст
    _ad.customParams.age = [NSNumber numberWithInt:25];
    // Задаем пол
    _ad.customParams.gender = MTRGGenderMale;
}

Примеры

Примеры интеграции доступны в нашем демоприложении на Github.

Медиация с другими рекламными SDK

Для видеорекламы поддерживается медиация с Admob SDK и Mopub SDK.

Медиация Admob

myTarget является сертифицированным партнером Google Mediation.

Требования
- Xcode 11 или выше
- iOS Deployment target of 9.0 или выше
- Google Mobile Ads SDK 7.57.0 или выше

Краткая инструкция для медиации myTarget через Admob
- Настроить группу медиации в настройках рекламного блока Admob
- Импортировать myTarget SDK и адаптер (при установке адаптера с помощью менеджера зависимостей CocoaPods, автоматически будет установлены myTarget SDK и Google Mobile Ads SDK)
- Протестировать интеграцию

Пожалуйста, ознакомьтесь с полной версией инструкции: https://developers.google.com/admob/ios/mediation/mytarget#step_2_configure_mediation_settings_for_your_ad_unit

Медиация Mopub

Для медиации с Mopub SDK необходимо добавить в проект классы медиации.

Настройка медиации осуществляется на сайте http://www.mopub.com/

В настройках Network необходимо задать следующие поля:
Поле
Значение
CUSTOM EVENT CLASS
MTRGMopubRewardedVideoCustomEvent
CUSTOM EVENT CLASS DATA
{"slotId":"your slot Id"}
Вам помогла эта статья?
Да
Нет