Rewarded Video Integration for Android (Korean)

1단계. 보상 비디오 리스너 구현

ironSource SDK는 광고 가용성 및 완료를 알려주기 위해 몇 가지 이벤트를 발생시키므로 사용자에게 보상할 시기를 알 수 있습니다. SDK는 아래에 나열된 모든 가능한 이벤트를 리스너에게 알립니다:

IronSource.setRewardedVideoListener(new RewardedVideoListener() {
    /**
     * Invoked when the RewardedVideo ad view has opened.
     * Your Activity will lose focus. Please avoid performing heavy
     * tasks till the video ad will be closed.
     */
    @Override
    public void onRewardedVideoAdOpened() {
    }
    /*Invoked when the RewardedVideo ad view is about to be closed.
    Your activity will now regain its focus.*/
    @Override
    public void onRewardedVideoAdClosed() {
    }
    /**
     * Invoked when there is a change in the ad availability status.
     *
     * @param - available - value will change to true when rewarded videos are *available.
     *          You can then show the video by calling showRewardedVideo().
     *          Value will change to false when no videos are available.
     */
    @Override
    public void onRewardedVideoAvailabilityChanged(boolean available) {
        //Change the in-app 'Traffic Driver' state according to availability.
    }
    /**
     * Invoked when the video ad starts playing.
     */
    @Override
    public void onRewardedVideoAdStarted() {
    }
    /*Invoked when the video ad finishes playing.*/
    @Override
    public void onRewardedVideoAdEnded() {
    }
    /**
     * Invoked when the user completed the video and should be rewarded.
     * If using server-to-server callbacks you may ignore this events and wait *for the callback from the ironSource server.
     *
     * @param - placement - the Placement the user completed a video from.
     */
    @Override
    public void onRewardedVideoAdRewarded(Placement placement) {
        /** here you can reward the user according to the given amount.
         String rewardName = placement.getRewardName();
         int rewardAmount = placement.getRewardAmount();
         */
    }
    /* Invoked when RewardedVideo call to show a rewarded video has failed
     * IronSourceError contains the reason for the failure.
     */
    @Override
    public void onRewardedVideoAdShowFailed(IronSourceError error) {
    }
});

2단계. 사용자에게 비디오 광고 보여주기

RewardedVideoListener 및 해당 기능을 올바르게 구현하면 onVideoAvailabilityChanged 콜백을 통해 가용성 상태를 수신할 수 있습니다.

public void onVideoAvailabilityChanged(boolean available)

또는 다음을 호출하여 광고 가용성을 직접 요청하세요 :

boolean available = IronSource.isRewardedVideoAvailable();

광고 네트워크에 사용 가능한 비디오가 있으면 이 비디오 광고를 사용자에게 보여줄 준비가 됩니다. 트리거를 삽입하여 사용자가 비디오 광고를 보도록 유도하기에 이상적인 순간입니다. ironSource 광고 게재 도구를 사용하면 보상 비디오 경험을 사용자 정의하고 최적화할 수 있습니다. 이 도구를 사용하면 보상에 따라 다양한 게재 위치에서 비디오를 사용자에게 제공할 수 있습니다. 아래 기능을 사용하여 광고를 보여주고 싶은 정확한 광고 게재 위치를 정의할 수 있습니다. 자세한 내용은 광고 게재 위치 문서를 참조하세요. ironSource의 showRewardedVideo() 메소드를 호출하여 사용자에게 비디오 광고를 보여주고 광고를 보여주고 싶은 정확한 게재 위치를 사용자 정의할 수 있습니다. 해당 게재 위치의 보상 설정은 ironSource 서버에서 가져옵니다:

IronSource.showRewardedVideo(placementName);

각 광고 게재와 관련된 특정 보상에 대한 세부 정보를 얻으려면 다음을 호출할 수 있습니다:

Placement placement = IronSource.getRewardedVideoPlacementInfo("placementName");
// Null can be returned instead of a placement if the placementName is not valid.
if (placement != null) {
    String rewardName = placement.getRewardName();
    int rewardAmount = placement.getRewardAmount();
}

이제 ironSource의 광고 게재 위치 외에도 선택한 게재 위치에 대한 상한 및 간격 설정을 구성할 수 있습니다. 상한 및 간격 기능은 정의된 기간 내에 게재되는 광고의 양을 제한하여 앱의 사용자 경험을 개선합니다. 상한 및 간격 기능에 대한 자세한 내용은 여기를 참조하세요.

IronSource.isRewardedVideoPlacementCapped("Your Placements");

AdRewarded 트랜잭션을 확인하기 위한 동적 사용자ID 동적 사용자ID는 세션에서 변경될 수 있는 매개 변수이며 서버 간 광고 보상 콜백에서 수신됩니다. 이 매개 변수는 AdRewarded 트랜잭션을 확인하는 데 도움이 되며 ShowRewardedVideo를 호출하기 전에 설정해야 합니다.

IronSource.setDynamicUserId("UserID");

3단계. 사용자 보상

ironSource SDK는 사용자가 성공적으로 비디오를 완료할 때마다 onRewardedVideoAdRewarded 이벤트를 발생시킵니다. RewardedVideoListener가 해당 이벤트를 수신하여 사용자에게 성공적으로 보상할 수 있습니다.

게재 위치 객체는 ironSource Admin에 정의된 대로 게재 위치의 보상 이름 및 보상 금액을 포함합니다:

public void onRewardedVideoAdRewarded(Placement placement)
{
    //TODO - here you can reward the user according to the given amount
    String rewardName = placement.getRewardName();
    int rewardAmount = placement.getRewardAmount();
}

완료!  이제 앱에서 보상 비디오 광고를 제공할 준비가 되었습니다!