UnityAds

This Guideline will instruct you step-by-step on how to set UnityAds as an Ad Network on the AdTiming Mediation platform.

Before You Start

Make sure you have correctly integrated AdTiming's  Banner, Rewarded Video and Interstitial Ads into your application.

Important! The ADAPTERS for ad networks are modularized, which means that you need to download Not Only the SDK of mediation networks  you choose to work with But Also the adapters for those ad networks. Be sure to follow this Guide to mediation Unity's Ads.

 

Step 1. Create a UnityAds Account

  1. Create an account with UnityAds. You can do so here.
  2. Once your account has been verified you can log in at their partner login here.

Step 2. Create an Application and Placement in UnityAds

Follow these steps to create your UnityAds application:

1. Create Application

  • Once you login, navigate to the Developer Dashboard and select the Operate tabandroid_unity_1.png
  • Then add a new projectandroid_unity_2.png 
  • Name your new project and enter the store IDs you wish to publish on (Apple App Store or Google Play). If the game hasn’t been published yet you can always add the IDs later.android_unity_3.png
        Note: You will need a unique UnityAds application per platform (iOS + Android).

 

2. Create Placement
UnityAds creates two default placements: one for Video (Interstitial on the AdTiming Dashboard) and on for Rewarded Video. To view your placements or create new placements to run with AdTiming's Mediation:

  • From Operate tab of the Developer Dashboard, select your Project:android_unity_4.png

 

    • Select Platforms from the left navigation bar to view a list of your Project's active platforms.
    • Select the platform you want to create Placements for.
    • Click on 'ADD NEW PLACEMENT'
android_unity_5.png

 

  • The below window will appear and you must fill in the following info:
  1. Check Rewarded video to make the ads displayed through this Placement unskippable.
  2. Select the ad Type to display through this Placement (currently, Video is the only option).
  3. Name the Placement. The Placement ID, which you call in your code implementation, automatically populates based on your entry.
  4. Check mute audio if you want the ad to default to muted audio.
  5. If you did not check Rewarded video, you can specify the number of seconds to Allow skip after for ads displayed through this Placement.
  6. After clicking 'Save', you should see your manually added placement under your default placements.android_unity_6.png

 

Step 3. Retrieve UnityAds Parameters

Immediately after you confirm your application, you will be redirected to a summary page open to the 'Monetization Settings' tab. Below parameters from your UnityAds account which need to be input into your AdTiming Network Setup Module in order for UnityAds to work correctly in connection with AdTiming.

Once you obtain this information, you must configure UnityAds Parameters in your AdTiming Account. By adding the above information correctly, you will be able to take full advantage of UnityAds’ ad inventory and reporting data on AdTiming’s Mediation platform.

1. Game ID

Go to Operate tab and select your Project, then select Platforms from the left navigation bar. You will then see a list of all added apps in that project as well as their respective Game IDs. android_unity_7.png

2. Placement ID
Go to Operate tab and select your Project, then select Platforms from the left navigation bar. Choose the platform you want to see placements for.

android_unity_8.png

Select the relevant application from the available list and under the Ad Placements tab you will see the placement IDs for all your placements. Choose the ID of the default ad type (Rewarded video, video or one of the placements you created)

 

3. API Key
Navigate to the main monetization dashboard and click on API KEYS. You will then see your API Key.

android_unity_api_key.png

Step 4. Configure UnityAds’ Parameters into AdTiming Account

Once you have all of these parameters, log in to your AdTiming account.

1. Once you have both of these parameters, log in to your AdTiming account and go to Placement ->Edit your placement

 

2. Click on Instances-> Add Instance. Select Unity from the list of Available Ad Networks, click 'New Account'UnityAds.jpg

3. Complete the following parameters below,and click 'Save'. 

___23.jpg

 

Step 5. Add the UnityAds SDK&Adapter to Your Build

Android

1.  Add the Unity SDK

  • Add the following to your application-level build.gradle file.
dependencies {
    ...
 
    implementation 'com.unity3d.ads:unity-ads:3.4.6'
}

 

2.  Add the Unity Adapter

     AdTiming supports both Gradle dependencies and Manual download mechanisms.

       Gradle dependencies

  • Add the following in your project-level build.gradle file.
...
 allprojects {
   repositories {
        ...

        jcenter()
        maven {
            url "https://dl.adtiming.com/android-sdk"
        }
   }
 }
  • Add the following in your application-level build.gradle file.
implementation 'com.adtiming.adapters:unity:3.5.0@aar'

       Manual download

  • Download the unity Adapter from here.
  • Add the unity Adapter to Your Project
  • Add the UnityAdapter-x.x.x.aar to the libs folder in your Android Project.
  • Make sure you add the following to your Gradle build file under the dependencies section:
implementation (name:'UnityAdapter-x.x.x', ext:'aar')

 

3. For ProGuard Users Only

If you are using ProGuard with the UnityAds adapter, you must add the following code to your ProGuard configuration (Android Studio: proguard-rules.pro or Eclipse: proguard-project.txt):

-keepattributes SourceFile,LineNumberTable
 -keepattributes JavascriptInterface
 -keep class android.webkit.JavascriptInterface {
     *;
 }
 -keep class com.unity3d.** {
     *;
 }

 

iOS

AdTiming supports both Cocoapods and Manualdownload mechanisms.

Cocoapods

To Integrate the Unity SDK with Cocoapods, enter the following line in your podfile and you are good to go!

pod 'UnityAds'
Copy

Manual Download

1. Download the Unity framework

  • you can find the lastest Unity SDK here.

2. Add the Unity frameworks to your Project

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

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.