Powered by

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

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

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

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

repositories {
    mavenCentral()
}

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

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

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

import ru.tander.mads.Mads

class DemoApplication : Application() {

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

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

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

import ru.tander.mads.Mads

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

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

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

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 и InLine.

Что дальше?