NAM (Naver Ad Manager)

SDK 설치

  • v8.10.3 호환 지원합니다.

api platform('com.naver.gfpsdk:nam-bom:8.10.3')
api 'com.naver.gfpsdk:nam-core'

// NAM 7.x.x 버전에는 아래 sdk 포함 필요
api 'com.naver.gfpsdk:nam-nda'
// NAM 8.x.x 버전에서는 아래 sdk 포함 필요.
api 'com.naver.gfpsdk.mediation:nam-nda'

AndroidManifest.xml 설정

NAM SDK의 정상 동작을 위해선 AnroidManifest.xml 파일 내에 Key-Value 값을 설정해야 합니다.

입력해야 되는 키 값에 대해서는 사업팀(monetize@adpopcorn.com)에 문의해 주세요.

circle-exclamation
<resources>
    <string name="nam_publisher_cd">7976096509</string>
</resources>
<meta-data
            android:name="com.naver.gfpsdk.PUBLISHER_CD"
            android:value="@string/nam_publisher_cd"/>

네이티브 광고 추가 설정

다른 타입의 광고와 다르게 네이티브 광고에서 미디에이션 사용하고자 할 경우에는 레이아웃에 대한 추가 설정이 필요합니다.

NAM 네이티브의 경우 일반 네이티브(GfpNativeAdView) 와 SimpleAd(GfpNativeSimpleAdView)를 지원하므로, 매체에서 사용하고자 하는 방식에 맞게 연동을 진행해 주세요

circle-exclamation

GfpNativeAdView + GfpNativeSimpleAdView

AdPopcornSSPNativeAd layout 내에 GfpNativeAdView와 GfpNativeSimpleAdView 영역을 같이 추가해 주세요

  • native_ad_mediation_layout.xml 샘플

  • nam_native_ad_unit_layout.xml 샘플

그리고 지정한 영역을 아래와 같이 setNamViewBinder를 통해 전달해 주면 됩니다.

각 component 별로 사용되어야 하는 타입은 아래와 같습니다.

  • 필수 View

    • assetContainerView : FrameLayout

    • adChoicesView : GfpAdChoicesView

    • advertiserView : TextView

    • bodyView : TextView

    • mediaView : GfpMediaView

  • 옵션 View

    • iconView : ImageView

    • titleView : TextView

    • callToActionButtonView : Button

    • socialContextView : TextView

triangle-exclamation

GfpNativeSimpleAdView

AdPopcornSSPNativeAd layout 내에 GfpNativeSimpleAdView 영역을 추가해 주세요

  • native_ad_mediation_layout.xml 샘플

그리고 지정한 영역을 아래와 같이 setNamViewBinder를 통해 전달해 주면 됩니다.

triangle-exclamation

GfpNativeAdView

AdPopcornSSPNativeAd layout 내에 GfpNativeAdView 영역을 추가해 주세요

  • native_ad_mediation_layout.xml 샘플

  • nam_native_ad_unit_layout.xml 샘플

그리고 지정한 영역을 아래와 같이 setNamViewBinder를 통해 전달해 주면 됩니다.

각 component 별로 사용되어야 하는 타입은 아래와 같습니다.

  • 필수 View

    • assetContainerView : FrameLayout

    • adChoicesView : GfpAdChoicesView

    • advertiserView : TextView

    • bodyView : TextView

    • mediaView : GfpMediaView

  • 옵션 View

    • iconView : ImageView

    • titleView : TextView

    • callToActionButtonView : Button

    • socialContextView : TextView

triangle-exclamation

네이티브 광고 중복 제어 설정

네이티브 광고에 대해서는 여러 지면에 중복된 광고가 노출되는것을 방지하기 위해 아래의 옵션을 제공합니다. NamViewBinder에 아래의 설정을 추가해 주면 동일한 GfpDedupeManager를 사용하는 지면은 중복된 광고가 노출되지 않습니다.(참고 : NAM 중복 제어 가이드arrow-up-right)

위와 같이 설정된 경우 adPopcornSSPNativeAd, adPopcornSSPNativeAd2 지면에서 NAM의 광고는 중복된 광고가 노출되지 않습니다. 만약 다른 지면에서는 중복을 허용하고자 할 경우에는 GfpDedupeManager를 새로 생성하거나, 세팅하지 않으면 됩니다.

GfpNativeAdView Media Ratio

GfpNativeAdView에서 사용되는 GfpMediaView의 Ratio 값 활용이 필요한 경우, 네이티브 광고가 로딩된 이후, NAMViewBinder의 gfpMediaAspectRatio 변수값을 통해 확인 가능합니다. (아래 샘플 코드 참고)

gfpMediaAspectRatio값이 0인 경우는 광고의 미디어 뷰가 정상적으로 처리 되지 않았거나, No Ad인 케이스입니다.

마지막 업데이트