안드로이드의 보상형 동영상 광고 연동

1단계. 보상형 동영상 광고 리스너 구현

아이언소스 SDK는 광고 준비 및 완료 사항에 대해 여러가지 이벤트를 송출하여 유저 보상이 필요한 시점을 알려줍니다.

아이언소스 SDK가 리스너로 소출하는 모든 이벤트 목록은 아래와 같습니다:

IronSource.setLevelPlayRewardedVideoListener(new LevelPlayRewardedVideoListener() {
   // Indicates that there's an available ad. 
   // The adInfo object includes information about the ad that was loaded successfully
   // Use this callback instead of onRewardedVideoAvailabilityChanged(true)
   @Override
   public void onAdAvailable(AdInfo adInfo) {}
   // Indicates that no ads are available to be displayed 
   // Use this callback instead of onRewardedVideoAvailabilityChanged(false) 
   @Override
   public void onAdUnavailable() {}
   // The Rewarded Video ad view has opened. Your activity will loose focus
   @Override
   public void onAdOpened(AdInfo adInfo) {}
   // The Rewarded Video ad view is about to be closed. Your activity will regain its focus
   @Override
   public void onAdClosed(AdInfo adInfo) {}
   // The user completed to watch the video, and should be rewarded. 
   // The placement parameter will include the reward data.
   // When using server-to-server callbacks, you may ignore this event and wait for the ironSource server callback
   @Override
   public void onAdRewarded(Placement placement, AdInfo adInfo) {}
   // The rewarded video ad was failed to show
   @Override
   public void onAdShowFailed(IronSourceError error, AdInfo adInfo) {}
   // Invoked when the video ad was clicked. 
   // This callback is not supported by all networks, and we recommend using it 
   // only if it's supported by all networks you included in your build
   @Override
   public void onAdClicked(Placement placement, AdInfo adInfo) {}
});

SDK 초기화

반드시 리스너를 아이언소스 SDK 초기화 이전에 등록해 주세요. 이는 SDK로터 전달되는 모든 관련 이벤트를 수신하기 위함입니다.

콜백

위의 리스너의 콜백들은 메인스레드 이외의 스레드에서 실행될 수도 있습니다. 아이언소스 콜백 결과에 영향받는 UI 상호작용이나 업데이트들은 모두 메인스레드로 넘겨진 후 실행되어야 합니다.

에러 코드

아이언소스 SDK는 연동 과정 또는 서비스 제공 중 발생할 수 있는 에러들에 대해서 어떤 에러인지 확인할 수 있도록 에러 코드 메커니즘을 제공합니다. 이 가이드 문서를 참고 부탁 드립니다.

네트워크 연결 상태

아이언소스 SDK의 Network Change Status 기능을 통해 사용자 기기의 인터넷 연결 상태를 확인 및 관찰할 수 있습니다. 본 기능을 활성화하면 아이언소스 SDK는 네트워크 변경사항에 따라 보상형 동영상 광고 준비상태가 변경됩니다. 예를들어, 기기가 인터넷에 연결되지 않은 경우 보상형 동영상 광고 준비상태는 FALSE로 변경됩니다.
본 기능의 기본값은 false, 즉 기본적으로 비활성화 되어 있습니다. 만약 네트워크 연결상태 변경을 수신하려면, 아이언소스 SDK 초기화 이전에 아래 구문을 통해 활성화 해 주세요:

IronSource.shouldTrackNetworkState(this, true);

2단계. 사용자에게 보상형 동영상 광고를 보여주기

광고 준비상태

RewardedVideoListener 및 해당 리스너의 메서드를 정확하게 구현하여 보상형 동영상 광고 준비 상태를 onVideoAvailabilityChanged 콜백을 통해서 받을 수 있습니다.

public void onVideoAvailabilityChanged(boolean available)

또는 아래의 메서드를 호출하여 직접 보상형 동영상 광고 준비 여부를 확인합니다:

boolean available = IronSource.isRewardedVideoAvailable();

광고 네트워크에 보상형 동영상이 준비되면 사용자들에게 광고를 송출할 준비가 된 것입니다. 사용자들에게 최상의 광고 경험을 제공하기 위해서는, 오디오를 비롯한 게임 및 앱의 동작을 반드시 먼저 일시정지 한 후에 광고를 송출합니다.

광고 플레이스먼트

레벨플레이 광고 플레이스먼트 도구를 사용하여, 보상형 동영상 광고 경험을 최적화하고 커스터마이즈 할 수 있습니다. 이 도구를 사용해서 보상에 따라 다양한 광고 게재 위치에서 사용자에게 보상형 영상을 제공할 수 있습니다. 아래의 함수를 사용하여 광고를 송출할 플레이스먼트를 지정할 수 있습니다. 자세한 정보는 광고 플레이스먼트 문서에서 찾아보실 수 있습니다.

보상형 동영상 광고 송출하기

IronSource 클래스의 showRewardedVideo() 메서드를 호출하여, 광고를 송출할 플레이스먼트를 지정하고 보상형 동영상 광고를 사용자에게 송출할 수 있습니다. 해당 플레이스먼트의 보상 설정은 아이언소스 서버에서 전달됩니다.

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.isRewardedVideoPlacementCapped("Your Placements");

동적 사용자 ID

동적 사용자 ID는 AdRewarded 콜백 통신을 확인하는 용도의 파라미터이며, 세션 중간에 변경될 수 있습니다.  해당 파라미터를 서버 간 콜백 중에 수신하려면, showRewardedVideo() 메서드 호출 이전에 동적 ID가 아래와 같이 설정되어야 합니다.  설정이 완료되면 콜백 URL에서 상세 보상 정보와 함께 dynamicUserId 파라미터를 수신할 수 있습니다.

IronSource.setDynamicUserId("UserID");

3단계. 사용자에게 보상 전달하기

아이언소스 SDK는 사용자가 성공적으로 보상형 동영상 광고 시청을 완료할 때마다 onAdRewarded 이벤트를 송출합니다. LevelPlayRewardedVideoListener로 이 이벤트를 수신하여야 사용자에게 정상적으로 보상을 지급할 수 있습니다.

Placement 객체에는 레벨플레이 Admin에서 정의된 해당 Placement의 보상 명칭과 보상 수량 정보가 포함되어 있습니다:

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

서버간 콜백

서버간 콜백 기능을 활성화 하실 경우, 반드시 아이언소스 SDK 초기화 이전에  사용자 ID를 설정하여 사용자들이 보상을 받을 수 있도록 하고, 반드시 사용자가 동일한 영상 시청 완료에 대해서는 단 한번만 보상을 받도록 합니다.

레벨플레이는 클라이언트로의 콜백과 서버간 콜백을 동시에 송출합니다. 다시말해, 한 번의 완료 이벤트마다 두 개의 통지를 받게 됩니다.

서버간 콜백의 이용에 대해서는, 여기를 읽어주세요.

완료했습니다!
이제 앱에 보상형 동영상 광고를 송출할 수 있습니다!