> For the complete documentation index, see [llms.txt](https://docs.nestads.com/nestads-sdk-dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nestads.com/nestads-sdk-dev/android/readme.md).

# 시작하기

## **최신 NestAds SDK 버전**

* [릴리즈 노트](/nestads-sdk-dev/android/release-notes.md) 를 확인해주세요.

***

## **최소 지원 사양**

* Android 5.0 Lollipop 이상
* minSdkVersion 21 이상
* [Offerwall 광고](/nestads-sdk-dev/android/ad-formats/offerwall.md) 사용 시 minSdkVersion 24 이상
* compileSdkVersion 33 이상

***

## NestAds **SDK** 추가

1. 프로젝트 단 `settings.gradle` 파일에 아래의 `Maven central repository`와 `wisebirds repository`를 추가합니다.

> Kotlin 1.7.x 와 Kotlin 1.9.x 로 빌드된 SDK 중 선택하여 추가할 수 있습니다.

{% tabs %}
{% tab title="Gradle" %}

```gradle
dependencyResolutionManagement {
   repositories {
       mavenCentral()
       
       // Kotlin 1.7.x 로 빌드된 SDK
       maven { url 'https://nexus.wisebirds.ai/repository/releases-k1_7/' }
     
       // Kotlin 1.9.x 로 빌드된 SDK
       maven { url 'https://nexus.wisebirds.ai/repository/releases/' }
   }
}
```

{% endtab %}
{% endtabs %}

2. 어플리케이션 단 `build.gradle` 파일에 아래의 `dependency`를 추가합니다.

{% tabs %}
{% tab title="Gradle" %}

```gradle
dependencies {
   implementation 'com.nestads:nestads-sdk-android:${version}'
}
```

{% endtab %}
{% endtabs %}

***

## SDK 초기화

광고를 로드하기 전에 앱에서 NestAds SDK를 [NestAds](/nestads-sdk-dev/android/reference/nestads.md).`initialize` 함수를 이용하여 초기화해야 합니다.

Activity에서 초기화하는 예제는 다음과 같습니다.

{% tabs %}
{% tab title="Kotiln" %}

```kotlin
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        NestAds.initialize(context = this)
    }
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Ad Blocker 환경에서 광고 차단을 우회해야 하는 경우, 매체사가 운영하는 프록시 서버를 통해 NestAds 요청을 라우팅할 수 있습니다. 자세한 설정 방법은 [Proxy Server 사용](/nestads-sdk-dev/android/readme/proxy-server.md) 가이드를 참고하세요.
{% endhint %}