Keep your mediation setup.

Quick start

Integrate with AppLovin MAX

The managed model in four steps. For the recommendation model, follow the Integration guide for your platform.

1. 1

   Add the SDK

   Add the Orivia SDK and its AppLovin MAX module.

   Add the Orivia Maven repository and both modules.

   build.gradle.ktsCopy

   repositories {
       maven { url = uri("https://raw.githubusercontent.com/orivia-ai/orivia-maven/main") }
   }
   
   dependencies {
       implementation("ai.orivia:monetization:1.18.0")
       implementation("ai.orivia:mediation-max:1.18.0")
   }

   Add the Orivia specs repository and both pods, then run pod install.

   PodfileCopy

   source 'https://github.com/orivia-ai/orivia-specs.git'
   source 'https://cdn.cocoapods.org/'
   
   pod 'OriviaMonetization', '1.18.0'
   pod 'OriviaMonetizationMax', '1.18.0'

   Import the orivia-sdk-max .unitypackage we provide, then reference the namespace.

   C#Copy

   using Orivia.Monetization;

2. 2

   Initialize

   Initialize with your publisher ID and default ad units. Orivia fetches its configuration, then initializes MAX. The default ad units are your fallback: use units with no floor or a $0.01 floor.

   KotlinCopy

   private val oriviaMaxSdk: OriviaMaxSdk by lazy { OriviaMaxSdk.getInstance(context) }
   
   fun start() {
       oriviaMaxSdk.onInterstitialLoadedListener = OriviaMaxSdk.OnAdLoadedListener {
           // Ad is ready to show. isInterstitialReady() == true.
       }
       oriviaMaxSdk.onRewardedLoadedListener = OriviaMaxSdk.OnAdLoadedListener {
           // Ad is ready to show. isRewardedReady() == true.
       }
   
       oriviaMaxSdk.init(
           sdkKey = MAX_SDK_KEY,
           publisherId = ORIVIA_PUBLISHER_ID,
           defaultInterstitialAdUnitId = INTERSTITIAL_AD_UNIT_ID,
           defaultRewardedAdUnitId = REWARDED_AD_UNIT_ID,
           initListener = {
               // Both Orivia SDK and MAX are ready — safe to start loading
               oriviaMaxSdk.loadInterstitial()
               oriviaMaxSdk.loadRewarded()
           }
       )
   }

   SwiftCopy

   func start() {
       OriviaMaxSdk.shared.onInterstitialLoaded = {
           // Ad is ready to show. isInterstitialReady() == true.
       }
       OriviaMaxSdk.shared.onRewardedLoaded = {
           // Ad is ready to show. isRewardedReady() == true.
       }
   
       OriviaMaxSdk.shared.initialize(
           sdkKey: maxSdkKey,
           publisherId: oriviaPublisherId,
           defaultInterstitialAdUnitId: interstitialAdUnitId,
           defaultRewardedAdUnitId: rewardedAdUnitId
       ) {
           // Both Orivia SDK and MAX are ready — safe to start loading
           OriviaMaxSdk.shared.loadInterstitial()
           OriviaMaxSdk.shared.loadRewarded()
       }
   }

   C#Copy

   void Start()
   {
       OriviaMaxSdk.OnInterstitialLoaded += OnInterstitialLoaded;
       OriviaMaxSdk.OnRewardedLoaded += OnRewardedLoaded;
   
       MaxSdk.SetSdkKey(MaxSdkKey);
       OriviaMaxSdk.Init(
           publisherId: OriviaPublisherId,
           defaultInterstitialAdUnitId: InterstitialAdUnitId,
           defaultRewardedAdUnitId: RewardedAdUnitId,
           initListener: new InitListener()
       );
   }
   
   private class InitListener : OriviaMaxSdk.IInitListener
   {
       public void OnInitFinished()
       {
           // Both Orivia SDK and MAX are ready — safe to start loading
           OriviaMaxSdk.LoadInterstitial();
           OriviaMaxSdk.LoadRewarded();
       }
   }

3. 3

   Make the mediation call

   Load and show through Orivia. Placement and custom data pass straight through to MAX.

   KotlinCopy

   oriviaMaxSdk.loadInterstitial()
   
   if (oriviaMaxSdk.isInterstitialReady()) {
       oriviaMaxSdk.showInterstitial("level_end")
   }

   SwiftCopy

   OriviaMaxSdk.shared.loadInterstitial()
   
   if OriviaMaxSdk.shared.isInterstitialReady() {
       OriviaMaxSdk.shared.showInterstitial(placement: "level_end")
   }

   C#Copy

   OriviaMaxSdk.LoadInterstitial();
   
   if (OriviaMaxSdk.IsInterstitialReady)
       OriviaMaxSdk.ShowInterstitial("level_end");

4. 4

   Validate

   In a debug build, turn on logging and check that initialization completes and ads load and show. Remove it before release. Our team reviews the integration with you before any traffic is allocated.

   Kotlin · logs appear in LogcatCopy

   oriviaMaxSdk.setLoggingEnabled(true)

   Swift · logs appear in the Xcode consoleCopy

   OriviaMaxSdk.shared.setLoggingEnabled(true)

   C# · logs appear in Logcat or the Xcode consoleCopy

   OriviaMaxSdk.SetLoggingEnabled(true);