Integrating the Mobile Ads Unity plugin

System: Yandex Advertising Network, Adfox

Unity is a cross-platform game development environment developed by Unity Technologies.

Mobile Ads Unity is a plugin for the Unity3D game platform that supports the Yandex Mobile Ads SDK.

App requirements

• To use this SDK, your app's Target API Level must be set to 31 or above.
• To load any type of ad, iOS version 13 or higher is required.
• Use Xcode 16.1 or higher.

Prerequisites

Registering your app in the Yandex Advertising Network

Here's how to register your app in the Yandex Advertising Network:

1. Log in or register your account in the Yandex Advertising Network.
2. Register your app in the Yandex Advertising Network.

Installing Unity

1. Download UnityHub from the official site and install it.

2. Open UnityHub, go to Installs, and click Add in the upper-right corner.

3. Select a Unity version. We recommend selecting from the latest LTS (long term support) versions. Click Install next to the version you want to use.

4. Select the options:

   • Android Build Support, including OpenJDK and Android SDK & NDK Tools.
   • iOS Build Support.

   Disable the Documentation option.

   Complete the installation.

5. Open UnityHub and go to Projects.

6. Select New project, then 2D-core. Click Create project.

You've downloaded Unity and created a project.

App configuration

1. Download the yandex-ads-unity-plugin directory and add the package yandex-mobileads-lite-8.0.0.unitypackage. You will also be prompted to install the Google resolver. If you've already added the Google resolver to your project, uncheck the box.

   How to add a package

   Select the required plugin (Assets → Import Package → Custom Package) and click Import.

2. Use the Google resolver to install dependencies: enable "auto-resolve" or select the menu item Assets → External Dependency Manager → Android Resolver → Resolve.

3. For proper operation, enable custom templates for the generated project. To do this, in the build settings (Build Settings → Player Settings → Publishing Settings → Build), select Custom Main Gradle Template.

   We recommend that you always enable Custom Main Gradle Template and Custom Gradle Properties Template when building a Unity app to avoid other potential errors.

   

4. To test the Mobile Ads Unity plugin, use one of the demo scripts in the samples directory of the yandex-ads-unity-plugin repository. Copy the script to the project directory and add it as a Component to the main camera.

Platform-specific setup

configurations.all {
    resolutionStrategy {
        force 'androidx.core:core:1.6.0'
        force 'androidx.core:core-ktx:1.6.0'
      }
}

Testing SDK integration

Android

iOS

You can verify the success of the library integration using the SDK's built-in integration testing tool.

To do so, after adding the dependency and initializing the SDK, rebuild the project.

Open Logcat and search for the “Yandex Ads” keyword.

The command outputs the integration status logs. You'll see a message indicating whether the integration was successful. If there's a problem, you'll see a detailed description along with steps to resolve it. Sample command output:

mobileads$ adb logcat | grep 'Yandex Ads' -i
[Yandex Ads]  I  Yandex Mobile Ads 8.0.0 integrated successfully
[Yandex Ads]  I  Yandex Mobile Ads 8.0.0 initialized successfully

The log shows two separate events:

• integrated successfully: Integration check (SDK hasn't been initialized yet).
• initialized successfully: Successful SDK initialization.

You can check the logs to make sure your SDK integration is correct.

To view logs, go to the Console tool and set Subsystem = com.mobile.ads.ads.sdk. You can filter logs by category, leaving only the ones related to the ad SDK integration. Set Category = Integration. Save the query and select it from the filter line whenever you need debugging.

You will see messages about successful integration: enabling YandexMobileAdsBundle.bundle, initializing the SDK, and connecting SKAdNetwork and mobile mediation adapters (if you use them in your project).

If there are any problems during SDK integration, you will see a detailed issue report.

Next steps

You have successfully integrated the Mobile Ads Unity Plugin and can now implement your ad formats.

Select one of the following types of ads that best suits your app:

Learn more

• Plugin integration errors