--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://ads.yandex.com/helpcenter/en/dev/ios/interstitial.md - https://ads.yandex.com/helpcenter/pt/dev/ios/interstitial.md - https://ads.yandex.com/helpcenter/ru/dev/ios/interstitial.md - https://ads.yandex.com/helpcenter/zh/dev/ios/interstitial.md - href: pt/dev/ios/interstitial.md type: text/markdown title: Markdown version - href: llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/pt/llms.txt # 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. {% cut "Aparência" %} {% endcut %} 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 {#pre} 1. Siga os passos de integração do SDK descritos em [Início rápido](../../../en/dev/ios/quick-start.md). 2. [Inicialize](../../../en/dev/ios/quick-start.md#init) seu SDK de anúncios com antecedência. 3. Confirme se você está utilizando a última versão do [Yandex Mobile Ads SDK](../../../en/dev/platforms.md). Se você estiver usando mediação, confirme se também está utilizando a última versão da [compilação unificada](../../../en/dev/platforms.md). ## Implementação {#implement} 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](../../../en/dev/ios/target-adfox.md) 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 {#features} 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`. ```swift 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](../../../en/dev/ios/target.md). O exemplo a seguir mostra como carregar um anúncio intersticial a partir do View Controller: ```swift 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. ```swift 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`. {% note warning %} Antes de publicar seu app na loja, lembre-se de substituir a ID de inserção demonstrativa por uma ID real obtida na interface do Yandex Advertising Network. {% endnote %} 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](../../../en/dev/ios/demo-blocks.md). ### 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`. ```swift 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 {#resources} * Link para [GitHub](https://github.com/yandexmobile/yandex-ads-sdk-ios/blob/master/Examples/YandexMobileAdsExample/YandexMobileAdsExample/Yandex/Interstitial/InterstitialAdViewController.swift).