RewardedAd

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();
                    }
                });
        }
    }
}

概要

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

パブリック メソッド
abstract Bundle

この RewardedAd で利用可能なすべての広告メタデータを取得します。
abstract @NonNull String

広告ユニット ID を返します。
abstract @Nullable FullScreenContentCallback

この RewardedAd の FullScreenContentCallback を取得します。
abstract @Nullable OnAdMetadataChangedListener

この RewardedAd の OnAdMetadataChangedListener を取得します。
abstract @Nullable OnPaidEventListener

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

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

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

読み込まれたリワード広告の報酬アイテムを取得します。
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

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

このリワード広告オブジェクトを没入モードで表示するかどうかを制御するフラグを設定します。
abstract void

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

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

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

この RewardedAd の ServerSideVerificationOptions を設定します。
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()

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

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

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

getOnAdMetadataChangedListener

public abstract @Nullable OnAdMetadataChangedListener getOnAdMetadataChangedListener()

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

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

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

getPlacementId

public abstract long getPlacementId()

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

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

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

getRewardItem

public abstract @NonNull RewardItem getRewardItem()

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

isAdAvailable

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

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

load

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

RewardedAd を読み込みます。

パラメータ
@NonNull Context context

コンテキスト。
@NonNull String adUnitId

広告ユニット ID。
@NonNull AdManagerAdRequest adManagerAdRequest

ターゲティング情報を含む Google アド マネージャーの広告リクエスト。
@NonNull RewardedAdLoadCallback loadCallback

リワード広告の読み込みが完了したときに呼び出されるコールバック。

load

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

RewardedAd を読み込みます。

パラメータ
@NonNull Context context

コンテキスト。
@NonNull String adUnitId

広告ユニット ID。
@NonNull AdRequest adRequest

ターゲティング情報を含む広告リクエスト。
@NonNull RewardedAdLoadCallback loadCallback

リワード広告の読み込みが完了したときに呼び出されるコールバック。

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)

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

setOnAdMetadataChangedListener

public abstract void setOnAdMetadataChangedListener(
    @Nullable OnAdMetadataChangedListener listener
)

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

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

setPlacementId

public abstract void setPlacementId(long placementId)

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

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

パラメータ
long placementId

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

setServerSideVerificationOptions

public abstract void setServerSideVerificationOptions(
    @Nullable ServerSideVerificationOptions options
)

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

表示する

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

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

パラメータ
@NonNull Activity activity

リワード広告を表示するアクティビティ。
@NonNull OnUserEarnedRewardListener onUserEarnedRewardListener

ユーザーが特典を獲得したときに通知されるリスナー。