Additional Request Parameters
Parameter | Format | Description |
---|---|---|
idfa | String. Required when request generated from a Apple device | Apple ID for Advertising. |
gid | String. Required when request generated from a Android device | Google Android ID for Advertising. |
srvi | Boolean | 1 - server to server integration. If set to 1, need to pass set ip and ua. |
uid | String | User identifier. Recommended when idfa and gid cannot be passed |
adcount | String | Number of Apps to return. Possible values: 1 (default) to 20 |
ua | String | User Agent String. Required when srvi is set to 1. |
ip | String | IP address of the client device |
locale | String | The locale used. i.e. DE |
lat | String | The current latitude of the requesting device. Don´t send param if value is unknown. |
long | String | The current longitude of the requesting device. Don't send param if value is unknown. |
gender | String | User's gender. Possible values: "m", "f" |
age | String | User's age |
coppa | String | Flag indicating if this request is subject to the COPPA regulations established by the FTC, where 0 = no, 1 = yes. |
bundleid | String | The bundle identifier of the requesting app. i.e. com.my.app, 422689480 |
keywords | String | A comma separated list of keywords |
secure | String | Default http; can use https secure parameter for overriding |
idfamd5 | String | Apple ID for Advertising (md5) |
idfasha1 | String | Apple ID for Advertising (sha1) |
gidmd5 | String | Android Advertiser Id(md5) |
gidsha1 | String | Android Advertiser Id(sha1) |
Ad layouts is a standardized way of requesting specific assets depending upon the size or type of your placement. Possible values s, m, l. (s - small, m - medium, l - large)
Each ad layout consists of a set of asset groups. Each asset group consists of a collection of assets. Possible assets served: icon, banner, title, description, rating, CTA
Response
Response structure
Field/Object | Description | Format |
---|---|---|
link | Click through URL | string |
assets object | Asset object contains information of all assets requested via the 'al' parameter. | object |
meta object | Meta object contains information of all meta properties requested via the 'mf' parameter | object |
beacons object | Beacons Object contains URL beacon used to confirm impressions | url |
Native Ads
Pubnative serves native ads for each ad layout - s
, m
, l
. Native ads are returned in the form of different assets.
Possible Asset Types returned by Pubnative -
- Publisher should support the following asset type:
icon, title, description, rating, banner. - The asset type will be mentioned explicitly. Sample asset responses have been mentioned below.
##Sample Icon Asset
{
"type": "icon",
"data": {
"w": 80,
"h": 80,
"url": "http://cdn.pubnative.net/games/icons/001/010/700/dimension_80x80.jpg?20160706190952"
}
}
##Sample Banner Asset
{
"type": "banner",
"data": {
"w": 1200,
"h": 627,
"url": "http://cdn.pubnative.net/games/promo_images_landscape/001/010/700/dimension_1200x627.jpg?20160622183653"
}
}
##Sample Title Asset
{
"type": "title",
"data": {
"text": "Sonax Scheiben- und FensterTuch 1 Stück"
}
}
##Sample Description Asset
{
"type": "description",
"data": {
"text": "Suchst Du eine neue, coole App? Lade mich jetzt runter."
}
}
##Sample CTA Asset
{
"type": "cta",
"data": {
"text": "Learn More"
}
}
Banner Ads
Pubnative serves banner ads for each ad layout - s
, m
, l
.
Access banner Ads
By default, Pubnative only serves native ads. If you would like us to start returning banner ads please contact our Account Manager. Please refer to the below section for more details -
Based on the ad layout requested Pubnative will return banner ads in the following dimensions.
Ad Layout | Asset Group | Dimension |
---|---|---|
s | 10 | 320x50 |
m | 8 | 300x250 |
l | 21 | 320x480 |
##Sample HtmlBanner response - when al=s
{
"status": "ok",
"ads": [
{
"link": "http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AV",
"assetgroupid": 10, //Possible values 10,8,21 depending on the ad layout requested
"assets": [
{
"type": "htmlbanner",
"data": {
"w": 320,
"h": 50,
"html": "<span class=\"PubAPIAd\"><STYLE>body{margin: auto;}</STYLE><DIV><A target=\"_blank\" href=\"http://track.pubmatic.com/AdServer/AdDisplayTrackerServlet?clickData=JnB1YklkPTE1NTk3NSZzaXRlSWQ9MTU5NjA2JmFkSWQ9ODIwMjE1JmthZHNpemVpZD05JnRsZElkPTAmY2FtcGFpZ25JZD0xNTIwOCZjcmVhdGl2ZUlkPTAmYWRTZXJ2ZXJJZD0yNDMmaW1waWQ9MkY4QjNBMTktQ0EyNy00MzEzLUE1RTEtMEIyNkQ4QzRBNzNEJm1vYmZsYWc9MSZpc21vYmlsZWFwcD0xJmNhcnJpZXJpZD0xNTAmcGFzc2JhY2s9MA==_url=http%3A%2F%2Fclickus.basebanner.com%2Fst%3Fcipid%3D2621000%26excid%3D23%26ttype%3D1%26dast%3Dv1_2621000_-1_3o1_884DB89344267722021886610003__4230937_14ch7_778_884DB8934426772201993852600_n_0_-7041993656288223481_820215____2g_4oa7_0_%26cipp%3D0.0219582271%26excid%3D23%26cisid%3D884DB89344267722021886610003%26pix%3D31581939%26tgt%3Dhttps%253A%252F%252Fwww.glassesusa.com%252Fcoupons-and-promotions%253Fsr%253D7742381\"><IMG border=0 width=300 height=250 id=\"_ci4230937_b4074867\" alt=\"\" src=\"http://d94r1llj8z8wm.clossudfront.net/uploads/1456266446847_300x250-mirror.gif\"/></A>\r\n</DIV>\r\n<script type=\"text/javascript\" src=\"http://imprusmp.basssssebanner.com/st?cipid=2621000&ttype=0&cirid=884DB8934426772201993852600&cicmp=1192487&cijs=1&dast=bXRtZGxpZD0zMjAzMTAwMjU4NyZjbXQ9LTEmZnJtaT0wJm1tdD0tMSZwcnJwPTEwMDAwMC4wJnBmcnA9LTEuMCZleGNpZD0U5OTgwMzQwNDYmc2VydmluZ0RvbWFpbj1iYXNlYmFubmVyLmNvbSZsYXQ9NDkuNDU2MyZsb25nPTguMDgxNCZjaXRicD0wLjAyNTE1Mzg0NjE1Mzg0NjE1&cipp=0.0219582271&excid=23\"></script></span>"
}
}
],
"meta": [
{
"type": "contentinfo",
"data": {
"link": "http://pubnative.net/content-info",
"icon": "http://cdn.pubnative.net/static/adserver/contentinfo.png",
"text": "Learn about this ad"
}
}
],
"beacons": [
{
"type": "impression",
"data": {
"url": "http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455"
}
}
]
}
]
}
##Sample HtmlBanner - when al=m
{
"status": "ok",
"ads": [
{
"link": "http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AV",
"assetgroupid": 10, //Possible values 10,8,21 depending on the ad layout requested
"assets": [
{
"type": "htmlbanner",
"data": {
"w": 300,
"h": 250,
"html": "<span class=\"PubAPIAd\"><STYLE>body{margin: auto;}</STYLE><DIV><A target=\"_blank\" href=\"http://track.pubmatic.com/AdServer/AdDisplayTrackerServlet?clickData=JnB1YklkPTE1NTk3NSZzaXRlSWQ9MTU5NjA2JmFkSWQ9ODIwMjE1JmthZHNpemVpZD05JnRsZElkPTAmY2FtcGFpZ25JZD0xNTIwOCZjcmVhdGl2ZUlkPTAmYWRTZXJ2ZXJJZD0yNDMmaW1waWQ9MkY4QjNBMTktQ0EyNy00MzEzLUE1RTEtMEIyNkQ4QzRBNzNEJm1vYmZsYWc9MSZpc21vYmlsZWFwcD0xJmNhcnJpZXJpZD0xNTAmcGFzc2JhY2s9MA==_url=http%3A%2F%2Fclickus.basebanner.com%2Fst%3Fcipid%3D2621000%26excid%3D23%26ttype%3D1%26dast%3Dv1_2621000_-1_3o1_884DB89344267722021886610003__4230937_14ch7_778_884DB8934426772201993852600_n_0_-7041993656288223481_820215____2g_4oa7_0_%26cipp%3D0.0219582271%26excid%3D23%26cisid%3D884DB89344267722021886610003%26pix%3D31581939%26tgt%3Dhttps%253A%252F%252Fwww.glassesusa.com%252Fcoupons-and-promotions%253Fsr%253D7742381\"><IMG border=0 width=300 height=250 id=\"_ci4230937_b4074867\" alt=\"\" src=\"http://d94r1llj8z8wm.clossudfront.net/uploads/1456266446847_300x250-mirror.gif\"/></A>\r\n</DIV>\r\n<script type=\"text/javascript\" src=\"http://imprusmp.basssssebanner.com/st?cipid=2621000&ttype=0&cirid=884DB8934426772201993852600&cicmp=1192487&cijs=1&dast=bXRtZGxpZD0zMjAzMTAwMjU4NyZjbXQ9LTEmZnJtaT0wJm1tdD0tMSZwcnJwPTEwMDAwMC4wJnBmcnA9LTEuMCZleGNpZD0U5OTgwMzQwNDYmc2VydmluZ0RvbWFpbj1iYXNlYmFubmVyLmNvbSZsYXQ9NDkuNDU2MyZsb25nPTguMDgxNCZjaXRicD0wLjAyNTE1Mzg0NjE1Mzg0NjE1&cipp=0.0219582271&excid=23\"></script></span>"
}
}
],
"meta": [
{
"type": "contentinfo",
"data": {
"link": "http://pubnative.net/content-info",
"icon": "http://cdn.pubnative.net/static/adserver/contentinfo.png",
"text": "Learn about this ad"
}
}
],
"beacons": [
{
"type": "impression",
"data": {
"url": "http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455"
}
}
]
}
]
}
##Sample HtmlBanner - when al=l
{
"status": "ok",
"ads": [
{
"link": "http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AV",
"assetgroupid": 21, //Possible values 10,8,21 depending on the ad layout requested
"assets": [
{
"type": "htmlbanner",
"data": {
"w": 320,
"h": 480,
"html": "<span class=\"PubAPIAd\"><STYLE>body{margin: auto;}</STYLE><DIV><A target=\"_blank\" href=\"http://track.pubmatic.com/AdServer/AdDisplayTrackerServlet?clickData=JnB1YklkPTE1NTk3NSZzaXRlSWQ9MTU5NjA2JmFkSWQ9ODIwMjE1JmthZHNpemVpZD05JnRsZElkPTAmY2FtcGFpZ25JZD0xNTIwOCZjcmVhdGl2ZUlkPTAmYWRTZXJ2ZXJJZD0yNDMmaW1waWQ9MkY4QjNBMTktQ0EyNy00MzEzLUE1RTEtMEIyNkQ4QzRBNzNEJm1vYmZsYWc9MSZpc21vYmlsZWFwcD0xJmNhcnJpZXJpZD0xNTAmcGFzc2JhY2s9MA==_url=http%3A%2F%2Fclickus.basebanner.com%2Fst%3Fcipid%3D2621000%26excid%3D23%26ttype%3D1%26dast%3Dv1_2621000_-1_3o1_884DB89344267722021886610003__4230937_14ch7_778_884DB8934426772201993852600_n_0_-7041993656288223481_820215____2g_4oa7_0_%26cipp%3D0.0219582271%26excid%3D23%26cisid%3D884DB89344267722021886610003%26pix%3D31581939%26tgt%3Dhttps%253A%252F%252Fwww.glassesusa.com%252Fcoupons-and-promotions%253Fsr%253D7742381\"><IMG border=0 width=300 height=250 id=\"_ci4230937_b4074867\" alt=\"\" src=\"http://d94r1llj8z8wm.clossudfront.net/uploads/1456266446847_300x250-mirror.gif\"/></A>\r\n</DIV>\r\n<script type=\"text/javascript\" src=\"http://imprusmp.basssssebanner.com/st?cipid=2621000&ttype=0&cirid=884DB8934426772201993852600&cicmp=1192487&cijs=1&dast=bXRtZGxpZD0zMjAzMTAwMjU4NyZjbXQ9LTEmZnJtaT0wJm1tdD0tMSZwcnJwPTEwMDAwMC4wJnBmcnA9LTEuMCZleGNpZD0U5OTgwMzQwNDYmc2VydmluZ0RvbWFpbj1iYXNlYmFubmVyLmNvbSZsYXQ9NDkuNDU2MyZsb25nPTguMDgxNCZjaXRicD0wLjAyNTE1Mzg0NjE1Mzg0NjE1&cipp=0.0219582271&excid=23\"></script></span>"
}
}
],
"meta": [
{
"type": "contentinfo",
"data": {
"link": "http://pubnative.net/content-info",
"icon": "http://cdn.pubnative.net/static/adserver/contentinfo.png",
"text": "Learn about this ad"
}
}
],
"beacons": [
{
"type": "impression",
"data": {
"url": "http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455"
}
}
]
}
]
}
Pubnative returns video creatives in VAST2.0 format. We serve VAST2.0 and VAST2.0 Wrapper creatives. We expect publishers to render these creatives in their own video player.
Based on the ad layout requested Pubnative will return video ads in the following dimensions -
Ad Layout | Asset Group | Dimension |
---|---|---|
m | 4 | 300x250(Coming soon!!) |
l | 15 | 320x480(Live!) |
{
"status": "ok",
"ads": [
{
"assetgroupid": 15,
"assets": [
{
"type": "vast2",
"data": {
"vast2": "<VAST version=\"2.0\"><Ad id=\"5d83bcac_194c323dac7c4150b332e94a1033ef2e\"><Wrapper><VASTAdTagURI>https://bid.g.doubleclick.net/dbm/vast?dbm_c=AKAmf-C87T4w3HHSEmovN-PWf3VXzz4hLCF-pkBlVIQiOd7NyP6gO1yjGHpD6vihgmOuATr1f4zv&dbm_d=AKAmf-AFw-KaBNjQecjYvj6LQ0RjtUF7fWshsm-fQEebYgdf2P8Kp3Te6BXzne3YBGX5Bbv6tJOfRV9n9IQENOXD_2pWfbvHP8mAxlx20zefQ-fyuJHuXZZ4EJi46chDToCzH3G6HZa_YeezsctlRh1BAJmwHpUThOUm-5ky-_44ibeupgiolTZTQtcHo8yaQOCDFWQe6KrH37X_4DGypyLAog9QGZ30f6c1R8Qv6qnlhbx7a0k_YfJk5hyR0yghRoA9SV7xHNmzhm4yY3O6CydZNt-H08UmFE2RuCM2RihpW3veLVWHy4Rev5MfHPMGcOMh7MrfzIASlQyjUFJPNkx0wToAaaEQkvlir_2aFSFBJ8K0RlPlLtYouqKHJ6hND4TEpZd_Nj7XBtwe29KHFcTmgKmUgAukBcdGLfwKDgSG_DsZMVAHXDx3WcmgUFEOEIWf7sFVuuj7zS00DKkKlXhOX5rkPyybkGP9gplJKodU_UYZp9wlCszsAN-QLi0aY_rK4XNlF1YGv_p2HbUeYJBDP2BlmsBisoVpL3dSKeBiICH1WnGsA3ttNk8RaCcBBinPWhIIpgkZ08awhAI6YE7N3dmCs3Atv_XrzEB7QTZc9II-Q-C2bvZVpp0wuQLd3dhAs5H3zoveH8vPstgfX3aKvUbNwblyaTxlTAb0F6bPQEnjFtexqKdEsmI3fkrZWMniQkbVCdojtSu-Zr2G8p-ObXXDVgDila7yXheV6huWaJBVwinjgE2NZsod0Z-NFKcjWVeBrYPsAuCna5XeAPA9TwUS8kTpbhOaxSbwXksYdaacjXIz_FeC2g_e0gWwfOZDNjaOuRRwVNLBJz5ORUDXPMgzUJRhrtpPrt3u1zqXGJfjVWAPMwaymefcT4oSJphuomxDz1-SrciyUpAH5qwHqlv6-Gkab0VGNp4Rj6mydJsqgl0OuTL54JhrHnvcnTiSJ8Vs9O483ZtvFtf-9PwCZ_SxlNAK4faKJateF9t07IYT665ziM78xcF1wc3dYbTQvmCYxggE5-a3HyurPfBhSMLUBi4-k17Ae_YW_bvdnuHW4ftYnugI0CgskYnABZM4fwvMqc3xE8zefy8_3AFrcDT2vacaQFf8qi4JbNvRvy2VvVKIQcM08M_WegyJFC7lpbuDbIvk0YH29l1urEAzJKUDktbC_EYuMEk-UGGfSzn5xIpKxEE8xzmEzgaHsuZ9XhWfCKdOdO_D_3Zbc7sZwuzj7ptfguqsTll_ydUBTQbAvMEp7bGfSbSSbt5mijCu0kHaUb1gylqOjG-zTLoUOnEX0jZh-wS3ns3pyIcIm3zsvJD3pqdpf7bD9UqsZd4uyOtR7lzHONktWBmPZvUaIpdrfmyz7KBS6MXon62hNu4k83SNC-jyPosEUryS2nRtystBRYYQG_GPZ1fj5RSj2hiP1VuxqFcfehEqihCmfTocjAaQP8eDM_JTWMta8afF-xmZ8fiiiZRVX_ab_nckqFzkTBkBLDz1AzBMKAV70udTP-KrbYihfUfvqoWXmnYUhPLUNPVDvVZQU7qq33-oJBEAL_oU9xE1AxOM4fTAbuAVeOfzu5Y5K7K69gZKYXOp7KyjqGO0Bpr4VsN5uw5en1rJFcO2XZr4FQ3c2zjiDPDdrpbCUymEz7MNPzL1WLnhVa_-zqZ55FTOWoSa_jCd8XoNW6DqV9MYRkjo3-blYvjHVSv3NSq-DGz8Crn_T_TDTjPQbZoyN2ku71O0tAExIH15-wn8SF1vArw05_cuQpa5hWjw72WK4cugA3aGrofhJ6UnfmYKvE0QuEjsPF1z_TqJ2MQeUprzCmvwWkHuCkiDL40sV5pbo_-KPEMda9mIax6swFD6D1EuaNJHC53PkRIKezGMNIAFAZaWLoXMyqJg5xPAJaU&cid=CAASBORo0qc</VASTAdTagURI><Error>http://gce-sc.bidswitch.net/vast_error/1ja825m-57ZZ1n2YoUucUH932hFGUPM1HouZxU1237SJTGi5Ec9JaTMFTSXVlmG8GjCNHnnt_FocRf5_Oq3g4KxN8WzjkueE7Qg4yYH4mWwmhQ25QooIExahf0Po1wu5S_6x7mPbY8vP_PnoXsGvk6diZ2O6cf-PF4bQbtheGv9czFpD-yDnQ52apB1Oj0Iw_y_UmEOLraTuZ_nt5Gv7AzOmGocuUv4OPwuRI7ng4iIHojrTzYVqah1IjQkVMdz6OLr7jV0eyUvzqXAPiM6VZg4xDizCpnzYscMnFHch9gpfb6KquosLGEaxBTRP0ZbdBzevVgHW-809O21ZlLbib9GIG2tm_oIfoaZAdFBGodud3bGUiM64UzdCI-iCpFYk3uQgvmNKwWZFqldrGhGoldE_G4TLrskpE7JC4HDdDmHsyQUkF0laTGdsnhLbZwQi-ds2WUy6ZDjeDzJ89dEsPJ91iapKOJe4iKiGwFQVJ3GNC9Ed1qbUCPZAdL2aaS8R_cgEyITJJi6CnBCXnhYhE6xjVTnTlaN-J_MSgBHjEmz_1LVEjS_hy75rpSMNdS_Fl5Odymw1BRNGBgBNbhkEWblzVH2_YT-9oluLDRB4-b7W7I9qKKOERwZKUhYzCkA75utTKcnIvX8tPA/</Error><AdSystem>BidSwitch</AdSystem><Impression>http://gce-sc.bidswitch.net/imp/0.02/BSWhttp_A_B_Badx.g.doubleclick.net_Bpagead_Badview_Cai_RCfLZnvxoYWoKwLIuWmATs-4CYAantz__RNsqmA28EGkS8QASCD__eYfYMm2po3spIQRyAEFqAMBmAQAqgSrAU__QrCFiwmkQjfmv9aPLTzUSNR__kD40dEKHgzp9FtTqR-t__HXUuo2AiQ0BDfOc-f__4H8toEnF3edCKVfsAtrDMI7DXTH4ElS7kvDe2QE0HM2HKiUYI0nCfwVDPmWwJQOBADuBZucHOELKM8DpNwkI-pcNGalkQSY1E2BrdNzmwJt8Z1sjyAZD0S7kUaPnHpnIIMAHkk1BLhv5y6i-4UjMw1QKKqhtoSFtkgNqcAE95m3kLMB4AQDiAXz6-LLA5IFBggdEAQYAZIFBggdEAEYAZIFBggeEAEYAZAGAaAGT9gGAoAH6ePOPKgHpr4bqAeeAdgHAPIHCRCT5QUY25yOJ6AIteulBLAIAtIIBwiIQBABGADyCBhiaWRkZXItcHVibmF0aXZlXzEwMTIzNzKACgSwE-3KrwPIE7jRowLQEwDYEwqCFBcaFXByZW1pdW0ucHVibmF0aXZlLm5ldA_Jsigh_Rmf23QvF89g0_Jcmd_RChdjYS1wdWItNzM1MDg5NzEzODA5OTk1OBgB_Jpr_R38_A_I_WAUCTION__PRICE_X/1ja825m-57ZZ1n2YoUucUH932hFGUPM1HouZxU1237SJTGi5Ec9JaTMFTSXVlmG8GjCNHnnt_FocRf5_Oq3g4KxN8WzjkueE7Qg4yYH4mWwmhQ25QooIExahf0Po1wu5S_6x7mPbY8vP_PnoXsGvk6diZ2O6cf-PF4bQbtheGv9czFpD-yDnQ52apB1Oj0Iw_y_UmEOLraTuZ_nt5Gv7AzOmGocuUv4OPwuRI7ng4iIHojrTzYVqah1IjQkVMdz6OLr7jV0eyUvzqXAPiM6VZg4xDizCpnzYscMnFHch9gpfb6KquosLGEaxBTRP0ZbdBzevVgHW-809O21ZlLbib9GIG2tm_oIfoaZAdFBGodud3bGUiM64UzdCI-iCpFYk3uQgvmNKwWZFqldrGhGoldE_G4TLrskpE7JC4HDdDmHsyQUkF0laTGdsnhLbZwQi-ds2WUy6ZDjeDzJ89dEsPJ91iapKOJe4iKiGwFQVJ3GNC9Ed1qbUCPZAdL2aaS8R_cgEyITJJi6CnBCXnhYhE6xjVTnTlaN-J_MSgBHjEmz_1LVEjS_hy75rpSMNdS_Fl5Odymw1BRNGBgBNbhkEWblzVH2_YT-9oluLDRB4-b7W7I9qKKOERwZKUhYzCkA75utTKcnIvX8tPA/</Impression><Impression>http://us-east-sync.bidswitch.net/sync?ssp=pubnative&dsp_id=16&imp=1</Impression><Creatives></Creatives></Wrapper></Ad></VAST>"
}
}
],
"meta": [
{
"type": "contentinfo",
"data": {
"link": "https://pubnative.net/content-info",
"icon": "https://cdn.pubnative.net/static/adserver/contentinfo.png",
"text": "Learn about this ad"
}
}
],
"beacons": [
{
"type": "impression",
"data": {}
},
{
"type": "impression",
"data": {
"url": "https://got.pubnative.net/impression?aid=1012372&t=_5OcHk6Z3uaDHvx1yBCL0mNzz8-Kyk0IDRfQwBzl0xgdlmhWCLwsEPcc_-HaoXdZdC9qxgw82AdEQAsi7sxZu18XBLqUQT8aDM2ndKnYe5uYaJfPwF-EuYmSzsFOe87k-Ircqf5JsPV541hXrbiN-3vFXeyA9xRO6sHQmKBC37QnVWY4HcQsyUFXua6zmKt_IrdRzzPnRWJ-yxW71YDvG0khtldXjKZ0WJ18bd0YaV_cVK_rgCQUVk2A1mwLz4rz3HW_SHdRo0PkWuHpC8bexbB-AremmW1VmA0WCqwFkL2r_3zoWDGLIM3WhAQqnJO1B6dhfArUSqdm6qvOeZ3jS5K9gBRiHo_cnyMHsnqQ6JOURT-QLmGvJ8uBt3VwOpfY-wn5FMaiYNavHSdGntVLyF6ZS13AioPqsl6wEJE3G7Dl7ubdBCiZXOLMYod_WN6N2rQJC93Vs1qp5H5lJkmFG6zwn9Zi_rK3vi6Ey4_emVp2_1H5l7csNcU2DM7ku_TXGlOv4WDgjqSmaLaQ2ZLO5KL28SaUJUmZgK6wn6Cy1k8M-WSd_KIkb6euq9fA-2IR6UHgugemQqGn2hK5J_qSOe0hPDtgriQ6RoG07s8TQVf4Yb_jhf0aPrXrNlGEI9HovGXTpMmao7eUmZEd64-tgngDt9Sj9ryjlK3wosahaL7Xr2CyQhzP7Z9d-HRLc1ebwzi2MH_wKwsym_XxrhLENPGLdapPZZha2eo1qop1QRnmU1qrGsJ0FlL8hS3x4lYFG07Z-4SJyvWlmtzP4zbvJo5bRr6iFaCgj3N9kfrhVNlIU8Uu2nf1cnxzslomaA"
}
},
{
"type": "click",
"data": {
"url": "https://got.pubnative.net/click/rtb?aid=1012372&t=hl6bkQhTTxTB7kpeDwKivvCdFD3G61HSmTHqrgCdNp5bNNA97sZ90dX0aEQHDwt2Bo26GwCP2fsK7im4OaE4GAgPuqfnYzcElMBfYrevrVU__T_78BUqdSQATzA0zPEM9uP19t_pV30jvn95mMBAyikD2b6msFD78gIi9FpLMhB_h0x6yLqrn3ZKNVDGUvdJcIOeaPoc9nQC34zKbEIxiXyYnSVLSkzV8GOGlpUTpAtu-kmsL9wvNS-v4_T-IBCtYt0pvbnbuy_1m8M6lLXUYq6ecp2hVzkAqWbFMEN8RHKm_5BQxgyRNArlAhtI7bpAIo-UWCo6MA5wLwLoSe8XMoxBazwcmGPJU68O6Jooedt5XKt5Kf6ssa_s5MTqPNMPAuUUnebkHx6JP8C7jUyxEB1Q2vMSxeSJM0V63FR6w2ALlwfdbiY-UsFX3AfOectnDFaTmbB_D2_xwX4OHIDBKJ9mkr4BMscb9khzGARASiQiklV29aKhRi-qOdGifRlzhk0KG1Ib0Jo"
}
}
]
}
]
}
Meta types
- 'points' specifies the payout associated with the campaign (1000 points =$1.00)
- 'revenuemodel' is the revenue model of the campaign returned.
- 'bundleid' is the bundle id of the app associated with the campaign.
- 'contentinfo' provides an easy access to users to Pubnative´s privacy policy.
- 'campaignid' is the campaign id of the app associated with the campaign.
"meta": [
{
"type": "points",
"data": {
"number": 2420
}
},
{
"type": "revenuemodel",
"data": {
"text": "cpa"
}
},
{
"type": "campaignid",
"data": {
"text": "3229480"
}
},
{
"type": "creativeid",
"data": {}
},
{
"type": "contentinfo",
"data": {
"link": "http://pubnative.net/content-info",
"icon": "http://cdn.pubnative.net/static/adserver/pnadchoices.png",
"text": "Learn about this ad"
}
},
{
"type": "bundleid",
"data": {}
}
]
Beacon Type
Pubnative response contain following beacon types:
1. Impression beacon - Type URL
"beacons": [
{
"type": "impression",
"data": {
"url": "http://tr.pubnative.net/impression?aid=1012003&t=uuJqdX8Q6ULYwTQwCxFTg8LdkPsKhhVL9UbAFc49jFQ6V8VFueXVyEw9w5CXp65y-FO_MkzYnsf9mCe6PPO1TzZCr-0BK3pM6Qj3cTVT6hJPGDQ-WwtnefolN05Go396WkFb0-L5b_yjE0J9X4yv46ZSEpPVx4whFUAhY0ztOdXHG7ILQe7iqYKXzAhW7UG2N4JYioWM2kXBcFB_9E8vk_Wk6wjHqPJ_gtlMuZkX3F_fp-dukRmtd4BzMlZraJg8Z7pZvFE1u0GaBaup9FYs-B26K8X9OONmEke3J5TAWhxZuqRD9c6SuYuZUhWtDJaFh5Vq4ApEuIqnb9HKt6n-zkMRPKQ8EIzYxJ-FJUNwhyVcsTqMws_udHtpZt-W68ygffT0pHiZ8DasPMgH73-Xld0uZ8qE7kHwSdWtZxB_7UPupUj-BhARg67QEQ5FwiQ_p8ghOBCGm56BhdrxinP1GQlCR2gIWrccVjSOH1MmlkQgBtjou_KCVZfzAfI2kIvWnQ6awfZo-gM3JLaooOoHJ2f81tAL_Q4LZ7fbWlJLp52b6XLeQUlPIBgPsG2WSZ0AU5j3M-6MqmxxJoRg5et9OcKmkg2Y6ovprNrvghccl9Ao&tl=620"
}
}, {
"type": "impression",
"data": {
"url": "https://NETWORKDOMAIN/c.asm/C/t/eh069iuvof/1pym/s/1h/db/u/0/0/0/eyJVSUQiOiIzYjY3Nzg4My1kOWI3LTQ3YzctYWNjNC0wZWFmYWIzN2U0MWQiLCJHUElEIjoiM2I2Nzc4ODMtZDliNy00N2M3LWFjYzQtMGVhZmFiMzdlNDFkIn0~/08ebd7a8-0157-1000-f8f2-3e92681100d0/-1/0/14/0/0/49.43330001831055,6.849999904632568,0.0/13494882/NW/2t/0/api/3.0.0/dir/Y29tLnRocmVldXBwbHVzLlByb19TbmlwZXJfU3RpY2ttYW5fRnJlZQ~~/Fp4oFsCNtwEW3ODqzNFVN5yijIBTlGE_FBwXAAAAAAAA8D8XVfbbM2QYZT8XAAAAAAAAAAAUBBIYODVZMHJtcTlvZVcrcW94QXNOa29TSldMK0Z2eS9HQ1JMTnJvOWFJZHc3RndBU0pUdVFZS0VlZz09GAZOQVRJVkUcFAAUAhwcFoDAuJWA6uvrERbf1Oe8wtvglg8AFoD208rquMLqTBUAEgAAORXAPiEUABbE5PiK6lEUBBgYcGVyZi1hZHBvb2wxMDAxLnBlcmYudWgxFAISPBUCACwVAgBTBgA=/-1/AA==/6/40d5d6fc?m=18&ts=$TS"
}
2. Impression beacon - Type JS
"beacons": [
{
"type": "impression",
"data": {
"js": "<script></script>"
}
}
2. Click Beacon - Type URL
"beacons": [
{
"type": "click",
"data": {
"url": "https://NETWORKDOMAIN/c.asm/C/t/eh069iuvof/1pym/s/1h/db/u/0/0/0/eyJVSUQiOiIzYjY3Nzg4My1kOWI3LTQ3YzctYWNjNC0wZWFmYWIzN2U0MWQiLCJHUElEIjoiM2I2Nzc4ODMtZDliNy00N2M3LWFjYzQtMGVhZmFiMzdlNDFkIn0~/08ebd7a8-0157-1000-f8f2-3e92681100d0/-1/0/14/0/0/49.43330001831055,6.849999904632568,0.0/13494882/NW/2t/0/api/3.0.0/dir/Y29tLnRocmVldXBwbHVzLlByb19TbmlwZXJfU3RpY2ttYW5fRnJlZQ~~/Fp4oFsCNtwEW3ODqzNFVN5yijIBTlGE_FBwXAAAAAAAA8D8XVfbbM2QYZT8XAAAAAAAAAAAUBBIYODVZMHJtcTlvZVcrcW94QXNOa29TSldMK0Z2eS9HQ1JMTnJvOWFJZHc3RndBU0pUdVFZS0VlZz09GAZOQVRJVkUcFAAUAhwcFoDAuJWA6uvrERbf1Oe8wtvglg8AFoD208rquMLqTBUAEgAAORXAPiEUABbE5PiK6lEUBBgYcGVyZi1hZHBvb2wxMDAxLnBlcmYudWgxFAISPBUCACwVAgBTBgA=/-1/AA==/6/40d5d6fc?m=8&ts=$TS"
}
}, {
"type": "click",
"data": {
"url": "https://NETWORKDOMAIN/c.asm/C/t/eh069iuvof/1pym/s/1h/db/u/0/0/0/eyJVSUQiOiIzYjY3Nzg4My1kOWI3LTQ3YzctYWNjNC0wZWFmYWIzN2U0MWQiLCJHUElEIjoiM2I2Nzc4ODMtZDliNy00N2M3LWFjYzQtMGVhZmFiMzdlNDFkIn0~/08ebd7a8-0157-1000-f8f2-3e92681100d0/-1/0/14/1/0/49.43330001831055,6.849999904632568,0.0/13494882/NW/2t/0/api/3.0.0/dir/Y29tLnRocmVldXBwbHVzLlByb19TbmlwZXJfU3RpY2ttYW5fRnJlZQ~~/Fp4oFsCNtwEW3ODqzNFVN5yijIBTlGE_FBwXAAAAAAAA8D8XVfbbM2QYZT8XAAAAAAAAAAAUBBIYODVZMHJtcTlvZVcrcW94QXNOa29TSldMK0Z2eS9HQ1JMTnJvOWFJZHc3RndBU0pUdVFZS0VlZz09GAZOQVRJVkUcFAAUAhwcFoDAuJWA6uvrERbf1Oe8wtvglg8AFoD208rquMLqTBUAEgAAORXAPiEUABbE5PiK6lEUBBgYcGVyZi1hZHBvb2wxMDAxLnBlcmYudWgxFAISPBUCACwVAgBTBgA=/-1/AA==/6/1d0f464a?at=1&am=0&ct=$TS"
}
Please be noted as soon as an impression (=creative) is shown to the user and ONLY after the ad has been viewed for 1 second should the impression be confirmed. This is the guideline is in order to respect IAB view-ability terms.
- How are impression and click beacons confirmed?
-
- In case the beacon is of type url, then you must send us a GET request to the URL which is specified in impression beacon client side.
- In case the beacon is of type js, then you must render js script in a web view and confirm the impression on client side.
Note: Number of impression and click beacons depend on the demand partner. The integration must be done in such a way that the app is in a position to confirm all beacons -impression and click.
Ad layout sample response
Quick recap of the above-mentioned information, below is sample responses for ad layouts type - s, m, l
{
"status": "ok",
"ads": [
{
"link": "http://tr.pubnative.net/click/native?aid=1004319&t=PBNNoP42B6gg2CszXsw5iNfVACMYMyVebc2ZYRwotIvpS2TlCvWa1_eqt8uFRF7nNkhLhkaXWNbblY5O905LWcD-1nMfkNFWd_A9lVFIQ0SRPc61vwegFYgt2OLK2UH1GysruFec3CvRs_0lMzDyEwvAWmP8CFK70pmXUuD3Lsk3vXJ6Hk3AF5CpOzTRs_0N12PZLzCzTy9I7sWAabX7LMn_RlxULMqkMQO7VD4eObrM_zLnV3udU_Vi9-k1QZ0MFr5conBgSOXd6ZjUnZ0P19fMtNxMGVeTdBuZ01z0rwk8rWASVesMfA4gZXyCd-XMt6ELofBilVnVn7weN6gNEHC-2o88Zz7F-3HVh1bzkrAjriRLhbd4UtXa6yoEJ5-lQAGZw3D5Uhjt9DAv0WnGygZR0lzrBpAhg73aCmIv8AecoU8bDOG9X8RGnQ_wnRiWXLit8ST80ahX1Kp_M-hGVX4c7-_EYeCuXwMK8zZYVKGXLrMjb6K76Rs-bSNFkZ3Sw39VeDPZ85kvtZBGXKdJ9K9SRPqxHDKBaUFebhvdY6zFqzEDE2Y6uOqHEHMUmG5SJwU-CvbMGJLpEMEvVaSlYk0mPsGlWs8us07PABws04gkzW5gn1cHjL8dnS3KKtQ",
"assetgroupid": 2,
"assets": [
{
"type": "icon",
"data": {
"w": 80,
"h": 80,
"url": "http://cdn.pubnative.net/games/icons/001/015/256/dimension_80x80.jpg?20161025074858"
}
},
{
"type": "title",
"data": {
"text": "Coin Dozer: Haunted"
}
},
{
"type": "description",
"data": {
"text": "Suchst Du eine neue, coole App? Lade mich jetzt runter."
}
},
{
"type": "cta",
"data": {
"text": "Installieren"
}
}
],
"meta": [
{
"type": "points",
"data": {
"number": 380
}
},
{
"type": "revenuemodel",
"data": {
"text": "cpa"
}
},
{
"type": "campaignid",
"data": {
"text": "4873307"
}
},
{
"type": "creativeid",
"data": {
"text": ""
}
}
],
"beacons": [
{
"type": "impression",
"data": {
"url": "http://tr.pubnative.net/impression?aid=1004319&t=clivZDG3sj6hnaC3hsCj4TDdfxiGcQg9LZyAKRjezva8zscP2C5DxpcIoHEGIZjWSlKglkRZIIwgGWiwAJvk83hm0sI_9hr7DA-N0YTeorSVnRak-_1slLYF_Jox41g9_bCB5xCg0OywJEYgwHdgbJr3SuiaSuXDwPykXAK3q5dCcJWNcZyzmoUKeb3qL8HIKqRXR_M9o20I5941lKdzTtoLCHjERo92BGAGIl1v_U2CMePaF4lks1__FZHs0m5JUnZlMVGVwNwPnWVlmqLHUuFI3k8Yl3kmPHLfTqyjPDa2SM8KlYgb1UcZd55J1K-iyw4_e0Xi0i8rFZfPR5l_bg1l5lXEtFirkcIPBy6vNoe2k-h3XNjqzkCKXFaVlCK6G3yYxdk0ttKEX5LVB8wDHeeg9qDUUIOJvapCH46XdYjBggQ2Dmv-PYXyv0PW&tl=444"
}
}
]
}
]
}
{
"status": "ok",
"ads": [
{
"link": "http://tr.pubnative.net/click/native?aid=1004319&t=S1c6jpWDjvV277qb1VNHhR-5qu3KQC2A2IIqylLkMXw8hVcBVeuCBjevqunqqekShO4FPgI3Q5W5Q1p1XOCkcSgsB5MHOIcxnF7aw6X_xy9rNUIZQx69QdseEnFBW-OEShmUoXvPNPWo5SsSPbyjJzG55OwQmggKEUa2IJK0Nk6Z35sk81BRibJ_BRm0wqnkLoiujE1C64hN8XSFfn2ex7R7FbcULVLad3cJ93zydGYtUTsIb1ckdwT8UhV02MdqgLBpy2S8sOZ9i6PnI5IRTNaSOjEL-z-jWOOl0LHHacC4D0pyiwZG58-qL0Rggiev4LL87z2Q6c3dGT83mQ3SquYnLRokhM0rmjV255c3GfCxy_E2B1nuvzWEfuivCSTQzjvlId4GfV73CXLmIF1s-mSATQ6lspLNSPmjnJ-umC_A6CUMkW9Dkyqy1123X9F2N9Ovh0N9cRuRTi_PVCy1Locvd7l7knwOXAi8mQNQiOALwfWPrXxJzxxoaELZ-5K6LcHFOoUsJ5RkBYMGOkqv62zkNmH78q1p-A4IuxVYMod6k4LTYMO0r8Z0HkvrUhxS_CTemd233wKlACqjZEURIM9zbSJxcMkobQuczwoVbU83RFx0yVp76D2GIPFKMiyZaA25j0KW3A3GwaVHTSH8e27JFeJA8wEhU_SRBebHqJOLf0-csgw00Zkv_jVjL0vjM9VIBaCwlLZe6CRam3jhUCnLfRqwwqPUCQrYMF1PcFWQyzXPOnO4cVM",
"assetgroupid": 5,
"assets": [
{
"type": "icon",
"data": {
"w": 80,
"h": 80,
"url": "http://cdn.pubnative.net/games/icons/001/005/541/dimension_80x80.jpg?20161025053515"
}
},
{
"type": "banner",
"data": {
"w": 1200,
"h": 627,
"url": "http://cdn.pubnative.net/games/promo_images_landscape/default/2_dimension_1200x627.jpg"
}
},
{
"type": "title",
"data": {
"text": "PAYBACK - Coupons & Gutscheine"
}
},
{
"type": "description",
"data": {
"text": "Suchst Du eine neue, coole App? Lade mich jetzt runter."
}
},
{
"type": "rating",
"data": {
"number": 4
}
},
{
"type": "cta",
"data": {
"text": "Installieren"
}
}
],
"meta": [
{
"type": "points",
"data": {
"number": 860
}
},
{
"type": "revenuemodel",
"data": {
"text": "cpa"
}
},
{
"type": "campaignid",
"data": {
"text": "4816214"
}
},
{
"type": "creativeid",
"data": {
"text": ""
}
}
],
"beacons": [
{
"type": "impression",
"data": {
"url": "http://tr.pubnative.net/impression?aid=1004319&t=8D8fP-_cgXz0eiwyZEf44aU_4ViDXgHXWrhBHq-GdMOMiQ96D7T4HPJUbb-0jF2-8WMB6uX5d_rH4x4LdmfkP2uy9O-_IeTl9P2yh8xp4Faf6rcbO3XRHdeanIoq_9qOUHbbbMjVzj-MIWE9Bw-S5i4_01hoclRwSAwnAHN5_xUfZlcM3M2vd2ZFybZxOVm9-iKYZvBwVzgB4G4PMDILTfAuEwpgDLOjGEBv10PX-TRZrm98BLkS2qndZMBQSmMW3E4MsccbR6Wtrzke0Cm0zl_OL9AEFjCE4HqKZd1dX_1XMXQewUSc1jgy9QRtIR7bcOvqjZm_xGbXDgXQf7MnEVnROVKvNHBJPiN2UPUFz7Rrv3KyJ2HI0h2T3eyY_ODID6M&tl=387"
}
}
]
}
]
}
{
"status": "ok",
"ads": [
{
"link": "http://tr.pubnative.net/click/native?aid=1004319&t=FmOB-EgqTQRg4Xs5I4jssBpFtYzpCsDv067_lI24m2ZvcYNnEMOREUiVo0Ztge_zXjOfxN2abqUP9OansDd4y2pIQ55nJeUSyMeaGAmMJQc_sVCiOQD5OXjgzl5tjmS5owrOkRh8e58dUl-dO0GVb3wSWa8_oQk3iAyl7527oF0Vmn6rmxChYxGU0rm8IbqSnFBUpqYLpOV4Ui7mt_hjavV9naSLYNCcngrTaSYqI8IGPSRMQn1ovGAlUdfjkONoGGBMI0XKvhylY_MXVllSThRSwvPucF128lNR1bG6CjNXaJtlCNICpy179uACP_Rh0Av5vb4rW01EecwhZTpEGmaFQLraZwl_USAlXZXWgmdb8tSBfAXBOW8300F0P2a8bpnJAB48gbVG_0ETbJky4keXXrRmiBHF89w-w3hmU1-rAadd--xvV8cwxb6sV7MDGOx4iuHvZhKeEn4frvmB2xGMDBJtdcbmYi73bQwg5blWtTIgjMpHLHddCKs_GjqqsH7fbY_yDSkzEYyspOdcEho2iQsHQAgk5ZPZrv0fq1aUgc0zQNTyrKgka1ENgxoOMScIqRVe-qBT0bAwVochl6-ar5xd3y3lGGKEG3K0hC0rM7aoJio7dcdBSh1lKfNMonwpK2g-wmVao9vT1VUp9g0bJneu4A5sImgT3cbNIUohqlFVs1Tm2LA50Mnu1Va1QLKH56ge1rTd_VbqwzRY9vOaUVQmUnPtMy_mC_W1iCpyAOCmo0tsoB0FE23SxXxIH_J6",
"assetgroupid": 16,
"assets": [
{
"type": "icon",
"data": {
"w": 80,
"h": 80,
"url": "http://cdn.pubnative.net/games/icons/001/003/592/dimension_80x80.jpg?20161025001049"
}
},
{
"type": "banner",
"data": {
"w": 1200,
"h": 627,
"url": "http://cdn.pubnative.net/games/promo_images_landscape/001/003/592/dimension_1200x627.jpg?20160622190318"
}
},
{
"type": "title",
"data": {
"text": "LOVOO Chat, Flirt, Neue Leute"
}
},
{
"type": "description",
"data": {
"text": "Erfolglose Flirts im Café oder doofe Anmachsprüche im Club gehören hiermit der Vergangenheit an!"
}
},
{
"type": "rating",
"data": {
"number": 4
}
},
{
"type": "cta",
"data": {
"text": "Installieren"
}
}
],
"meta": [
{
"type": "creativeid",
"data": {
"text": ""
}
},
{
"type": "points",
"data": {
"number": 380
}
},
{
"type": "revenuemodel",
"data": {
"text": "cpa"
}
},
{
"type": "campaignid",
"data": {
"text": "4897669"
}
}
],
"beacons": [
{
"type": "impression",
"data": {
"url": "http://tr.pubnative.net/impression?aid=1004319&t=UjDL5E6i1M2BSWmv3XSt-a-iiIT_FAmofG6DcIKtrTIzw_qtVwvNJOg0k2izojP5p_oG-39qAD2aqwnCo5RvGMzTrwesUBvnw8a4tH8zZkijFH93230GJnu3GkNTlNvWz7xvNkGhm0Cxf7QXFhKquFLj_iSP8tyCrdEfdvngSbJTo6KH1DZMgvgp7b9ppesmvr2h8RAjkbHTAMLHKU4Edx68t5EEglElXMgQSTwRPANPVWZNHSiq0s_tlb8EpIg9oD0c4RxNtBLS2o4jHBiocXdJPhL7ZDR4FUFyBHdr9qo7gjLdNtsGBFZDpW2u0sFbSo5Gz94FZxPxqv7JPOBMNBNzbhQ2vmSSIqVLROdoit8PQhQoLaHzM2lcqJU3ulPl1NwHVmBZluVnk18ODZI6IR2YFgat3dDugxaOLQw7RDEgdykmFzK98CFQCyqN&tl=444"
}
}
]
}
]
}
How to use?
- The server generates a GET request to the relevant ad-format together with the url param, the server returns a json response.
- The server parses the json according to the ad-format
- When the ad is shown, our server must be notified about the impression
- When user clicks on the ad, the server should redirect to the URL which is specified in ad's click_url:
"ads": [
{
"link": "http://tr.pubnative.net/click/native?aid=4&t=qyaUDc7fF-_rqXR6BLs_t9z2cpmf_SpRnCmC-r7BpFpxRSBSM_LdwFFbF5yN9Tdz7mkuMpTws22UFVb24k4TmeQRGqSStKi3CzFmqppwCiLPxGANFs88oQlWiex6kqFXZbubHWjBKb9ZdBWrKzgnCmEREdAOEMDvV3W8MVQ-loUv5cgnlQF-gXf-wsBKAytCF4m6zQN2w-TcUYkGH......"
- CPA or Cost Per Action, which means that users have to download and open th eapp for conversion
- CPC or Cost Per Click
- CPM or Cost Per Mille, which is a cost for every 1000 impresssions
Points Calculation:
- CPA campaign: 1 point = 0.001 USD per conversion
- CPM campaign: 1 point = 0.001 USD per 1000 impressions
- CPC campaign: 1 point = 0.001 USD per click
If the points value is 0, please send notification to the PubNative team
Frequently Asked Questions
1. What is impression confirmation?
When the ad is shown, our server must be notified about the impression in order to track the campaign performance correctly.
2. Why is impression confirmation required?
The impression confirmation is a critical part of RTB compliance as well as for the eCPM maximization algorithm and the impression beacon should be triggered when the user actually sees the ad. One of the reasons for this is that campaigns available via RTB are CPM based and if we do not have the impression confirmation at 'seeing' stage, then the revenue will not be counted properly.
Please be noted that overall performance depends on the number of submitted targeting criteria. For example if you decide to share age, gender, location and other demographics in the request it makes it easier to win impressions for RTB demands so we highly recommend to send us all the parameters you can possibly send.
Adding Postback
If you wish to receive conversion postback of certain parameter you send (example: Click ID) please follow below steps:
- At the end of API click_url, add "&aff_sub={YourClickID}"
- Example: https://tr.pubnative.net/tracking/click?aid=1001000&t=...&aff_sub={YourClickID}
Please send PubNative team your postback URL with Click ID parameter
After setting up PubNative team will guide you through the test
Checklist Before Activation
After the integration is complete, all that remains is to test the integration and make sure everything is working fine. All for your users' sake.
Request
- Your request URL includes all required parameters with correct value
- Your request URL includes user identifiers. (Android Advertiser ID or Apple IDFA)
- Your request URL have to include adchoices (mf=contentinfo)
- You are sending requests when user reaches the ad inventory and with planned frequency.
- The best practice is to request a maximum of 3 ads per user session. Ads should be refreshed after an event (click or download) or after period of non-engagement. This period depends on the length of user sessions and can be from 1 minute to 3 minutes.
Response
Your app works correctly even when there is no fill (API returns no ads). In case anything is wrong with the app PubNative can disable the fill and later enable it back on when the encountered problems are fixed.
Impression
- You are confirming impressions when the user sees the ad for the first time for a minimum duration of 1 second.
- You are confirming impressions immediately, in real-time.
- You shouldn’t confirm impressions twice, even if the user sees the same ad again. One (initial) confirmation is enough.
- You should confirm multiple impression beacons
Clicks
- Click happens when the user clicks the advertisement which is linked with the click URL PubNative provides.
- The click event has to be done by a genuine user and should not be an automated bot or incentivized (rewarded) click.
- Depending on the type of campaign (app promotion or mobile landing page) the redirect behaviour should be considered
- for App promotion campaigns, background redirect (hidden browser/webview) is permitted in order to maintain the user experience
- for mobile landing pages, at the end of the redirect you must make sure to either show an internal browser window (better user experience) or send the user directly to the default mobile browser
Please also send your request URL to PubNative team so we can help you to make sure everything is properly setup and ready to go live!
If you have any questions, don’t hesitate to get in touch: [email protected]