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

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

RewardedAd

Kotlin |Java

public 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 @NonNull String`	`getAdUnitId()` แสดงรหัสหน่วยโฆษณา
`abstract @Nullable FullScreenContentCallback`	`getFullScreenContentCallback()` รับ `FullScreenContentCallback` สำหรับ `RewardedAd` นี้
`abstract @Nullable OnAdMetadataChangedListener`	`getOnAdMetadataChangedListener()` รับ `OnAdMetadataChangedListener` สำหรับ `RewardedAd` นี้
`abstract @Nullable OnPaidEventListener`	`getOnPaidEventListener()` รับ `OnPaidEventListener` สำหรับ `RewardedAd` นี้
`abstract @NonNull ResponseInfo`	`getResponseInfo()` แสดงผลออบเจ็กต์ `ResponseInfo` สําหรับโฆษณาที่โหลด
`abstract @NonNull RewardItem`	`getRewardItem()` รับไอเทมที่ได้จากโฆษณาที่มีการให้รางวัลที่โหลด
`static boolean`	`isAdAvailable(@NonNull Context context, @NonNull String adUnitId)` วิธีการนี้เลิกใช้งานแล้ว ให้ใช้ `isAdAvailable` แทน
`static void`	`load( @NonNull Context context, @NonNull String adUnitId, @NonNull AdManagerAdRequest adManagerAdRequest, @NonNull RewardedAdLoadCallback loadCallback )` โหลด `RewardedAd`
`static void`	`load( @NonNull Context context, @NonNull String adUnitId, @NonNull AdRequest adRequest, @NonNull RewardedAdLoadCallback loadCallback )` โหลด `RewardedAd`
`static @Nullable RewardedAd`	`pollAd(@NonNull Context context, @NonNull String adUnitId)` วิธีการนี้เลิกใช้งานแล้ว ให้ใช้ `pollAd` แทน
`abstract void`	`setFullScreenContentCallback( @Nullable FullScreenContentCallback fullScreenContentCallback )` ลงทะเบียนการเรียกกลับที่จะเรียกใช้เมื่อโฆษณาแสดงและปิดเนื้อหาแบบเต็มหน้าจอ
`abstract void`	`setImmersiveMode(boolean immersiveModeEnabled)` ตั้งค่า Flag ที่ควบคุมว่าออบเจ็กต์โฆษณาที่มีการให้รางวัลนี้จะแสดงในโหมดสมจริงหรือไม่
`abstract void`	`setOnAdMetadataChangedListener( @Nullable OnAdMetadataChangedListener listener )` ตั้งค่า `OnAdMetadataChangedListener` สำหรับ `RewardedAd` นี้
`abstract void`	`setOnPaidEventListener(@Nullable OnPaidEventListener listener)` ลงทะเบียนการเรียกกลับที่จะเรียกใช้เมื่อคาดว่าโฆษณานี้จะได้รับรายได้
`abstract void`	`setServerSideVerificationOptions( @Nullable ServerSideVerificationOptions options )` ตั้งค่า `ServerSideVerificationOptions` สำหรับ `RewardedAd` นี้
`abstract void`	`show( @NonNull Activity activity, @NonNull OnUserEarnedRewardListener onUserEarnedRewardListener )` แสดงโฆษณาที่มีการให้รางวัล

ตัวสร้างแบบสาธารณะ

RewardedAd

public RewardedAd()

เมธอดสาธารณะ

getAdMetadata

public abstract Bundle getAdMetadata()

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

getAdUnitId

public abstract @NonNull String getAdUnitId()

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

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

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

getOnAdMetadataChangedListener

public abstract @Nullable OnAdMetadataChangedListener getOnAdMetadataChangedListener()

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

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

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

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

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

getRewardItem

public abstract @NonNull RewardItem getRewardItem()

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

isAdAvailable

public static boolean isAdAvailable(@NonNull Context context, @NonNull String adUnitId)

แสดงผลเป็น true หากมีโฆษณาที่มีการให้รางวัลที่โหลดจาก startPreload

โหลด

public static void load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdManagerAdRequest adManagerAdRequest,
    @NonNull RewardedAdLoadCallback loadCallback
)

โหลด RewardedAd

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

โหลด

public static void load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdRequest adRequest,
    @NonNull RewardedAdLoadCallback loadCallback
)

โหลด RewardedAd

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

pollAd

public static @Nullable RewardedAd pollAd(@NonNull Context context, @NonNull String adUnitId)

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

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

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

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

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

setOnAdMetadataChangedListener

public abstract void setOnAdMetadataChangedListener(
    @Nullable OnAdMetadataChangedListener listener
)

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

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

setServerSideVerificationOptions

public abstract void setServerSideVerificationOptions(
    @Nullable ServerSideVerificationOptions options
)

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

แสดง

public abstract void show(
    @NonNull Activity activity,
    @NonNull OnUserEarnedRewardListener onUserEarnedRewardListener
)

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

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