통합하기

매체는 NAM의 광고유닛을 호출하여 NAM과 연동된 다양한 광고공급자로부터 광고를 공급받을 수 있습니다.

광고를 게재하고 수익을 올리려면 먼저 NAM SDK 를 앱에 통합해야 합니다.

시작하기 앞서

최신 버전의 Android Studio 사용을 권장 합니다.

Prerequisites

Android 4.4 (API version 19) 이상
AndroidX 대응 확인
(만약 minSdkVersion이 21 미만이라면) 멀티덱스 사용 설정

NAM SDK 적용하기

앱 수준의 build.gradle 에 core 모듈 및 사용할 DSP 별 extension 모듈을 추가합니다. (필요 모듈만 추가)

Kotlin DSL
Groovy

dependencies {
    implementation(platform("com.naver.gfpsdk:nam-bom:7.5.3"))
    implementation("com.naver.gfpsdk:nam-core")          // NAM SDK core (mandatory)
    implementation("com.naver.gfpsdk:nam-nda")        // Naver S2S extension
    implementation("com.naver.gfpsdk:nam-dfp")        // DFP extension
    implementation("com.naver.gfpsdk:nam-fan")        // FAN extension
    implementation("com.naver.gfpsdk:nam-inmobi")     // InMobi extension
    implementation("com.naver.gfpsdk:nam-unity")      // Unity extension
    implementation("com.naver.gfpsdk:nam-applovin")   // AppLovin(MAX) extension
    implementation("com.naver.gfpsdk:nam-vungle")     // Vungle extension
    implementation("com.naver.gfpsdk:nam-dt")         // DigitalTurbine(Fyber) extension
    implementation("com.naver.gfpsdk:nam-aps")        // AmazonPublisherServices(APS) extension
    implementation("com.naver.gfpsdk:nam-ironsource") // IronSource extension
}

dependencies {
    implementation platform('com.naver.gfpsdk:nam-bom:7.5.3')
    implementation 'com.naver.gfpsdk:nam-core'          // NAM SDK core (mandatory)
    implementation 'com.naver.gfpsdk:nam-nda'        // Naver S2S extension
    implementation 'com.naver.gfpsdk:nam-dfp'        // DFP extension
    implementation 'com.naver.gfpsdk:nam-fan'        // FAN extension
    implementation 'com.naver.gfpsdk:nam-inmobi'     // InMobi extension
    implementation 'com.naver.gfpsdk:nam-unity'      // Unity extension
    implementation 'com.naver.gfpsdk:nam-applovin'   // AppLovin(MAX) extension
    implementation 'com.naver.gfpsdk:nam-vungle'     // Vungle extension
    implementation 'com.naver.gfpsdk:nam-dt'         // DigitalTurbine(Fyber) extension
    implementation 'com.naver.gfpsdk:nam-aps'        // AmazonPublisherServices(APS) extension
    implementation 'com.naver.gfpsdk:nam-ironsource' // IronSource extension
}

NAM 플랫폼(혹은 NAM 담당자)를 통해 발급 받은 NAM Publisher Code 및 Service Code를 AndroidManifest.xml 파일에 설정합니다.

먼저 Publisher Code 및 Service Code의 문자열 처리를 위해 string.xml 파일에 발급 받은 Publisher Code 및 Service Code를 추가합니다.

<string name="nam_publisher_cd">YOUR_PUBLISHER_CODE</string>
<string name="nam_service_cd">YOUR_SERVICE_CODE</string>

AndroidManifest.xml 파일 application 태그 하위에 meta-data 태그를 추가합니다.

이때 name은 com.naver.gfpsdk.PUBLISHER_CD, com.naver.gfpsdk.SERVICE_CD 를 사용하고, value는 위에 추가한 문자열 리소스 정보를 사용합니다.

<manifest>
    <application>
      <!-- Publisher Code 추가 -->
        <meta-data
            android:name="com.naver.gfpsdk.PUBLISHER_CD"
            android:value="@string/nam_publisher_cd"/>
        <meta-data
            android:name="com.naver.gfpsdk.SERVICE_CD"
            android:value="@string/nam_service_cd" />
    </application>
</manifest>

정보

v7.4.0 이전에 Publisher Code 을 발급받은 경우 Service Code 가 없을 수 있습니다. 이 경우에는 Publisher Code 만 입력합니다.

몇가지 확인 사항

IronSource 모듈 사용시

