Banner

Os anúncios de banner são anúncios retangulares de imagem ou texto que ocupam um espaço dentro do layout do aplicativo. Eles permanecem na tela enquanto os usuários interagem com o app e podem ser atualizados automaticamente após um determinado período de tempo. Se você é novo em publicidade mobile, eles são uma excelente opção para começar.

Integração

Para integrar um banner, você precisa adicionar um componente da classe WABannerAd à interface do app.

Em seguida, solicite o carregamento de um anúncio como mostra o exemplo abaixo:

Swift

import UIKit
import WortiseSDK

class ViewController: UIViewController {
    @IBOutlet
    weak var bannerAd: WABannerAd!

    override func viewDidLoad() {
        super.viewDidLoad()
        ...
        bannerAd.adUnitId = "Ad Unit ID da Wortise"
        bannerAd.adSize = WAAdSize.height50
        bannerAd.rootViewController = self
        // Opcional: valor em segundos para atualizar o anúncio automaticamente
        bannerAd.autoRefreshTime = 60.0
        bannerAd.loadAd()
    }
}

Banners adaptativos

Os banners adaptativos são um novo formato de banner em que o tamanho dos anúncios se adapta ao dispositivo e à interface do app, para maximizar o desempenho.

Atualmente há suporte para dois tipos de banners adaptativos:

Ancorados

Este tipo de banner foi projetado para substituir os banners tradicionais de 320x50 e ser posicionado na parte superior ou inferior da tela.

Para usar este formato, o seguinte código deve ser utilizado para configurar um tamanho adaptativo:

Swift

// É necessário especificar a largura do banner
let adSize = WAAdSize.getAnchoredAdaptiveBannerAdSize(width: width)
bannerAd.adSize = adSize

Como alternativa, é possível implementar esta outra opção para que o SDK calcule a largura do banner, passando a própria instância do WABannerAd ou a UIView que irá contê-lo:

Cuidado

Nesta opção, é altamente recomendável que a UIView passada ao método já esteja adicionada ao layout do app, para que o SDK possa calcular corretamente todas as dimensões.

Swift

let adSize = WAAdSize.getAnchoredAdaptiveBannerAdSize(container: view)
bannerAd.adSize = adSize

Inline

Este outro tipo de banner, em comparação com os ancorados, foi projetado para ter uma altura variável e ser posicionado dentro de um conteúdo com rolagem.

Neste caso, o seguinte código deve ser utilizado para configurar um tamanho adaptativo adequado:

Swift

let maxHeight = 200

// É necessário especificar a largura do banner. A altura máxima é um
// parâmetro opcional
let adSize = WAAdSize.getInlineAdaptiveBannerAdSize(width: width,
                                                    maxHeight: maxHeight)
bannerAd.adSize = adSize

Como alternativa, é possível implementar esta outra opção para que o SDK calcule a largura do banner, passando a própria instância do WABannerAd ou a UIView que irá contê-lo:

Cuidado

Nesta opção, é altamente recomendável que a UIView passada ao método já esteja adicionada ao layout do app, para que o SDK possa calcular corretamente todas as dimensões.

Swift

let maxHeight = 200

let adSize = AdSize.getInlineAdaptiveBannerAdSize(container: view,
                                                  maxHeight: maxHeight)
bannerAd.adSize = adSize

Banners colapsáveis

Os banners colapsáveis são banners ancorados que inicialmente são exibidos como uma sobreposição maior, com um botão que os colapsa até o tamanho declarado. Eles foram pensados para melhorar o desempenho dos banners ancorados sem ocupar mais espaço de forma permanente.

Para solicitar um, passe uma instância de WARequestParameters com a posição desejada ao método loadAd:

Swift

let parameters = WARequestParameters(collapsible: .bottom)

bannerAd.loadAd(parameters: parameters)

A posição determina onde o anúncio expandido é ancorado, e deve corresponder à posição do banner dentro da interface do app:

Valor	Descrição
.bottom	O banner está posicionado na parte inferior da tela
.top	O banner está posicionado na parte superior da tela

Nota

Os banners colapsáveis exigem um tamanho adaptativo ancorado, portanto certifique-se de que o banner foi configurado conforme explicado na seção Ancorados.

Cuidado

O formato colapsável só é solicitado para o primeiro anúncio de uma instância de WABannerAd. Quando o banner é atualizado, os anúncios seguintes são solicitados como banners ancorados comuns.

Configuração do delegate

É possível definir um listener em qualquer instância de WABannerAd para receber os eventos que ocorrem durante seu ciclo de vida. Para isso, você precisa implementar a interface WABannerDelegate como mostra o exemplo abaixo:

Swift

extension ViewController : WABannerDelegate {

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

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

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

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

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

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

bannerAd.delegate = self