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 um aplicativo exibe um anúncio intersticial, o usuário pode clicar para acessar o site do anunciante ou fechar o anúncio e retornar ao app.

Durante as impressões de anúncios intersticiais, a atenção do usuário fica totalmente voltada para o anúncio, o que resulta em um custo mais alto para essas impressões.

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. Primeiro, é preciso inicializar o SDK de publicidade.
3. Certifique-se de estar usando a última versão do Yandex Mobile Ads SDK e, caso esteja usando mediação, a última versão do build unificado.

Implementação

Principais passos para integrar anúncios intersticiais:

• Criar e configurar o carregador de anúncios InterstitialAdLoader.
• 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 InterstitialAdDelegate 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 enfaticamente a não tentar carregar outro anúncio imediatamente após um erro de carregamento. Com completion handlers, isso corresponde ao caso .failure. Com swift concurrency, ao bloco catch. Caso precise tentar carregar anúncios de novo a partir do handler de erros, limite o número de tentativas. Isso ajuda a evitar que ocorram infindáveis solicitações de anúncio sem sucesso quando houver problemas na rede.

3. Recomendamos manter uma referência forte ao anúncio e seu carregador durante todo o ciclo de vida da tela na qual ocorre a interação com o anúncio.

Carregamento de anúncios

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

Para carregar um anúncio, use o método loadAd(with:completion:) com um completion handler ou o método loadAd(with:) com swift concurrency.

Você pode expandir os parâmetros de solicitação de anúncio através de AdRequest, passando interesses do usuário, dados contextuais da página, detalhes de localização ou outras informações. O acréscimo de mais contexto às solicitações de anúncios pode melhorar a qualidade dos anúncios consideravelmente. Para saber mais, consulte 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()
    private var interstitialAd: InterstitialAd?

    func loadAd() async {
        let request = AdRequest(adUnitID: "R-M-XXXXX-YY")
        do {
            let ad = try await interstitialAdLoader.loadAd(with: request)
            interstitialAd = ad
            ad.delegate = self
        } catch {
            // Erro de carregamento
        }
    }
}

final class InterstitialViewController: UIViewController {
    private lazy var interstitialAdLoader = InterstitialAdLoader()
    private var interstitialAd: InterstitialAd?

    func loadAd() {
        let request = AdRequest(adUnitID: "R-M-XXXXX-YY")
        interstitialAdLoader.loadAd(with: request){ [weak self] result in
            switch result {
            case .success(let ad):
                self?.interstitialAd = ad
                ad.delegate = self
            case .failure:
                // Erro de carregamento
                break
            }
        }
    }
}

Exibição de anúncios

Os anúncios intersticiais devem ser exibidos durante pausas naturais no funcionamento do aplicativo. Um bom exemplo disso seriam as impressões ocorridas entre duas fases de um jogo ou quando um usuário conclui uma ação, como baixar um arquivo.

Após o carregamento do anúncio intersticial, salve-o e exiba‑o:

final class InterstitialViewController: UIViewController {
    private lazy var interstitialAdLoader = InterstitialAdLoader()
    private var interstitialAd: InterstitialAd?

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

Teste da integração de anúncios intersticiais

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

Use anúncios-teste para verificar a integração dos anúncios e o aplicativo em si. Para garantir que os anúncios-teste sejam retornados para cada solicitação de anúncio, é possível usar uma ID especial de posicionamento de anúncios demonstrativa.

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

Para a lista de todas as IDs de posicionamento de anúncio demonstrativas disponíveis, consulte Blocos de anúncio demonstrativos para testes.

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, convoque o método enableLogging da classe YandexAds.

YandexAds.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.