IronSource SDK 는 mavenCentral 이 아닌 아래의 repository를 추가해 주셔야 합니다.

Kotlin DSL
Java

repositories {
    maven {
        url = uri("https://android-sdk.is.com/")
    }
}

repositories {
    maven {
        url "https://android-sdk.is.com/"
    }
}

AppSetID

AppSetID는 동일한 기기내에서 Publisher 마다의 사용자 추적을 도와줍니다.

NAM SDK 4.4.0 이상 부터는 기본 적용되어 있으니 DFP 모듈을 사용하시거나 play-services / play-services-appset 라이브러리를 사용하고 계신다면 app-set-id 가 광고 요청 파라미터에 포함 됩니다.

참고로 NAM SDK 는 com.google.android.gms:play-services-appset:16.0.2 로 테스트 되었습니다.

InMobi 모듈 사용시

InMobi 라이브러리에서는 내부적으로 Picasso 라이브러리를 사용하고 있습니다.

관련해서 빌드시 com.android.support 라이브러리를 사용하고 있어 AndroidX 관련 문제가 발생할 수 있습니다.

InMobi 모듈을 사용하시는 경우 gradle.properties 파일에 android.enableJetifier=true를 설정하여 사용해 주시기 바랍니다.

Google (DFP) 모듈 사용시

구글 Ad Manager를 초기화 하기 위해 App ID가 AndroidManifest.xml 파일에 설정되어 있어야 합니다.

설정 없이 DFP 모듈을 추가하게 되면 앱 실행시 비 정상적으로 종료 됩니다.

<manifest>
  <application>
    <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>

네이티브 광고의 동영상 유형을 위한 하드웨어 가속화 설정 확인

FAN 모듈 등, 동영상 소재가 포함된 네이티브 광고가 보여질 때 검은 화면이 나타날 수 있습니다.

타겟 API 수준이 14(Ice Cream Sandwich, Android 4.0.1) 이상이면 하드웨어 가속화가 기본적으로 활성화되지만

앱 수준이나 활동 수준에서 명시적으로 이 기능을 활성화할 수도 있습니다.

네트워크 보안 구성 확인

(FAN 모듈을 사용하는 경우) Meta Audience Network SDK에서는 SDK 에서 미디어 파일을 캐싱하는 캐싱 프록시로 127.0.0.1 (localhost)을 사용합니다.

Android P부터 일반 텍스트 트래픽(암호화되지 않은 HTTP)은 기본적으로 차단 되는데, 이로 인해 SDK의 미디어 캐싱 기능이 영향을 받게 되며 사용자 경험과 광고 매출도 영향을 받을 수 있습니다.

지원하는 Mediation DSP 별 광고 종류

C2S

DFP: Doubleclick for Publishers (구글 광고)
FAN: META(Facebook) Audience Network
InMobi
Unity
AppLovin
Vungle
DigitalTurbine
APS: Amazon Publisher Services
IronSource

S2S

NDA: Naver Display Ads 의 약자로써 NAVER 가 제공하는 광고 및 Pubmatic, AppNexus, Rubicon 등의 외부 광고 제공자의 광고도 NDA 모듈(s2s)을 통해 제공 됩니다.

정보

아래 지원되는 광고를 참고하시고, NAM 관리자와 협의하여 연결하고자 하는 DSP를 확인하시고 각 모듈을 추가 하여야 합니다.

Ad Provider	Banner	Native	Native (without media view)	Reward	Interstitial
NDA	O	O	O	X	X
DFP	O	O	O	O	O
FAN	O	O	O	O	O
InMobi	O	O	X	X	X
Unity	O(only 320*50)	X	X	O	O
AppLovin	O	O	O	O	O
Vungle	X	X	X	O	O
DigitalTurbine	O	X	X	O	O
APS	O	X	X	X	X
IronSource	X	X	X	O	O

정보

FAN 등 기타 C2S의 경우 테스트 광고를 받기 위해서는 ad id (광고 추적 ID) 의 등록이 필요할 수 있습니다.

시작하기 앞서​

Prerequisites​

NAM SDK 적용하기​

몇가지 확인 사항​

IronSource 모듈 사용시​

AppSetID​

InMobi 모듈 사용시​

Google (DFP) 모듈 사용시​

네이티브 광고의 동영상 유형을 위한 하드웨어 가속화 설정 확인​

네트워크 보안 구성 확인​

지원하는 Mediation DSP 별 광고 종류​

C2S​

S2S​

광고 적용하기​