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

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.
• Registrar o listener para métodos de callback de carregamento de anúncios: InterstitialAdLoadListener.
• Carregar o anúncio.
• Passar configurações adicionais 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

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

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.

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:

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)
    }
}

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);
        }
    }
}

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

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:

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)
    }
}

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);
    }
}

Liberação de recursos

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.

override fun onDestroy() {
    super.onDestroy()
    interstitialAdLoader?.setAdLoadListener(null)
    interstitialAdLoader = null
    destroyInterstitialAd()
}

private fun destroyInterstitialAd() {
    interstitialAd?.setAdEventListener(null)
    interstitialAd = null
}

@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;
    }
}

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

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 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 usada para depuração de aplicativos Android.

adb logcat -v brief '*:S YandexAds'

Se a integração for bem-sucedida, você verá a seguinte mensagem:

adb logcat -v brief '*:S YandexAds'
mobileads$ adb logcat -v brief '*:S YandexAds'
I/YandexAds(13719): [Integration] Ad type interstitital 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

• Link para GitHub.