Installing and configuring the plugin

Integration Guide.

Release version 1.4.2 | Release date 07/07/2025

Minimum requirements:

Use Unity 2018.3+ version.
Use Android API level 22 (Android OS 5.1) and above.
Use iOS 13.0 and above.
Use Xcode 13 and above.

Demo application

Use our demo application as an example.

GitHub - MadexTech/madex-unity-demoGitHub

Installation

General description of the installation process

To install the Unity Plugin, you will need:

Check out the demo application
Download and import the latest version of the plugin into your project.
Configure External Dependency Manager
Check the installation correctness by initializing the plugin with debug mode enabled

Download the Plugin

Download the latest version of the plugin at the link.
Import the plugin into your project using the Custom Package option. The plugin includes the External Dependency Manager. You may not import it if it has already been installed in the project.

Configure External Dependency Manager

External Dependency Manager is a plugin for resolving dependency conflicts

To resolve dependency conflicts in your application, follow these steps:

Navigate to Build Settings → Android → Player Settings → Publishing settings
For Unity 2018.4 - Unity 2019.2: add the Custom Gradle Template flag For Unity 2019.3 or newer: add the Custom Main Gradle Template flag
Go to External Dependency Manager → Android Resolver → Settings
Enable the Patch mainTemplate.gradle setting
Enable the Use Jetifier setting
Select the Force Resolve option in External Dependency Manager → Android Resolver → Force Resolve
If the dependencies are installed successfully, you will see the Resolution Succeeded alert

Code obfuscation

If code obfuscation is enabled in your application, then add the following text to the end of the file proguard-rules.pro:

-keep class sspnet.tech.**.* { *; }

Add the Applovin SDK key

If you are using an adapter for Applovin, then follow these steps for the platform you are working with// Some code

If you are using an adapter for Applovin, then add the following <meta-data> element to your AndroidManifest.xml inside the <application> element:

<meta-data android:name="applovin.sdk.key"
           android:value="APPLOVIN_SDK_KEY"/>

You can copy your APPLOVIN_SDK_KEY in the "Keys" section of your Applovin personal account.

Add the following key to Info.plist:

<key>AppLovinSdkKey</key>
<string>APPLOVIN_SDK_KEY</string>

You can copy your APPLOVIN_SDK_KEY in the "Keys" section of your Applovin personal account.

Installation check

To make sure that the plugin is installed correctly, you will need to enable debug mode and initialize the plugin.

Debug mode

In debug mode the plugin logs errors and events. It is disabled by default.

Use the EnableDebug method to enable debug mode.

Madex.enableDebug(true);

Initialization

Inherit the class that will work with the SDK from the interface for tracking SDK initialization.

class YourClassName : IInitializationListener {    
    public void OnInitializeSuccess()
    {
        // Called when the SDK is installed correctly
    }
    
    public void OnInitializeFailed(AdException error)
    {
        // Called when an error occurred during SDK installation
        // Using AdException error, you can get detailed information about the error
    }
}

Use the code below to initialize the plugin in your project. You can copy your publisher_id in the "Settings" section of your Madex personal account.

Madex.initialize("publisher_id");

If the plugin is installed correctly, you will see the following message in the console.

Call to Initialize on not supported platform. To test advertising, install your application on the Android/iOS device.

This message indicates that the plugin is installed correctly, but ad display is only possible after building the application for Android/iOS.

Done! The plugin is installed, you can proceed to setting up ads.

We recommend that you don't disable debug mode until you finish working with ads.

If the plugin is installed incorrectly

In case of errors, we recommend clearing the External Dependency Manager cache and selecting Force Resolve in External Dependency Manager → Android Resolver.

If this doesn't help, try installing the plugin in a clean project. If the plugin is installed correctly, try to debug errors in your project.

We also recommend to take a look at the installation and initialization in the demo application.

If you are unable to install the plugin correctly and the above steps didn't lead to successful initialization, please contact support.

Connecting external ad networks to the project

If you are using Madex mediation (working with other ad networks through our plugin):

Import the file into the project received from the Madex account manager (drag and drop the file into the project or use the Custom Package option)
Select the Force Resolve option in External Dependency Manager → Android Resolver → Force Resolve

Updating the Plugin and Managing Adapters for Other Ad Networks

Check for an update before building the app.

The Madex Unity Plugin provides a convenient interface for updating the plugin and managing ad networks. In the Dependency Manager window, you can update the plugin to the latest version and choose the ad networks you want to use.

Additional actions to increase revenue

Setting Up Apple ID

For more effective targeted advertising and increased revenue, Madex Unity Plugin collects and transmits user App ID data - a unique numerical application identifier from the Apple AppStore.

It is determined automatically, but in some cases, Madex Unity Plugin may not be able to determine it.

If Madex Unity Plugin did not determine your App ID, you will see the following message in the console.

AppStore ID is nil. You must set AppStore ID manually.

In this case, you need to set the ID manually.

To set up Apple ID, use the setCustomParams method.

Madex.setCustomParams("appStoreAppID", "apple_id")

Replace apple_id with your App ID from the AppStore developer account. You can find it on the app page in the developer account.

Apple Advertising Identifier (IDFA)

For more effective targeted advertising and increased revenue, you can collect the Apple device advertising identifier and pass it to Madex Unity Plugin.

To enable IDFA collection, check the following checkboxes in the plugin setting:

NSUserTrackingUsageDescription - Permission to collect the advertising identifier (Advertising Identifier IDFA).

Geolocation data collection

To make targeted ads work more effectively and increase revenue, you can collect in app data about a user's exact and/or approximate geolocation, and feed it into the Madex Unity Plugin.

To enable geolocation data collection on Android, check the following checkboxes in the plugin settings:

ACCESS_COARSE_LOCATION - Permission to collect approximate user geolocation.

ACCESS_FINE_LOCATION - Permission to collect precise user geolocation.

To enable geolocation data collection on iOS, check the following checkboxes in the plugin settings:

NSLocationWhenInUseUsageDescription - Permission to collect user geolocation

Other plugin settings

In order to comply with the requirements of the app store and the laws governing the collection, processing and use of user's personal data, it is required to obtain his consent to the above actions.

Usually, the user's consent is obtained on a special screen when the application is first launched — consent-screen.

The Madex Unity Plugin implements such a screen, you can add and configure it using the Content Manager library.

You can find out more about its installation and configuration in the corresponding section.

User Consent Screen

Possible errors

Library not loaded: @rpath/MadexSDK.framework/MadexSDK

The error occurs due to the peculiarities of xcframework linking in Unity. In order to fix the error, you need to download MadexPostProcessBuildiOS.cs from this link and place it in the scripts folder or in another folder for your scripts.

PreviousUnity Plugin NextWorking with advertising

Last updated 4 days ago