RewardedAd

Kotlin |자바

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() 광고 단위 ID를 반환합니다.
abstract @Nullable FullScreenContentCallback	getFullScreenContentCallback() 이 RewardedAd의 FullScreenContentCallback를 가져옵니다.
abstract @Nullable OnAdMetadataChangedListener	getOnAdMetadataChangedListener() 이 RewardedAd의 OnAdMetadataChangedListener를 가져옵니다.
abstract @Nullable OnPaidEventListener	getOnPaidEventListener() 이 RewardedAd의 OnPaidEventListener를 가져옵니다.
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) 이 보상형 광고 객체가 몰입형 모드로 표시될지 여부를 제어하는 플래그를 설정합니다.
abstract void	setOnAdMetadataChangedListener(     @Nullable OnAdMetadataChangedListener listener ) 이 RewardedAd의 OnAdMetadataChangedListener를 설정합니다.
abstract void	setOnPaidEventListener(@Nullable OnPaidEventListener listener) 이 광고에서 수익이 창출된 것으로 추정될 때 호출할 콜백을 등록합니다.
abstract void	setServerSideVerificationOptions(     @Nullable ServerSideVerificationOptions options ) 이 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를 가져옵니다.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

로드된 광고의 ResponseInfo 객체를 반환합니다.

getRewardItem

public abstract @NonNull RewardItem getRewardItem()

로드된 보상형 광고의 리워드 항목을 가져옵니다.

isAdAvailable

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

이 메서드는 지원 중단되었습니다.

대신 isAdAvailable를 사용하세요.

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 Ad Manager 광고 요청입니다.
@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)

이 메서드는 지원 중단되었습니다.

대신 pollAd를 사용하세요.

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)

이 광고에서 수익이 창출된 것으로 추정될 때 호출할 콜백을 등록합니다.

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	사용자가 리워드를 획득하면 알림을 받는 리스너입니다.