Интеграция Light SDK
Light SDK — это Appodeal SDK без нашей рекламы: ядро SDK плюс адаптеры AppsFlyer и Meta Analytics, без адаптеров рекламных сетей. Это один из двух режимов шага визарда Monetization Setup, панель которого сообщает: "Integrate Appodeal SDK without ad network adapter and only with AppsFlyer and Meta adapters, there is no need for full integration at this step." В итоге SDK стоит в вашем билде, а кнопка Complete Monetization Setup активна. Не уверены, что это ваш режим? См. Light SDK или Appodeal SDK.
Прежде чем начать
Вам понадобится:
- Завершённый шаг 1. Select Your App.
- Ключ вашего приложения — Application Key.
- Со стороны Meta и AppsFlyer пока ничего не нужно — эти значения вводятся в UA Setup.
1. Mediation
В блоке 1. Mediation нажмите Light SDK. Прогресс-бар показывает две вехи, Mediation и SDK, а у шага одна галочка — SDK implemented.
2. Import SDK
Встроенная панель показывает шаги Import SDK для вашей платформы и текущую версию плагина; набор зависимостей Light SDK — во вкладке вашей платформы. Тестовую интеграцию удобно вести в отдельной ветке Git.
- Android
- iOS
- Unity
- Flutter
- React Native
- Добавьте репозиторий Appodeal (Шаг 1. Импорт SDK).
- Добавьте набор зависимостей Light SDK в модуль приложения.
dependencies {
implementation("com.appodeal.ads.sdk:core:4.3.0")
implementation("org.bidon:bidmachine-adapter:3.7.1.1")
implementation("com.appodeal.ads.sdk.adapters:appsflyer:6.18.0.1")
implementation("com.appodeal.ads.sdk.adapters:bidmachine:3.7.1.0")
implementation("com.appodeal.ads.sdk.adapters:bidon:0.14.0.0")
implementation("com.appodeal.ads.sdk.adapters:facebook_analytics:18.3.0.0")
implementation("com.appodeal.ads.sdk.adapters:iab:1.8.1.0")
implementation("com.appodeal.ads.sdk.adapters:sentry_analytics:8.44.1.0")
}
BidMachine, Bidon, IAB и Sentry нужны самому ядру SDK; это не рекламные сети. Сверьте версии с панелью визарда 2. Import SDK (Kotlin DSL / Groovy).
- Инициализируйте SDK (Шаг 3. Инициализация SDK).
- Создайте
Podfile.
platform :ios, '15.0'
use_frameworks!
# pods: copy them from the wizard's iOS tab (2. Import SDK → 1. Podfile configuration → Show Podfile)
Возьмите список подов из вкладки iOS визарда (Show Podfile); если сомневаетесь, пришлите нам свой Podfile — мы подтверждаем его по каждому приложению (Помощь).
- Выполните
pod installи откройте файл.xcworkspace. - Инициализируйте SDK (Шаг 3. Инициализация SDK).
- Capacitor: примените эту вкладку к проекту
ios/.
-
Скачайте External Dependency Manager (
.tgz, версия v1.2.175 или новее) и добавьте его через Window → Package Manager → + → Add package from tarball. Затем добавьте пакет Appodeal через Add package from git URL, взяв URL, который печатает визард, — он фиксирует текущую версию плагина, и это та версия, которую нужно использовать. -
Project Settings → Appodeal DM → нажмите Minimal (в старых руководствах эта кнопка называется None).
-
Прокрутите до блока Services, выберите AppsFlyer и Meta Analytics, нажмите Generate. Sentry остаётся выбранным (он обязателен); Adjust и Firebase остаются выключенными.
-
Инициализируйте SDK (Шаг 3. Инициализируйте SDK).
Плагин оборачивает нативные SDK: установите текущий релиз из
репозитория плагина для Flutter, затем примените
вкладки Android и iOS к android/ и ios/. Набор зависимостей Light SDK мы подтверждаем по каждому
проекту — Помощь.
Плагин оборачивает нативные SDK. Установите текущий релиз из
репозитория плагина для React Native; примените вкладки
Android и iOS к android/ и ios/. Сочетание версий React Native / Expo мы подтверждаем по каждому
проекту — Помощь.
Выберите SDK implemented.
Дополнительно: события
Для теста события не требуются. Дополнительно: если ваша собственная реклама остаётся включённой, логируйте места, где реклама была бы показана. Если пропустить этот шаг, для ревью ничего не изменится.
Appodeal.LogEvent("potential_interstitial_shown");
Appodeal.LogEvent("potential_rewarded_shown");
Игры с уровнями могут дополнительно отправлять события level_start / level_finish (level_name, result,
time); сохраняйте имена такими же, как в примере.
Если зависимости Unity не резолвятся
- Assets → External Dependency Manager → Android Resolver → нажмите Delete Resolved Libraries, затем Force Resolve.
- Если не помогло, закройте Unity, удалите папку
Library/и откройте проект заново. - Проверьте, что в
Assets/Appodeal/Editor/Dependencies/AppodealDependencies.xmlперечислены зависимости. - Ошибки Gradle: Настройки Gradle.
Complete Monetization Setup
Нажмите Complete Monetization Setup. В режиме Light SDK кнопка становится активной сразу после того, как выбрана галочка SDK implemented; больше её ничто не блокирует. Сам билд проверяется на шаге 3 — 3. Подготовка приложения к тестированию.
Если что-то не так
| Что вы видите | Почему | Что делать |
|---|---|---|
| Кнопка Complete Monetization Setup неактивна | Не выбрана галочка SDK implemented — в режиме Light SDK это единственное условие | Выберите её |
| Визард показывает только вкладки Android | Unity (или iOS | Unity) | Панель следует за выбранной записью приложения | Flutter / React Native: используйте вкладки Android и iOS на этой странице |
| В PDF-руководстве написано нажать None | Оговорка в названии в старом руководстве | Кнопка называется Minimal |
Дальше вы вводите свой Meta App ID (и 64-символьный Decryption Key на Android), нажимаете Request UA и MMP Setup и отправляете билд на ревью.
Далее: 3. UA Setup
Помощь
Напишите на [email protected] и [email protected] или [email protected]. Укажите bundle ID, платформу (Android, iOS, Unity, Flutter или React Native), какой режим вы выбрали — Light SDK или Appodeal SDK — и что именно блокирует: блок визарда и скриншот либо точный текст ошибки или строки лога.