> For the complete documentation index, see [llms.txt](https://adpopcornssp.gitbook.io/ssp-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adpopcornssp.gitbook.io/ssp-sdk/undefined-2/web-adfit/android.md). # Android ## 0. AdFit SDK 연동 AdFit 광고 송출을 위해서는 우선 AdFit Android SDK v3.16.0 연동이 필요합니다. 1. 먼저 최상위 [`build.gradle`](https://github.com/adfit/adfit-android-sdk/blob/master/build.gradle) 파일에 Maven repository를 추가합니다. ``` allprojects { repositories { google() jcenter() maven { url 'https://devrepo.kakao.com/nexus/content/groups/public/' } } } ``` 2. App 모듈 [`build.gradle`](https://github.com/adfit/adfit-android-sdk/blob/master/app/build.gradle) 파일에 최신 버전의 AdFit SDK를 추가합니다. ``` dependencies { implementation "com.google.android.gms:play-services-ads-identifier:$play_service_version" implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.4.10' implementation 'com.kakao.adfit:ads-base:3.16.0' } ``` 3. 설정 후, 툴바의 Sync Project with Gradle Files를 눌러 변경사항을 반영합니다. ## 1. WebPage 환경 설정 **1.1 스크립트 설치** 스크립트 설치는 페이지 내에 다른 리소스에 영향을 주지 않도록 페이지 맨 하단에 `` 부분 바로 위에 설치하는 것이 좋습니다. 이때, 설치하고자 하는 페이지에 따라 설정 방법이 달라질 수 있습니다. ``` ``` **1.3 No-Ad 콜백 설정하기** 광고 요청이 실패하거나 노출할 광고가 없는 경우에 이를 제어하도록 NO-AD 콜백 함수를 설정할 수 있습니다. 애드팝콘 SSP 사업팀을 통해 발급받은 AdFit 코드를 아래와 같이 Callback 함수 요소를 추가하여 설정할 수 있습니다. ```html ``` Callback 함수 실행시 ins 태그 객체를 첫 번째 인자(arg1)로 전달 받습니다. 또한 한 페이지 내 2개 이상의 광고단위 설치 시 Callback 메서드 명을 달리 해야 합니다. **1.4 예시 (외부 광고 스크립트를 삽입하는 경우)** 외부 광고 스크립트를 삽입하는 경우 동일한 사이즈의 외부 광고를 사용하여야 합니다. (예시. Google AdSense 코드. 외부 광고 코드 유형은 반드시 “비동기” 방식을 사용하여야 합니다.) ```html     function callBackFunc(elm) {       text = [];       text.push('');           elm.innerHTML = text.join(' ');       (adsbygoogle = window.adsbygoogle || []).push({});   }                 ``` ## 2. Native Side(Android) 환경 설정 #### 2.1 WebView 초기화 광고를 송출을 위해 `WebView`를 AdFit SDK에 등록하는 과정이 필요합니다. 광고를 송출하려는 `WebView`를 Main Thread 상에서 아래와 같은 설정과 함께 `AdFitSdk.register(webView: WebView)`를 호출하여 광고 송출에 필요한 설정을 합니다. 
import android.webkit.CookieManager
import android.webkit.WebView
import com.kakao.adfit.AdFitSdk

class MainActivity : AppCompatActivity() {

    private lateinit var webView: WebView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        setContentView(R.layout.activity_main)

        webView = findViewById(R.id.webview)
        initializeWebView(webView)
    }

    @MainThread
    private fun initializeWebView(webView: WebView) {
        // 3자 쿠키 사용 설정 허용
        CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)

        // JavaScript 사용 설정
        webView.getSettings().javaScriptEnabled = true

        // Local Storage 사용 설정
        webView.getSettings().domStorageEnabled = true

        // 비디오 자동 재생 허용 설정
        webView.getSettings().mediaPlaybackRequiresUserGesture = false

        // AdFit SDK에 WebView 등록
        AdFitSdk.register(webView)
    }
}
#### 2.2 비디오 광고 자동 재생 설정하기 앱의 설정에 따라 AdFit을 통해 송출되는 비디오 광고의 자동 재생 여부를 아래와 같이 설정할 수 있습니다.\ 설정하지 않을 경우, 기본 값은 `AdFitVideoAutoPlayPolicy.WIFI_ONLY` (WiFi 연결 상태에서만 자동 재생)입니다. ```kotlin // 자동 재생하지 않음 AdFitSdk.mediaAutoPlayPolicy = AdFitVideoAutoPlayPolicy.NONE // WiFi 연결 상태에서만 자동 재생 AdFitSdk.mediaAutoPlayPolicy = AdFitVideoAutoPlayPolicy.WIFI_ONLY // 항상 자동 재생 AdFitSdk.mediaAutoPlayPolicy = AdFitVideoAutoPlayPolicy.ALWAYS ```