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 Ad Manager 광고 요청입니다.
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 UI에서 제공하는 긴 정수입니다.

setServerSideVerificationOptions

abstract fun setServerSideVerificationOptions(
    options: ServerSideVerificationOptions?
): Unit

이 RewardedAd의 ServerSideVerificationOptions를 설정합니다.

표시

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

보상형 광고를 표시합니다.

매개변수
activity: Activity	보상형 광고가 표시되어야 하는 활동입니다.
onUserEarnedRewardListener: OnUserEarnedRewardListener	사용자가 리워드를 획득할 때 알림을 받을 리스너입니다.