โฆษณาที่มีการให้รางวัลคือโฆษณาที่ผู้ใช้มีตัวเลือกในการโต้ตอบเพื่อแลกกับรางวัลในแอป คู่มือนี้จะแสดงวิธีผสานรวมโฆษณาที่มีการให้รางวัลจาก Ad Manager เข้ากับแอป Flutter
ทดสอบด้วยโฆษณาทดสอบเสมอ
เมื่อสร้างและทดสอบแอป โปรดใช้โฆษณาทดสอบแทนโฆษณาเวอร์ชันที่ใช้งานจริง หากไม่ดำเนินการดังกล่าวอาจส่งผลให้บัญชีถูกระงับ
วิธีที่ง่ายที่สุดในการโหลดโฆษณาทดสอบคือการใช้รหัสหน่วยโฆษณาทดสอบสําหรับโฆษณาที่มีการให้รางวัลโดยเฉพาะ ดังนี้
/21775744923/example/rewarded
หน่วยโฆษณาทดสอบได้รับการกําหนดค่าให้แสดงโฆษณาทดสอบสําหรับคําขอทุกรายการ และคุณใช้หน่วยโฆษณาทดสอบในแอปของคุณเองได้ขณะเขียนโค้ด ทดสอบ และแก้ไขข้อบกพร่อง เพียงอย่าลืมแทนที่รหัสดังกล่าวด้วยรหัสหน่วยโฆษณาของคุณเองก่อนเผยแพร่แอป
โหลดโฆษณา
ตัวอย่างต่อไปนี้จะโหลดโฆษณาที่มีการให้รางวัล
class RewardedExampleState extends State<RewardedExample> { RewardedAd? _rewardedAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = '/21775744923/example/rewarded'; /// Loads a rewarded ad. void loadAd() { RewardedAd.loadWithAdManagerAdRequest( adUnitId: adUnitId, adManagerAdRequest: const AdManagerAdRequest(), 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 = '/21775744923/example/rewarded'; /// Loads a rewarded ad. void loadAd() { RewardedAd.loadWithAdManagerAdRequest( adUnitId: adUnitId, adManagerAdRequest: const AdManagerAdRequest(), 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
เท่านี้ก็เรียบร้อย ตอนนี้แอปของคุณพร้อมแสดงโฆษณาที่มีการให้รางวัลแล้ว