PremiumAds AppLovin MAX Adapter — Unity

Integrate PremiumAds as a mediation ad source in your Unity app using the AppLovin MAX Unity Plugin.

Supported formats: Banner, MREC, Interstitial, Rewarded, Native

App Open is not supported. AppLovin MAX does not support the App Open ad format for custom network adapters.

Prerequisites

• Unity 2022.3 LTS or newer (Unity 6 supported)
• AppLovin MAX Unity Plugin (required)
• External Dependency Manager for Unity (EDM4U) — already included in the AppLovin MAX Unity Plugin

1. Install the PremiumAds Unity Package

1. Download PremiumAdsMaxAdapter.unitypackage from the Releases page.
2. In Unity: Assets → Import Package → Custom Package → select the downloaded .unitypackage
3. Click Import to import all files.
4. EDM4U will automatically resolve native dependencies on next build:
   • Android: net.premiumads.sdk:max-adapter (from PremiumAds JFrog Maven)
   • iOS: PremiumAdsMaxAdapter (from CocoaPods)

To force resolve immediately: Assets → External Dependency Manager → Android Resolver → Force Resolve

2. Configure the MAX Custom Network

In the AppLovin MAX dashboard, add PremiumAds as a Custom Network:

Field	Value
Network Name	PremiumAds Custom Adapter
iOS Class Name	PremiumAdsAdapter
Android Class Name	net.premiumads.sdk.adapter.max.PremiumAdsAdapter
Placement / Parameter	Your PremiumAds ad unit ID

3. Load Ads

The adapter works automatically through the AppLovin MAX Unity Plugin — no extra C# code needed. Load ads as usual through the standard MAX SDK APIs (Banner, MREC, Interstitial, Rewarded, Native).

4. Debug Logging (Optional)

Enable verbose debug logging from the PremiumAds adapter:

using PremiumAds;

void Start()
{
    PremiumAdsMaxAdapter.SetDebug(true);
}

Filter logs:

• Android Logcat: tag:PremiumAdsAdapter
• iOS Xcode console: [PremiumAdsAdapter]

5. Build & Run

Android

1. Unity: File → Build Settings → Android
2. EDM4U will fetch the adapter AAR automatically during build
3. Run on a real device or emulator

iOS

1. Unity: File → Build Settings → iOS → Build
2. Open the generated Xcode project workspace (.xcworkspace)
3. CocoaPods will auto-install PremiumAdsMaxAdapter
4. Build and run on device

Building from Source

With Unity installed:

./build-unitypackage.sh [unity-version]

Without Unity installed, the package can also be built directly from the committed .meta files:

./scripts/pack-unitypackage.sh

Source Code & Releases

• Repository: https://github.com/premium-ads/max-adapter-unity
• Releases: https://github.com/premium-ads/max-adapter-unity/releases

Troubleshooting

Build fails with missing AAR: Run Assets → External Dependency Manager → Android Resolver → Force Resolve

iOS build fails with missing pod: Open a terminal in the generated Xcode project folder and run pod install

New ad units / waterfall changes don't take effect immediately: Changes to ad units or waterfall configuration in the MAX dashboard take 30–60 minutes to propagate.

Ads never load / NO FILL (HTTP 204): A NO FILL response means the waterfall has no eligible line item for the requesting app/device — check that your ad unit has active demand and that the app's bundle/package ID matches the app configured in the MAX dashboard.

Adapter not initialized: Verify the custom network class names in the MAX dashboard match exactly:

• Android: net.premiumads.sdk.adapter.max.PremiumAdsAdapter
• iOS: PremiumAdsAdapter

Documentation

• Max Adapter Overview & Dashboard Setup
• Android Integration
• iOS Integration
• Test Ad Units

Support

Contact your PremiumAds account manager or email [email protected]