Перейти к основному содержимому
Версия: 3.4.0-beta.2

Баннеры

Классический тип рекламы, который обычно располагается внизу или вверху экрана приложения. Appodeal поддерживает стандартные размеры баннеров 320x50 для телефонов, 728x90 для планшетов и смарт баннеры на всю ширину экрана.

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

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

Баннер С Фиксированной Позицией

Отображение

В Appodeal SDK Баннеры являются синглтонами: если на разных контроллерах у вас есть и bannerTop, и bannerBottom, то Appodeal SDK будет использовать для них один и тот же экземпляр Баннера. Баннеры обновляются автоматически каждые 15 секунд. Для отображения Баннера внизу экрана используйте следующий код:

Appodeal.showAd(.bannerBottom, rootViewController: self)

Отображение Баннера Вверху Экрана

Appodeal.showAd(.bannerTop, rootViewController: self)

Отображение Баннера С Правой Или Левой Стороны

Если ваше приложение использует ландшафтную ориентацию, вы можете показывать баннеры с левой или правой стороны. Такой баннер будет иметь отступ в соответствии с safe area layout guide.

предупреждение

Выключите banner smart sizing, если вы используете AppodealShowStyleBannerLeft или AppodealShowStyleBannerRight

// Overrides default rotation angles
// Appodeal.setBannerLeftRotationAngleDegrees(90, rightRotationAngleDegrees: 180)


Appodeal.showAd(.bannerLeft, forPlacement: placement, rootViewController: self)
// Appodeal.showAd(.bannerRight, forPlacement: placement, rootViewController: self)

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

Вы можете проверить статус загрузки перед показом. Этот метод возвращает булевое значение, которое указывает, была ли загружена реклама.

Appodeal.isReadyForShow(with: .bannerTop)

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

Скрытие

Чтобы удалить Баннер из иерархии представлений:

Appodeal.hideBanner()

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

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

//set delegate
Appodeal.setBannerDelegate(self)

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

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

// banner was loaded (precache flag shows if the loaded ad is precache)
func bannerDidLoadAdIsPrecache(_ precache: Bool) {}
// banner was shown
func bannerDidShow() {}
// banner failed to load
func bannerDidFailToLoadAd() {}
// banner was clicked
func bannerDidClick() {}
// banner did expire and could not be shown
func bannerDidExpired() {}
подсказка

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

предупреждение

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

Баннер С Кастомной Позицией

Отображение Баннера В Программно Созданном Представлении

Вы можете добавить баннер в иерархию представлений вручную.

For example:

override func viewWillAppear(_ animated: Bool) {
super.viewWillAppear(animated)
if let banner = Appodeal.banner() {
self.view.addSubview(banner)
banner.frame = CGRect(x: 0, y: 0, width: self.view.bounds.width, height: 50)
}
}

Важно!

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

Дополнительно

Плейсменты

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

Appodeal.showAd(.bannerTop, forPlacement: placement, rootViewController: self)

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

Appodeal.canShow(.bannerTop, forPlacement: placement)

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

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

Важно!

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

Расширенные Возможности Интеграции

Если классические методы отображения Баннеров не подходят для вашего приложения вы можете использовать AppodealBannerView - UIView сабкласс для реализации:

import UIKit
import Appodeal

class YourViewController : UIViewController, AppodealBannerViewDelegate {

override func viewDidLoad () {
super.viewDidLoad()
// required: init ad banner
var bannerView: AppodealBannerView!
bannerView.init(size: bannerSize, rootViewController: self);

// optional: set delegate
bannerView.setDelegate(self);

// required: add banner to superview and call -loadAd to start banner loading
self.view addSubview(bannerView);
bannerView.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")
}
}
подсказка

Для улучшения пользовательского опыта, мы рекомендуем использовать единственный экземпляр APDBannerView для всех экранов, где должен отображаться баннер.

Даллее предложены несолько примеров: использование UIStoryboardSegue в Storyboard приложении и передача баннера в приложении с програмной навигацией с помощью UINavigationController.

Storyboard приложение.

  1. Создадим вспомогательный протокол, который будут использовать реализации UIViewController для размещения баннера.
BannerContainableController.swift
import Foundation
import UIKit
import Appodeal


protocol BannerContainableController: UIViewController {
var bannerContainerView: UIView! { get }
}

extension BannerContainableController {
func layoutBannerView(_ bannerView: APDBannerView) {
bannerView.removeFromSuperview()
bannerView.rootViewController = self
bannerContainerView.addSubview(bannerView)

NSLayoutConstraint.activate([
bannerView.topAnchor.constraint(equalTo: bannerContainerView.topAnchor),
bannerView.bottomAnchor.constraint(equalTo: bannerContainerView.bottomAnchor),
bannerView.leftAnchor.constraint(equalTo: bannerContainerView.leftAnchor),
bannerView.rightAnchor.constraint(equalTo: bannerContainerView.rightAnchor),
])
}
}

