Unity

The CrystalExpress AdMob Custom Event allows AdMob publishers to add CrystalExpress as a Custom Ad Network within the AdMob platform.

CrystalExpress currently support rewarded video format for AdMob mediation. Please use Rewarded Video ad unit to mediate Rewarded Video ads.

NOTICE: The aspect ratio for CrystalExpress ad is 16:9, 4:3 or 1:1.

Before adding CrystalExpress as Custom network, you have to integrate AdMob SDK by following the instructions on the AdMob website.

NECESSARY STEPS:

• Get CrystalExpress SDK and Crystal ID.

• Import CrystalExpress SDK and Rewarded Video Adapter.

• Configure AdMob to mediate CrystalExpress.

Get CrystalExpress SDK and Crystal ID

Please contact your Intowow account manager. We will provide the appropriate version of SDK and Crystal ID to fit your needs.

Import Crystal Express SDK and Rewarded Video Adapter

For Android

1. Add Crystal express SDK (ce-[premium|lite]-global-[version].aar) and the Rewarded Video Adapter (CEMediationRewardedVideo.jar) to the existing libraries into the [UNITY PROJECT ROOT]/Assets/Plugins/Android folder.

   • You can see verbose log and test ad by replacing the Rewarded Video Adapter to CEMediationRewardedVideo_testMode.jar. Don't forget to change it back before publishing your app.

2. Declare Crystal ID received from your Intowow account manager in your Android Manifest.

   <!-- for Intowow SDK integration (Required if using Intowow SDK) -->
   <meta-data android:name="CRYSTAL_ID" android:value="crystalidforandroidtestdontuseit" />

3. Declare Permission in your Android Manifest

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

For iOS

1. Unzip the SDK file and replace the crystal_id in CrystalExpress.plist

2. Create a folder "CrystalExpressSDK" under [UNITY PROJECT ROOT]/Assets/Plugins/iOS and copy the following files in to this folder.

   ce-premium-global-xxx CERewardedVideoAD.h CrystalExpress.plist I2WAPI.h

   IWOWMoatMobileAppKit.framework

3. For your unity project in folder CustomEvents/AdMob/Unity

   import CEMediationRewardedVideo.unitypackage

NOTICE: When integrating CrystalExpressSDK, you can enable testMode for developing. Don't forget to disable it before publishing your app.

• To enable the testMode edit the function initWithRewardBasedVideoAdNetworkConnector: under file

  CEMediationRewardedVideoAdapter/CEMediationAdapterRewardedVideo.m

  [I2WAPI initWithVerboseLog:YES isTestMode:YES];

• To disable the testMode edit the function initWithRewardBasedVideoAdNetworkConnector: under file CEMediationRewardedVideoAdapter/CEMediationAdapterRewardedVideo.m

  [I2WAPI initWithVerboseLog:YES isTestMode:NO];

Configure AdMob to mediate CrystalExpress

Step 1

Log in to your AdMob account and register your application on your account dashboard.

If you have set up a Mediation Group, please click the Mediation Group and skip Step 1. 1. Click Mediation in the side bar and Create Mediation Group.

2.Select targeted ad format(Rewarded Video) and Platform, and click CONTINUE.

3.Set up Name and Ad units to mediation group

NECESSARY: Please prepare at least 1 ad unit. Otherwise, you would be block here and Ad sources could not be set.

Step 2

1. Click ADD CUSTOM EVENT in the ad sources table

   

Step 3

1.Please set up the name(Label) and eCPM for your Custom Event, and click CONTINUE.

2.Add Custom Event Class Name

• For Android

  • Rewarded Video ad: Please enter com.intowow.admob.rewardedvideo.CEMediationAdapterRewardedVideo

• For iOS

• • Rewarded Video ad: Please enter CEMediationAdapterRewardedVideo

3.Add Parameter with Placement ID:

ATTENTION: Please ignore the optional notation for Parameter on Configure ad units panel. To request ad from intowow successfully, Parameter is a must.

Please contact intowow account manager for the Placement ID.

4. Click DONE.

5.Click Save.

Step 4

Request ad as the instructions for Rewarded Video Integration from AdMob.

The Orientation of CrystalExpress AD

We'll let the resolution of AD to fit the screen size of device. For example, we'll use landscape to play 16:9 ad. But in this situation, we'll not change the orientation of App, we only rotate the view.