Anúncios intersticiais

A publicidade intersticial é um formato de anúncio em tela cheia incorporado ao conteúdo do aplicativo durante pausas naturais, como a transição entre níveis de jogo ou a conclusão de uma ação-alvo.

Quando o aplicativo renderiza um anúncio intersticial, o usuário tem duas opções: clicar no anúncio e ir para o site do anunciante ou fechar o anúncio e voltar para o aplicativo.

Nos anúncios intersticiais, a atenção do usuário está totalmente focada nos anúncios, por isso o custo de impressão é maior.

Aparência

Este guia mostrará como integrar anúncios intersticiais em aplicativos iOS. Além de exemplos de código e instruções, contém recomendações específicas aos formatos e links para recursos adicionais.

Pré-requisito

1. Siga os passos de integração do SDK descritos em Início rápido.
2. Inicialize seu SDK de anúncios com antecedência.
3. Confirme se você está utilizando a última versão do Yandex Mobile Ads SDK. Se você estiver usando mediação, confirme se também está utilizando a última versão da compilação unificada.

Implementação

Principais passos para integrar anúncios intersticiais:

• Criar e configurar o carregador de anúncios InterstitialAdLoader.
• Definir um delegado e implementar os métodos de AdInterstitialAdLoaderDelegate necessários.
• Carregar o anúncio.
• Passar configurações adicionais se você estiver usando Adfox.
• Se necessário, definir um delegado para o objeto de anúncio e implementar os métodos de AdInterstitialAdDelegate necessários.
• Renderizar o anúncio.

Características da integração de anúncios intersticiais

1. Todas as chamadas para métodos do Yandex Mobile Ads SDK devem ser feitas a partir do thread principal.

2. Aconselhamos que você não tente carregar um novo anúncio ao receber um erro no callback func interstitialAdLoader(_ adLoader: InterstitialAdLoader, didFailToLoadWithError error: AdRequestError). Se você precisar carregar um anúncio de func interstitialAdLoader(_ adLoader: InterstitialAdLoader, didFailToLoadWithError error: AdRequestError), restrinja as tentativas de carregamento de anúncios para evitar solicitações de anúncios malsucedidas recorrentes devido a restrições de conexão de rede.

3. Recomendamos manter uma referência forte ao anúncio e seu carregador durante todo o ciclo de vida da tela que interage com o anúncio.

Carregamento de anúncios

Para carregar anúncios intersticiais, você precisa criar uma instância da classe InterstitialAdLoader.

Para notificar quando os anúncios são carregados ou falham ao carregar, defina a propriedade delegate para a classe InterstitialAdLoader e implemente o delegado InterstitialAdLoaderDelegate.

final class InterstitialViewController: UIViewController {
    private lazy var interstitialAdLoader: InterstitialAdLoader = {
        let loader = InterstitialAdLoader()
        loader.delegate = self
        return loader
    }()
}

extension InterstitialViewController: InterstitialAdLoaderDelegate {
    func interstitialAdLoader(_ adLoader: InterstitialAdLoader, didLoad interstitialAd: InterstitialAd) {
        // This method will call after successfully loading
    }

    func interstitialAdLoader(_ adLoader: InterstitialAdLoader, didFailToLoadWithError error: AdRequestError) {
        // This method will call after getting any error while loading the ad
    }
}

Para carregar um anúncio, você vai precisar do identificador da unidade de anúncio da interface do Yandex Advertising Network (adUnitId).

Você pode expandir os parâmetros de solicitação de anúncio através de AdRequestConfiguration, passando interesses do usuário, dados contextuais da página, detalhes de localização ou outras informações. Dados contextuais adicionais entregues na solicitação podem melhorar consideravelmente a qualidade do anúncio. Saiba mais na seção Segmentação de anúncios.

O exemplo a seguir mostra como carregar um anúncio intersticial a partir do View Controller:

final class InterstitialViewController: UIViewController {
    private lazy var interstitialAdLoader: InterstitialAdLoader = {
        let loader = InterstitialAdLoader()
        loader.delegate = self
        return loader
    }()

    func loadAd() {
        let configuration = AdRequestConfiguration(adUnitID: "R-M-XXXXX-YY")
        interstitialAdLoader.loadAd(with: configuration)
    }
}

Renderização de anúncios

Os anúncios intersticiais devem ser exibidos durante pausas naturais no funcionamento do aplicativo. Uma boa opção é inserir anúncios intersticiais entre níveis de um jogo ou após uma conversão (por exemplo, após um arquivo ser baixado).

Após o anúncio intersticial ser carregado com êxito, o método func interstitialAdLoader(_ adLoader: InterstitialAdLoader, didLoad interstitialAd: InterstitialAd) será chamado. Use-o para exibir o anúncio intersticial.

final class InterstitialViewController: UIViewController {
    private var interstitialAd: InterstitialAd?

    func showAd() {
        interstitialAd?.show(from: self)
    }
}

extension InterstitialViewController: InterstitialAdLoaderDelegate {
    func interstitialAdLoader(_ adLoader: InterstitialAdLoader, didLoad interstitialAd: InterstitialAd) {
        self.interstitialAd = interstitialAd
        self.interstitialAd.delegate = self

        showAd()
    }
}

Teste da integração de anúncios intersticiais

Uso de blocos de anúncios de demonstração para teste de anúncios

Recomendamos usar anúncios de teste para testar sua integração de anúncios e seu próprio aplicativo.

Para garantir que anúncios de teste sejam retornados para cada solicitação de anúncio, criamos um ID especial de posicionamento de anúncios de demonstração. Use-o para verificar sua integração de anúncios.

adUnitId de demonstração: demo-interstitial-yandex.

Confira a lista de IDs de posicionamento de anúncios de demonstração disponíveis na seção Blocos de anúncio de demonstração para teste.

Teste da integração de anúncios

Você pode testar sua integração de anúncios usando a ferramenta Console nativa.

Para ver logs detalhados, chame o método enableLogging da classe YMAMobileAds.

YMAMobileAds.enableLogging()

Para ver os logs do SDK, acesse a ferramenta Console e defina Subsystem = com.mobile.ads.ads.sdk. Você também pode filtrar logs por categoria e nível de erro.

Se você estiver tendo problemas para integrar anúncios, receberá um relatório detalhado sobre os problemas e recomendações de como corrigi-los.

Recursos adicionais

• Link para GitHub.