# AppLovin MAX

{% hint style="danger" %}
The **legacy MAX HyprMX adapter** is being sunset. Migrate to the **custom adapter** **today** to avoid any disruption to monetization
{% endhint %}

## Introduction <a href="#hyprmxmobilesdkadmobadapteroverview-introduction" id="hyprmxmobilesdkadmobadapteroverview-introduction"></a>

This guide walks you through setting up the HyprMX Android SDK as a custom ad network in AppLovin MAX mediation. See below for instructions on how to set up a new adapter or upgrade to newer versions.

## Supported Ad Formats <a href="#hyprmxmobilesdkadmobadapteroverview-introduction" id="hyprmxmobilesdkadmobadapteroverview-introduction"></a>

* Rewarded Ads
* Interstitial Ads&#x20;
* Banner/MREC&#x20;

## Compatibility <a href="#hyprmxmobilesdkadmobadapteroverview-upgradeinstructions5.0to5.4.5.0" id="hyprmxmobilesdkadmobadapteroverview-upgradeinstructions5.0to5.4.5.0"></a>

* **HyprMX-MAX Adapter Version:** 6.4.6.0
* **Compatible with AppLovin SDK:** 12.4.2+

{% hint style="info" %}
Find additional compatibility details on the [Downloads](https://documentation.hyprmx.com/sdk-integration-guides/android-amazon/downloads) page.
{% endhint %}

If you need support for older AppLovin versions, your HyprMX account manager is here to help.

## Step 1: Add HyprMX as a Custom Network <a href="#hyprmxmobilesdkadmobadapteroverview-upgradeinstructions5.0to5.4.5.0" id="hyprmxmobilesdkadmobadapteroverview-upgradeinstructions5.0to5.4.5.0"></a>

{% stepper %}
{% step %}
In the MAX Dashboard, go to: [MAX > Mediation > Manage > Networks](https://dash.applovin.com/o/mediation/networks/).
{% endstep %}

{% step %}
Click "**Click here to add a Custom Network"** at the bottom of the page. The "**Create Custom Network"** page appears.
{% endstep %}

{% step %}
Enter the following details about the custom network:

* **Network Type**: SDK
* **Custom Network Name**: HyprMX
* **iOS Adapter Class Name**: HyprMXAdapter
  * Keep this blank if you're only integrating with Android
* **Android Adapter Class Name:** com.hyprmx.android.HyprMXMaxAdapter

{% hint style="info" %}
**Please note:** iOS and Android Class Names must be entered *exactly* as indicated above.
{% endhint %}

<figure><img src="https://1334370064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FotZpoAL3N1sv1EOOdyKQ%2Fuploads%2F85xSUoPQ6ml1mMighoRU%2Fimage.png?alt=media&#x26;token=c4ea5756-82af-445d-be12-1385838da9a4" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Press Save to create the SDK network.
{% endstep %}
{% endstepper %}

## Step 2: Create Ad Units <a href="#hyprmxmobilesdkadmobadapteroverview-upgradeinstructions5.0to5.4.5.0" id="hyprmxmobilesdkadmobadapteroverview-upgradeinstructions5.0to5.4.5.0"></a>

> 💡**Migrating from the MAX Legacy Adapter?**
>
> If you’ve previously set up HyprMX ad units using the legacy adapter, you’ll need to create **new placements** for the custom adapter.

**To set up:**

{% stepper %}
{% step %}
Open [MAX > Mediation > Manage > Ad Units](https://dash.applovin.com/o/mediation/ad_units/) in the MAX dashboard.
{% endstep %}

{% step %}
Click the ad unit where you want to enable HyprMX.
{% endstep %}

{% step %}
Scroll down to the Custom Networks section and enable **HyprMX.**

<figure><img src="https://1334370064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FotZpoAL3N1sv1EOOdyKQ%2Fuploads%2FxDe52CN1y2iGcr17vt56%2Fimage.png?alt=media&#x26;token=0206e298-d68c-4b96-8e6d-d5d5a164659a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Enter relevant information for each placement.

> 💡**Migrating from the MAX Legacy Adapter?**
>
> To keep your reporting clean and seamless:
>
> * **Use the same Distributor ID(s)** you've been using with your current setup
> * **Use the same Placement Name(s)** as your current setup

* **App ID:** Your Distributor ID (from your account manager)
* **Placement ID:** Your Placement Name (from your account manager)
* **CPM Price:** Desired floor price
  {% endstep %}

{% step %}
Save and repeat these steps for each Ad Unit you'd like to configure.
{% endstep %}

{% step %}
If you’re migrating from the legacy adapter and still have older app builds with the legacy adapter live, keep the legacy adapter settings enabled under **Other Networks** to continue monetizing those builds. You may keep both legacy and custom adapter settings enabled at the same time, **but each app build should include only one HyprMX adapter to avoid conflicts.**

<figure><img src="https://1334370064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FotZpoAL3N1sv1EOOdyKQ%2Fuploads%2FZhEXuMaMKJ39fDbE3J8J%2Fimage.png?alt=media&#x26;token=0d8f0709-493c-4fcc-8492-be285087cb4e" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Step 3: Install Custom Adapter <a href="#hyprmxmobilesdkadmobadapteroverview-upgradeinstructions5.0to5.4.5.0" id="hyprmxmobilesdkadmobadapteroverview-upgradeinstructions5.0to5.4.5.0"></a>

This guide assumes you already have the AppLovin Android SDK integrated into your project. If not, refer to the [AppLovin integration guide](https://developers.applovin.com/en/max/android/overview/integration/) before proceeding.

Follow these steps to install the HyprMX custom adapter:

{% stepper %}
{% step %}
Open your existing application in Android Studio.
{% endstep %}

{% step %}
If you're migrating from the legacy adapter, remove the following dependency from your app's  `build.gradle` file: &#x20;

{% hint style="danger" %}
**Important: Avoid Adapter Conflicts**

Only use a **single** HyprMX adapter (either legacy or custom) in a given **app** **build**. Running more than one may cause conflicts and disrupt monetization.
{% endhint %}

```
implementation 'com.applovin.mediation:hyprmx-adapter:+'
```

{% endstep %}

{% step %}
Add or update the following dependency to your app's `build.gradle` file:

```
dependencies {
    // Remove the old max adapter if migrating from the MAX-certified adapter
    // implementation 'com.applovin.mediation:hyprmx-adapter:+'
    // Add the new one below
    implementation 'com.hyprmx.android:HyprMX-Max:6.4.6.0'
}
```

{% endstep %}
{% endstepper %}

## Step 4: Test and Verify Integration <a href="#hyprmxmobilesdkadmobadapteroverview-upgradeinstructions5.0to5.4.5.0" id="hyprmxmobilesdkadmobadapteroverview-upgradeinstructions5.0to5.4.5.0"></a>

You can receive test ads by enabling test mode. When using the **custom adapter**, enable **test mode** before initializing MAX:

{% tabs %}
{% tab title="Kotlin" %}

```kotlin
HyprMXMaxAdapter.enableTestMode()
```

{% endtab %}

{% tab title="Java" %}

```java
HyprMXMaxAdapter.enableTestMode();
```

{% endtab %}
{% endtabs %}

We recommend putting HyprMX at the top of your waterfall during testing to ensure you receive ad requests.

<figure><img src="https://1334370064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FotZpoAL3N1sv1EOOdyKQ%2Fuploads%2FV1AraIPvOh6NJ3xXYHJD%2Fimage.png?alt=media&#x26;token=47c2966a-8e8a-42aa-8bf4-a910b368a20e" alt=""><figcaption></figcaption></figure>

Once the SDK is initialized, request an ad and confirm you see **test ads**. That’s it — you're integrated!&#x20;

{% hint style="info" %}
**Don’t forget:** Disable test mode before going live to start receiving live ads.
{% endhint %}

## Need Help? <a href="#need-help" id="need-help"></a>

If you have any questions, your HyprMX account manager is just a message away!

## License <a href="#license" id="license"></a>

By integrating the HyprMX SDK, you are agreeing to the [End User License Agreement](https://hyprmx.com/eula.html).