Unity Package integration
Download and integrate the LevelPlay Unity Plugin into your project to enable ad mediation and monetization features.
読み終わるまでの所要時間 4 分最終更新 1日前
注
The LevelPlay Unity package supports Unity Editor Supported and LTS versions, and Android operating systems version 4.4 (API level 19)+. iOS version support is defined per network. LevelPlay mediation supports iOS versions 13+, and Xcode versions 16+.
ヒント
AI-assisted integration (Beta): The LevelPlay Unity Integration Skill for Claude Code and other AI coding agents provides step-by-step guidance on LevelPlay setup. To get started, install it from the Unity Skills repository and activate it in your agent. This skill is currently in beta and is shaped by your feedback: Take our survey to let us know your thoughts.
Step 1. Add LevelPlay to your Unity project
注
If you're looking to upgrade from an earlier version of the LevelPlay Unity package to version 9.0.0+, follow this guide instead.
- Recommended: Add the Ads Mediation package to your project by navigating to Window > Package Manager in Unity. Look for “Ads Mediation” and select the install button. You can also add the package by its name:
com.unity.services.levelplay - Or, Download Unity Plugin Version 9.5.0 (.unitypackage) and import it into your Unity project.
Step 2. Initialize the SDK
If you haven't done so already, go to the LevelPlay Platform and create a new app. When complete, use your App Key to initialize the SDK:- Import the namespace: At the top of your C# script, include the namespace:
using Unity.Services.LevelPlay; - Initialize the SDK: Inside your Start() method, register event listeners and initialize the SDK:
It is important to register OnInitFailed and OnInitSuccess before initializing LevelPlay as they provide you with important insight: OnInitSuccess – triggered when LevelPlay initialized successfully. After you receive this callback, you can start showing ads in your app. OnInitFailed – triggered when LevelPlay failed to initialize and therefore ads will not show. We recommend trying to initialize LevelPlay later (when internet connection is available, or when the failure reason is resolved).public void Start() { // Register OnInitFailed and OnInitSuccess listeners LevelPlay.OnInitSuccess += SdkInitializationCompletedEvent; LevelPlay.OnInitFailed += SdkInitializationFailedEvent; // SDK init LevelPlay.Init("ThisIsYourAppKey");}
Set UserID
You can pass in a User ID when initializing LevelPlay. This is useful if you're trying to use Ad Quality's User Journey, or if you're using server-to-server callbacks to reward your users.LevelPlay.Init("ThisIsYourAppKey", "UserId");
Step 3. LevelPlay Network Manager
The LevelPlay Network Manager window is a one stop shop for all things LevelPlay. You can find it in Unity's top navigation bar, under Ads Mediation. From here, you can:- Update your LevelPlay SDK.
- Install & update your preferred Ad Networks. When installed, you'll need to configure each ad network separately. Learn more.
- Get your app's Info.plist automatically updated with SKAdNetwork IDs according to the ad networks you have installed.
Android
To apply your changes and download the relevant ad network artifacts, you'll need to use a resolver. Go to: Assets > Mobile Dependency Manager > Android Resolver > Resolve You should do this after each change in the LevelPlay Network Manager. If you're using Gradle, you can avoid downloading the network artifacts into your project. Instead, the artifacts will be added to your Gradle file during the compilation.注
If you imported Mobile Dependency Resolver with Unity package 8.10.0 or later, this will be done automatically.
- Go to: Edit > Project Settings > Player > Android > Publishing Settings
- Enable Custom Main Gradle Template
- Go to: Assets > Mobile Dependency Manager > Android Resolver > Settings
- Select “Patch mainTemplate.gradle”
- Save your changes, by pressing “OK”
Step 4. Additional setup
iOS
SKAdNetwork support
注
LevelPlay will automatically manage this if you've performed a fresh install of version 9.1.0+ of the Unity package. In versions 8.8.1-9.0.1, this feature can be enabled in the Network Manager, as described in Step 3. In versions 8.10.0 and earlier, you must also enable LevelPlay SDK SKAN ID automation under Ads Mediation > Developer Settings > LevelPlay Mediation Settings.
<key>SKAdNetworkItems</key><array> <dict> <key>SKAdNetworkIdentifier</key> <string>su67r6k2v3.skadnetwork</string> </dict></array>
App transport security settings
- Add in a dictionary called 'NSAppTransportSecurity'. Make sure you add this dictionary on the 'Top Level Key'.
- Inside this dictionary, add a Boolean called 'NSAllowsArbitraryLoads' and set it to YES.
- Make sure that your info.plist does not contain any other exceptions besides 'NSAllowsArbitraryLoads', as this might create a conflict.
- Find more information on ATS here.
重要
To be compliant with Apple's privacy requirements, you must implement SKAdNetwork attribution (automatically managed as of Unity package 9.1.0) as well as the iOS Privacy Manifest. LevelPlay supports both and you can learn more here.
重要
You must implement the privacy methods relevant to your app. Learn more here.
Android
Apps using Android 13+ (API level 33+) will need to declare a Google Play services normal permission in the manifest file as follows:Read more about Google Advertising ID changes here.<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
Step 5. Verify your integration
The LevelPlay package provides an easy way to verify that your integration was completed successfully with its integration test suite. Test your app’s integration, verify platform setup, and review ads related to your configured networks. To enable the test suite in your app, call the following before initializing the SDK:After successfully initializing LevelPlay, launch the test suite by calling:LevelPlay.SetMetaData("is_test_suite", "enable");
For more details and an implementation example of the LevelPlay integration test suite navigate to this article.LevelPlay.LaunchTestSuite();