전면 광고

1 : 준비

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

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

• 전면 광고의 경우 이미지와 비디오가 있으며, 대시보드에서 광고유형을 Image 또는 Video 를 필수적으로 하나 선택해야 한다.

• 전면 비디오 광고는 보통 높은 단가를 형성하여 이미지 광고 보다 우선적으로 노출하는 것을 권장한다.

- (주의사항) 전면 비디오 광고를 노출하기 위해서는 SDK 1.12.0 버전 이상을 연동해야 한다.

2 : 액티비티 추가

• AndroidManifest.xml에서 <application> 태그 안에 activity를 추가한다.

<activity android:name="com.gomfactory.adpie.sdk.InterstitialActivity"
          android:configChanges="keyboardHidden|orientation|screenSize" />

3 : 광고 요청과 표출

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

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

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

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

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

private InterstitialAd interstitialAd;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // SDK 초기화로 앱실행 1회만 호출한다. (Main Activity 에 필수로 입력한다.)
    AdPieSDK.getInstance().initialize(getApplicationContext(), "AdPie-Media-ID");

    ...

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

4 : 광고 타겟팅

• 타겟팅 적용으로 보다 높은 수익을 얻을 수 있다.

• 형태 : 성별, 위치, 나이 또는 출생일(YYYY)

TargetingData targetingData = new TargetingData.Builder()
    .setGender(TargetingData.Gender.MALE)
    .setAge(30)
    .setYearOfBirthday(1970)
    .build();
// 광고 요청시 타겟팅 정보를 넣어준다.
interstitialAd.load(targetingData);

5 : 광고 리스너 사용

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

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

 interstitialAd.setAdListener(
     new com.gomfactory.adpie.sdk.InterstitialAd.InterstitialAdListener() {
         @Override
         public void onAdLoaded() {
             // 광고 로딩 완료 후 이벤트 발생

             // 광고 요청 후 즉시 노출하고자 할 경우 아래의 코드를 추가한다.
             if (interstitialAd.isLoaded()) {
                 // 광고 표출
                 interstitialAd.show();
             }
         }

         @Override
         public void onAdFailedToLoad(int errorCode) {
            // 광고 요청 실패 후 이벤트 발생
            // error message -> AdPieError.getMessage(errorCode)
         }

         @Override
         public void onAdShown() {
            // 광고 표출 후 이벤트 발생
         }

         @Override
         public void onAdClicked() {
            // 광고 클릭 후 이벤트 발생
         }

         @Override
         public void onAdDismissed() {
            // 광고가 표출한 뒤 사라질 때 이벤트 발생
         }
     }
 );