หากต้องการพูดคุยและแสดงความคิดเห็นเกี่ยวกับผลิตภัณฑ์ของเรา โปรดเข้าร่วมช่อง AdMob อย่างเป็นทางการใน Discord ในเซิร์ฟเวอร์ชุมชนการโฆษณาและการวัดผลของ Google

หน้านี้ได้รับการแปลโดย Cloud Translation API

RewardedAd

Kotlin |Java

abstract class RewardedAd

คลาสนี้ใช้เพื่อขอและแสดงโฆษณาที่มีการให้รางวัล

public class MainActivity extends AppCompatActivity {

    private RewardedAd rewardedAd;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        FullScreenContentCallback fullScreenContentCallback =
            new FullScreenContentCallback() {
                @Override
                public void onAdShowedFullScreenContent() {
                    // Code to be invoked when the ad showed full screen content.
                }

                @Override
                public void onAdDismissedFullScreenContent() {
                    rewardedAd = null;
                    // Code to be invoked when the ad dismissed full screen content.
                }
            };

        RewardedAd.load(
            this,
            "adUnitId",
            new AdRequest.Builder().build(),
            new RewardedAdLoadCallback() {
                @Override
                public void onAdLoaded(RewardedAd ad) {
                    findViewById(R.id.display_button).setVisibility(View.VISIBLE);
                    rewardedAd = ad;
                    rewardedAd.setFullScreenContentCallback(fullScreenContentCallback);
                }
            });
    }

    public void onDisplayButtonClicked(View view) {
        if (rewardedAd != null) {
            rewardedAd.show(
                this,
                new OnUserEarnedRewardListener() {
                    @Override
                    public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
                        Toast.makeText(
                            MainActivity.this,
                            "onRewarded! currency: "
                                + rewardItem.getType() + "    amount: "
                                + rewardItem.getAmount(), Toast.LENGTH_SHORT).show();
                    }
                });
        }
    }
}

สรุป

ผู้รับเหมาสาธารณะ
`RewardedAd()`

ฟังก์ชันสาธารณะ
`abstract Bundle!`	`getAdMetadata()` รับข้อมูลเมตาของโฆษณาทั้งหมดที่พร้อมใช้งานสำหรับ `RewardedAd` นี้
`abstract String`	`getAdUnitId()` แสดงรหัสหน่วยโฆษณา
`abstract FullScreenContentCallback?`	`getFullScreenContentCallback()` รับ `FullScreenContentCallback` สำหรับ `RewardedAd` นี้
`abstract OnAdMetadataChangedListener?`	`getOnAdMetadataChangedListener()` รับ `OnAdMetadataChangedListener` สำหรับ `RewardedAd` นี้
`abstract OnPaidEventListener?`	`getOnPaidEventListener()` รับ `OnPaidEventListener` สำหรับ `RewardedAd` นี้
`abstract Long`	`getPlacementId()` รับรหัสตำแหน่งสำหรับ `RewardedAd` นี้
`abstract ResponseInfo`	`getResponseInfo()` แสดงผลออบเจ็กต์ `ResponseInfo` สำหรับโฆษณาที่โหลด
`abstract RewardItem`	`getRewardItem()` รับไอเทมที่ได้จากโฆษณาที่มีการให้รางวัลที่โหลดแล้ว
`java-static Boolean`	`isAdAvailable(context: Context, adUnitId: String)` ฟังก์ชันนี้เลิกใช้งานแล้ว โปรดใช้ `isAdAvailable` แทน
`java-static Unit`	`load( context: Context, adUnitId: String, adManagerAdRequest: AdManagerAdRequest, loadCallback: RewardedAdLoadCallback )` โหลด `RewardedAd`
`java-static Unit`	`load( context: Context, adUnitId: String, adRequest: AdRequest, loadCallback: RewardedAdLoadCallback )` โหลด `RewardedAd`
`java-static RewardedAd?`	`pollAd(context: Context, adUnitId: String)` ฟังก์ชันนี้เลิกใช้งานแล้ว โปรดใช้ `pollAd` แทน
`abstract Unit`	`setFullScreenContentCallback( fullScreenContentCallback: FullScreenContentCallback? )` ลงทะเบียนการเรียกกลับที่จะเรียกใช้เมื่อโฆษณาแสดงและปิดเนื้อหาแบบเต็มหน้าจอ
`abstract Unit`	`setImmersiveMode(immersiveModeEnabled: Boolean)` ตั้งค่า Flag ที่ควบคุมว่าจะแสดงออบเจ็กต์โฆษณาที่มีการให้รางวัลนี้ในโหมดสมจริงหรือไม่
`abstract Unit`	`setOnAdMetadataChangedListener(listener: OnAdMetadataChangedListener?)` ตั้งค่า `OnAdMetadataChangedListener` สำหรับ `RewardedAd` นี้
`abstract Unit`	`setOnPaidEventListener(listener: OnPaidEventListener?)` ลงทะเบียนฟังก์ชันเรียกกลับที่จะเรียกใช้เมื่อระบบประเมินว่าโฆษณานี้สร้างรายได้
`abstract Unit`	`setPlacementId(placementId: Long)` ตั้งค่ารหัสตำแหน่งสำหรับโฆษณาที่มีการให้รางวัล
`abstract Unit`	`setServerSideVerificationOptions( options: ServerSideVerificationOptions? )` ตั้งค่า `ServerSideVerificationOptions` สำหรับ `RewardedAd` นี้
`abstract Unit`	`show( activity: Activity, onUserEarnedRewardListener: OnUserEarnedRewardListener )` แสดงโฆษณาที่มีการให้รางวัล

ผู้รับเหมาสาธารณะ

RewardedAd

RewardedAd()

ฟังก์ชันสาธารณะ

getAdMetadata

abstract fun getAdMetadata(): Bundle!

รับข้อมูลเมตาของโฆษณาทั้งหมดที่พร้อมใช้งานสำหรับ RewardedAd นี้ ข้อมูลเมตาของโฆษณาจะว่างเปล่าหากโฆษณาที่โหลดไม่มีข้อมูลเมตา ข้อมูลเมตาของโฆษณาอาจอัปเดตหลังจากโหลด ใช้ onAdMetadataChanged เพื่อฟังการเปลี่ยนแปลง

getAdUnitId

abstract fun getAdUnitId(): String

แสดงรหัสหน่วยโฆษณา

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

รับ FullScreenContentCallback สำหรับ RewardedAd นี้

getOnAdMetadataChangedListener

abstract fun getOnAdMetadataChangedListener(): OnAdMetadataChangedListener?

รับ OnAdMetadataChangedListener สำหรับ RewardedAd นี้

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

รับ OnPaidEventListener สำหรับ RewardedAd นี้

getPlacementId

abstract fun getPlacementId(): Long

รับรหัสตำแหน่งสำหรับ RewardedAd นี้

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

แสดงผลออบเจ็กต์ ResponseInfo สำหรับโฆษณาที่โหลด

getRewardItem

abstract fun getRewardItem(): RewardItem

รับไอเทมที่ได้จากโฆษณาที่มีการให้รางวัลที่โหลดแล้ว

isAdAvailable

java-static fun isAdAvailable(context: Context, adUnitId: String): Boolean

แสดงผล true หากมีโฆษณาที่มีการให้รางวัลที่พร้อมใช้งานซึ่งโหลดจาก startPreload

โหลด

java-static fun load(
    context: Context,
    adUnitId: String,
    adManagerAdRequest: AdManagerAdRequest,
    loadCallback: RewardedAdLoadCallback
): Unit

โหลด RewardedAd

พารามิเตอร์
`context: Context`	บริบท
`adUnitId: String`	รหัสหน่วยโฆษณา
`adManagerAdRequest: AdManagerAdRequest`	คำขอโฆษณา Google Ad Manager ที่มีข้อมูลการกำหนดเป้าหมาย
`loadCallback: RewardedAdLoadCallback`	Callback ที่จะเรียกใช้เมื่อโฆษณาที่มีการให้รางวัลโหลดเสร็จ

โหลด

java-static fun load(
    context: Context,
    adUnitId: String,
    adRequest: AdRequest,
    loadCallback: RewardedAdLoadCallback
): Unit

โหลด RewardedAd

พารามิเตอร์
`context: Context`	บริบท
`adUnitId: String`	รหัสหน่วยโฆษณา
`adRequest: AdRequest`	คำขอโฆษณาที่มีข้อมูลการกำหนดเป้าหมาย
`loadCallback: RewardedAdLoadCallback`	Callback ที่จะเรียกใช้เมื่อโฆษณาที่มีการให้รางวัลโหลดเสร็จ

pollAd

java-static fun pollAd(context: Context, adUnitId: String): RewardedAd?

เรียกโฆษณาที่มีการให้รางวัลถัดไปที่โหลดจาก startPreload หรือ null หากไม่มีโฆษณา

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

ลงทะเบียนการเรียกกลับที่จะเรียกใช้เมื่อโฆษณาแสดงและปิดเนื้อหาแบบเต็มหน้าจอ

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

ตั้งค่า Flag ที่ควบคุมว่าจะแสดงออบเจ็กต์โฆษณาที่มีการให้รางวัลนี้ในโหมดสมจริงหรือไม่ เรียกใช้เมธอดนี้ก่อน show ในระหว่าง show หากเปิดแฟล็กนี้และรองรับโหมดสมจริง ระบบจะเปิด SYSTEM_UI_FLAG_IMMERSIVE_STICKY และ SYSTEM_UI_FLAG_HIDE_NAVIGATION สำหรับโฆษณาที่มีการให้รางวัล

setOnAdMetadataChangedListener

abstract fun setOnAdMetadataChangedListener(listener: OnAdMetadataChangedListener?): Unit

ตั้งค่า OnAdMetadataChangedListener สำหรับ RewardedAd นี้

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

ลงทะเบียนฟังก์ชันเรียกกลับที่จะเรียกใช้เมื่อระบบประเมินว่าโฆษณานี้สร้างรายได้

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

ตั้งค่ารหัสตำแหน่งสำหรับโฆษณาที่มีการให้รางวัล

เรียกใช้เมธอดนี้ก่อนแสดงโฆษณาเพื่อให้มั่นใจว่าระบบจะรวมรหัสตำแหน่งนี้ไว้ในการรายงาน

พารามิเตอร์
`placementId: Long`	จำนวนเต็มแบบยาวที่ UI ของ AdMob ระบุสำหรับตําแหน่งที่กําหนดค่า

setServerSideVerificationOptions

abstract fun setServerSideVerificationOptions(
    options: ServerSideVerificationOptions?
): Unit

ตั้งค่า ServerSideVerificationOptions สำหรับ RewardedAd นี้

แสดง

abstract fun show(
    activity: Activity,
    onUserEarnedRewardListener: OnUserEarnedRewardListener
): Unit

แสดงโฆษณาที่มีการให้รางวัล

พารามิเตอร์
`activity: Activity`	กิจกรรมที่ควรแสดงโฆษณาที่มีการให้รางวัล
`onUserEarnedRewardListener: OnUserEarnedRewardListener`	Listener ที่จะได้รับการแจ้งเตือนเมื่อผู้ใช้ได้รับรางวัล