Руководство по интеграции
Версия Релиза | Дата Релиза |
---|---|
3.9.0 | 28.08.2025 |
Следуйте этому руководству, чтобы получить максимальную отдачу от Appodeal.
Appodeal SDK даёт вам доступ к 70+ рекламным источникам и заставляет их конкурировать друг с другом на аукционе в реальном времени, максимизируя ваши доходы от рекламы. Функционал Appodeal SDK также включает In-app Bidding, автоматическую оптимизацию UA, сегментацию пользователей & A/B тестирование, перекрестное продвижение, прямые сделки, мгновенные выплаты и многое другое.
Appodeal SDK предоставляет два способа интеграции. Из предложенных ниже вариантов выберите тот, который больше соответствует вашим потребностям:
- Appodeal SDK Full Package
- Appodeal SDK Mediation Only
The Appodeal SDK Full Package - - Appodeal SDK предоставляет вам
инструменты для развития ваших мобильных приложений и игр. В
дополнение к монетизации вы можете воспользоваться сервисами
продвижения пользователей UA (User Acquisition) и аналитики в
приложении.
Вот список сервисов, которые включает Appodeal SDK Full Package:
-
Начните с Appodeal, чтобы получить доступ к Монетизации и Аналитике.
-
Подключитесь к Adjust или AppsFlyer, чтобы разблокировать функции Атрибуции.
-
Подключитесь к Meta (ранее известная как facebook-core) для User Acquisition.
-
Подключитесь к Firebase для Аналитики + remote config для продуктовых A/B тестов и настроек.
Если вы планируете проводить кампании UA, хотите анализировать свои показатели в нашем инструменте бизнес-аналитики Appodeal без использования MMP или хотите использовать remote config для тестов и настроек, ваш вариант — полный пакет.
The Appodeal SDK Mediation only - Если вы не планируете проводить кампании по привлечению пользователей (UA) и не хотите использовать расширенную аналитику Appodeal, мы создали облегченную версию нашего SDK только с функцией медиации. В процессе интеграции от вас не потребуется устанавливать никаких дополнительных сервисов, кроме медиации. Это может ускорить процесс интеграции, и вы всегда сможете перейти на Full Package, когда будете готовы.
Пожалуйста, следуйте данному руководству по интеграции шаг за шагом и выбирете свой вариант интеграции по мере необходимости.
В следующем документе показано, как интегрировать Appodeal в ваш Android проект с нужными вам сетями через gradle build, а также настройка всех рекламных форматов.
Android API level 23 (Android OS 6.0) или выше.
В качестве эталонного проекта мож но использовать наше демо приложения
Demo App
Шаг 1. Импорт SDK
Приложения с minApiVersion
ниже 26 могут столкнуться с проблемами совместимости с GoogleAds Identifier 18.2.0.
Решение: Включите desugaring основной библиотеки в вашем build.gradle. См. наше руководство по устранению неполадок для получения пошаговых инструкций.
Настроить Build.gradle
- Appodeal SDK Full Package
- Appodeal SDK Mediation Only
Мы предоставляем удобный и интерактивный способ управления build.gradle dependencies в зависимости от выбранных типов рекламы, сетей и сервисов. Чтобы настроить ваш build.gradle, пожалуйста, посетите страницу Настройка Медиационных Сетей.
Ниже представлен базовый и рекомендуемый код для build.gradle:
Мы предоставляем удобный и интерактивный способ управления build.gradle dependencies в зависимости от выбранных типов рекламы, сетей и сервисов. Чтобы настроить ваш build.gradle, пожалуйста, посетите страницу Настройка Медиационных Сетей.
Ниже представлен базовый и рекомендуемый код для build.gradle:
- Kotlin DSL
- Groovy
1. Вставьте следующий код в settings.gradle.kts на уровень корня проекта
2. Вставьте следующий код в файл на уровне приложения build.gradle.kts
1. Вставьте следующий код в build.gradle на уровень корня проекта
2. Вставьте следующий код в файл на уровне приложения build.gradle
После этого сохраните файл и выполните Gradle sync.
Шаг 2. Настройка проекта
Конфигурация сетевой безопасности
Android 9.0 (API 28) по умолчанию блокирует трафик с открытым текстом (не-HTTPS), что может препятствовать корректному отобра жению рекламы. Подробнее об этом здесь.
Чтобы предотвратить блокировку системой android http-трафика, выполните следующие действия:
- Добавьте файл Network Security Configuration в ваш AndroidManifest.xml :
<?xml version="1.0" encoding="utf-8"?>
<manifest>
<application
...
android:networkSecurityConfig="@xml/network_security_config">
</application>
</manifest>
- В файл network_security_config.xml добавьте base-config и установите cleartextTrafficPermitted в значение true :
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<base-config cleartextTrafficPermitted="true">
<trust-anchors>
<certificates src="system" />
</trust-anchors>
</base-config>
</network-security-config>
Настройка AdMob Meta-data
Только если вы используете адаптер AdMob.
Admob Bidding теперь доступен с Appodeal SDK 3.2.0.
Не забудьте установить нашу новую версию Admob Sync инструмента по ссылке и выполнит ь синхронизацию.
Можете прочитать подробнее про Admob Sync в нашей инструкции.
Добавьте AdMob app id в meta-data тег:
<manifest>
<application>
<!-- Add your AdMob App ID -->
<meta-data
android:name="com.google.android.gms.ads.APPLICATION_ID"
android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
</application>
</manifest>
Вы можете найти AdMob app id в личном кабинете на странице AdMob:
Более подробную информацию о синхронизации с Admob смотрите в нашем руководстве по Admob.
Шаг 3. Инициализация SDK
Мы рекомендуем вызывать метод инициализации в вашей MainActivity - onCreate
только один раз во
всем приложении:
- Kotlin
- Java
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
/// Any other pre-initialization
/// app specific logic
Appodeal.initialize(
context = activity,
appKey = "APP_KEY",
adTypes = adTypes,
callback = object : ApdInitializationCallback {
override fun onInitializationFinished(errors: List<ApdInitializationError>?) {
// Appodeal initialization finished
}
}
)
}
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
/// Any other pre-initialization
/// app specific logic
Appodeal.initialize(activity, "APP_KEY", adTypes, new ApdInitializationCallback() {
@Override
public void onInitializationFinished(@Nullable List<ApdInitializationError> errors) {
// Appodeal initialization finished
}
});
}
-
activity
- Activity вашего приложения. -
Замените
APP_KEY
на актуальный ключ вашего приложения. Вы можете найти ключ приложения в списке приложений в вашем личном кабинете. -
adTypes
- Тип рекламы. Инициализируйте только те типы рекламы, которые вы хотите использовать в своем приложении, чтобы избежать запросов рекламы на неиспользуемые типы. Используйте приведенные ниже коды типов для установки предпочтительного формата объявлений:Appodeal.INTERSTITIAL
для полноэкранной рекламы;Appodeal.REWARDED_VIDEO
для видео с вознаграждением;Appodeal.NATIVE
для нативной рекламы;Appodeal.BANNER
для баннеров;Appodeal.MREC
для баннеров 300*250.
Типы рекламы можно комбинировать с помощью оператора or
. Например, Appodeal.INTERSTITIAL or Appodeal.REWARDED_VIDEO
.
callback
- Callback инициализации AppodealApdInitializationCallback
. Callback инициализации используется для определения результата инициализации Appodeal SDK. Вызывается после завершения инициализации Appodeal. Если инициализация прошла успешно, тоerrors
будетnull
. В противном случае он содержит списокerrors
.