Перейти к основному содержимому
Версия:

MREC

View-Based формат рекламы

MREC – это view-based формат рекламы, который ведет себя иначе, чем другие типы рекламы Appodeal. В отличие от межстраничной или видеорекламы с вознаграждением, MREC отображается как view-элемент, который нужно вручную добавлять в иерархию представлений.

MREC – это баннер с размером 300x250. Данный тип рекламы может быть полезен в приложениях, где есть достаточно места для его размещения в пользовательском интерфейсе.

Вы можете использовать наше демо приложение в качестве примера по интеграции.

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

Ручное Кеширование​

MREC не поддерживает режим автоматического кеширования.

Для загрузки MREC используйте метод:

// MREC view
mrec.loadAd()

Более подробную информацию о ручном кешировании вы можете найти в нашем FAQ.

Проверка Загрузки​

Важно

Для проверки готовности MREC рекламы необходимо использовать свойство mrec.isReady.

// MREC view
mrec.isReady

Отображение​

Класс AppodealMRECView – это сабкласс AppodealBannerView. AppodealMRECView - это баннер с размером 300x250.

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

import UIKit
import Appodeal

class YourViewController: UIViewController, AppodealBannerViewDelegate {

  override func viewDidLoad () {
    super.viewDidLoad()
    // required: init ad banner
    let mrecView: AppodealMRECView = AppodealMRECView()
    mrecView.usesSmartSizing = false
    mrecView.rootViewController = self

    // optional: set delegate
    mrecView.delegate = self

    // required: add banner to superview and call -loadAd to start banner loading
    self.view.addSubview(mrecView)
    mrecView.loadAd()
  }

  // optional: implement any of AppodealBannerViewDelegate methods
  func bannerViewDidLoadAd(_ bannerView: APDBannerView, isPrecache precache: Bool) {
     NSLog("bannerView was loaded")       
  }

  func bannerView(_ bannerView: APDBannerView, didFailToLoadAdWithError error: Error) {
     NSLog("bannerView failed to load");        
  }

  func bannerViewDidInteract(_ bannerView: APDBannerView) {
     NSLog("bannerView was clicked")
  }

  func bannerViewDidShow(_ bannerView: APDBannerView) {
     NSLog("bannerView was shown")
  }

  func bannerViewExpired(_ bannerView: APDBannerView) {
     NSLog("bannerView did expire and could not be shown")
  }
}

Методы Обратного Вызова​

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

//set delegate
mrecView.delegate = self

Обычно класс, который работает с MREC-баннерами, одновременно является и классом делегата, поэтому в качестве свойства делегата можно указать self.

Теперь вы можете использовать следующие методы обратного вызова:

// MREC was loaded (precache flag shows if the loaded ad is precache)
func bannerViewDidLoadAd(_ bannerView: APDBannerView, isPrecache precache: Bool) {}
// MREC failed to load
func bannerView(_ bannerView: APDBannerView, didFailToLoadAdWithError error: Error) {}
// MREC was clicked
func bannerViewDidInteract(_ bannerView: APDBannerView) {}
// MREC was shown
func bannerViewDidShow(_ bannerView: APDBannerView) {}
// MREC failed to show
func bannerView(_ bannerView: APDBannerView, didFailToPresentWithError error: Error) {}
// MREC did expire and could not be shown
func bannerViewExpired(_ bannerView: APDBannerView) {}
подсказка

Все функции обратного вызова вызываются в главном потоке.

Плейсменты​

Appodeal SDK позволяет вам отмечать показы различными тегами с помощью плейсментов. Для использования данной функции вам необходимо создать плейсмент в настройках вашего приложения. Больше информации о плейсментах в нашем руководстве about placements.

// set placement before adding the MREC view to the view hierarchy
mrecView.placement = "placementName"
Важно для MREC

Не используйте Appodeal.canShow(.MREC, forPlacement:) для проверки возможности показа рекламы для плейсмента. Этот метод ненадежен для MREC и будет возвращать false даже когда реклама готова к показу.

Вместо этого используйте mrec.isReady для проверки готовности MREC перед показом.

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

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

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

Важно!

Настройки плейсментов влияют только на показ рекламы и не влияют на ее загрузку.

Получение Прогнозируемого eCPM​

Этот метод возвращает ожидаемый eCPM для загруженного креатива. Цена высчитывается из исторических данных для конкретного рекламного блока.

Appodeal.predictedEcpm(for: .MREC)

Проверка Инициализации​

Appodeal.isInitialized(for: .MREC)

Возвращает true, если MREC реклама была проинициализирована.

Проверка Типа Кеширования​

MREC не поддерживает автоматическое кеширование.

Скрытие​

MREC - это наследник UIView, для скрытия которого достаточно удалить его с superview.

// MREC view
mrec.removeFromSuperview()

Отслеживание Показа​

Вы всегда можете проверить в логах, был ли отслежен показ и видна ли ваша реклама.

В случае успешного показа вы увидите следующий лог:

[Appodeal *.*.*] [debug] [impression] Impression <APDImpression: 0x600002953b10> succesfully tracked