Notify New Application

From wiki.taptica.com
Revision as of 09:14, 16 August 2012 by Admin (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

This method is used to send request to Taptica's AdCore servers for creating a new mobile ads profile for a new application. The method will pass to Taptica's AdCore servers a unique ID identifying the application and a set of metadata describing the application.

End Point

Service end point:

[ Version 4.0 ]

Service: http://api.taptica.com/sts/v4/NotifyApplicationAPI

WSDL: http://api.taptica.com/sts/v4/NotifyApplicationAPI?wsdl

JSON: http://api.taptica.com/sts/v4/NotifyApplicationAPI/json/NotifyNewApplication

Method Signature

AdCoreProfileResult NotifyNewApplication(
   Authentication auth,		// Authentication Details
   ApplicationProfile profile	        // Profile
)


Return Value
Type: AdCoreProfileResult
Return value has the following properties:

Property Type Description
Result OutcomeEnum The Result is an enumeration, possible value: Fail, Success
ErrorCode Int Specific error code. AdCore can define these.
ResultDescription string The description of the method call result in case of error


Parameters Description

Parameter Description
auth Type: Authentication
Hold the authentication tokens for AdCore.
This object has these properties:
UserName 
A string having the username for used to identify on AdCore.
Password
Password for above username.


profile Type: ApplicationProfile
An object describing the application, it has these properties:
ApplicationID 
String (36): in UUID format with ID of application as provisioned by AdCore.
This ID will also be used on update calls and by 3rd party mobile application 
when it contact AdCore server for mobile ads content.
ApplicationURL 
String : represent the application url.
Name
String (64) : Name of application
Description 
String (120): a description of the application.
DeveloperName 
String (64):  Developer Name – developer of the application.
AdsProviders 
List of string and weight (0..10) of Ads provider, 
Example:
 InMobi,5,
 MillennialMedia,4,
 Vexigo,3,
 Dealnet,2,
 TargetedMobi,10,
 JumpTap = 6,
 Mojiva = 6,
 AdFonic = 0
ContentTypes  
Array of Strings: each string describing one of the 
content types applicable to the application. Each string in the array has a max 
length of 64 chars.
example: [‘Gambling Related’, ‘Advertising’] 
can be an empty array.
Category  
Array of Strings: each string describing one of the categories applicable 
to the application. Each string max length is 64 chars.
example: [‘Communications’, ‘Games’, ‘Lifestyle’]
Category's List:
* Communications
* Entertainments
* Financial Services
* Games
* Health & Fitness
* News & Weather
* Shopping / Retail
* Social
* Sports
* Tools/utilities
* Travel and Local
* Lifestyle
* Multimedia
* Automotive
* Books & Reference
Tags  
Array of Strings: each string describing one of a user defined tag that 
the developer used to describe the application. Each tag has a  
max 64 chars. Can be empty.
Platform  
String: Describing one of the supported platforms.
Possible values: BlackBerry, J2ME, Android, Symbian, iPhone (iOS), WebApp
ContentFilters 
Array of Strings: each string describing one of the exclude ads from categories.
Each string max length is 64 chars.
example: [‘Tools, ‘Books’, ‘Photos’]
TextFilters
Array of Strings: each string describing one of the exclude ads that contains text.
Each string max length is 64 chars.
example: [‘cats, ‘dogs’, ‘bats’]
LanguageFilters
Array of Strings: each string describing one of the exclude ads in these Language Filters.
Each string max length is 64 chars.
example: [‘Thai, ‘German, ‘French]
Resolutions
String of comma separator resolution types 
example: 320x50,120x20
EnableBannerAd 
Enable Banner Ad
EnableTextAd
Enable Text Ad
EnableHtmlAd
Enable Html Ad

JSON

Request:

{
   "auth":{
       "Password":"somepassword!",
       "UserName":"someusername!"
   },
   "profile":{
       "AdsProviders":[
           {
               "Key":"TargetedMobi",
               "Value":10
           },
           {
               "Key":"InMobi",
               "Value":1
           }
       ],
       "ApplicationId":"16101917-1c15-1515-1316-1a1a1a11f4b7",
       "ApplicationURL":null,
       "Category":[
           "Games"
       ],
       "ContentFilters":null,
       "ContentTypes":null,
       "Description":"Some Description",
       "DeveloperName":"Some Developer Name",
       "EnableBannerAd":false,
       "EnableHtmlAd":false,
       "EnableTextAd":false,
       "LanguageFilters":null,
       "Name":"Application/Site Name",
       "Platform":"Android",
       "Resolutions":null,
       "Tags":null,
       "TextFilters":null
   }
}

Successful Response:

{
   "NotifyNewApplicationResult":{
       "ErrorCode":0,
       "Result":0,
       "ResultDescription":null
   }
}

Error Response:

{
   "NotifyNewApplicationResult":{
       "ErrorCode":61,
       "Result":1,
       "ResultDescription":"the application id 56205967-5c65-4555-a396-0a3a1aa1f4b7 is already exist"
   }
}
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox