Установка и настройка SDK

Руководство по Интеграции.

Версия релиза 1.7.7 | Дата релиза 20.10.2025

Минимальные требования:

• Используйте Android API level 22 (Android OS 5.1) и выше.

Демо-приложение

Используйте наше демо-приложение в качестве примера.

GitHub - YabbiSDKTeam/yabbi-android-demoGitHub

Установка

Общее описание процесса установки

Для установки Android SDK вам потребуется:

• Ознакомиться с демо-приложением

• Дополнить settings.gradle вашего проекта

• Дополнить build.gradle вашего проекта

• Синхронизировать gradle проекта

• Проверить корректность установки с помощью инициализации SDK с включенным режимом отладки

Подготовьте Gradle

В Android 11 изменился способ запроса приложений и взаимодействия с другими приложениями, установленными пользователем на устройстве. По этой причине убедитесь, что вы используете версию Gradle, которая соответствует одной из перечисленных здесь.

1. Дополните файл settings.gradle необходимыми для установки SDK репозиториями. Полный список репозиториев вам предоставит аккаунт-менеджер Yabbi. Посмотрите вашу версию Android Studio, и вставьте соответствующий код в settings.gradle в корне проекта. Пример подключения репозиториев в settings.gradle.

Начиная с Arctic Fox и выше

// project-level settings.gradle

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // ... other repositories
        
        // подключение репозитория Yabbi SDK
        maven { url  "https://sdkpkg.sspnet.tech" }
        
        // подключение репозитория SDK рекламной сети IronSource
        maven { url "https://android-sdk.is.com" }
        
        // подключение репозитория SDK рекламной сети Mintegral
        maven { url  "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea" }
    }
}

Для версий до Arctic Fox

1. Дополните build.gradle необходимыми параметрами сборки для корректной установки SDK.

// app-level build.gradle

android {
  // ... other settings
     
   defaultConfig {
     // ... other settings
       
     multiDexEnabled true // Enable multidex
   }
 
   compileOptions {
       sourceCompatibility JavaVersion.VERSION_1_8
       targetCompatibility JavaVersion.VERSION_1_8
   }
}

1. В этом же файле добавьте зависимости для установки всех нужных адаптеров. Полный список зависимостей с актуальными номерами версий библиотек и адаптеров вам предоставит аккаунт-менеджер Yabbi. Пример зависимостей для сетей Yabbi, Applovin, IronSource, Yandex и Mintegral.

dependencies {
    // ... другие зависимости
    
    // подключение зависимости Yabbi SDK
    implementation 'sspnet.tech:yabbi:1.7.7'
    
    // пподключение зависимости рекламной сети Applovin SDK
    implementation 'sspnet.tech.adapters:applovin:1.4.0'
    implementation 'com.applovin:applovin-sdk:13.0.0'
    
    // подключение зависимости рекламной сети IronSource SDK
    implementation 'sspnet.tech.adapters:ironsource:1.5.0'
    implementation 'com.ironsource.sdk:mediationsdk:8.3.0'
    
    // подключение зависимости рекламной сети Yandex SDK
    implementation 'sspnet.tech.adapters:yandex:1.5.1'
    implementation 'com.yandex.android:mobileads:7.1.0'
    
    // подключение зависимости рекламной сети Mintegral SDK
    implementation 'sspnet.tech.adapters:mintegral:1.5.0'
    implementation 'com.mbridge.msdk.oversea:reward:16.6.31'
    implementation 'com.mbridge.msdk.oversea:newinterstitial:16.6.31'
}

1. Сохраните файл и нажмите Gradle Sync.

Конфигурация сетевой безопасности

Android 9.0 (API 28) по умолчанию блокирует http-трафик (не-HTTPS), что может препятствовать корректному отображению рекламы. Подробнее об этом здесь.

Чтобы разрешить использование http-трафика, нужно добавить атрибут usesCleartextTraffic в файл AndroidManifest.xml:

<application
    ...
    android:usesCleartextTraffic="true">
    ...
</application>

Обфускация кода

Если в вашем приложении включена обфускация кода, то добавьте следующий текст в конец файла proguard-rules.pro:

-keep class sspnet.tech.**.* { *; }

Поддержка OAID

Для аналитики пользовательской активности SDK использует GAID — рекламный идентификатор Google.

Если вы хотите распостранять приложение на устройства Huawei без поддержки Google Mobile Services, то вам необходимо включить поддержку OAID у себя в приложении.

1. Посмотрите вашу версию Android Studio, и вставьте соответствующий код в settings.gradle в корне проекта.

Начиная с Arctic Fox и выше

// project-level settings.gradle

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // ... other repositories
        
        // подключение репозитория Huawei
        maven { url 'https://developer.huawei.com/repo/' }
    }
}

Для версий до Arctic Fox

1. Добавьте в build.gradle следующуе зависимости:

// app-level build.gradle

dependencies {
    // ... other dependencies
    
   // подключение зависимости Huawei Mobile Services
   implementation 'com.huawei.hms:ads-identifier:3.4.62.300'
}

Добавьте ключ Applovin SDK

Если вы используете адаптер для Applovin, то добавьте следующий <meta-data> элемент в свой AndroidManifest.xml внутри <application> элемента:

<meta-data android:name="applovin.sdk.key"
           android:value="APPLOVIN_SDK_KEY"/>

Ваш APPLOVIN_SDK_KEY вы сможете скопировать в разделе "Keys" в личном кабинете Applovin.

Проверка установки

Чтобы убедиться, что SDK установлена корректно, потребуется включить режим отладки и инициализировать SDK.

Режим отладки

В режиме отладки SDK логирует ошибки и события. По умолчанию выключен.

Для включения режима отладки используйте метод enableDebug.

Yabbi.enableDebug(true);

Инициализация

Используйте код ниже, чтобы инициализировать SDK в вашем проекте.

Ваш publisher_id вы сможете скопировать в разделе "Настройки" в личном кабинете Yabbi.

Yabbi.initialize("publisher_id", new InitializationListener() {
   @Override
   public void onInitializeSuccess() {
      // Вызывется когда SDK установлена корректно
   }

   @Override
    public void onInitializeFailed(AdException error) {
      // Вызывется когда при установке SDK произошла ошибка
      // С помощью AdException error можно получить подробную информацию об ошибке
    }
});

Если SDK установлена корректно, то вы увидите в консоли следующее сообщение.

SDK initialized(<номер версии Yabbi SDK>)

Готово! SDK установлена, можем переходить к настройке рекламы.

Рекомендуем вам не отключать режим отладки до завершения работы с рекламой.

Если SDK устанавливается некорректно

В случае возникновения ошибок рекомендуем очистить кеш Gradle.

Очистка кеша Gradle в Android Studio на Mac OS

Если это не помогло, попробуйте установить SDK в чистый проект. Если SDK установилась корректно, попробуйте отладить ошибки в вашем проекте.

Также рекомендуем взглянуть на установку и инициализацию в демо-приложении.

Если у вас не получается корректно установить SDK, и действия выше не привели к успешной инициализации — обратитесь в поддержку.

Дополнительные действия для повышения дохода

Сбор данных о геолокации

Для более эффективного работы таргетированной рекламы и повышения дохода вы можете собирать в приложении данные о точной и/или примерной геолокации пользователя, и передавать их в Yabbi SDK.

Разрешение на доступ к примерной геолокации ACCESS_COARSE_LOCATION уже включено в SDK при установке.

Если вы не хотите предоставлять примерную геолокацию пользователя:

1. Добавьте следующий код в AndroidManifest.xml вашего приложения:

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" tools:node="remove" />

1. Обновите приложение в Google Play. В процессе публикации убедитесь, что в Google Play Console нет предупреждений о наличии работы с разрешением местоположения без упоминания в политике конфиденциальности приложения и/или без необходимости для функций приложения.

Прочие настройки SDK

Экран пользовательского согласия

Для соответствия требованиям магазина приложений и законов, регулирующих сбор, обработку и использование персональных данных пользователя, требуется получение его согласия на вышеуказанные действия.

Обычно получение согласия пользователя происходит на специальном экране при первом запуске приложения — consent-screen.

В Yabbi SDK реализован такой экран, вы можете добавить и настроить его с помощью библиотеки Consent Manager.

Подробнее о его установке и настройке вы можете узнать в соответствующем разделе.

Экран пользовательского согласия