InMobi Tizen Ad SDK

The InMobi Tizen Ad SDK allows you to monetize your Tizen application with a wide range of advertisement formats. From banner ads to full-screen interstitial ads, you can deliver ads from the InMobi network for a better user experience.

Tizen Web application: Tizen Web applications use the Tizen Web Framework to interact with the Web subsystems. The application is built using Web languages, such as HTML5, CSS, and JavaScript.

Tizen Native application: Tizen Native application uses EFL (Enlightenment Foundation Libraries) for the application UI. The application is developed using C and it can access advanced device-specific features.

Unity game on Tizen: To use Tizen Ads in your Unity game, you need the Unity SDK version 5.4.1 or above for privilege addition support. The game is developed using C#.

InMobi Tizen Ads allows application sellers to monetize Tizen applications and games with the ads provided by InMobi. The following ad sizes are supported:

Small banner: 320 X 50 pixels (InMobi slot #15)

Big banner: 300 X 250 pixels (InMobi slot #10)

Interstitial: 320 X 480 pixels (InMobi slot #14)

You can download the attached zip filewhich has inmobi-tizen-adsdk_1.0.3.zip, api references for native, unity, and web adlibraries,3 sample apps, and Unityadlib.unitypackage at the end of this page.

Getting Started with InMobi Tizen Ads

Step 2 - You will receive a document stating the terms and conditions for app monetization with InMobi along with a list of details required for account creation and site ids approval

Step 3 - Fill in the required details (only to be TYPED, not handwritten) and share a signed copy with InMobi. A scanned copy should be shared on the above mentioned email id and a hard copy should be mailed to the below mentioned address

Check the following sample applications and games and refer to the code snippets in this tutorial.

Unity game sample (UnityAdSample.7z)

Native application sample (NativeAdSample.7z)

Web application sample (WebAdSample.7z)

We recommend you to use the blog on Tizen Ads on Tizen community for any issues. If you still face issues, send them to tizen.ads@samsung.com. The API version of the tizen applications using AdSDK should be mandatorily 2.4 or more, otherwise the tizenstore will reject the applications.

InMobi Tizen Ads for Web Applications

To use InMobi Tizen Ads in Web applications:

For Web applications, include the InMobi JavaScript file to use InMobi Tizen ads:

InMobi Tizen Ads for Native Applications

This section describes the InMobi Tizen Ads APIs for Tizen native (EFL) applications. Familiarize yourself with Tizen native application development and EFL UI development before attempting to integrate the Ads SDK.

To deinitialize Adlib, call the adlib_deinit() function. This is required when exiting the application to free the resources.

ret = adlib_deinit();

Create banner ad:

Create ad:

Ad object can be added on applications main window or on user defined layout as per application requirement. Add the banner ad by specifying the type of ad along with the layout or window in which the banner ad must be displayed:

The adview can be swallowed in to the layout or can be shown as an overlay above the current layout. In the later case, application has to manage the show state of the adview explicitly. On successfull load of bannerad, banner_ad_load_request_succeeded callback will be triggered in which application needs to call the show of bannerad object using native api evas_object_show(). Also while navigating between the views or during loadFailure, application can choose to handle based on its logic, for example it can hide the adview by calling evas_object_hide() or it can show the adview with the old ad

By default, the auto refresh option is enabled for banner ads and the ads are refreshed every 30 seconds provided a new ad is downloaded from the server. The application can control the refresh timer as well as disable the auto refresh option as shown in the following example.

Adlib handles the repositioning of the ad object when the device orientation changes. If the application changes the position of the banner_ad_obj object using Evas functions, such as evas_object_move(), the application is responsible for handling device orientation changes.

By default, the ad object is placed at BANNER_AD_POSITION_BOTTOM_CENTER.

Create an interstitial ad:

Create ad:

Add the interstitial ad by specifying the layout or window on which interstitial ad has to be displayed:

adlib_err result = adview_add_interstitial_ad(ad->layout);

The application needs to load the interstitial ad, and on successful load, it needs to call show. Once the load is successful, the interstitial_ad_load_request_succeeded callback is triggered. After this, the interstitial ad is ready to be shown.

result = adview_interstitial_load();

After receiving the interstitial_ad_load_request_succeeded callback, the application can show the ad at any time as per application logic.

result = adview_interstitial_show(); /* Show the interstitial ad */

Contrary to the banner ad, the call to load does not take care of showing the interstitial ad.

Adlib has a callback mechanism to update the application about the interstitial ad state. The following example shows the callbacks the application has to register.

InMobi Tizen Ads for Unity Games

To get started, the Unity package ('Unityadlib.unitypackage' in the attached zip file) is needed. For more information on setting up the Unity SDK for Tizen, see the Unity documentation. The minimum Unity SDK version for integrating with Tizen is 5.4.1.

To create InMobi Tizen ads for Unity games:

The game needs the following capabilities for the Unity game in the Tizen build settings:

Network Get

Internet

AppManagerLaunch

Enums that are defined in header to set position, set ad size and error codes:

public enum ErrorType
public enum BannerAdSize
public enum BannerAdPosition

Initialize Adlib.

To use the functions of Adlib, get the AdProvider instance by writing the following code in the script file:

Using Tizen.AdLib;
AdProvider adobject = AdProvider.Instance;

Initialize Adlib by passing valid banner and interstitial site IDs obtained from the InMobi registration.

By default, the auto refresh option is enabled for banner ads and the ads are refreshed every 30 seconds provided a new ad is downloaded from the server. The game can control the refresh timer as well as disable the auto refresh option as shown in the following example.

The game can positon the ad to any (x, y) position using the BannerAdSetMove() function. The game is responsible for handling the device orientation changes in this situation.

result = adobject.BannerAdSetMove(adhandle, 100, 200);

By default, the ad object is placed at BANNER_AD_POS_BOTTOM_CENTER.

Create an interstitial ad:

Create ad:

Add an interstitial ad by calling the following function:

ErrorType result = adobject.AddInterstitialAd();

The game needs to load the interstitial ad and on successful load, it needs to call show. Once the load is successful, the OnAdLoadSucceeded callback is triggered by the Adlib. After this the interstitial ad is ready to be shown.

result = adobject.InterstitialAdLoad();

After receiving the OnAdLoadSucceeded callback, the game can show the ad at any time.

result = adobject.InterstitialAdShow(); // Show the interstitial ad

Contrary to the banner ad, the call to load does not take care of showing the interstitial ad.

Adlib has a callback mechanism to update the game about the interstitial ad state. The game has to register listener callbacks with Adlib using the following functions:

Developer Testcases

Please use the testcases for sanity testing after integrating the adlib to your app.

Category: AdFunctionality

Clicking on the Ad should open details in Browser window separately.

If the orientation of the application changes, the adview should be resized according to current orientation.

While loading interstitial ads or interacting with them no sluggish behavior should be observed.

Category: User Experience

Sample ads resolution should be proper. They should not be stretched or skewed.

Application layout should be designed in such a way that user experience should not be disturbed when ads are not loaded (no white patches).

If network is not available and when ads are not displayed, app's user experience should not be impacted.

Banner ad position should be handled by app in such a way that it should not cause any hinderance to the buttons or menus.

Application should manage to show the banner ad once it receives the adloadsuccess callback. Navigation between views should maintain the showstate as per app design.

Ensure that interstitial ad load is successful and then only call show of the adview and pause application events.

While navigating between different views of the application, the ads should be hidden/shown properly as per app design.

Terminating the application in any scenario (with or without mobile data) should not cause any force closure of the app.

During the app pause and resume the ads rendering should be proper.

Incase of a list shown in the app, ensure that the list items are not hidden by the ads.

SDK update

This page will always host the latest version of the Inmobi Tizen Ad SDK. Advertizement service for older versions of the Ad SDK will be supported for only 90 days. When developer receives an email notice to udpate the Ad SDK, it is adviced to update quickly.