Contact usContact us

YSO Integration Guide

This guide will instruct you step-by-step on how to set YSO Ads live as an ad network on Unity LevelPlay.

⚡ Before you start Make sure you have correctly integrated LevelPlay’s Rewarded, Interstitial or Banner into your application.

Step 1: Create a YSO Network account

Start by creating a YSO Network account. This gives you access to the dashboard where you configure your apps and placements.

  1. Go to the YSO Network website.
  2. Register for a YSO Network account.
  3. Wait for your account approval from your YSO account manager.
  4. Sign in to the YSO Network dashboard.

Step 2: Create an app and placements

Add your app

  1. Log in to the YSO Network dashboard.
  2. Select Applications from the top menu bar.
  3. Click the plus (+) button.
  4. To enter your app information on the Applications > New page, follow these steps:
    1. Enter the app name
    2. Provide the bundle ID
    3. Select the platform
  5. Click Create to add your app.

    Create ad placements

    1. Select Publishing from the menu.
    2. Click the plus (+) button.
    3. Set the following placement details:
       • Name: Enter a placement name
       • Application: Select your iOS app
       • Type: Choose the ad format
    4. Click Create.

    When you create a placement, YSO Network generates a placement key. You can find it in the Publishing section of the dashboard.

    Step 3. Activate YSO Ads on the LevelPlay platform 

      • Log into your LevelPlay account and go to the LevelPlay side bar ➣ Setup ➣ Networks
      • Locate YSO Ads from the list of available ad networks and click Setup.Then enter the relevant information
      • Next, go to the Instances page, select the app on which you’d like to run Unity LevelPlay’s Mediation with YSO Ads bidding.
      • Select YSO Ads and enter the relevant information for Interstitial, Rewarded, Banner, and Native settings. Then click Save.

        The network will be active for your app.

            Step 4. Add the YSO Ads Adapter to Your Build

            Unity LevelPlay supports both Gradle dependencies and manual download mechanisms.

            Gradle

            1. Make sure the following Maven URL exists in your build.gradle script of your app module.
              maven { 
url 'https://ysonetwork.s3.eu-west-3.amazonaws.com/sdk/android' 
}
              1. Add the adapter’s Maven name to your build.gradle script of your app module.
                dependencies {
    implementation 'com.unity3d.ads-mediation:yso-adapter:5.0.0'
    implementation 'com.ysocorp:ysonetwork:fivead:1.2.7'
}

              Done!
              You are now all set to deliver YSO Ads within your application!