SDK 연동

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

요구사항

최신 버전의 Android Studio 사용 권장
minSdkVersion 21 이상

적용하기

프로젝트 수준의 Gradle 설정 파일에 Maven 중앙 저장소를 포함합니다.

Kotlin DSL
Groovy

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    mavenCentral()
    // . . .
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    mavenCentral()
    // . . .
  }
}

앱 수준의 빌드 파일에 NAVER Ad Manager SDK의 종속 항목을 추가합니다. 이때 nam-core 모듈은 필수 모듈이며, 사용할 광고 공급자 별 mediation 모듈을 별도로 추가할 수 있습니다. 자세한 것은 Mediation 연동 가이드를 확인해주세요.

Kotlin DSL
Groovy

dependencies {
    implementation(platform("com.naver.gfpsdk:nam-bom:8.4.0"))
    implementation("com.naver.gfpsdk:nam-core")                 // NAM Core (required)
    implementation("com.naver.gfpsdk.mediation:nam-nda")        // for NAVER S2S mediation (optional)
    // . . .
    // 필요 시 별도의 mediation 모듈 추가
}

dependencies {
    implementation platform('com.naver.gfpsdk:nam-bom:8.4.0')
    implementation 'com.naver.gfpsdk:nam-core'                 // NAM Core (required)
    implementation 'com.naver.gfpsdk.mediation:nam-nda'        // for NAVER S2S mediation (optional)
    // . . .
    // 필요 시 별도의 mediation 모듈 추가
}

NAM 플랫폼 혹은 담당자를 통해 발급 받은 NAM Publisher Code를 아래와 같이 AndroidManifest.xml 파일에 설정합니다. 이때 android:name의 값은 com.naver.gfpsdk.PUBLISHER_CD를 사용합니다.

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

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

위험

Publisher Code 는 필수 값으로서, 해당 값을 추가하지 않을 경우 앱이 시작되는 시점에 크래시가 발생하게 되니 꼭 추가해주시기 바랍니다.

추가 확인사항

아래는 일반적인 NAM SDK 연동 시 추가적으로 확인이 필요할 수 있는 사항에 대한 가이드입니다.

AD ID

AD ID(Google Play Advertising ID)는 Android 기기에서 제공하는 고유한 광고 식별자입니다. 이는 사용자가 광고 맞춤 설정을 제어할 수 있도록 설계된 익명 식별자로, 앱 개발자와 광고 네트워크가 사용자 추적 및 광고 타겟팅에 활용합니다.

AD ID 를 사용하기 위해선 앱에 play-services-ads-identifier 라이브러리 의존성이 추가되어 있고, 사용자의 기기 설정에서 구글 광고 추적 ID 옵션이 활성화되어 있어야 합니다.

정보

NAM SDK 는 com.google.android.gms:play-services-ads-identifier:17.0.1 버전을 기반으로 테스트 되었습니다.

AppSetID

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

NAM SDK 4.4.0 이상 버전부터 nam-dfp 모듈을 사용하거나 play-services 또는 play-services-appset 라이브러리 의존성이 추가되어 있을 시 AppSetID 가 광고 요청 파라미터에 포함됩니다.

정보

NAM SDK 는 com.google.android.gms:play-services-appset:16.0.2 버전을 기반으로 테스트 되었습니다.

WebView 사용 시

NAM SDK 를 연동하는 앱에서 GFP Web SDK를 통해 광고가 표시될 수 있는 WebView 를 사용하는 경우, WebView 인스턴스 별로 SDK에 등록하는 작업이 반드시 필요합니다. 이는 WebView에 로드되는 NAM Web SDK가 적용된 웹사이트와 통신하여 광고 타겟팅 정확도를 향상시키고 앱의 광고 수익성을 개선하기 위한 핵심 기능입니다. 따라서 반드시 8.2.4 이상 버전을 사용하여 웹뷰 등록 가이드를 적용해주시기 바랍니다.

네트워크 보안 구성 확인

일부 제공자는 HTTP 를 통해 광고를 제공합니다. Android 9.0(API 28) 이상에서는 기본적으로 HTTP 트래픽을 차단하므로, 이로 인해 사용자 경험과 광고 매출도 영향을 받을 수 있습니다. 매출을 최대화하기 위해서는 HTTP 트래픽을 허용할 것을 권장합니다. 영향을 받는 광고 공급자는 다음과 같습니다.

BidMachine

광고 게시하기

정보

전체적인 샘플은 GitHub NAM Android SDK 저장소에서 확인하실 수 있습니다.

요구사항​

적용하기​

추가 확인사항​

AD ID​

AppSetID​

WebView 사용 시​

네트워크 보안 구성 확인​

광고 게시하기​