Этот проотокол будет использован в ParentViewController и ChildViewController для отображения баннера внизу экрана

  1. Создадим новый переход с идентификатором: ShowChildViewController
  1. Переопределим метод prepare(for segue:, sender:) в ParentViewController для передачи экземпляра баннера в ChildViewController.
ParentViewController.swift

import UIKit
import Appodeal


class ParentViewController: UIViewController, BannerContainableController {
@IBOutlet weak var bannerContainerView: UIView!

private lazy var bannerView = APDBannerView(size: kAPDAdSize320x50)

override func viewDidLoad() {
super.viewDidLoad()
// Load banner and it to the view in hierarchy
bannerView.loadAd()
bannerView.translatesAutoresizingMaskIntoConstraints = false
layoutBannerView(bannerView)
}

override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
guard
segue.identifier == "ShowChildViewController",
let childViewController = segue.destination as? ChildViewController
else { return }

childViewController.onDismiss = { [weak self] in
guard let self else { return }
self.layoutBannerView(self.bannerView)
}

childViewController.bannerView = bannerView
}
}

  1. При возвращении пользователя на ParentViewController, требуется вернуть экземпляр баннера в иерархию этого контроллера. Чтобы достичь данного метода будем использовать метод обратного вызова onDismiss.
ChildViewController.swift
import Foundation
import UIKit
import Appodeal


class ChildViewController: UIViewController, BannerContainableController {
@IBOutlet weak var bannerContainerView: UIView!

weak var bannerView: APDBannerView?

var onDismiss: (() -> ())?

override func viewDidLoad() {
super.viewDidLoad()
guard let bannerView = bannerView else { return }
layoutBannerView(bannerView)
}

override func viewWillDisappear(_ animated: Bool) {
super.viewWillDisappear(animated)
onDismiss?()
}
}

Приложение с in-code навигацией с помощью UINavigationController

  1. Создадим вспомогательный протокол, который будут использовать реализации UIViewController для размещения баннера по аналогии с предыдущим примером.

  2. В ParentViewController создаем новый инстанс ChildViewController и передаем в него экземпляр баннера.

ParentViewController.swift
import UIKit
import Appodeal


class ParentViewController: UIViewController, BannerContainableController {
private lazy var bannerView = APDBannerView(size: kAPDAdSize320x50)

override func viewDidLoad() {
super.viewDidLoad()
self.navigationItem.title = "Root View Controller"

bannerView.translatesAutoresizingMaskIntoConstraints = false

bannerView.rootViewController = self
bannerView.loadAd()

layoutBannerView(bannerView)

setupNavigationButton()
}

func setupNavigationButton() {
var configuration = UIButton.Configuration.filled()
configuration.titlePadding = 16
configuration.imagePadding = 16

let button = UIButton(configuration: configuration)
button.setImage(UIImage(systemName: "chevron.right"), for: .normal)
button.setTitle("Go To The Next View Controller", for: .normal)
button.translatesAutoresizingMaskIntoConstraints = false
button.addTarget(self, action: #selector(navigateToChildrenViewController), for: .touchUpInside)

view.addSubview(button)

NSLayoutConstraint.activate([
button.centerYAnchor.constraint(equalTo: view.centerYAnchor),
button.centerXAnchor.constraint(equalTo: view.centerXAnchor),
button.heightAnchor.constraint(equalToConstant: 44)
])
}

@objc func navigateToChildrenViewController() {
let destinationViewController = ChildViewController()
destinationViewController.layoutBannerView(bannerView)
destinationViewController.onDismiss = { [weak self] in
guard let self = self else { return }
self.layoutBannerView(self.bannerView)
}
navigationController?.pushViewController(destinationViewController, animated: true)
}
}
  1. В ChildViewController так же требуется вернуть экземпляр баннера в иерархию родительского контроллера при возвращении пользователя.
import UIKit

class ChildViewController: UIViewController, BannerContainableController {
var onDismiss: (() -> ())?

override func viewDidLoad() {
super.viewDidLoad()
}

override func viewWillDisappear(_ animated: Bool) {
super.viewWillDisappear(animated)
onDismiss?()
}
}

BannerView в приложениях использующих SwifUI

Также как и для UIKit приложений, для SwiftUI мы рекомендуем использовать единственный экземпляр APDBannerView для всех экранов,

Чтобы добиться указанного поведения, потребуется создать несколько вспомогательных классов.

