Gli interstitial con premio sono un tipo di formato dell'annuncio incentivato che ti consente di premi per gli annunci visualizzati automaticamente durante le transizioni naturali dell'app. A differenza degli annunci con premio, gli utenti è necessario attivare la visualizzazione di un interstitial con premio. Questa guida illustra come integrare gli annunci interstitial con premio di Ad Manager in un'app Flutter.
Prerequisiti
- Plug-in Flutter 1.1.0 o versioni successive.
- Completa la sezione Inizia. Il tuo L'app Flutter deve già avere il plug-in Flutter degli annunci per dispositivi mobili di Google importati.
Effettua sempre test con annunci di prova
Durante la creazione e il test delle tue app, assicurati di utilizzare annunci di prova anziché annunci di produzione attivi. In caso contrario, l'account verrà sospeso.
Il modo più semplice per caricare gli annunci di prova è utilizzare il nostro ID unità pubblicitaria di prova dedicato Gli annunci interstitial con premio:
/21775744923/example/rewarded-interstitial
Le unità pubblicitarie di prova sono configurate in modo da restituire annunci di prova per ogni richiesta. puoi usarle liberamente nelle tue app durante la programmazione, i test e il debug. Assicurati di sostituirli con i tuoi ID unità pubblicitaria prima della pubblicazione la tua app.
Carica un annuncio
Nell'esempio seguente viene caricato un annuncio interstitial con premio:
class RewardedInterstitialExampleState extends State<RewardedInterstitialExample> { RewardedInterstitialAd? _rewardeInterstitialdAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = '/21775744923/example/rewarded-interstitial'; /// Loads a rewarded ad. void loadAd() { RewardedInterstitialAd.loadWithAdManagerAdRequest( adUnitId: adUnitId, adManagerAdRequest: const AdManagerAdRequest(), adLoadCallback: RewardedInterstitialAdLoadCallback( // Called when an ad is successfully received. onAdLoaded: (ad) { debugPrint('$ad loaded.'); // Keep a reference to the ad so you can show it later. _rewardedInterstitialAd = ad; }, // Called when an ad request failed. onAdFailedToLoad: (LoadAdError error) { debugPrint('RewardedInterstitialAd failed to load: $error'); }, )); } }
Eventi di annunci interstitial con premio
Utilizzando FullScreenContentCallback
, puoi esaminare il ciclo di vita
ad esempio quando l'annuncio viene mostrato o ignorato. Imposta
RewardedInterstitialAd.fullScreenContentCallback
prima di mostrare l'annuncio a
ricevere notifiche per questi eventi. Questo esempio implementa ogni metodo
registra un messaggio nella console:
class RewardedInterstitialExampleState extends State<RewardedInterstitialExample> { RewardedInterstitialAd? _rewardedInterstitialAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = '/21775744923/example/rewarded-interstitial'; /// Loads a rewarded ad. void loadAd() { RewardedInterstitialAd.loadWithAdManagerAdRequest( adUnitId: adUnitId, adManagerAdRequest: const AdManagerAdRequest(), adLoadCallback: RewardedInterstitialAdLoadCallback( // Called when an ad is successfully received. onAdLoaded: (ad) { ad.fullScreenContentCallback = FullScreenContentCallback( // Called when the ad showed the full screen content. onAdShowedFullScreenContent: (ad) {}, // Called when an impression occurs on the ad. onAdImpression: (ad) {}, // Called when the ad failed to show full screen content. onAdFailedToShowFullScreenContent: (ad, err) { // Dispose the ad here to free resources. ad.dispose(); }, // Called when the ad dismissed full screen content. onAdDismissedFullScreenContent: (ad) { // Dispose the ad here to free resources. ad.dispose(); }, // Called when a click is recorded for an ad. onAdClicked: (ad) {}); debugPrint('$ad loaded.'); // Keep a reference to the ad so you can show it later. _rewardedInterstitialAd = ad; }, // Called when an ad request failed. onAdFailedToLoad: (LoadAdError error) { debugprint('RewardedInterstitialAd failed to load: $error'); }, )); } }
Annuncio display
Un RewardedInterstitialAd
viene visualizzato come overlay sopra tutti i contenuti dell'app
e sono posizionati in modo statico; perciò non potrà essere aggiunto
alla struttura del widget Flutter.
Puoi scegliere quando mostrare l'annuncio chiamando il numero show()
.
RewardedInterstitialAd.show()
prende OnUserEarnedRewardCallback
, ovvero
richiamati quando l'utente riceve un premio. Assicurati di implementarla e premia
per aver guardato un annuncio.
_rewardedInterstitialAd.show(onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) { // Reward the user for watching an ad. });
Dopo aver chiamato show()
, non è possibile rimuovere Ad
visualizzato in questo modo
in modo programmatico e richiede l'input dell'utente. Un RewardedInterstitialAd
può solo
vengono mostrati una volta sola. Le chiamate successive alla visualizzazione verranno attivate
onAdFailedToShowFullScreenContent
.
Un annuncio deve essere eliminato quando non è più necessario accedervi. La best practice
per sapere quando chiamare dispose()
è in
FullScreenContentCallback.onAdDismissedFullScreenContent
e
FullScreenContentCallback.onAdFailedToShowFullScreenContent
callback.
È tutto. La tua app è ora pronta per mostrare gli annunci interstitial con premio.