전면 광고

1 : 준비

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

• 사이트 에서 매체를 등록하여 Media ID 를 발급받고, 슬롯을 등록하면서 광고 유형을 비디오 또는 이미지 광고를 선택하고 Slot ID 를 발급받는다.

2 : SDK 초기화

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

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

3 : 광고 요청과 표출

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

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

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

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

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

4 : 광고 리스너 사용

• 전면 (이미지, 비디오) 광고 요청에 대한 이벤트를 수신할 수 있다.

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

{
    InterstitialAd interstitialAd = new InterstitialAd("AdPie-Slot-ID");
    interstitialAd.OnAdLoaded += InterstitialAd_OnAdLoaded;
    interstitialAd.OnAdFailedToLoad += InterstitialAd_OnAdFailedToLoad;
    interstitialAd.OnAdClicked += InterstitialAd_OnAdClicked;
    interstitialAd.OnAdShown += InterstitialAd_OnAdShown;
    interstitialAd.OnAdDismissed += InterstitialAd_OnAdDismissed;
    interstitialAd.Load();
}

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

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

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

void InterstitialAd_OnAdShown()
{
    // 광고 표출 후 이벤트 발생
}

void InterstitialAd_OnAdDismissed()
{
    // 광고가 표출한 뒤 사라질 때 이벤트 발생
}

• 비디오 광고의 경우 비디오 플레이에 대한 이벤트를 받을 수 있다.

{
    // optional
    VideoAdPlaybackListener videoAdPlaybackListener = new VideoAdPlaybackListener();
    videoAdPlaybackListener.OnVideoAdStarted += OnVideoAdStarted;
    videoAdPlaybackListener.OnVideoAdPaused += OnVideoAdPaused;
    videoAdPlaybackListener.OnVideoAdStopped += OnVideoAdStopped;
    videoAdPlaybackListener.OnVideoAdSkipped += OnVideoAdSkipped;
    videoAdPlaybackListener.OnVideoAdError += OnVideoAdError;
    videoAdPlaybackListener.OnVideoAdCompleted += OnVideoAdCompleted;
    interstitialAd.setVideoAdPlaybackListener(videoAdPlaybackListener);
}

void OnVideoAdStarted()
{
    // 비디오 광고 시작 이벤트 알림
}

void OnVideoAdPaused()
{
    // 비디오 광고 일시중지 이벤트 알림
}

void OnVideoAdStopped()
{
    // 비디오 광고 중지 이벤트 알림
}

void OnVideoAdSkipped()
{
    // 비디오 광고 건너뜀 이벤트 알림
}

void OnVideoAdError()
{
    // 비디오 광고 오류 이벤트 알림
}

void OnVideoAdCompleted()
{
    // 비디오 광고 완료 이벤트 알림
}