Actions

NativeTarget SDK

From SVG Media

Revision as of 13:38, 17 February 2015 by Anshul.c (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Contents

Overview

Ecosystem.png

  • Monetize your apps with NativeTarget SDK.
  • Multi Geo(=more $) coverage to monetize scaling of your inventory.
  • Earn higher eCPM by focusing on meeting advertisers performance goals.
  • Newer ad formats, ensure maximum coverage of your inventory.
  • Flexibility to choose and customize ad formats, providing more control.

Monetize

How monetization works?

Integrate-SDK.png
Step 1 - Register your app with TyrooCentral and manage ad placements from the interface. Install SDK into your app.
Decide-on-ad-platform.png
Step 2 - Decide formats that you want to display. Control ads from interface or allow the platform to choose optimized ads for you.
User-views-the-ad.png
Step 3 - User views ads. Clicks on it, and performs actions, like Install app or buy stuff.
You-earn-revenue.png
Step 4 - Track your earnings from TyrooCentral interface real time or integrate postbacks if you want to track it in your own platform.

Steps to integrate

Register App on TyrooCentral

1 Click on the Mobile tab
2 Click on the “Register New App” tab.
4.png
3 Fill app details and save.
5.png

Integrate NativeTarget SDK Library

  • Unzip the downloaded file.
  • Add and reference the NativeTarget SDK library project as follows,
      1. Right click on your app project in Eclipse and select Properties.
31.png
      1. Select Android and then click Add. Find the nativetarget-sdk_lib project and select OK

to add the NativeTarget SDK library.


32.png


      1. The project now references the NativeTarget SDK library.


33.png



Integrate NativeTarget Resource file

For every app you register on TyrooCentral platform, you can download a resource file.

4.png


  • Select the Manage Apps tab
  • Select the particular app from your list of apps.
  • Click on the View Details link for that app

This action takes the control to the Manage Placements section. Click on -


Download NativeTarget Resource

141.png


Clicking this gives a pop-up to select the type of banners that you would like to cache or not cache (It is advised to cache as many banner types as possible for performance and revenue maximization)


Select the Ads to be Cached

15.png


If you choose to select some of the categories then you need to check them and click on "Select" to download and use the nt.xml generated

161.png


If you choose to deselect certain categories then you need to check them and click on "Skip and download" to download and use the nt.xml generated


171.png


Either of the two actions will result in your nt.xml file



Place this file in -

"Your App Name" >> res >> values >> nt.xml

Eclipsentxml.png


Please change nt_debug to false when you are publlishing your application on the store. Leaving it true will make you application to show debug log even to the end user after downloads.

Replace <bool name="nt_debug">true</bool> with <bool name="nt_debug">false</bool> in nt.xml



Initate Caching

The NativeTarget SDK enables fast serving of ads through a caching mechanism that needs to be activated by you. In order to enable caching, please call the following function as early as possible in your app code.

       new NTView();


Declare Activity

The NativeTarget SDK requires that com.nt.sdk.publisher.adview.NTFullScreenActivity be declared in your app's AndroidManifest.xml:


<activity
      android:name="com.nt.sdk.publisher.adview.NTFullScreenActivity"
      android:label="@string/app_name" >
</activity>
 
<service 
      android:name="com.nt.sdk.publisher.backend.AdService">
</service>
 
<receiver android:name="com.nt.sdk.publisher.backend.EventReceiver" android:exported="true" >


Setup permissions

Making ad requests requires these permissions to be declared in the manifest:

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


Next Steps

Now you are ready to integrate different ad formats into your app. Please follow steps for each type of ad specified in next section.


Formats

Ad Format Supported View
Banner ViewStub
Interstitial ViewStub, Activity, Dialog
Dialog Dialog
Expandable ViewStub, Activity
Adwall ViewStub, Activity, Dialog

Banner ad displays a small image creative to the user which can be clicked and leads the user to a website or app store page.

Add a ViewStub

Create a ViewStub in layout file

<ViewStub
 
        android:id="@+id/viewStub"
 
       android:layout_width="match_parent"
 
       android:layout_height="fill_parent"/>


Create a new layout object for respective ad types


viewStub = (ViewStub) findViewById(R.id.viewStub);


Display Ad

Create a new NTView object for respective ad types

new NTView(activity, AdLanguage, CreativeType.BANNER, AdScaleType.VIEW_STUB, viewStub,<PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. This is optional and can be removed from call, if you want platform to optimize ad serving for you.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp

new NTView(activity, AdLanguage, CreativeType.BANNER, AdScaleType.VIEW_STUB, viewStub);



Interstitial

Interstitial ad is typically displayed in between two screens and is a full screen ad.


Interstitial in a ViewStub

new NTView(activity, AdLanguage, CreativeType.INTERSTITIAL, AdScaleType.VIEW_STUB, viewStub,  <PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. This is optional and can be removed from call, if you want platform to optimize ad serving for you.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp

new NTView(activity, AdLanguage, CreativeType.INTERSTITIAL, AdScaleType.VIEW_STUB, viewStub);


Interstitial in Activity

new NTView(activity, AdLanguage, CreativeType.INTERSTITIAL, AdScaleType.ACTIVITY, <PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. This is optional and can be removed from call, if you want platform to optimize ad serving for you.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp

new NTView(activity, AdLanguage, CreativeType.INTERSTITIAL, AdScaleType.ACTIVITY);


Interstitial in a Dialog

new NTView(activity, AdLanguage, CreativeType.AD_WALL, AdScaleType.DIALOG,<PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. This is optional and can be removed from call, if you want platform to optimize ad serving for you.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp

new NTView(activity, AdLanguage, CreativeType.AD_WALL, AdScaleType.DIALOG);



Expandable

These ads are presented as icons or banners with a message and expand into an enlarged message on user interaction


Expandable in a ViewStub

new NTView(activity, AdLanguage, CreativeType.EXPANDABLE, AdScaleType.DIALOG, viewStub, <PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. This is optional and can be removed from call, if you want platform to optimize ad serving for you.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp

new NTView(activity, AdLanguage, CreativeType.EXPANDABLE, AdScaleType.DIALOG, viewStub);


Expandable in Activity

new NTView(activity, AdLanguage, CreativeType.EXPANDABLE, AdScaleType.ACTIVITY, viewStub, <PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. This is optional and can be removed from call, if you want platform to optimize ad serving for you.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp

new NTView(activity, AdLanguage, CreativeType.EXPANDABLE, AdScaleType.ACTIVITY, viewStub);




Dialog

These ads show a bubble or a message on user interaction or by default. Dialog ad may be single button or two button, depending on option chosen during ad creation.

Display Dialog

new NTView(activity, AdLanguage, CreativeType.DIALOG, AdScaleType.VIEW_STUB, <PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. This is optional and can be removed from call, if you want platform to optimize ad serving for you.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp

new NTView(activity, AdLanguage, CreativeType.DIALOG, AdScaleType.DIALOG);



Adwall

Adwall is a collection of ads presented as a list. You can either pick a pre-defined Adwall from options available, or you can create your own Adwall from the TyrooCentral Interface and present it to your users as specified below.

Adwall in a ViewStub

Adwall4.png
Adwall1.png
new NTView(activity, AdLanguage, CreativeType.AD_WALL, AdScaleType.DIALOG, <PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. If Smart Adwall is being used PlacementId is not required and can be left blank.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp


Adwall in Activity

Adwall6.png
Adwall2.png


new NTView(activity, AdLanguage, CreativeType.AD_WALL, AdScaleType.ACTIVITY, <PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. If Smart Adwall is being used PlacementId is not required and can be left blank.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp

Adwall in a Dialog

Adwall5.png
Adwall3.png


new NTView(activity, AdLanguage, CreativeType.AD_WALL, AdScaleType.DIALOG, <PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. If Smart Adwall is being used PlacementId is not required and can be left blank.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp


Product Listing Ads (PLA) Adwall

Mobile devices have overtaken web interfaces in the volume of e-commerce transactions in the past few years. To stay abreast with the trend we have introduced Product Listing Ads (PLA) Adwall. Publishers can now select the PLA Adwall as the creative type and relevant e-commerce product ads will be shown that will direct the consumers to the buying page for those products.

PLA Adwall is similar to the Adwall introduced in the last section. The only difference is that the ads are product commerce ads. You can either pick a pre-defined PLA Adwall from options available, or you can create your own PLA Adwall from the TyrooCentral Interface and present it to your users as specified below.


PLA Adwall in a ViewStub

1pla.png
2pla.png
new NTView(activity, AdLanguage, CreativeType.AD_WALL, AdScaleType.DIALOG, <PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. If Smart Adwall is being used PlacementId is not required and can be left blank.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp


PLA Adwall in Activity

new NTView(activity, AdLanguage, CreativeType.AD_WALL, AdScaleType.ACTIVITY, <PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. If Smart Adwall is being used PlacementId is not required and can be left blank.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp

PLA Adwall in a Dialog

new NTView(activity, AdLanguage, CreativeType.AD_WALL, AdScaleType.DIALOG, <PlacementId>);
PlacementId This is the ID of placement created on TyrooCentral Platform. If Smart Adwall is being used PlacementId is not required and can be left blank.
AdLanguage This is the language of the ads that you would like to be served on your app. This is optional and can be removed from call. In absence of this argument the ads served can be of any language. The AdLanguage parameter is entered as a key for the language. For example EN for English.

The complete list is available at http://www.mcanerin.com/EN/articles/meta-language.asp


Rules, Apps and Placements

The following section details the creation of rules and their application on the apps and placements. This facility gives you complete control over the kind of ads that you would like to see on your apps and placements. The section has been divided into following sub-sections

  • Manage Ad Rules
  • Manage Apps
  • Manage Placements


1) Manage Ad Rules

Rule information:

1) Rule Name is clickable and enables rule edition

2) Status tab shows the current status of the rule

3) View Filters in the Filters column is clickable and provides details on the applied filters

4) Applied To column shows the list of apps on which the rule is applied

       a.	Shows All Apps if the rule is applied to all apps of the publisher
       b.	Shows App List if the rule is applied to some apps
       c.	Shows No Apps if the rule isn’t applied to any of the apps

1.png


Add Rules: Create rules to define the type of ads visible in your apps

  • Click on Add Rules tab – This will result in a pop-up
  • Add Rule Name - Unique name for new rules needs to be entered
  • Create Filters: Each rule is made up of the following Filters (all of which get applied in unison)
     a.	Campaign Category – Select the campaign category from the dropdown list
     b.	Ad Language – Select the language of the advertisement that you’d like
     c.	Campaign options – Include/Exclude Campaign option allows you to select campaigns


2.png


View By: Enables the publisher to see the rules by status (activated/deactivated)

Activate/Deactivate Rule: Enables activation and deactivation of a particular rule

Apply/Remove from All Apps: This option allows rule(s) to be applied to or removed from all apps


3.png


2) Manage Apps

Register New App: Enables registering a new App

4.png


5.png


Apply Rules:

This tab enables app level application and removal of rules (created in Manage Ad Rules tab)

  • Click on Apply Rules tab – A pop-up with App and Rule list is shown
  • Search/select the Apps and the corresponding Rules and click on Apply


6.png


App Information

1) Manage Rules: Enables removal of particular rules from Apps

       a.	Click on the Manage Rules link for a particular App and remove the Rule that you want

2) View Details : Clicking on this link takes you to Manage Placement tab for that particular tab

       a.	The details are described in the Manage Placements section


3) Manage Placements

Placements level rule application on the Apps

Application dropdown: Select the App on which the placement needs to be applied


7.png


Add Placement: Create a new placement

1) Ad Creative Type: Select the ad creative type from this list

       a.	In case of Adwall select an Adwall and then select the rules
       b.	In case of other ad creative types
               i.	Rules : Select rules from the rule list
               ii.	Static Banner: Select from the campaigns that need to be visible


8.png


Placement Table

1) View Rules: Click on View Rules in the Rule(s) column to see the rules applied 2) Edit: Edit the parameters of the placement 3) Delete: Delete a particular placement


9.png


Download the NativeTarget library from here

Download NativeTarget SDK Library