โฆษณาที่มีการให้รางวัลคือโฆษณาที่ผู้ใช้โต้ตอบด้วยได้เพื่อแลกกับรางวัลในแอป คู่มือนี้จะแสดง วิธีผสานรวมโฆษณาที่มีการให้รางวัลจาก AdMob ลงในแอป Flutter
ทดสอบด้วยโฆษณาทดสอบเสมอ
เมื่อสร้างและทดสอบแอป ให้ตรวจสอบว่าคุณใช้โฆษณาทดสอบแทนโฆษณาจริงเวอร์ชันที่ใช้งานจริง ไม่เช่นนั้น บัญชีของคุณอาจถูกระงับ
วิธีที่ง่ายที่สุดในการโหลดโฆษณาทดสอบคือการใช้รหัสหน่วยโฆษณาทดสอบเฉพาะสำหรับโฆษณาที่มีการให้รางวัล ดังนี้
Android
ca-app-pub-3940256099942544/5224354917
iOS
ca-app-pub-3940256099942544/1712485313
หน่วยโฆษณาทดสอบได้รับการกำหนดค่าให้ส่งโฆษณาทดสอบสำหรับทุกคำขอ และคุณจะใช้หน่วยโฆษณาทดสอบในแอปของคุณเองขณะที่เขียนโค้ด ทดสอบ และแก้ไขข้อบกพร่องได้อย่างอิสระ แต่อย่าลืมแทนที่รหัสเหล่านั้นด้วยรหัสหน่วยโฆษณาของคุณเองก่อนเผยแพร่แอป
โหลดโฆษณา
ตัวอย่างต่อไปนี้โหลดโฆษณาที่มีการให้รางวัล
class RewardedExampleState extends State<RewardedExample> { RewardedAd? _rewardedAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = Platform.isAndroid ? 'ca-app-pub-3940256099942544/5224354917' : 'ca-app-pub-3940256099942544/1712485313'; /// Loads a rewarded ad. void loadAd() { RewardedAd.load( adUnitId: adUnitId, request: const AdRequest(), adLoadCallback: RewardedAdLoadCallback( // Called when an ad is successfully received. onAdLoaded: (ad) { debugPrint('$ad loaded.'); // Keep a reference to the ad so you can show it later. _rewardedAd = ad; }, // Called when an ad request failed. onAdFailedToLoad: (LoadAdError error) { debugPrint('RewardedAd failed to load: $error'); }, )); } }
กิจกรรมโฆษณาที่มีการให้รางวัล
เมื่อใช้ FullScreenContentCallback
คุณจะฟังเหตุการณ์ในวงจรได้ เช่น เมื่อโฆษณาแสดงหรือปิดโฆษณา ตั้งค่า RewardedAd.fullScreenContentCallback
ก่อนที่จะแสดงโฆษณาเพื่อรับการแจ้งเตือนสำหรับเหตุการณ์เหล่านี้ ตัวอย่างนี้ใช้แต่ละเมธอดและบันทึกข้อความไปยังคอนโซล
class RewardedExampleState extends State<RewardedExample> { RewardedAd? _rewardedAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = Platform.isAndroid ? 'ca-app-pub-3940256099942544/5224354917' : 'ca-app-pub-3940256099942544/1712485313'; /// Loads a rewarded ad. void loadAd() { RewardedAd.load( adUnitId: adUnitId, request: const AdRequest(), adLoadCallback: RewardedAdLoadCallback( // 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. _rewardedAd = ad; }, // Called when an ad request failed. onAdFailedToLoad: (LoadAdError error) { debugPrint('RewardedAd failed to load: $error'); }, )); } }
โฆษณาแบบดิสเพลย์
RewardedAd
จะแสดงเป็น "ซ้อนทับ" ที่ด้านบนของเนื้อหาแอปทั้งหมดและอยู่ในตำแหน่งคงที่ ดังนั้นจึงไม่สามารถเพิ่มลงในแผนผังวิดเจ็ต Flutter ได้ และคุณสามารถเลือกเวลาที่จะแสดงโฆษณาได้โดยโทรไปที่ show()
RewardedAd.show()
จะได้รับ OnUserEarnedRewardCallback
ซึ่งระบบจะเรียกใช้เมื่อผู้ใช้ได้รับรางวัล อย่าลืมนำวิธีนี้ไปใช้และตอบแทน
เมื่อผู้ใช้ดูโฆษณา
_rewardedAd.show(onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) { // Reward the user for watching an ad. });
เมื่อมีการเรียกใช้ show()
แล้ว จะนํา Ad
ที่แสดงด้วยวิธีนี้ออกแบบเป็นโปรแกรมไม่ได้และผู้ใช้ต้องป้อนข้อมูล RewardedAd
แสดงได้เพียงครั้งเดียว การเรียกให้แสดงครั้งต่อๆ ไปจะเรียกให้ onAdFailedToShowFullScreenContent
แสดง
ต้องกำจัดโฆษณาเมื่อไม่จำเป็นต้องใช้การเข้าถึงอีกต่อไป แนวทางปฏิบัติแนะนำสำหรับเวลาที่จะโทรหา dispose()
คืออยู่ในโค้ดเรียกกลับ FullScreenContentCallback.onAdDismissedFullScreenContent
และ FullScreenContentCallback.onAdFailedToShowFullScreenContent
เท่านี้ก็เรียบร้อย ตอนนี้แอปของคุณพร้อมแสดงโฆษณาที่มีการให้รางวัลแล้ว