# Быстрый старт — Android

Это руководство поможет установить MADS SDK и показать первое рекламное объявление в Android-приложении.

## 1. Добавление зависимостей

Перед началом интеграции необходимо добавить зависимость от SDK в нужные модули проекта:

```kotlin
repositories {
    mavenCentral()
}

dependencies {
    implementation("ru.magnit.mads.mobile:android-sdk:0.0.1")
}
```

## 2. Инициализация SDK

Инициализацию SDK необходимо выполнить после старта приложения, вызвав метод `Mads.init(...)`:

```kotlin
import ru.tander.mads.Mads

class DemoApplication : Application() {

    override fun onCreate() {
        Mads.init(this)
    }
}
```

## 3. Идентификация пользователя

Когда пользователь входит в систему, важно связать его действия, совершенные анонимно, с его постоянным профилем. Для этого после авторизации необходимо передать внутренний `userId`:

```kotlin
import ru.tander.mads.Mads

fun onUserIdUpdated(userId: String) {
    Mads.userId = userId
}
```

### Таймаут запроса за рекламой

Таймаут сетевого запроса за рекламой задаётся параметром `adRequestTimeoutMillis` метода `init(...)` в **миллисекундах**. По умолчанию — `10_000` (10 секунд). Если ответ не получен за отведённое время, загрузка завершается ошибкой `AdLoadingTimeoutException`.

```kotlin
import ru.tander.mads.Mads

class DemoApplication : Application() {

    override fun onCreate() {
        Mads.init(this, adRequestTimeoutMillis = 5_000) // 5 секунд
    }
}
```

- При превышении таймаута загрузка завершается ошибкой ``AdLoadingTimeoutException (`InAppAdResponse.Failure` / `InLineAdResponse.Failure`). Обработать её можно в результате загрузки соответствующего формата — см. [In App Message](<Рекламные форматы/In App Message/подформаты/modal-window.md>) и [InLine](<Рекламные форматы/InLine/подформаты/multiformat.md>).

> [!NOTE]
> Параметр задаётся в миллисекундах — единообразно с iOS SDK.

## Что дальше?

- [In App Message (Модальное окно)](<Рекламные форматы/In App Message/подформаты/modal-window.md>) — показ всплывающей рекламы
- [InLine (Баннеры)](<Рекламные форматы/InLine/подформаты/multiformat.md>) — встраивание рекламных блоков в контент