--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://ads.yandex.com/helpcenter/en/dev/android/rewarded.md - https://ads.yandex.com/helpcenter/pt/dev/android/rewarded.md - https://ads.yandex.com/helpcenter/ru/dev/android/rewarded.md - https://ads.yandex.com/helpcenter/zh/dev/android/rewarded.md - href: pt/dev/android/rewarded.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 Rewarded Rewarded ads are a popular full-screen ad format, where the user receives a reward for viewing the ad. The display of this ad type is activated by the user, for instance, to receive a bonus or additional life in a game. High user motivation makes this ad format the most popular and profitable in free apps. {% cut "Aparência" %} {% list tabs %} - Anúncios de texto e imagens - Vídeo {% endlist %} {% endcut %} Este guia mostrará como integrar anúncios Rewarded 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 Rewarded: * Criar e configurar o carregador de anúncios `RewardedAdLoader`. * Registrar o listener para métodos de callback de carregamento de anúncios: `RewardedAdLoadListener`. * Carregar o anúncio. * Registrar o listener `RewardedAdEventListener` para métodos de callback de eventos de anúncios. * Renderizar `RewardedAd`. * Premiar o usuário por visualizar o anúncio. ## Características da integração de anúncios Rewarded {#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. 4. Recomendamos usar uma única instância de `RewardedAdLoader` para todos os carregamentos de anúncios a fim de melhorar o desempenho. ## Carregamento de anúncios {#load} Para carregar anúncios Rewarded, crie e configure o objeto `RewardedAdLoader`. 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 `RewardedAdLoadListener` para o objeto `RewardedAdLoader`. 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 `AdRequest.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(rewardedAd: RewardedAd)`), salve o link para o `RewardedAd` carregado antes que sua exibição seja concluída. O exemplo a seguir mostra como carregar um anúncio premiado a partir de Activity: {% list tabs %} - Kotlin ```kotlin class RewardedAdActivity : AppCompatActivity(R.layout.activity_rewarded_ad) { private var rewardedAd: RewardedAd? = null private var rewardedAdLoader: RewardedAdLoader? = null private lateinit var binding: ActivityRewardedAdBinding override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) binding = ActivityRewardedAdBinding.inflate(layoutInflater) setContentView(binding.root) // Rewarded ads loading should occur after initialization of the SDK. // Initialize SDK as early as possible, for example in Application.onCreate or Activity.onCreate rewardedAdLoader = RewardedAdLoader(this) loadRewardedAd() } private fun loadRewardedAd() { val adRequest = AdRequest.Builder("your-ad-unit-id").build() rewardedAdLoader?.loadAd(adRequest, object : RewardedAdLoadListener { override fun onAdLoaded(ad: RewardedAd) { rewardedAd = 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. } }) } } ``` - Java ```java public class RewardedAdActivity extends AppCompatActivity { @Nullable private RewardedAd mRewardedAd = null; @Nullable private RewardedAdLoader mRewardedAdLoader = null; private ActivityRewardedAdBinding mBinding; public RewardedAdActivity() { super(R.layout.activity_rewarded_ad); } @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); mBinding = ActivityRewardedAdBinding.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 mRewardedAdLoader = new RewardedAdLoader(this); loadRewardedAd(); } private void loadRewardedAd() { if (mRewardedAdLoader != null) { final AdRequest adRequest = new AdRequest.Builder("your-ad-unit-id").build(); mRewardedAdLoader.loadAd(adRequest, new RewardedAdLoadListener() { @Override public void onAdLoaded(@NonNull final RewardedAd rewardedAd) { mRewardedAd = rewardedAd; // 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. } }); } } } ``` {% endlist %} ## Renderização de anúncios {#ad-view} Rewarded advertising is an incentive-based ad format that allows the user to receive a reward for viewing the ad. The reward could be an extra life or advancing to the next level in a game. The reward format is determined at the app level. Para monitorar o ciclo de vida do anúncio premiado e enviar prêmios, defina o listener do método de callback `RewardedAdEventListener` para o objeto RewardedAd. 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() { rewardedAd?.apply { setAdEventListener(object : RewardedAdEventListener { override fun onAdShown() { // Called when an ad is shown. } override fun onAdFailedToShow(adError: AdError) { // Called when an RewardedAd failed to show } override fun onAdDismissed() { // Called when an ad is dismissed. // Clean resources after Ad dismissed rewardedAd?.setAdEventListener(null) rewardedAd = null // Now you can preload the next rewarded ad. loadRewardedAd() } 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. } override fun onRewarded(reward: Reward) { // Called when the user can be rewarded. } }) show(this@Activity) } } ``` - Java ```java private void showAd() { if (mRewardedAd != null) { mRewardedAd.setAdEventListener(new RewardedAdEventListener() { @Override public void onAdShown() { // Called when an 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 (mRewardedAd != null) { mRewardedAd.setAdEventListener(null); mRewardedAd = null; } // Now you can preload the next interstitial ad. loadRewardedAd(); } @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. } @Override public void onRewarded(@NonNull final Reward reward) { // Called when the user can be rewarded. } }); mRewardedAd.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. Isso libera os recursos e evita vazamentos de memória. {% list tabs %} - Kotlin ```kotlin override fun onDestroy() { super.onDestroy() rewardedAdLoader = null destroyRewardedAd() } private fun destroyRewardedAd() { rewardedAd?.setAdEventListener(null) rewardedAd = null } ``` - Java ```java @Override protected void onDestroy() { super.onDestroy(); mRewardedAdLoader = null; destroyRewardedAd(); } private void destroyRewardedAd() { if (mRewardedAd != null) { mRewardedAd.setAdEventListener(null); mRewardedAd = null; } } ``` {% endlist %} ## Teste da integração de anúncios Rewarded {#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 Rewarded 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-rewarded-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 testar sua integração de anúncios Rewarded usando o analisador integrado do SDK. A ferramenta garante que seus anúncios Rewarded 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á esta mensagem: ```bash adb logcat -v brief '*:S YandexAds' mobileads$ adb logcat -v brief '*:S YandexAds' I/YandexAds(13719): [Integration] Ad type rewarded was integrated successfully ``` Se você estiver tendo problemas para integrar anúncios Rewarded, 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).