리워드 비디오 광고

1 : 준비

• 프로젝트 설정을 통해 광고 연동을 위한 준비를 합니다.

• 사이트 에서 매체를 등록하여 Media ID와 Slot ID 를 발급받습니다.

2 : SDK 초기화

• SDK 초기화를 하지 않았다면, 사이트에서 발급받은 Media ID를 입력하여 초기화를 합니다.

AdPieSDK.Instance.Initialize("AdPie-Media-ID");

3 : 광고 요청과 표출

• 사이트에서 발급받은 Slot ID를 입력하여 RewardedVideoAd 객체를 생성합니다.

• 광고 요청과 표출로 메소드가 각각 나누어져 있습니다.

• 광고 요청시 Load() 메소드를 호출하고, 표출 시 Show()를 호출을 합니다.

• 광고 컨텐츠가 로드되지 않을 가능성이 있기에 IsLoaded()를 통해 확인 후 Show() 메소드를 호출합니다.

{
    // 광고 연동을 위한 슬롯 ID를 필수로 입력한다.
    RewardedVideoAd rewardedVideoAd = new RewardedVideoAd("AdPie-Slot-ID");
    rewardedVideoAd.Load();
}

4 : 광고 리스너 사용

• 광고 요청에 대한 이벤트를 수신할 수 있습니다.

• 에러코드를 통해 광고 실패에 대한 이유를 알 수 있습니다.

{
    RewardedVideoAd rewardedVideoAd = new RewardedVideoAd("AdPie-Slot-ID");
    rewardedVideoAd.OnRewardedVideoLoaded += RewardedVideoAd_OnRewardedVideoLoaded;
    rewardedVideoAd.OnRewardedVideoFailedToLoad += RewardedVideoAd_OnRewardedVideoFailedToLoad;
    rewardedVideoAd.OnRewardedVideoClicked += RewardedVideoAd_OnRewardedVideoClicked;
    rewardedVideoAd.OnRewardedVideoStarted += RewardedVideoAd_OnRewardedVideoStarted;
    rewardedVideoAd.OnRewardedVideoFinished += RewardedVideoAd_OnRewardedVideoFinished;
    rewardedVideoAd.Load();
}

void RewardedVideoAd_OnRewardedVideoLoaded()
{
    // 광고 로딩 완료 후 이벤트 발생
    
    // 광고 요청 후 즉시 노출하고자 할 경우 아래의 코드를 추가합니다.
    if (rewardedVideoAd != null && rewardedVideoAd.IsLoaded())
    {
        rewardedVideoAd.Show();
    }
    
}

void RewardedVideoAd_OnRewardedVideoFailedToLoad(int errorCode)
{
    // 광고 요청 또는 표출 실패 후 이벤트 발생
}

void RewardedVideoAd_OnRewardedVideoClicked()
{
    // 광고 클릭 후 이벤트 발생
}

void RewardedVideoAd_OnRewardedVideoStarted()
{
    // 리워드 동영상 광고 시작 이벤트 발생
}

void RewardedVideoAd_OnRewardedVideoFinished(int finishState)
{
    // 리워드 동영상 광고 종료 이벤트 발생
    string state = "";
    switch(finishState) {
        case 0:
            state = "UNKNOWN";
            break;
        case 1:
            // 동영상 광고 시청완료
            state = "COMPLETED";
            break;
        case 2:
            // 동영상 광고 오류
            state = "ERROR";
            break;
        case 3:
            // 동영상 광고 건너뜀
            state = "SKIPPED";
            break;
    }
}