Liftoff Monetize integration
Add Liftoff Monetize as an ad network in Unity LevelPlay by creating an account, setting up placements, and adding the Liftoff adapter to your build.
Read time 2 minutesLast updated a day ago
Important
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.
Note
The Vungle iOS SDK v.6.8.0+ (Vungle adapter 4.3.6+) supports Xcode 12 or higher. Building on Xcode 11 or below is not supported.Note
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:Step 1. Create a Liftoff Monetize Account
- Create an account with Liftoff Monetize. You can do so here
- After your account has been verified, you can log in at their partner login here
Step 2. Create an Application in Liftoff Monetize
After you log in, go to the Applications tab on the left side menu drop-down in the upper-left corner and select Add Application.Step 3. Add a Placement
Select the relevant app from the application list. On the app's dedicated page, select Add Placement. Then input the necessary details to create a Liftoff placement and select Continue, then Sounds Good. Banner Placement When creating Banner ad placement, it's recommended to disable the "Ad Refresh" option. You can later control the refresh rate on Unity LevelPlay.Step 4. Activate Liftoff Monetize on the LevelPlay SDK Networks Module
There are 4 pieces of data from your Liftoff account that need to be inserted into your LevelPlay Network Setup Module in order for Liftoff to work correctly in connection with LevelPlay:Liftoff App ID | This is the unique identifier of your application in Liftoff's system. |
|---|---|
| Reporting API ID | This is a unique identifier for your app in Liftoff''s system, used with the Reporting API to track app performance. |
| Reporting API Key | This is a unique identifier for your Liftoff account. Along with the Reporting API ID, this will allow Unity LevelPlay to import performance data from your Liftoff Monetize account. |
| Placement Reference ID | This is the unique identifier of the ad unit, necessary to differentiate Rewarded ads from Interstitial ads and Banner ads. |
-
Reporting API Key
Go to the My Account in the upper-right corner of the screen you will then see the Reporting API Key. -
Liftoff Monetize Application ID
Go to the Applications tab on the left side menu and select the application to configure on LevelPlay dashboard. You will then see Liftoff App ID. -
Reporting API ID
Go to the Applications tab on the left side menu and select the application you to configure on LevelPlay dashboard. You will then see Liftoff Reporting API ID. -
Placement Reference ID
Go to the Placements tab on the left side menu and choose the application's placements you would like to configure on LevelPlay dashboard.
Activate Liftoff Monetize on Unity LevelPlay
After you've collected all necessary parameters, log in to your LevelPlay account.- Go to Monetize > Setup > SDK Networks:
- Select Liftoff from the list of Available Ad Networks and enter the Liftoff ‘Reporting API Key‘. This step will be required only once.
- To activate the auto-setup feature, toggle on the Liftoff Monetize auto-setup tool. This will enable you to automatically create an app and bidder placement on the Liftoff Monetize platform and allow LevelPlay to retrieve placement details from Liftoff Monetize after you’ve toggled on the auto-setup tool and enter the Secret Token found on the Overview page on the Liftoff Monetize platform. Then, select Save
- Select Save. Liftoff will then be enabled in the Available Networks table
5. Set up Liftoff Monetize 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, click Setup and enter the, Reporting API Key, App ID and Reporting API ID. Then under the relevant ad unit settings, add the Placement Reference ID.
- Select Save. You will then see Liftoff Monetize as Active for Mediation on your Setup Dashboard.
Bidder setup
There are two ways to set up the Liftoff Monetize bidder on LevelPlay:- Auto-setup – Automatically create a new app and placements on the Liftoff Monetize dashboard and populate all the necessary settings on LevelPlay
- Manual – Manually enter the necessary app details on the LevelPlay and Liftoff Monetize 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 Liftoff row.
- Select Add bidder to automatically create new app and bidding placements on the Liftoff Monetize platform, and import the relevant information into LevelPlay.
- Select Save to approve and accept all configurations. If you close the module without saving, the assets will be created on the Liftoff Monetize platform without importing the data onto the LevelPlay platform.
Note
The status of Liftoff Monetiz bidder instances will be the same as the status of the ironSource Ads bidder, by ad unit. For example, if you’re not using the ironSource Ads bidder for rewarded ads, it will not be automatically activated for the Liftoff Monetize network. To activate the Liftoff Monetize bidding instance for rewarded ads, select the Liftoff Monetize row and toggle on the ad unit.
- Select the app where you’d like to run banner, interstitial or rewarded ads from liftoff Monetize
- Select Liftoff from the Setup list of Ad Networks, select the define icon, and insert the Reporting API Key, App ID and Reporting API ID. Then under the relevant ad unit settings, add the Placement Reference ID.
- Click Save
Step 6. Add the Vungle Adapter to Your Build
To use Liftoff Monetize, you need to install the Vungle SDK here.iOS
LevelPlay supports both Cocoapods and Manual download mechanisms.Cocoapods
To integrate the Vungle SDK with Cocoapods, enter the following line in your podfile and you're good to go!Manual Downloadpod 'IronSourceVungleAdapter','5.6.0'
- Download the Vungle Adapter: Add the Vungle Adapter and SDK files to your build. Refer to Mediation networks for iOS. Important! The Vungle Adapter does not contain the Vungle SDK. You need to add the Vungle SDK as well.
- Add the Vungle XCframeworks to your Project: After you download and unzip the Adapter and SDK files, drop the XCframework files into your Xcode project.
- Remove the iOS Status Bar For optimal user experience, Vungle strongly recommends removing the iOS Status bar when their ad unit is served to your users. To do this, open your Info.pList, add the key "View controller-based status bar appearance" and set it to "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];
Step 7. Liftoff Additional Settings
COPPA User status
Unity LevelPlay lets publishers communicate Vungle COPPA settings directly to the Liftoff network. This feature is enabled using LevelPlay SDK 7.2.2+, Vungle Android Adapter 4.3.20+. Read more about Vungle COPPA API here. Use the following syntax, to update Vungle's COPPA User Status with the parameter “Yes”:[LevelPlay setMetaDataWithKey:@"Vungle_coppa" value:@"Yes"];
[LevelPlay setMetaDataWithKey:@"Vungle_coppa" value:@"No"];