--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://ads.yandex.com/helpcenter/en/dev/android/interstitial.md - https://ads.yandex.com/helpcenter/pt/dev/android/interstitial.md - https://ads.yandex.com/helpcenter/ru/dev/android/interstitial.md - https://ads.yandex.com/helpcenter/zh/dev/android/interstitial.md - href: pt/dev/android/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 Android. 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/android/quick-start.md). 2. [Inicialize](../../../en/dev/android/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/android/changelog-android.md). Se você estiver usando mediação, confirme se também está utilizando a última versão da [compilação unificada](../../../en/dev/android/changelog-android.md). ## Implementação {#implement} Principais passos para integrar anúncios intersticiais: * Criar e configurar o carregador de anúncios `InterstitialAdLoader`. * Registrar o listener para métodos de callback de carregamento de anúncios: `InterstitialAdLoadListener`. * Carregar o anúncio. * Passar [configurações adicionais](../../../en/dev/android/target-adfox.md) se você estiver usando Adfox. * Registrar o listener `InterstitialAdEventListener` para métodos de callback de eventos de anúncios. * Renderizar `InterstitialAd`. ## 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. Se houve um erro no callback `onAdFailedToLoad()`, não tente carregar um novo anúncio novamente. Se não houver outra opção, limite o número de tentativas de carregamento de anúncios. Isso ajudará a evitar solicitações constantes malsucedidas e problemas de conexão quando surgirem limitações. 3. Recomendamos manter uma referência forte ao carregador e ao anúncio durante todo o ciclo de vida da tela que hospeda as interações com o anúncio para evitar a limpeza pelo coletor de lixo. 4. Recomendamos usar uma única instância de `InterstitialAdLoader` para todos os carregamentos de anúncios a fim de melhorar o desempenho. ## Carregamento de anúncios {#load} Para carregar anúncios intersticiais, crie e configure o objeto `InterstitialAdLoader`. Para isso, você precisará do contexto de Activity ou Application. Para notificar quando os anúncios são carregados ou falham ao carregar, defina o listener do método de callback `InterstitialAdLoadListener` para o objeto `InterstitialAdLoader`. 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.Builder()` passando interesses do usuário, dados contextuais do aplicativo, detalhes de localização ou outros dados. Fornecer dados contextuais adicionais na solicitação pode melhorar consideravelmente a qualidade do anúncio. Saiba mais na seção [Segmentação de anúncios](../../../en/dev/android/target.md). Após o anúncio ser carregado (chamando o método `onAdLoaded(interstitialAd: InterstitialAd)`), salve o link para o `InterstitialAd` carregado antes que sua exibição seja concluída. O exemplo a seguir mostra como carregar um anúncio intersticial a partir de Activity: {% list tabs %} - Kotlin ```kotlin class InterstitialAdActivity : AppCompatActivity(R.layout.activity_interstitial_ad) { private var interstitialAd: InterstitialAd? = null private var interstitialAdLoader: InterstitialAdLoader? = null private lateinit var binding: ActivityInterstitialAdBinding override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) binding = ActivityInterstitialAdBinding.inflate(layoutInflater) setContentView(binding.root) // Interstitial ads loading should occur after initialization of the SDK. // Initialize the SDK as early as possible, for example in Application.onCreate or Activity.onCreate interstitialAdLoader = InterstitialAdLoader(this).apply { setAdLoadListener(object : InterstitialAdLoadListener { override fun onAdLoaded(ad: InterstitialAd) { interstitialAd = ad // The ad was loaded successfully. You can now show the ad. } override fun onAdFailedToLoad(adRequestError: AdRequestError) { // Ad failed to load with AdRequestError. // Attempting to load a new ad from the onAdFailedToLoad() method is strongly discouraged. } }) } loadInterstitialAd() } private fun loadInterstitialAd() { val adRequestConfiguration = AdRequestConfiguration.Builder("your-ad-unit-id").build() interstitialAdLoader?.loadAd(adRequestConfiguration) } } ``` - Java ```java public class InterstitialAdActivity extends AppCompatActivity { @Nullable private InterstitialAd mInterstitialAd = null; @Nullable private InterstitialAdLoader mInterstitialAdLoader = null; private ActivityInterstitialAdBinding mBinding; public InterstitialAdActivity() { super(R.layout.activity_interstitial_ad); } @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); mBinding = ActivityInterstitialAdBinding.inflate(getLayoutInflater()); setContentView(mBinding.getRoot()); // Interstitial ads loading should occur after initialization of the SDK. // Initialize SDK as early as possible, for example in Application.onCreate or Activity.onCreate mInterstitialAdLoader = new InterstitialAdLoader(this); mInterstitialAdLoader.setAdLoadListener(new InterstitialAdLoadListener() { @Override public void onAdLoaded(@NonNull final InterstitialAd interstitialAd) { mInterstitialAd = interstitialAd; // The ad was loaded successfully. You can now show the ad. } @Override public void onAdFailedToLoad(@NonNull final AdRequestError adRequestError) { // Ad failed to load with AdRequestError. // Attempting to load a new ad from the onAdFailedToLoad() method is strongly discouraged. } }); loadInterstitialAd(); } private void loadInterstitialAd() { if (mInterstitialAdLoader != null ) { final AdRequestConfiguration adRequestConfiguration = new AdRequestConfiguration.Builder("your-ad-unit-id").build(); mInterstitialAdLoader.loadAd(adRequestConfiguration); } } } ``` {% endlist %} Se você veicula anúncios pelo Adfox, será possível, após a resposta do banner publicitário, acessar os dados de `campaignId`, `bannerId` e `placeId` a partir dos objetos `interstitialAdLoader` usando a propriedade `adAttributes` do tipo `AdAttributes`. ## Renderização de anúncios {#ad-view} 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). Antes de renderizar o anúncio, defina o listener do método de callback do anúncio `InterstitialAdEventListener`. Para renderizar um anúncio, você precisará passar a Activity para o método show do anúncio carregado: {% list tabs %} - Kotlin ```kotlin private fun showAd() { interstitialAd?.apply { setAdEventListener(object : InterstitialAdEventListener { override fun onAdShown() { // Called when ad is shown. } override fun onAdFailedToShow(adError: AdError) { // Called when an InterstitialAd failed to show. // Clean resources after Ad dismissed interstitialAd?.setAdEventListener(null) interstitialAd = null // Now you can preload the next interstitial ad. loadInterstitialAd() } override fun onAdDismissed() { // Called when an ad is dismissed. // Clean resources after Ad dismissed interstitialAd?.setAdEventListener(null) interstitialAd = null // Now you can preload the next interstitial ad. loadInterstitialAd() } override fun onAdClicked() { // Called when a click is recorded for an ad. } override fun onAdImpression(impressionData: ImpressionData?) { // Called when an impression is recorded for an ad. } }) show(this@Activity) } } ``` - Java ```java private void showAd() { if (mInterstitialAd != null) { mInterstitialAd.setAdEventListener(new InterstitialAdEventListener() { @Override public void onAdShown() { // Called when ad is shown. } @Override public void onAdFailedToShow(@NonNull final AdError adError) { // Called when an InterstitialAd failed to show. } @Override public void onAdDismissed() { // Called when an ad is dismissed. // Clean resources after Ad dismissed if (mInterstitialAd != null) { mInterstitialAd.setAdEventListener(null); mInterstitialAd = null; } // Now you can preload the next interstitial ad. loadInterstitialAd(); } @Override public void onAdClicked() { // Called when a click is recorded for an ad. } @Override public void onAdImpression(@Nullable final ImpressionData impressionData) { // Called when an impression is recorded for an ad. } }); mInterstitialAd.show(this); } } ``` {% endlist %} ## Liberação de recursos {#destroy} Não armazene links de anúncios renderizados anteriormente. Chame `setAdEventListener(null)` para anúncios renderizados anteriormente. Chame `setAdLoadListener(null)` para o carregador se ele não for mais usado. Isso libera os recursos e evita vazamentos de memória. {% list tabs %} - Kotlin ```kotlin override fun onDestroy() { super.onDestroy() interstitialAdLoader?.setAdLoadListener(null) interstitialAdLoader = null destroyInterstitialAd() } private fun destroyInterstitialAd() { interstitialAd?.setAdEventListener(null) interstitialAd = null } ``` - Java ```java @Override protected void onDestroy() { super.onDestroy(); if (mInterstitialAdLoader != null) { mInterstitialAdLoader.setAdLoadListener(null); mInterstitialAdLoader = null; } destroyInterstitialAd(); } private void destroyInterstitialAd() { if (mInterstitialAd != null) { mInterstitialAd.setAdEventListener(null); mInterstitialAd = null; } } ``` {% endlist %} ## Teste da integração de anúncios intersticiais {#test} ### Uso de blocos de anúncios de demonstração para teste de anúncios {#demo-blocks} Recomendamos usar anúncios de teste para testar sua integração de anúncios intersticiais 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/android/demo-blocks.md). ### Teste da integração de anúncios {#test-int} Você pode verificar sua integração de anúncios intersticiais usando o analisador integrado do SDK. A ferramenta garante que seus anúncios intersticiais estejam integrados corretamente e gera um relatório detalhado no log. Para ver o relatório, procure a palavra-chave "YandexAds" na ferramenta [Logcat](https://developer.android.com/studio/command-line/logcat) usada para depuração de aplicativos Android. ```bash adb logcat -v brief '*:S YandexAds' ``` Se a integração for bem-sucedida, você verá a seguinte mensagem: ```bash adb logcat -v brief '*:S YandexAds' mobileads$ adb logcat -v brief '*:S YandexAds' I/YandexAds(13719): [Integration] Ad type interstitial was integrated successfully ``` Se você estiver tendo problemas para integrar anúncios intersticiais, 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-android).