통합형 네이티브 광고

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

통합형 네이티브 광고는 애드팝콘 v3.10.7 부터 지원되는 타입으로 기존 네이티브 광고와 동일한 기능을 지원하며, 네이티브 레이아웃 구성을 통합하여 지원해, 좀 더 쉽게 레이아웃을 구성할 수 있는 타입입니다.

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

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

JAVA

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

Kotlin

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

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

JAVA

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

Kotlin

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

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

• 일반 네이티브

네이티브 레이아웃 가이드

• 네이티브 동영상

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

4. 네이티브 광고 옵션 설정

AdPopcornSSPNativeAdConfig는 네이티브 광고의 미디에이션업체 별 고유 설정을 관리할 때 사용됩니다.

단, AdFit의 bizboard 옵션은 bizboard 사용 시, 반드시 true로 설정해 사용해 주세요.

Java

AdPopcornSSPNativeAdConfig config = new AdPopcornSSPNativeAdConfig.Builder()                                                                                                                            
          // 공통 옵션                                                                                                                                                                                    
          .privacyIconVisibility(true)                                                                                                                                                                    
          .privacyIconPosition(AdPopcornSSPNativeAdConfig.PrivacyIconPosition.TOP_RIGHT)                                                                                                                  
          // NAM 옵션                                                                                                                                                                                     
          .namTimeoutMillis(30000)                                                                                                                                                                        
          .namAdChoicePosition(1)                                                                                                                                                                         
          // AdFit 옵션                                                                                                                                                                                   
          .adFitBizBoard(true)                                                                                                                                                                            
          .build();                                                                                                                                                                                       
                                                                                                                                                                                                          
  nativeAdView.setNativeAdConfig(config);   

Kotlin

4.1 애드팝콘 (일반 광고)

애드팝콘 템플릿 선택 안 할 경우에 적용 가능한 옵션 값입니다.

옵션	기본값	설명
privacyIconVisibility	TRUE	PrivacyIcon 표시 여부
privacyIconPosition	TOP_RIGHT	PrivacyIcon 위치
privacyIconWidth	15	PrivacyIcon 너비 (dp)
privacyIconHeight	15	PrivacyIcon 높이 (dp)
privacyIconLRMargin	2	PrivacyIcon 좌우 마진 (dp)
privacyIconTBMargin	2	PrivacyIcon 상하 마진 (dp)
privacyIconCornerRadius	0	PrivacyIcon 코너 라운드

4.2 애드팝콘 (템플릿광고)

애드팝콘 템플릿 선택 했을때 적용 가능한 옵션 값입니다.

메서드	기본값	설명
templateBackgroundColor	#F8F8F8	템플릿 배경색
templatePrivacyIconPosition	BOTTOM_LEFT	템플릿 PrivacyIcon 위치
templatePrivacyIconCornerRadius	0	템플릿 PrivacyIcon 코너 라운드
templateMainImageCornerRadius	0	템플릿 메인 이미지 코너 라운드
templateIconImageCornerRadius	0	템플릿 아이콘 이미지 코너 라운드
templatePrivacyIconLRMargin	0	템플릿 PrivacyIcon 좌우 마진
templatePrivacyIconTBMargin	0	템플릿 PrivacyIcon 상하 마진

4.2 NAM 전용 옵션

메서드	기본값	설명
namActivateObservingOnBackground	FALSE	백그라운드 관찰 활성화
namEnableMediaBackgroundBlur	FALSE	미디어 배경 블러 활성화
namTimeoutMillis	60000	광고 요청 타임아웃 (ms)
namAdChoicePosition	1 (TOP_RIGHT)	AdChoice 위치

namAdChoicePosion은 아래와 같이 정의됩니다.

• 0 : TOP_LEFT

• 1 : TOP_RIGHT

• 2 : BOTTOM_LEFT

• 3 : BOTTOM_RIGHT

4.3 AdFit 전용 옵션

메서드	기본값	설명
adFitBizBoard	FALSE	BizBoard 광고 사용 여부
adFitVideoAutoPlayPolicy	0	비디오 자동 재생 정책

5. 네이티브 광고 요청

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

JAVA

nativeAd.loadAd();

Kotlin

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

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

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

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

이벤트 리스너	설명
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

7. 네이티브 광고 종료

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

JAVA

nativeAd.destroy();

Kotlin