  1. Создадим APDBannerViewController - контроллер, который будет использоваться для отображения баннера и мониторинга его жизненного цикла.
APDBannerViewController.swift
import UIKit
import Appodeal

final class APDBannerViewController: UIViewController {
weak var bannerView: APDBannerView?

var onDismiss: (() -> ())?

override func viewDidLoad() {
super.viewDidLoad()
layoutBannerView()
}

deinit {
onDismiss?()
}

func layoutBannerView() {
guard let bannerView = bannerView else { return }

bannerView.removeFromSuperview()
bannerView.rootViewController = self
view.addSubview(bannerView)

NSLayoutConstraint.activate([
bannerView.topAnchor.constraint(equalTo: view.topAnchor),
bannerView.bottomAnchor.constraint(equalTo: view.bottomAnchor),
bannerView.leftAnchor.constraint(equalTo: view.leftAnchor),
bannerView.rightAnchor.constraint(equalTo: view.rightAnchor),
])
}
}

  1. Создадим BannerView - структура, которая имплементирует протокол UIViewControllerRepresentable. Данная структура будет использована для размещения баннера в иерархии отображений приложения. Также потребуется создать произвольный Coordinator (в данном примеры он будет единственным экземпляром). Он будет использовать NSHashTable для хранения и управления ссылками на экземпляры APDBannerViewController.
BannerView.swift
import SwiftUI


struct BannerView: UIViewControllerRepresentable {
typealias UIViewControllerType = APDBannerViewController

func makeUIViewController(context: Context) -> APDBannerViewController {
let controller = APDBannerViewController()
controller.bannerView = context.coordinator.bannerView
controller.onDismiss = context.coordinator.dismiss
context.coordinator.store(controller)
return controller
}

func updateUIViewController(
_ uiViewController: APDBannerViewController,
context: Context
) {}

func makeCoordinator() -> Coordinator {
return .shared
}

final class Coordinator {
static let shared = Coordinator()

private lazy var storage = NSHashTable<APDBannerViewController>(options: .weakMemory)

lazy var bannerView: APDBannerView = {
let bannerView = APDBannerView(size: kAPDAdSize320x50)
bannerView.translatesAutoresizingMaskIntoConstraints = false
bannerView.loadAd()
return bannerView
}()

func store(_ controller: APDBannerViewController) {
storage.add(controller)
}

func dismiss() {
let previousController = storage.allObjects.last

previousController?.bannerView = bannerView
previousController?.layoutBannerView()
}
}
}

  1. Теперь мы можем добавить BannerView в ирархию отображений SwiftUI.
предупреждение

Для BannerView требуется передать frame фиксированной высоты.

ContentView.swift
import SwiftUI


struct ContentView: View {
var body: some View {
NavigationStack {
VStack {
BannerView()
.frame(height: 50)
.frame(maxWidth: .infinity)
.background(Color(uiColor: .secondarySystemFill))
Spacer()
NavigationLink(
destination: {
ChildView()
},
label: {
HStack {
Image(systemName: "chevron.right")
Text("Go To The Next View")
}
.foregroundColor(.white)
.padding()
.background(RoundedRectangle(cornerRadius: 8).fill(Color.blue))
}
)
}
.navigationTitle("Root View")
}
}
}


struct ChildView: View {
var body: some View {
NavigationStack {
VStack {
Spacer()
BannerView()
.frame(height: 50)
.frame(maxWidth: .infinity)
.background(Color(uiColor: .secondarySystemFill))
}
.navigationTitle("Child View")
}
}
}


Включение Смарт Баннеров

Смарт-баннеры – это баннеры, которые автоматически подстраиваются под размеры экрана/контейнера. Их использование позволяет добиться корректного отображения рекламы на устройствах с любым размером экрана. Для того, чтобы подключить их, используйте следующий метод:

//for top/bottom banners allows banner view to resize automatically to fit device screen
Appodeal.setSmartBannersEnabled(true)
//for banner view allows banner view to resize automatically to fit device screen
bannerView.usesSmartSizing = true

Изменение Фона Для Баннеров

Этот метод позволяет создать фон серого цвета для Баннеров:

//for top/bottom banners
Appodeal.setBannerBackgroundVisible(true)

//for bannerView
bannerView.backgroundVisible = true

Включение Анимации При Смене Баннеров

//for top/bottom banners
Appodeal.setBannerAnimationEnabled(true)

//for bannerView
bannerView.bannerAnimationEnabled = true

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

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

Appodeal.predictedEcpm(for: .banner)

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

Appodeal.isInitialized(for: .banner)

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

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

Appodeal.isAutocacheEnabled(.banner)

Возвращает true, если было включено автоматическое кеширование для Баннерной рекламы.

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

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

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

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