App Open

Os anúncios App Open são um formato especial cujo principal objetivo é permitir a monetização das telas de carregamento do app.

Esses anúncios podem ser fechados a qualquer momento e foram pensados para serem exibidos quando o app volta ao primeiro plano.

Integração

Este formato de anúncio só pode ser integrado por código, implementando qualquer uma das duas formas de integração descritas abaixo.

Manual

Neste tipo de integração, você precisa criar uma instância da classe WAAppOpenAd e usar os métodos loadAd() e showAd() para carregar e exibir o anúncio sob demanda. O publisher é o responsável por decidir quando o anúncio deve ser exibido e por implementar a lógica necessária.

Abaixo você encontra um exemplo simples de integração:

Swift

import UIKit
import WortiseSDK

class ViewController: UIViewController {

    private var appOpenAd: WAAppOpenAd!

    override func viewDidLoad() {
        super.viewDidLoad()
        ...
        appOpenAd = WAAppOpenAd(adUnitId: "test-app-open")
        appOpenAd.loadAd()
    }

    override func willMove(toParent controller: UIViewController?) {
        super.willMove(toParent: controller)
        ...
        appOpenAd.destroy()
    }

    func showAppOpen() {
        if appOpenAd.isAvailable {
            appOpenAd.showAd(from: self)
        }
    }
}

Além disso, a classe WAAppOpenAd oferece os seguintes métodos adicionais para configurar seu comportamento:

Swift

// Define se um novo anúncio deve ser carregado após fechar o anterior
appOpenAd.autoReload = true

// Exibe um anúncio imediatamente, se disponível. Caso contrário, solicita o
// carregamento de um novo anúncio
appOpenAd.tryToShowAd(from: self)

Via Manager

O SDK oferece uma implementação padrão de App Open para facilitar a integração deste formato de anúncio.

Para realizar este tipo de integração, você precisa criar uma instância de WAAppOpenManager dentro da classe AppDelegate, como mostra o exemplo abaixo:

Swift

import UIKit
import WortiseSDK

class AppDelegate: UIResponder, UIApplicationDelegate {

    private var appOpenManager: WAAppOpenManager!

    func application(_
        application: UIApplication, didFinishLaunchingWithOptions
        launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        ...
        appOpenManager = WAAppOpenManager(adUnitId: "test-app-open")
        appOpenManager.loadAd()
    }
}

Com esta integração simples, o app exibirá anúncios sempre que houver uma transição do segundo plano para o primeiro plano.

Além disso, a classe WAAppOpenManager oferece os mesmos métodos que WAAppOpenAd para configurar seu comportamento e exibir anúncios sob demanda.

Configuração do delegate

Assim como nos outros formatos, é possível definir um delegate para receber os eventos que ocorrem durante o ciclo de vida do anúncio. Para isso, você precisa implementar a interface WAAppOpenDelegate como mostra o exemplo abaixo:

Swift

extension AppDelegate : WAAppOpenDelegate {

    func didClick(appOpenAd: WAAppOpenAd) {
        // Invocado quando o anúncio foi clicado
    }

    func didDismiss(appOpenAd: WAAppOpenAd) {
        // Invocado quando o anúncio foi fechado
    }

    func didFailToLoad(appOpenAd: WAAppOpenAd, error: WAAdError) {
        // Invocado quando não foi possível carregar o anúncio
        // (por causa de um erro ou sem preenchimento (no fill))
    }

    func didFailToShow(appOpenAd: WAAppOpenAd, error: WAAdError) {
        // Invocado quando não foi possível exibir o anúncio
    }

    func didImpress(appOpenAd: WAAppOpenAd) {
        // Invocado quando o anúncio gerou uma impressão
    }

    func didLoad(appOpenAd: WAAppOpenAd) {
        // Invocado quando o anúncio foi carregado
    }

    func didPayRevenue(appOpenAd: WAAppOpenAd, data: WARevenuedata) {
        // Invocado quando o anúncio gerou receita
    }

    func didShow(appOpenAd: WAAppOpenAd) {
        // Invocado quando o anúncio foi exibido
    }
}

Depois de implementar a interface, o delegate é atribuído à instância do anúncio:

appOpenAd.delegate = self