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() 広告ユニット ID を返します。
abstract FullScreenContentCallback?	getFullScreenContentCallback() この RewardedAd の FullScreenContentCallback を取得します。
abstract OnAdMetadataChangedListener?	getOnAdMetadataChangedListener() この RewardedAd の OnAdMetadataChangedListener を取得します。
abstract OnPaidEventListener?	getOnPaidEventListener() この RewardedAd の OnPaidEventListener を取得します。
abstract Long	getPlacementId() この RewardedAd のプレースメント ID を取得します。
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) このリワード広告オブジェクトを没入モードで表示するかどうかを制御するフラグを設定します。
abstract Unit	setOnAdMetadataChangedListener(listener: OnAdMetadataChangedListener?) この RewardedAd の OnAdMetadataChangedListener を設定します。
abstract Unit	setOnPaidEventListener(listener: OnPaidEventListener?) この広告で収益が発生したと推定されるときに呼び出されるコールバックを登録します。
abstract Unit	setPlacementId(placementId: Long) リワード広告のプレースメント ID を設定します。
abstract Unit	setServerSideVerificationOptions(     options: ServerSideVerificationOptions? ) この RewardedAd の ServerSideVerificationOptions を設定します。
abstract Unit	show(     activity: Activity,     onUserEarnedRewardListener: OnUserEarnedRewardListener ) リワード広告を表示します。

パブリック コンストラクタ

RewardedAd

RewardedAd()

パブリック関数

getAdMetadata

abstract fun getAdMetadata(): Bundle!

この RewardedAd で利用可能なすべての広告メタデータを取得します。読み込まれた広告にメタデータがない場合、広告のメタデータは空になります。広告メタデータは読み込み後に更新されることがあります。onAdMetadataChanged を使用して変更をリッスンします。

getAdUnitId

abstract fun getAdUnitId(): String

広告ユニット ID を返します。

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

この RewardedAd の FullScreenContentCallback を取得します。

getOnAdMetadataChangedListener

abstract fun getOnAdMetadataChangedListener(): OnAdMetadataChangedListener?

この RewardedAd の OnAdMetadataChangedListener を取得します。

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

この RewardedAd の OnPaidEventListener を取得します。

getPlacementId

abstract fun getPlacementId(): Long

この RewardedAd のプレースメント ID を取得します。

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

読み込まれた広告の ResponseInfo オブジェクトを返します。

getRewardItem

abstract fun getRewardItem(): RewardItem

読み込まれたリワード広告の報酬アイテムを取得します。

isAdAvailable

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

この関数は非推奨になりました。

isAdAvailable を代わりに使用してください。

startPreload から読み込まれた利用可能なリワード広告がある場合は true を返します。

load

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

RewardedAd を読み込みます。

パラメータ
context: Context	コンテキスト。
adUnitId: String	広告ユニット ID。
adManagerAdRequest: AdManagerAdRequest	ターゲティング情報を含む Google アド マネージャーの広告リクエスト。
loadCallback: RewardedAdLoadCallback	リワード広告の読み込みが完了したときに呼び出されるコールバック。

load

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

RewardedAd を読み込みます。

パラメータ
context: Context	コンテキスト。
adUnitId: String	広告ユニット ID。
adRequest: AdRequest	ターゲティング情報を含む広告リクエスト。
loadCallback: RewardedAdLoadCallback	リワード広告の読み込みが完了したときに呼び出されるコールバック。

pollAd

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

この関数は非推奨になりました。

pollAd を代わりに使用してください。

startPreload から読み込まれた次のリワード広告を取得します。広告が利用できない場合は null を取得します。

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

広告が表示され、全画面コンテンツが閉じられたときに呼び出されるコールバックを登録します。

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

このリワード広告オブジェクトを没入モードで表示するかどうかを制御するフラグを設定します。show の前にこのメソッドを呼び出します。show の間、このフラグがオンで没入モードがサポートされている場合、リワード広告に対して SYSTEM_UI_FLAG_IMMERSIVE_STICKY と SYSTEM_UI_FLAG_HIDE_NAVIGATION がオンになります。

setOnAdMetadataChangedListener

abstract fun setOnAdMetadataChangedListener(listener: OnAdMetadataChangedListener?): Unit

この RewardedAd の OnAdMetadataChangedListener を設定します。

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

この広告で収益が発生したと推定されるときに呼び出されるコールバックを登録します。

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

リワード広告のプレースメント ID を設定します。

このプレースメント ID がレポートに含まれるようにするには、広告を表示する前にこのメソッドを呼び出します。

パラメータ
placementId: Long	構成されたプレースメント用に AdMob 管理画面から提供される長整数。

setServerSideVerificationOptions

abstract fun setServerSideVerificationOptions(
    options: ServerSideVerificationOptions?
): Unit

この RewardedAd の ServerSideVerificationOptions を設定します。

表示する

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

リワード広告を表示します。

パラメータ
activity: Activity	リワード広告を表示するアクティビティ。
onUserEarnedRewardListener: OnUserEarnedRewardListener	ユーザーが特典を獲得したときに通知されるリスナー。