โฆษณาที่มีการให้รางวัลคือโฆษณาที่ผู้ใช้เลือกโต้ตอบด้วยได้เพื่อแลกเปลี่ยน เพื่อรับรางวัลในแอป คู่มือนี้แสดง วิธีผสานรวมโฆษณาที่มีการให้รางวัลจาก 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
และ
Callback FullScreenContentCallback.onAdFailedToShowFullScreenContent
รายการ
เท่านี้ก็เรียบร้อย ตอนนี้แอปของคุณพร้อมแสดงโฆษณาที่มีการให้รางวัลแล้ว