Integrate the Light SDK
Light SDK is the Appodeal SDK without our ads: the SDK core plus the AppsFlyer and Meta Analytics adapters, no ad-network adapters. It is one of the two modes of wizard step Monetization Setup, whose panel says: "Integrate Appodeal SDK without ad network adapter and only with AppsFlyer and Meta adapters, there is no need for full integration at this step." You end with the SDK in your build and Complete Monetization Setup active. Not sure this is your mode? See Light SDK or Appodeal SDK.
Before you start
You need:
- Step 1. Select Your App done.
- Your app key — Application Key.
- Nothing Meta- or AppsFlyer-side is needed yet — those values are entered in UA Setup.
1. Mediation
In 1. Mediation click Light SDK. The progress bar shows two milestones, Mediation and SDK, and the step has one checkbox, SDK implemented.
2. Import SDK
The embedded panel shows your platform's Import SDK steps and the current plugin version; the Light dependency set is in the tab for your platform. A separate Git branch for the test integration works well.
- Android
- iOS
- Unity
- Flutter
- React Native
- Add the Appodeal repository (Step 1. Import SDK).
- Add the Light dependency set to your app module.
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 and Sentry are required by the SDK core; they are not ad networks. Match the versions to the wizard's 2. Import SDK panel (Kotlin DSL / Groovy).
- Initialize the SDK (Step 3. Initialize SDK).
- Create the
Podfile.
platform :ios, '15.0'
use_frameworks!
# pods: copy them from the wizard's iOS tab (2. Import SDK → 1. Podfile configuration → Show Podfile)
Take the pod list from the wizard's iOS tab (Show Podfile); if you are unsure, send us your Podfile — we confirm it per app (Get help).
- Run
pod installand open the.xcworkspacefile. - Initialize the SDK (Step 3. Initialize SDK).
- Capacitor: apply this tab to the
ios/project.
-
Download External Dependency Manager (
.tgz, v1.2.175 or newer) and add it with Window → Package Manager → + → Add package from tarball. Then add the Appodeal package with Add package from git URL, using the URL the wizard prints — it pins the current plugin version, and that is the version to use. -
Project Settings → Appodeal DM → click Minimal (older guides call this button None).
-
Scroll to Services, select AppsFlyer and Meta Analytics, click Generate. Sentry stays selected (required); Adjust and Firebase stay off.
-
Initialize the SDK (Step 3. Initialize SDK).
The plugin wraps the native SDKs: install the current release from the
Flutter plugin repository, then apply the Android and
iOS tabs to android/ and ios/. The Light dependency set is confirmed per project — Get help.
The plugin wraps the native SDKs. Install the current release from the
React Native plugin repository; apply the Android and
iOS tabs to android/ and ios/. A React Native / Expo version pairing is confirmed per project —
Get help.
Select SDK implemented.
Optional: log events
No events are required for the test. Optional: if your own ads stay on, log where an ad would have shown. If you skip it, nothing changes for the review.
Appodeal.LogEvent("potential_interstitial_shown");
Appodeal.LogEvent("potential_rewarded_shown");
Level-based games can also send level_start / level_finish events (level_name, result, time); keep
the names as in the sample.
If Unity dependencies do not resolve
- Assets → External Dependency Manager → Android Resolver → click Delete Resolved Libraries, then Force Resolve.
- If it still fails, close Unity, delete the
Library/folder and reopen the project. - Check that
Assets/Appodeal/Editor/Dependencies/AppodealDependencies.xmllists the dependencies. - Gradle errors: Gradle Settings.
Complete Monetization Setup
Click Complete Monetization Setup. In Light SDK mode the button is active as soon as SDK implemented is selected; nothing else gates it. The build itself is verified in step 3 — 3. Prepare the app for testing.
If something is off
| You see | Why | Do this |
|---|---|---|
| Complete Monetization Setup is grey | SDK implemented is not selected — in Light SDK mode it is the only gate | Select it |
| The wizard shows only Android | Unity (or iOS | Unity) sub-tabs | The panel follows the app entry you selected | Flutter / React Native: use the Android and iOS tabs on this page |
| The PDF guide says click None | Naming slip in an older guide | The button is Minimal |
Next you enter your Meta App ID (and the 64-character Decryption Key on Android), click Request UA and MMP Setup, and send the build for review.
Next: 3. UA Setup
Get help
Write to [email protected] and [email protected] or [email protected]. Include your bundle ID, the platform (Android, iOS, Unity, Flutter or React Native), whether you chose Light SDK or Appodeal SDK, and what is blocking you: the wizard block and a screenshot, or the exact error or log text.