Adgebra Ad-serving API

Adgebra ad-serving API integration guidelines

This API integration guidelines, will be able to request demand from adgebra in real time by sending required parameters in API call. In response, adgebra will send ad details which can be used to serve ads in Web, Push Notifications and In-App environment.

Ad elements :

1. Request Format:

Request Format:

https://adgebra.co.in/AdServing/PushNativeAds?pid=[Partner_Id]&mkeys=[KEYWORDS]&dcid=9&nads=[Number_of_Ads]&deviceId=[Device_ID]&uid=[Unique_ID]&gaid=[Goodle_Advertiser_ID]&ip=[IP_address]&url=[whitelisted_Domain_mapping_url]&pnToken=[Token_Id]&inApp=[In_App]&slotId=[Slot_ID]&templateId=[Template_ID]&articleTitle=[Article_Title]&articleDescp=[Article_Description]&refUrl=[Refer_URL]&chToken=[Token_Id]&osType=[OS_Type]&osVersion=[OS_Version]&deviceBrand=[Device_Brand]&deviceModel=[Device_Model]

Request Example:

https://adgebra.co.in/AdServing/PushNativeAds?pid=123&mkeys=cricket%2Cipl%2Cvirat&dcid=9&nads=3&deviceId=1&uid=9c98c8c8863ce7ef&ip=156.26.55.11&url=xyz.com&pnToken=KGnveR3b2h5H3VdH&gaid=Google_123&slotId=0&templateId=128&osType=android&articleTitle=We%20Get%20Excited%20Not%20Nervous%20Looking%20at%20Lively%20Pitches%3A%20Kohli&articleDescp=WATCH%20%7C%20We%20Get%20Excited%20Not%20Nervous%20Looking%20at%20Lively%20Pitches%3A%20Kohli%20on%20Perth%20Track&refUrl=https%3A%2F%2Fwww.news18.com%2Fcricketnext%2Fvideos%2Fwatch-we-get-excited-looking-at-lively-pitches-rather-than-nervous-virat-kohli-on-perth-track-1972185.html&chToken=KGnveR3b2h5H3VdH

Request Parameter

2. Response Format:

Response Format:

[

{

"imageUrl": "[Image_Path]",

"lifeOfAd": "[Validity_of_Ad]",

"languageId": "[Site_Language_ID]",

"ctaMessage": "[CTA_Button_NAME]",

"notificationMessage": "[Description_of_Ad]",

"trackerUrl": "[Landing_Page_URL]",

"notificationTitle": "[Short_Text_or_Brand_Name]",

"icon": "[Short_Text_or_Brand_Name]",

"notificationImage": "[Ad_Image]",

"advId": "[Ad_ID]",

"campId": "[Campaign_ID]",

"pricingModel": "[Pricing_Model]",

"currency": "[Current_Format]",

"price": "[Bid_Price]",

"brandingLine": "[Brandline]",

"brandingImageUrl": "[Brand_Image_URL]",

"clientImpressionTracker": "[Third_Party_Impression_Tracker_URL]",

"impressionTrackerUrl": "[Adgebra Impression_Tracker_URL to be fired at client side when ad served]",

"landingPageUrl": "[Actual_Landing_Page_URL]",

"uId": "[UserID]",

"gaid": "[Google_Advertiser_ID]",

"size_43_400x300": "[imageurl for the size 400x300]",

"size_43_200x150": "[imageurl for the size 200x150]",

"size_43_100x75": "[imageurl for the size 100x75]",

"size_169_400x225": "[imageurl for the size 400x225]",

"size_169_200x113": "[imageurl for the size 200x113]",

"size_169_100x56": "[imageurl for the size 100x56]",

"size_21_800x400": "[imageurl for the size 800x400]",

"size_21_400x200": "[imageurl for the size 400x200]",

"size_21_200x100": "[imageurl for the size 200x100]",

"size_21_100x50": "[imageurl for the size 100x50]",

"size_65_600x500": "[imageurl for the size 600x500]",

"size_65_300x250": "[imageurl for the size 300x250 ]",

"size_65_100x83": "[imageurl for the size 100x83]",

"custom_360x240": "[imageurl for the size 360x240]",

"img990x505": "[imageurl for the size 990x505]",

"impTPTracker": ["Third Party Impression Tracker 1 to be fired at client side", "Third Party Impression Tracker 2 to be fired at client side"],

}

]

Response Example:

*If nads =1

[

{

"imageUrl": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_400x300.jpg",

"notificationMessage": "Own+the+BMW+2GC+at+a+monthly+payment+of+%E2%82%B939%2C300",

"trackerUrl": "https://adgebra.co.in/Tracker/ClickTracker p1=160432&p2=4966&token=91921010700717&p3=&p4=${flag}&slotId=0&templateId=0&pnStatus=1&uid=1421_12345678&pnReferUrl=english.dailyhunt.in&p5=${url}&adg_dummy=1",

"notificationTitle": "BMW+India",

"icon": "https://cdn.adgebra.in/images//991_4142/31781_157791/BMW_Logo.jpg",

"lifeOfAd": "1800",

"notificationImage": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_360X240.jpg",

"advId": "4142",

"campId": "32227",

"pricingModel": "1",

"currency": "inr",

"price": "12.0",

"brandingLine": "null",

"brandingImageUrl": "null",

"clientImpressionTracker": "",

"impressionTrackerUrl": "https://adgebra.co.in/AdServing/SPNTracker?bannerId=160432&siteId=4966&dcId=9&deviceId=1&uid=1421_12345678&countryId=1269750&stateId=1264418&cityId=1259229&ipAdrs=203.109.101.177&bidPrice=12.0&apiFlag=1",

"uId": "12345678",

"gaid": "g127j283i42j2344",

"img990x505": "https://cdn.adgebra.in/images/991_4142_9663/990x505.jpg",

"size_43_200x150": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_200x150.jpg",

"size_43_100x75": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_100x75.jpg",

"size_169_400x225": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_400x225.jpg",

"size_169_200x113": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_200x113.jpg",

"size_169_100x56": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_100x56.jpg",

"size_21_400x200": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_400x200.jpg",

"size_21_200x100": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_200x100.jpg",

"size_21_100x50": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_100x50.jpg",

"size_65_600x500": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_600x500.jpg",

"size_65_300x250": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_300x250.jpg",

"size_65_100x83": "https://cdn.adgebra.in/images/991_4142_9663/BMW_updated_100x83.jpg"

"impTPTracker":["https://adgebra.co.in/clicktracker/click?p1=302473&p2=21400&p3=&p5=&p6=&p7=9&p18=&langId=2&languagePriority=2&slotId","https://adgebra.co.in/clicktracker/click?p1=302473&p2=21400&p3=&p5=&p6=&p7=9&p18=&langId=2&languagePriority=2&slotId"]

}

]

*If nads is greater than 1