Unity Ads integration
Set up Unity Ads as an ad network in Unity LevelPlay by creating a Unity ID, setting up your app and placements, and linking them to your LevelPlay account.
読み終わるまでの所要時間 1 分最終更新 1日前
重要
The following documentation discusses products or services (“Third-party Products”) not developed, owned, or operated by Unity.
This information might be outdated or incomplete and is provided for your convenience.
Your use of any Third-party Product is subject to its own terms.
Unity makes no warranties regarding these products and isn't liable for any damages or losses arising from their use, including issues related to content, advertising, or materials from Third-party providers.
注
To view the adapter changelog for this mediation network, refer to Mediation Networks for iOS.
Prerequisites
Ensure that you correctly integrate Rewarded ads, Interstitial ads, or Banner ads into your application. Refer to the following platform-specific guides for integration instructions:- Unity Ads supports Android operating systems version 4.4 (API level 19) and up
- Unity Ads SDK 4.7.1+ requires minimum compile SDK version 33, and minimum Kotlin version 1.7.0+
Step 1. Set up Unity Ads
Complete the following steps before setting up Unity Ads:注
After you have completed step 1, you can skip to step 4 and use the auto bidder setup tool to get up and running with Unity Ads bidder on Unity LevelPlay. If you’d rather continue with a manual setup, continue with step 2.
Step 2. Create a project on Unity Ads
Follow these steps to create your app on Unity Ads:Create an app
- On the Unity Monetization Dashboard, select Projects.
- Select Organization, then Projects
-
Select Create project
- Enter a project name and COPPA designation
-
Select Create project
Create an ad unit
Use an Ad Unit to surface an event in your game that triggers ad content:- From the left navigation menu, select Monetization > Ad Units
- Select Add Ad Unit to bring up the creation modal
- Enter an Ad Unit name, then select a platform (iOS or Android) and ad format (Rewarded ads, Interstitial, or Banner).
- Select Create to save your Ad Unit
Add a placement
After your project is created, navigate to Monetization > Placements and take note of the Game ID for both platforms.
注
While Unity Ads automatically creates “default” placements when first creating your project, we recommend creating new unique placements for each Unity Ads mediation configuration.
Step 3. Retrieve your credentials
You’ll need to retrieve the following details from the Unity Ads platform to complete setup on LevelPlay:- API Key
- Organization core ID
- Key ID
- Secret key
Step 4. Configure Unity Ads on LevelPlay
After you have all of these parameters, log in to your LevelPlay account.-
Go to ‘Mediation‘ > ‘Setup‘ > ‘SDK Networks‘.
- Select Unity Ads from the list of Available Networks
-
Input the Unity Ads API Key and Organizational Core ID in the relevant fields
- To activate the auto-setup feature, toggle on the Unity Ads auto-setup tool. This will enable you to automatically create an app and bidder placement on the Unity Ads platform and allow LevelPlay to retrieve placement details from Unity Ads
-
After you’ve toggled on the auto-setup tool, enter the key ID and secret key (from step 3). Then, select Save
注
If you toggle the auto-setup tool on, you can still configure Unity Ads bidding manually on LevelPlay.
Step 5: Set up Unity Ads on the app level
Traditional waterfall setup
- Choose the app you want to integrate from the list on the left side of the SDK Networks page
- In the ad unit row, select Setup and enter the Game ID and Placement ID under the relevant ad unit settings
- You will then see Unity Ads as Active for Mediation on your Setup Dashboard.
Bidder setup
There are two ways to set up the Unity Ads bidder on LevelPlay:- Auto-setup - Automatically create a new app and placements on the Unity Monetize dashboard and populate all the necessary settings on LevelPlay
- Manual - Manually enter the necessary app details on the LevelPlay and Unity Ads platforms
-
Select the app where you’d like to run interstitial, rewarded, or banner ads from Unity Ads. Then select the define icon in the Unity Ads row
-
Select Add bidder to automatically create new app and bidding placements on the Unity Ads platform, and import the Game ID and Placement IDs. If there is a Game ID already attached to the app, you will be able to use the auto-setup tool if there is at least 1 placement without the Placement ID parameter value. In this case, a new bidding placement will be created (for the Game ID insert)
- Select the app where you’d like to run interstitial or rewarded ads from Unity Ads
- Select Unity Ads from the Setup list of Ad Networks, select the define icon, and insert the Game ID and Placement ID in the relevant fields
- Select Save
Step 6. Add the Unity Ads Adapter to Your Build
LevelPlay supports both Cocoapods and Manual download mechanisms.Download the Unity Ads Adapter with Cocoapods
To integrate the Unity Ads SDK with Cocoapods, enter the following line in your podfile and you're good to go!pod 'IronSourceUnityAdsAdapter','5.5.0'
Manual Download
- Download the Unity Ads Adapter and SDK: Add the Unity Ads Adapter to your build. Refer to Mediation networks for iOS. Important! The Unity Ads Adapter does not contain the Unity Ads SDK. Make sure to add Unity Ads SDK as well.
- Add the Unity Ads frameworks to your Project: After you download the SDK and Adapter files and unzip them, drop the framework files into your Xcode Project.
Update Property List file (Info.plist)
Unity Ads SDK 3.4.8+ requires to include Unity Ads ad network ID in your app property list file (Info.plist). Learn more about Unity Ads SKAdNetwork Ids documentation here.Step 7. Unity Ads Additional Settings
User-level COPPA
Unity LevelPlay lets publishers communicate Unity Ads User-level COPPA settings directly to the Unity Ads network. This feature is enabled using LevelPlay SDK 7.1.12+, Unity Ads iOS Adapter 4.3.15+. Use the following syntax, to set Unity Ads user.nonBehavioral flag with the parameter True:[LevelPlay setMetaDataWithKey:@"UnityAds_coppa" value:@"YES"];
[LevelPlay setMetaDataWithKey:@"UnityAds_coppa" value:@"NO"];
Evaluate Your Ad Network Integration
- Verify your ad network integration with our Integration Helper. The LevelPlay SDK provides a tool to ensure you've successfully integrated our SDK as well as any additional network adapters.
-
Manage the debug logs for your integrated mediation ad networks with this boolean
When set to YES, this line of code will enable debug logs to help you troubleshoot issues with all of your mediation ad networks. Remove this code before your app goes live with our ad units! Supported for SDK versions 6.5.2 and up.[LevelPlay setAdaptersDebug:YES];