네이티브 광고

네이티브 광고는 광고가 게재되는 사용자 환경의 형식 및 기능에 맞춰 자동으로 최적화되어 출력됩니다.

위 네이티브 광고 타입은 추후 지원이 종료될 예정입니다. 이에 신규 연동시에는 통합형 네이티브 광고 가이드를 확인하시고, 연동 진행하시기 바랍니다.

1. 네이티브 광고 인스턴스 생성

아래 코드를 추가하여 네이티브 광고 인스턴스를 생성 합니다.

JAVA

private AdPopcornSSPNativeAd nativeAd;
     	
@Override
protected void onCreate(Bundle savedInstanceState) {
     // Layout xml 사용할 경우
     nativeAd = (AdPopcornSSPNativeAd) findViewById(R.id.igaw_native_ad);
}

Kotlin

2. 네이티브 광고 Placement ID 설정

아래 코드를 추가하여 네이티브 광고 PLACEMENT ID 를 설정합니다. 네이티브 광고 PLACEMENT ID 는 애드팝콘 SSP 콘솔에서 생성이 가능합니다.

JAVA

nativeAd.setPlacementId("네이티브_PlacementId");

Kotlin

3. 네이티브 레이아웃 구성

애드팝콘에서는 일반 네이티브와 네이티브 동영상을 지원합니다. 원하는 타입에 맞추어 레이아웃을 구성해 주세요.

• 일반 네이티브

네이티브 레이아웃 가이드

• 네이티브 동영상

네이티브 동영상 레이아웃 가이드

4. 네이티브 광고 요청

네이티브 광고 영역에 광고를 로드 할 경우, loadAd() API를 추가하여 광고를 요청 합니다. 광고가 정상적으로 수신 시, 아래 layout 형태로 광고가 노출 됩니다. (igaw_native_ad_layout_template.xml 사용 시)

JAVA

nativeAd.loadAd();

Kotlin

loadAd 호출에 대한 결과로 광고 수신에 실패한 경우에는 loadAd 재호출을 하시면 안됩니다. 과도한 광고 요청 api 호출은 block 사유가 됩니다.

네이티브 광고 예시 이미지

5. 네이티브 광고 이벤트 리스너

네이티브 광고에서 발생하는 이벤트를 받고자 할 경우 , 이벤트 리스너를 생성하여 전달해 줍니다.

이벤트 리스너를 통해 들어오는 이벤트들을 아래와 같습니다.

이벤트 리스너	설명
onNativeAdLoadSuccess	네이티브 광고 요청 성공 시
onNativeAdLoadFailed	네이티브 광고 요청 실패 시. 에러코드 값
onImpression	네이티브 광고가 화면에 노출되었을 때
onClicked	네이티브 광고를 클릭 했을 때
onAdHidden	네이티브 광고를 닫았을 경우(NAM 미디에이션 광고일 경우에만 발생)

JAVA

nativeAd.setNativeAdEventCallbackListener (new INativeAdEventCallbackListener () {
    @Override
    public void onNativeAdLoadSuccess () {
    }

    @Override
    public void onNativeAdLoadFailed (SSPErrorCode errorCode) {
    }

    @Override
    public void onImpression() {
    }

    @Override
    public void onClicked() {
    }

    @Override
    public void onAdHidden() {
    }
});

Kotlin

6. 네이티브 광고 종료

네이티브 광고 인스턴스를 더 이상 사용하지 않을 경우 , destroy API를 호출 하여 메모리 정리를 진행 합니다.

JAVA

nativeAd.destroy();

Kotlin