{"__v":4,"_id":"5783cba3359cd219005453c0","category":{"project":"574ff4bd3fa1870e00889ba6","version":"574ff4bd3fa1870e00889ba9","_id":"5774fe18605b770e0037be8a","__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-06-30T11:10:16.206Z","from_sync":false,"order":1,"slug":"api-documentation","title":"API Documentation"},"editedParams":true,"editedParams2":true,"parentDoc":null,"project":"574ff4bd3fa1870e00889ba6","user":"574ff3adaef76a0e00840968","version":{"__v":17,"_id":"574ff4bd3fa1870e00889ba9","project":"574ff4bd3fa1870e00889ba6","createdAt":"2016-06-02T08:56:29.492Z","releaseDate":"2016-06-02T08:56:29.492Z","categories":["574ff4bd3fa1870e00889baa","577278ecdceb570e003a9001","577279865617b117009e643f","577279985617b117009e6440","577279bc8c48e00e00503504","5774fe18605b770e0037be8a","577ce3ad87acf617003c4187","577f8476a77c700e006a6c52","57b486ae0d2b640e00e9d3f5","57b722133d3e620e004ec74b","57bd95f00fe3a00e003e2cc5","57c8349359cd4b0e00b888ef","57c8349b5754fa1700b12242","57cedb0bad483e0e00890239","57cedbe807d7ea0e00e438cc","57d82967156ef72b007ffcd8","58ee353ad1ee2f0f0034a13d"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"3.0.0","version":"3.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-11T16:38:59.440Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"language":"curl","code":"GET /api/v3/native?apptoken=YOURAPPTOKEN&devicemodel=SM-T550&gid=3b677883-d9b7-47c7-acc4-0eafab37e41d&al=m&reqid=4ad3b9d5-f9d9-4494-a924-cff2b98b4a0f&zoneid=1&mf=revenuemodel&locale=en&gidsha1=e06e0d690375c4d666ae425a07e5fede33a30ebb&osver=6.0.1&os=android&gidmd5=6ca9c03a59993e5c0a67ac50e968ce04 HTTP/1.1"}]},"method":"get","results":{"codes":[{"status":200,"language":"json","code":"{\n    \"status\": \"ok\",\n    \"ads\": [\n        {\n            \"link\": \"http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AVUHRTCBCPSh-3mYsytGbPi0MBC0fDR8EH-VNF2d8Gewf9x74EOqWmkxfJzz6iPurjiVvlrve0EVBUFzFqPa6d59B42V0T4bTXDwa0E_JAATY1Q5GCDvgd3tC3AnM1gfxxRjuScoC10W1ktZ7aDlYPVBx6wihAxeNSSJobeDTRJgK02tY2CiBVrHEptgxsGDA7rv1CkkmA6J4eh7UHhOtlN3OQiFDQ-xjiLhReumkflWiiHzGrGC4c0Pkoh7tqPwHdqht9u_jDJkRLBNIWnltbnWew8o2txMHqdfwZ9LmGLc6NL_OR7PFX-ITGJTw0XJIp_Jc0kylsKW0byLKaqqFLfRL0PG_AYqiQDPHrdMuaIOzbbrfm769fY3hGdWgUtJZhyNQYXw0o2usHRa7sD7pHEfqb_xM6ZIQc3u_dXDeSJvqAQyTus03NEFfe_najdb5Cnso1MikCR36jv9NZuPxtut-Y6SXShWwBe0dvbOxAXRflaokAcrmDQSTjwVdNpbgO7y1MfM3IB1zpFEQ2sCDCNlhkAPdz48M6Osdm1AxB22AMz0F8enJeNiRM7ZgmdtKqLWMBhy6_1EM\",\n            \"assetgroupid\": 5,\n            \"assets\": [\n                {\n                    \"type\": \"icon\",\n                    \"data\": {\n                        \"w\": 80,\n                        \"h\": 80,\n                        \"url\": \"http://cdn.pubnative.net/games/icons/001/006/596/dimension_80x80.jpg?20161020082017\"\n                    }\n                },\n                {\n                    \"type\": \"banner\",\n                    \"data\": {\n                        \"w\": 1200,\n                        \"h\": 627,\n                        \"url\": \"http://cdn.pubnative.net/games/promo_images_landscape/001/006/596/dimension_1200x627.jpg?20160622174207\"\n                    }\n                },\n                {\n                    \"type\": \"title\",\n                    \"data\": {\n                        \"text\": \"MyFreeZoo Mobile\"\n                    }\n                },\n                {\n                    \"type\": \"description\",\n                    \"data\": {\n                        \"text\": \"Zeit für eine neue App? Installiere mich jetzt.\"\n                    }\n                },\n                {\n                    \"type\": \"rating\",\n                    \"data\": {\n                        \"number\": 4\n                    }\n                },\n                {\n                    \"type\": \"cta\",\n                    \"data\": {\n                        \"text\": \"Installieren\"\n                    }\n                }\n            ],\n            \"meta\": [\n                {\n                    \"type\": \"contentinfo\",\n                    \"data\": {\n                        \"link\": \"http://pubnative.net/content-info\",\n                        \"icon\": \"http://cdn.pubnative.net/static/adserver/contentinfo.png\",\n                        \"text\": \"Learn about this ad\"\n                    }\n                }\n            ],\n            \"beacons\": [\n                {\n                    \"type\": \"impression\",\n                    \"data\": {\n                        \"url\": \"http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455\"\n                    }\n                }\n            ]\n        }\n    ]\n}","name":""},{"code":"{\n  \"ads\": [],\n  \"status\": \"ok\"\n}","language":"json","status":200,"name":"No Fill"}]},"settings":"","auth":"required","params":[{"_id":"577a46d2aea88b0e00f63344","ref":"","in":"path","required":true,"desc":"This is your internal app token that you fetch from the publisher dashboard.","default":"","type":"string","name":"apptoken"},{"_id":"577a4a90aea88b0e00f63354","ref":"","in":"path","required":true,"desc":"The operating system of requesting device.  Possible values: ios, android","default":"","type":"string","name":"os"},{"_id":"577a4a90aea88b0e00f63352","ref":"","in":"path","required":true,"desc":"The operating system version of the requesting device","default":"","type":"string","name":"osver"},{"_id":"577e8d24781f3e0e005fbbb7","ref":"","in":"path","required":true,"desc":"The model name of the device","default":"","type":"string","name":"devicemodel"},{"_id":"577a4a90aea88b0e00f63351","ref":"","in":"path","required":true,"desc":"This field specifies if the user related information should be tracked by Pubnative. 0 - Track user ; 1 - Do not track user","default":"1","type":"string","name":"dnt"},{"_id":"577e57c347a9ab0e003e00e1","ref":"","in":"path","required":true,"desc":"Ad layouts that need to be requested. Possible values: s,m,l","default":"","type":"string","name":"al"},{"_id":"577a8a20b7ee4a0e007c4c5a","ref":"","in":"path","required":true,"desc":"Specify the meta data . Possible values:  points, revenuemodel, campaignid, creativeid,contentinfo","default":"","type":"string","name":"mf"},{"_id":"57a4c5236e32b51700cc29d7","ref":"","in":"path","required":true,"desc":"The ad zone identifier. Zones need to be created in the PubNative Dashboard prior to use.","default":"","type":"string","name":"zoneid"}],"url":"/v3/native?apptoken=:apptoken&os=:os&al=:al&mf=:mf&osver=:osver&devicemodel=:devicemodel&dnt=:dnt&zoneid=:zoneid"},"isReference":true,"order":5,"body":"##Additional Request Parameters\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Parameter\",\n    \"h-1\": \"Format\",\n    \"h-2\": \"Description\",\n    \"2-0\": \"srvi\",\n    \"3-0\": \"uid\",\n    \"4-0\": \"adcount\",\n    \"5-0\": \"ua\",\n    \"6-0\": \"ip\",\n    \"7-0\": \"locale\",\n    \"8-0\": \"lat\",\n    \"9-0\": \"long\",\n    \"10-0\": \"gender\",\n    \"11-0\": \"age\",\n    \"14-0\": \"keywords\",\n    \"15-0\": \"secure\",\n    \"16-0\": \"idfamd5\",\n    \"17-0\": \"idfasha1\",\n    \"18-0\": \"gidmd5\",\n    \"19-0\": \"gidsha1\",\n    \"2-1\": \"Boolean\",\n    \"2-2\": \"1 -  server to server integration. If set to 1, need to pass set ip and ua.\",\n    \"3-2\": \"User identifier. Recommended when idfa and gid cannot be passed\",\n    \"4-2\": \"Number of Apps to return.  Possible values: 1 (default) to 20\",\n    \"5-2\": \"User Agent String. Required when srvi is set to 1.\",\n    \"6-2\": \"IP address of the client device\",\n    \"7-2\": \"The locale used. i.e. DE\",\n    \"8-2\": \"The current latitude of the requesting device. Don´t send param if value is unknown.\",\n    \"9-2\": \"The current longitude of the requesting device. Don't send param if value is unknown.\",\n    \"10-2\": \"User's gender. Possible values: \\\"m\\\", \\\"f\\\"\",\n    \"11-2\": \"User's age\",\n    \"14-2\": \"A comma separated list of keywords\",\n    \"15-2\": \"Default http; can use https secure parameter for overriding\",\n    \"16-2\": \"Apple ID for Advertising (md5)\",\n    \"17-2\": \"Apple ID for Advertising (sha1)\",\n    \"18-2\": \"Android Advertiser Id(md5)\",\n    \"19-2\": \"Android Advertiser Id(sha1)\",\n    \"3-1\": \"String\",\n    \"4-1\": \"String\",\n    \"5-1\": \"String\",\n    \"6-1\": \"String\",\n    \"7-1\": \"String\",\n    \"8-1\": \"String\",\n    \"9-1\": \"String\",\n    \"10-1\": \"String\",\n    \"11-1\": \"String\",\n    \"14-1\": \"String\",\n    \"15-1\": \"String\",\n    \"16-1\": \"String\",\n    \"17-1\": \"String\",\n    \"18-1\": \"String\",\n    \"19-1\": \"String\",\n    \"0-0\": \"idfa\",\n    \"1-0\": \"gid\",\n    \"0-1\": \"String. \\nRequired when request generated from a Apple device\",\n    \"1-1\": \"String. \\nRequired when request generated from a Android device\",\n    \"0-2\": \"Apple ID for Advertising.\",\n    \"1-2\": \"Google Android ID for Advertising.\",\n    \"13-0\": \"bundleid\",\n    \"13-1\": \"String\",\n    \"13-2\": \"The bundle identifier of the requesting app. i.e. com.my.app, 422689480\",\n    \"12-0\": \"coppa\",\n    \"12-1\": \"String\",\n    \"12-2\": \"Flag indicating if this request is subject to the COPPA regulations established by the FTC, where 0 = no, 1 = yes.\"\n  },\n  \"cols\": 3,\n  \"rows\": 20\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<div class=\\\"isa_info\\\">\\n<b>Ad layouts</b>\\n<p>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)\\n<br>\\nEach 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</p>    \\n</div> \"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Response\"\n}\n[/block]\n## Response structure\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Field/Object\",\n    \"h-1\": \"Description\",\n    \"h-2\": \"Format\",\n    \"h-3\": \"RTB Compatiable\",\n    \"0-0\": \"link\",\n    \"1-0\": \"assets object\",\n    \"2-0\": \"meta object\",\n    \"3-0\": \"beacons object\",\n    \"0-1\": \"Click through URL\",\n    \"1-1\": \"Asset object contains information of all assets requested via the 'al' parameter.\",\n    \"2-1\": \"Meta object contains information of all meta properties requested via the 'mf' parameter\",\n    \"3-1\": \"Beacons Object contains URL beacon used to confirm impressions\",\n    \"0-2\": \"string\",\n    \"1-2\": \"object\",\n    \"2-2\": \"object\",\n    \"3-2\": \"url\",\n    \"0-3\": \"YES\",\n    \"1-3\": \"YES\",\n    \"2-3\": \"YES\",\n    \"3-3\": \"YES\"\n  },\n  \"cols\": 3,\n  \"rows\": 4\n}\n[/block]\n# Native Ads\nPubnative serves native ads for each ad layout - `s`, `m`, `l`. Native ads are returned in the form of different assets.\n\n##Possible Asset Types returned by Pubnative -\n* Publisher should support the following asset type:\nicon, title, description, rating, banner.\n* The asset type will be mentioned explicitly. Sample asset responses have been mentioned below.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"##Sample Icon Asset\\n{\\n          \\\"type\\\": \\\"icon\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 80,\\n            \\\"h\\\": 80,\\n            \\\"url\\\": \\\"http://cdn.pubnative.net/games/icons/001/010/700/dimension_80x80.jpg?20160706190952\\\"\\n          }\\n        }\\n\\n##Sample Banner Asset\\n{\\n          \\\"type\\\": \\\"banner\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 1200,\\n            \\\"h\\\": 627,\\n            \\\"url\\\": \\\"http://cdn.pubnative.net/games/promo_images_landscape/001/010/700/dimension_1200x627.jpg?20160622183653\\\"\\n          }\\n}\\n##Sample Title Asset\\n{\\n          \\\"type\\\": \\\"title\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"Sonax Scheiben- und FensterTuch 1 Stück\\\"\\n          }\\n}\\n##Sample Description Asset\\n        \\n{\\n          \\\"type\\\": \\\"description\\\",\\n          \\\"data\\\": {\\n                        \\\"text\\\": \\\"Suchst Du eine neue, coole App? Lade mich jetzt runter.\\\"\\n                    }\\n}\\n\\n##Sample CTA Asset\\n{\\n          \\\"type\\\": \\\"cta\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"Learn More\\\"\\n          }\\n}\\n\\n   \",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n# Banner Ads\nPubnative serves banner ads for each ad layout - `s`, `m`, `l`.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Access banner Ads\",\n  \"body\": \"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 -\"\n}\n[/block]\n\nBanner ads can be returned as two creative types -\n\n- ## URL\n\nBased on the ad layout requested Pubnative will return banner ads in the following dimensions -\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Ad Layout\",\n    \"h-1\": \"Asset Group id\",\n    \"h-2\": \"Dimension\",\n    \"0-0\": \"s\",\n    \"1-0\": \"m\",\n    \"2-0\": \"l\",\n    \"0-1\": \"9\",\n    \"1-1\": \"7\",\n    \"2-1\": \"13\",\n    \"0-2\": \"320x50\",\n    \"1-2\": \"300x250\",\n    \"2-2\": \"320x480\"\n  },\n  \"cols\": 3,\n  \"rows\": 3\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"##Sample StandardBanner ad layout = s\\n\\n{\\n  \\\"status\\\": \\\"ok\\\",\\n  \\\"ads\\\": [\\n    {\\n      \\\"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\\\",\\n      \\\"assetgroupid\\\": 9,Possible values 7,9,13 depending on the ad layout requested\\n      \\\"assets\\\": [\\n        {\\n          \\\"type\\\": \\\"standardbanner\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 320,\\n            \\\"h\\\": 50,\\n            \\\"url\\\": \\\"http://cdn.pubnative.net/games/promo_images_landscape/001/010ssssnsion_1200x627.jpg?20160622183653\\\"\\n          }\\n        }\\n      ],\\n      \\\"beacons\\\": [\\n        {\\n          \\\"type\\\": \\\"impression\\\",\\n          \\\"data\\\": {\\n            \\\"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\\\"\\n          }\\n        }\\n      ]\\n    }\\n  ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Ad Layout `s` Banner\"\n    },\n    {\n      \"code\": \"##Sample StandardBanner ad layout = m\\n\\n{\\n  \\\"status\\\": \\\"ok\\\",\\n  \\\"ads\\\": [\\n    {\\n      \\\"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\\\",\\n      \\\"assetgroupid\\\": 7,Possible values 7,9,13 depending on the ad layout requested\\n      \\\"assets\\\": [\\n        {\\n          \\\"type\\\": \\\"standardbanner\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 320,\\n            \\\"h\\\": 50,\\n            \\\"url\\\": \\\"http://cdn.pubnative.net/games/promo_images_landscape/001/010ssssnsion_1200x627.jpg?20160622183653\\\"\\n          }\\n        }\\n      ],\\n      \\\"beacons\\\": [\\n        {\\n          \\\"type\\\": \\\"impression\\\",\\n          \\\"data\\\": {\\n            \\\"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\\\"\\n          }\\n        }\\n      ]\\n    }\\n  ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Ad Layout `m` Banner\"\n    },\n    {\n      \"code\": \"##Sample StandardBanner ad layout = l\\n\\n{\\n  \\\"status\\\": \\\"ok\\\",\\n  \\\"ads\\\": [\\n    {\\n      \\\"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\\\",\\n      \\\"assetgroupid\\\": 13,Possible values 7,9,13 depending on the ad layout requested\\n      \\\"assets\\\": [\\n        {\\n          \\\"type\\\": \\\"standardbanner\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 320,\\n            \\\"h\\\": 480,\\n            \\\"url\\\": \\\"http://cdn.pubnative.net/games/promo_images_landscape/001/010ssssnsion_1200x627.jpg?20160622183653\\\"\\n          }\\n        }\\n      ],\\n      \\\"beacons\\\": [\\n        {\\n          \\\"type\\\": \\\"impression\\\",\\n          \\\"data\\\": {\\n            \\\"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\\\"\\n          }\\n        }\\n      ]\\n    }\\n  ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Ad Layout `l` Banner\"\n    }\n  ]\n}\n[/block]\n- ## HTML banner\n\nBased on the ad layout requested Pubnative will return banner ads in the following dimensions -\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Ad Layout\",\n    \"h-1\": \"Asset Group\",\n    \"h-2\": \"Dimension\",\n    \"0-0\": \"s\",\n    \"1-0\": \"m\",\n    \"2-0\": \"l\",\n    \"0-1\": \"10\",\n    \"1-1\": \"8\",\n    \"2-1\": \"21\",\n    \"0-2\": \"320x50\",\n    \"1-2\": \"300x250\",\n    \"2-2\": \"320x480\"\n  },\n  \"cols\": 3,\n  \"rows\": 3\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"##Sample HtmlBanner response - when al=s\\n\\n{\\n  \\\"status\\\": \\\"ok\\\",\\n  \\\"ads\\\": [\\n    {\\n      \\\"link\\\": \\\"http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AV\\\",\\n       \\\"assetgroupid\\\": 10, //Possible values 10,8,21 depending on the ad layout requested\\n      \\\"assets\\\": [\\n        {\\n          \\\"type\\\": \\\"htmlbanner\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 320,\\n            \\\"h\\\": 50,\\n            \\\"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>\\\"\\n          }\\n        }\\n      ],\\n      \\\"meta\\\": [\\n        {\\n          \\\"type\\\": \\\"contentinfo\\\",\\n          \\\"data\\\": {\\n            \\\"link\\\": \\\"http://pubnative.net/content-info\\\",\\n            \\\"icon\\\": \\\"http://cdn.pubnative.net/static/adserver/contentinfo.png\\\",\\n            \\\"text\\\": \\\"Learn about this ad\\\"\\n          }\\n        }\\n      ],\\n      \\\"beacons\\\": [\\n        {\\n          \\\"type\\\": \\\"impression\\\",\\n          \\\"data\\\": {\\n            \\\"url\\\": \\\"http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455\\\"\\n          }\\n        }\\n      ]\\n    }\\n  ]\\n}\\n\\n\\n\\n\\n\",\n      \"language\": \"json\",\n      \"name\": \"Ad Layout `s` HTML Banner\"\n    },\n    {\n      \"code\": \"##Sample HtmlBanner - when al=m\\n\\n{\\n  \\\"status\\\": \\\"ok\\\",\\n  \\\"ads\\\": [\\n    {\\n      \\\"link\\\": \\\"http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AV\\\",\\n       \\\"assetgroupid\\\": 10, //Possible values 10,8,21 depending on the ad layout requested\\n      \\\"assets\\\": [\\n        {\\n          \\\"type\\\": \\\"htmlbanner\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 300,\\n            \\\"h\\\": 250,\\n            \\\"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>\\\"\\n          }\\n        }\\n      ],\\n      \\\"meta\\\": [\\n        {\\n          \\\"type\\\": \\\"contentinfo\\\",\\n          \\\"data\\\": {\\n            \\\"link\\\": \\\"http://pubnative.net/content-info\\\",\\n            \\\"icon\\\": \\\"http://cdn.pubnative.net/static/adserver/contentinfo.png\\\",\\n            \\\"text\\\": \\\"Learn about this ad\\\"\\n          }\\n        }\\n      ],\\n      \\\"beacons\\\": [\\n        {\\n          \\\"type\\\": \\\"impression\\\",\\n          \\\"data\\\": {\\n            \\\"url\\\": \\\"http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455\\\"\\n          }\\n        }\\n      ]\\n    }\\n  ]\\n}\\n\\n\\n\\n\\n\",\n      \"language\": \"json\",\n      \"name\": \"Ad Layout `m` HTML Banner\"\n    },\n    {\n      \"code\": \"##Sample HtmlBanner - when al=l\\n{\\n  \\\"status\\\": \\\"ok\\\",\\n  \\\"ads\\\": [\\n    {\\n      \\\"link\\\": \\\"http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AV\\\",\\n       \\\"assetgroupid\\\": 21, //Possible values 10,8,21 depending on the ad layout requested\\n      \\\"assets\\\": [\\n        {\\n          \\\"type\\\": \\\"htmlbanner\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 320,\\n            \\\"h\\\": 480,\\n            \\\"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>\\\"\\n          }\\n        }\\n      ],\\n      \\\"meta\\\": [\\n        {\\n          \\\"type\\\": \\\"contentinfo\\\",\\n          \\\"data\\\": {\\n            \\\"link\\\": \\\"http://pubnative.net/content-info\\\",\\n            \\\"icon\\\": \\\"http://cdn.pubnative.net/static/adserver/contentinfo.png\\\",\\n            \\\"text\\\": \\\"Learn about this ad\\\"\\n          }\\n        }\\n      ],\\n      \\\"beacons\\\": [\\n        {\\n          \\\"type\\\": \\\"impression\\\",\\n          \\\"data\\\": {\\n            \\\"url\\\": \\\"http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455\\\"\\n          }\\n        }\\n      ]\\n    }\\n  ]\\n}\\n\",\n      \"language\": \"json\",\n      \"name\": \"Ad Layout `l` HTML Banner\"\n    }\n  ]\n}\n[/block]\n##Meta types\n* 'points' specifies the payout associated with the campaign (1000 points =$1.00)\n* 'revenuemodel' is the revenue model of the campaign returned.\n* 'bundleid' is the bundle id of the app associated with the campaign.\n* 'contentinfo' provides an easy access to users to Pubnative´s privacy policy.\n* 'campaignid' is the campaign id of the app associated with the campaign.\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"\\\"meta\\\": [\\n        {\\n          \\\"type\\\": \\\"points\\\",\\n          \\\"data\\\": {\\n            \\\"number\\\": 2420\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"revenuemodel\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"cpa\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"campaignid\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"3229480\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"creativeid\\\",\\n          \\\"data\\\": {}\\n        },\\n\\t\\t\\t\\t{\\n          \\\"type\\\": \\\"contentinfo\\\",\\n          \\\"data\\\": {\\n          \\\"link\\\": \\\"http://pubnative.net/content-info\\\",\\n          \\\"icon\\\": \\\"http://cdn.pubnative.net/static/adserver/pnadchoices.png\\\",\\n          \\\"text\\\": \\\"Learn about this ad\\\"\\n                  }\\n        },\\n        {\\n        \\\"type\\\": \\\"bundleid\\\",\\n        \\\"data\\\": {}\\n        }\\n      ]\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n## Beacon Type\n\nPubnative response contain following beacon types:\n\n**1. Impression beacon - Type URL**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"\\\"beacons\\\": [\\n        {\\n      \\\"type\\\": \\\"impression\\\",\\n\\t\\t\\t\\\"data\\\": {\\n\\t\\t  \\\"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\\\"\\n\\t\\t\\t}\\n\\t\\t}, {\\n\\t\\t\\t\\\"type\\\": \\\"impression\\\",\\n\\t\\t\\t\\\"data\\\": {\\n\\t\\t\\t\\\"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\\\"\\n          }\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n**2. Impression beacon - Type JS**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"\\\"beacons\\\": [\\n         {\\n          \\\"type\\\": \\\"impression\\\",\\n          \\\"data\\\": {\\n            \\\"js\\\": \\\"<script></script>\\\"\\n          }\\n        }\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n**2. Click Beacon - Type URL**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"\\\"beacons\\\": [\\n        {\\n         \\t\\\"type\\\": \\\"click\\\",\\n\\t\\t\\t\\\"data\\\": {\\n\\t\\t\\t\\t\\\"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\\\"\\n\\t\\t\\t}\\n\\t\\t}, {\\n\\t\\t\\t\\\"type\\\": \\\"click\\\",\\n\\t\\t\\t\\\"data\\\": {\\n\\t\\t\\t\\t\\\"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\\\"\\n          }\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<div class=\\\"isa_info\\\">\\n  <b>Impression and click beacons MUST be confirmed client side</b>. PubNative provides a complex mix of demand sources from premium advertisers to performance marketing partners and OpenRTB exchanges. The programmatic buyers are paying only when their impressions and clicks are confirmed in real-time. That is why it is essential to confirm the impression and click beacons in real time.\\n<p>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.</p>\\n<dl>\\n  <dt>How are impression and click beacons confirmed?</dt>\\n  \\t<dd>\\n      <ul>\\n        <li>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.</li>\\n        <li>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.</li>\\n      </ul>\\n  \\t</dd>\\n<p><b>Note:</b> 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.</p>     \\n</div> \"\n}\n[/block]\n## Ad layout sample response\n\nQuick recap of the above-mentioned information, below is sample responses for ad layouts type - s, m, l\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"status\\\": \\\"ok\\\",\\n  \\\"ads\\\": [\\n    {\\n      \\\"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\\\",\\n      \\\"assetgroupid\\\": 2,\\n      \\\"assets\\\": [\\n        {\\n          \\\"type\\\": \\\"icon\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 80,\\n            \\\"h\\\": 80,\\n            \\\"url\\\": \\\"http://cdn.pubnative.net/games/icons/001/015/256/dimension_80x80.jpg?20161025074858\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"title\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"Coin Dozer: Haunted\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"description\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"Suchst Du eine neue, coole App? Lade mich jetzt runter.\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"cta\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"Installieren\\\"\\n          }\\n        }\\n      ],\\n      \\\"meta\\\": [\\n        {\\n          \\\"type\\\": \\\"points\\\",\\n          \\\"data\\\": {\\n            \\\"number\\\": 380\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"revenuemodel\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"cpa\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"campaignid\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"4873307\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"creativeid\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"\\\"\\n          }\\n        }\\n      ],\\n      \\\"beacons\\\": [\\n        {\\n          \\\"type\\\": \\\"impression\\\",\\n          \\\"data\\\": {\\n            \\\"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\\\"\\n          }\\n        }\\n      ]\\n    }\\n  ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Sample response for ad layout `s`\"\n    },\n    {\n      \"code\": \"{\\n  \\\"status\\\": \\\"ok\\\",\\n  \\\"ads\\\": [\\n    {\\n      \\\"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\\\",\\n      \\\"assetgroupid\\\": 5,\\n      \\\"assets\\\": [\\n        {\\n          \\\"type\\\": \\\"icon\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 80,\\n            \\\"h\\\": 80,\\n            \\\"url\\\": \\\"http://cdn.pubnative.net/games/icons/001/005/541/dimension_80x80.jpg?20161025053515\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"banner\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 1200,\\n            \\\"h\\\": 627,\\n            \\\"url\\\": \\\"http://cdn.pubnative.net/games/promo_images_landscape/default/2_dimension_1200x627.jpg\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"title\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"PAYBACK - Coupons & Gutscheine\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"description\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"Suchst Du eine neue, coole App? Lade mich jetzt runter.\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"rating\\\",\\n          \\\"data\\\": {\\n            \\\"number\\\": 4\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"cta\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"Installieren\\\"\\n          }\\n        }\\n      ],\\n      \\\"meta\\\": [\\n        {\\n          \\\"type\\\": \\\"points\\\",\\n          \\\"data\\\": {\\n            \\\"number\\\": 860\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"revenuemodel\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"cpa\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"campaignid\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"4816214\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"creativeid\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"\\\"\\n          }\\n        }\\n      ],\\n      \\\"beacons\\\": [\\n        {\\n          \\\"type\\\": \\\"impression\\\",\\n          \\\"data\\\": {\\n            \\\"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\\\"\\n          }\\n        }\\n      ]\\n    }\\n  ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Sample response for ad layout `m`\"\n    },\n    {\n      \"code\": \"{\\n  \\\"status\\\": \\\"ok\\\",\\n  \\\"ads\\\": [\\n    {\\n      \\\"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\\\",\\n      \\\"assetgroupid\\\": 16,\\n      \\\"assets\\\": [\\n        {\\n          \\\"type\\\": \\\"icon\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 80,\\n            \\\"h\\\": 80,\\n            \\\"url\\\": \\\"http://cdn.pubnative.net/games/icons/001/003/592/dimension_80x80.jpg?20161025001049\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"banner\\\",\\n          \\\"data\\\": {\\n            \\\"w\\\": 1200,\\n            \\\"h\\\": 627,\\n            \\\"url\\\": \\\"http://cdn.pubnative.net/games/promo_images_landscape/001/003/592/dimension_1200x627.jpg?20160622190318\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"title\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"LOVOO Chat, Flirt, Neue Leute\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"description\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"Erfolglose Flirts im Café oder doofe Anmachsprüche im Club gehören hiermit der Vergangenheit an!\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"rating\\\",\\n          \\\"data\\\": {\\n            \\\"number\\\": 4\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"cta\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"Installieren\\\"\\n          }\\n        }\\n      ],\\n      \\\"meta\\\": [\\n        {\\n          \\\"type\\\": \\\"creativeid\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"points\\\",\\n          \\\"data\\\": {\\n            \\\"number\\\": 380\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"revenuemodel\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"cpa\\\"\\n          }\\n        },\\n        {\\n          \\\"type\\\": \\\"campaignid\\\",\\n          \\\"data\\\": {\\n            \\\"text\\\": \\\"4897669\\\"\\n          }\\n        }\\n      ],\\n      \\\"beacons\\\": [\\n        {\\n          \\\"type\\\": \\\"impression\\\",\\n          \\\"data\\\": {\\n            \\\"url\\\": \\\"http://tr.pubnative.net/impression?aid=1004319&t=UjDL5E6i1M2BSWmv3XSt-a-iiIT_FAmofG6DcIKtrTIzw_qtVwvNJOg0k2izojP5p_oG-39qAD2aqwnCo5RvGMzTrwesUBvnw8a4tH8zZkijFH93230GJnu3GkNTlNvWz7xvNkGhm0Cxf7QXFhKquFLj_iSP8tyCrdEfdvngSbJTo6KH1DZMgvgp7b9ppesmvr2h8RAjkbHTAMLHKU4Edx68t5EEglElXMgQSTwRPANPVWZNHSiq0s_tlb8EpIg9oD0c4RxNtBLS2o4jHBiocXdJPhL7ZDR4FUFyBHdr9qo7gjLdNtsGBFZDpW2u0sFbSo5Gz94FZxPxqv7JPOBMNBNzbhQ2vmSSIqVLROdoit8PQhQoLaHzM2lcqJU3ulPl1NwHVmBZluVnk18ODZI6IR2YFgat3dDugxaOLQw7RDEgdykmFzK98CFQCyqN&tl=444\\\"\\n          }\\n        }\\n      ]\\n    }\\n  ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Sample response for ad layout `l`\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"How to use?\"\n}\n[/block]\n  * The server generates a GET request to the relevant ad-format together with the url param, the server returns a json response.\n  *  The server parses the json according to the ad-format \n  * When the ad is shown, our server must be notified about the impression\n  * When user clicks on the ad, the server should redirect to the URL which is specified in ad's click_url:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"\\\"ads\\\": [\\n    {\\n      \\\"link\\\": \\\"http://tr.pubnative.net/click/native?aid=4&t=qyaUDc7fF-_rqXR6BLs_t9z2cpmf_SpRnCmC-r7BpFpxRSBSM_LdwFFbF5yN9Tdz7mkuMpTws22UFVb24k4TmeQRGqSStKi3CzFmqppwCiLPxGANFs88oQlWiex6kqFXZbubHWjBKb9ZdBWrKzgnCmEREdAOEMDvV3W8MVQ-loUv5cgnlQF-gXf-wsBKAytCF4m6zQN2w-TcUYkGH......\\\"\\n\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<div class=\\\"isa_info\\\">\\n  <b>Revenue Models Supported:</b>. \\n<ul>\\n  <li>CPA or Cost Per Action, which means that users have to download and open th eapp for conversion</li>\\n  <li>CPC or Cost Per Click</li>\\n  <li>CPM or Cost Per Mille, which is a cost for every 1000 impresssions</li>\\n</ul>\\n  <p> </p>\\n  <b>Points Calculation:</b>\\n  <ul>\\n    <li>CPA campaign: 1 point = 0.001 USD per conversion</li>\\n    <li>CPM campaign: 1 point = 0.001 USD per 1000 impressions</li>\\n    <li>CPC campaign: 1 point = 0.001 USD per click</li>\\n  </ul>\\n  <p>If the points value is 0, please send notification to the PubNative team</p>\\n</div> \"\n}\n[/block]\n## Frequently Asked Questions\n\n**1. What is impression confirmation?**\nWhen the ad is shown, our server must be notified about the impression in order to track the campaign performance correctly.\n\n**2. Why is impression confirmation required?**\nThe 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.\n\n[block:html]\n{\n  \"html\": \"<div class=\\\"isa_info\\\">\\n  <b>Use all available parameters</b>. \\n<p>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.</p>\\n</div> \"\n}\n[/block]\n## Adding Postback\n\nIf you wish to receive conversion postback of certain parameter you send (example: Click ID) please follow below steps:\n* At the end of API click_url, add \"&aff_sub={YourClickID}\"\n* Example: https://tr.pubnative.net/tracking/click?aid=1001000&t=...&aff_sub={YourClickID} \nPlease send PubNative team your postback URL with Click ID parameter\nAfter setting up PubNative team will guide you through the test\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Checklist Before Activation\"\n}\n[/block]\nAfter the integration is complete, all that remains is to test the integration and make sure everything is working fine. All for your users' sake.\n\n##Request\n  * Your request URL includes all required parameters with correct value\n  * Your request URL includes user identifiers. (Android Advertiser ID or Apple IDFA)\n  * Your request URL have to include adchoices (mf=contentinfo)\n  * You are sending requests when user reaches the ad inventory and with planned frequency.\n  * 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.\n \n##Response\n   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.\n \n##Impression\n  * You are confirming impressions when the user sees the ad for the first time for a minimum duration of 1 second.\n  * You are confirming impressions immediately, in real-time.\n  * You shouldn’t confirm impressions twice, even if the user sees the same ad again. One (initial) confirmation is enough.\n  * You should confirm multiple impression beacons\n\n \n##Clicks\n  * Click happens when the user clicks the advertisement which is linked with the click URL PubNative provides.\n  * The click event has to be done by a genuine user and should not be an automated bot or incentivized (rewarded) click.\n  * Depending on the type of campaign (app promotion or mobile landing page) the redirect behaviour should be considered\n  * for App promotion campaigns, background redirect (hidden browser/webview) is permitted in order to maintain the user experience\n  * 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 \n\n\n**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!**\n\n**If you have any questions, don’t hesitate to get in touch: support:::at:::pubnative.net**\n[block:html]\n{\n  \"html\": \"<style>\\n.isa_info {\\nmargin: 10px 0px !important;\\npadding:12px !important;\\n}\\n\\n.isa_info {\\n    color: #424242 !important;\\n    background-color: #dcdcdc !important;\\n}\\n\\n.isa_info i {\\n    margin:10px 22px !important;\\n    font-size:16px !important;\\n    vertical-align:middle !important;\\n}\\n  \\n</style>\"\n}\n[/block]","excerpt":"","slug":"client-api-v30","type":"endpoint","title":"Client API v3.0"}

getClient API v3.0


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

apptoken:
required
string
This is your internal app token that you fetch from the publisher dashboard.
os:
required
string
The operating system of requesting device. Possible values: ios, android
osver:
required
string
The operating system version of the requesting device
devicemodel:
required
string
The model name of the device
dnt:
required
string1
This field specifies if the user related information should be tracked by Pubnative. 0 - Track user ; 1 - Do not track user
al:
required
string
Ad layouts that need to be requested. Possible values: s,m,l
mf:
required
string
Specify the meta data . Possible values: points, revenuemodel, campaignid, creativeid,contentinfo
zoneid:
required
string
The ad zone identifier. Zones need to be created in the PubNative Dashboard prior to use.

Examples


Result Format


Documentation

##Additional Request Parameters [block:parameters] { "data": { "h-0": "Parameter", "h-1": "Format", "h-2": "Description", "2-0": "srvi", "3-0": "uid", "4-0": "adcount", "5-0": "ua", "6-0": "ip", "7-0": "locale", "8-0": "lat", "9-0": "long", "10-0": "gender", "11-0": "age", "14-0": "keywords", "15-0": "secure", "16-0": "idfamd5", "17-0": "idfasha1", "18-0": "gidmd5", "19-0": "gidsha1", "2-1": "Boolean", "2-2": "1 - server to server integration. If set to 1, need to pass set ip and ua.", "3-2": "User identifier. Recommended when idfa and gid cannot be passed", "4-2": "Number of Apps to return. Possible values: 1 (default) to 20", "5-2": "User Agent String. Required when srvi is set to 1.", "6-2": "IP address of the client device", "7-2": "The locale used. i.e. DE", "8-2": "The current latitude of the requesting device. Don´t send param if value is unknown.", "9-2": "The current longitude of the requesting device. Don't send param if value is unknown.", "10-2": "User's gender. Possible values: \"m\", \"f\"", "11-2": "User's age", "14-2": "A comma separated list of keywords", "15-2": "Default http; can use https secure parameter for overriding", "16-2": "Apple ID for Advertising (md5)", "17-2": "Apple ID for Advertising (sha1)", "18-2": "Android Advertiser Id(md5)", "19-2": "Android Advertiser Id(sha1)", "3-1": "String", "4-1": "String", "5-1": "String", "6-1": "String", "7-1": "String", "8-1": "String", "9-1": "String", "10-1": "String", "11-1": "String", "14-1": "String", "15-1": "String", "16-1": "String", "17-1": "String", "18-1": "String", "19-1": "String", "0-0": "idfa", "1-0": "gid", "0-1": "String. \nRequired when request generated from a Apple device", "1-1": "String. \nRequired when request generated from a Android device", "0-2": "Apple ID for Advertising.", "1-2": "Google Android ID for Advertising.", "13-0": "bundleid", "13-1": "String", "13-2": "The bundle identifier of the requesting app. i.e. com.my.app, 422689480", "12-0": "coppa", "12-1": "String", "12-2": "Flag indicating if this request is subject to the COPPA regulations established by the FTC, where 0 = no, 1 = yes." }, "cols": 3, "rows": 20 } [/block] [block:html] { "html": "<div class=\"isa_info\">\n<b>Ad layouts</b>\n<p>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)\n<br>\nEach 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</p> \n</div> " } [/block] [block:api-header] { "type": "basic", "title": "Response" } [/block] ## Response structure [block:parameters] { "data": { "h-0": "Field/Object", "h-1": "Description", "h-2": "Format", "h-3": "RTB Compatiable", "0-0": "link", "1-0": "assets object", "2-0": "meta object", "3-0": "beacons object", "0-1": "Click through URL", "1-1": "Asset object contains information of all assets requested via the 'al' parameter.", "2-1": "Meta object contains information of all meta properties requested via the 'mf' parameter", "3-1": "Beacons Object contains URL beacon used to confirm impressions", "0-2": "string", "1-2": "object", "2-2": "object", "3-2": "url", "0-3": "YES", "1-3": "YES", "2-3": "YES", "3-3": "YES" }, "cols": 3, "rows": 4 } [/block] # 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. [block:code] { "codes": [ { "code": "##Sample Icon Asset\n{\n \"type\": \"icon\",\n \"data\": {\n \"w\": 80,\n \"h\": 80,\n \"url\": \"http://cdn.pubnative.net/games/icons/001/010/700/dimension_80x80.jpg?20160706190952\"\n }\n }\n\n##Sample Banner Asset\n{\n \"type\": \"banner\",\n \"data\": {\n \"w\": 1200,\n \"h\": 627,\n \"url\": \"http://cdn.pubnative.net/games/promo_images_landscape/001/010/700/dimension_1200x627.jpg?20160622183653\"\n }\n}\n##Sample Title Asset\n{\n \"type\": \"title\",\n \"data\": {\n \"text\": \"Sonax Scheiben- und FensterTuch 1 Stück\"\n }\n}\n##Sample Description Asset\n \n{\n \"type\": \"description\",\n \"data\": {\n \"text\": \"Suchst Du eine neue, coole App? Lade mich jetzt runter.\"\n }\n}\n\n##Sample CTA Asset\n{\n \"type\": \"cta\",\n \"data\": {\n \"text\": \"Learn More\"\n }\n}\n\n ", "language": "json" } ] } [/block] # Banner Ads Pubnative serves banner ads for each ad layout - `s`, `m`, `l`. [block:callout] { "type": "success", "title": "Access banner Ads", "body": "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 -" } [/block] Banner ads can be returned as two creative types - - ## URL Based on the ad layout requested Pubnative will return banner ads in the following dimensions - [block:parameters] { "data": { "h-0": "Ad Layout", "h-1": "Asset Group id", "h-2": "Dimension", "0-0": "s", "1-0": "m", "2-0": "l", "0-1": "9", "1-1": "7", "2-1": "13", "0-2": "320x50", "1-2": "300x250", "2-2": "320x480" }, "cols": 3, "rows": 3 } [/block] [block:code] { "codes": [ { "code": "##Sample StandardBanner ad layout = s\n\n{\n \"status\": \"ok\",\n \"ads\": [\n {\n \"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\",\n \"assetgroupid\": 9,Possible values 7,9,13 depending on the ad layout requested\n \"assets\": [\n {\n \"type\": \"standardbanner\",\n \"data\": {\n \"w\": 320,\n \"h\": 50,\n \"url\": \"http://cdn.pubnative.net/games/promo_images_landscape/001/010ssssnsion_1200x627.jpg?20160622183653\"\n }\n }\n ],\n \"beacons\": [\n {\n \"type\": \"impression\",\n \"data\": {\n \"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\"\n }\n }\n ]\n }\n ]\n}", "language": "json", "name": "Ad Layout `s` Banner" }, { "code": "##Sample StandardBanner ad layout = m\n\n{\n \"status\": \"ok\",\n \"ads\": [\n {\n \"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\",\n \"assetgroupid\": 7,Possible values 7,9,13 depending on the ad layout requested\n \"assets\": [\n {\n \"type\": \"standardbanner\",\n \"data\": {\n \"w\": 320,\n \"h\": 50,\n \"url\": \"http://cdn.pubnative.net/games/promo_images_landscape/001/010ssssnsion_1200x627.jpg?20160622183653\"\n }\n }\n ],\n \"beacons\": [\n {\n \"type\": \"impression\",\n \"data\": {\n \"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\"\n }\n }\n ]\n }\n ]\n}", "language": "json", "name": "Ad Layout `m` Banner" }, { "code": "##Sample StandardBanner ad layout = l\n\n{\n \"status\": \"ok\",\n \"ads\": [\n {\n \"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\",\n \"assetgroupid\": 13,Possible values 7,9,13 depending on the ad layout requested\n \"assets\": [\n {\n \"type\": \"standardbanner\",\n \"data\": {\n \"w\": 320,\n \"h\": 480,\n \"url\": \"http://cdn.pubnative.net/games/promo_images_landscape/001/010ssssnsion_1200x627.jpg?20160622183653\"\n }\n }\n ],\n \"beacons\": [\n {\n \"type\": \"impression\",\n \"data\": {\n \"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\"\n }\n }\n ]\n }\n ]\n}", "language": "json", "name": "Ad Layout `l` Banner" } ] } [/block] - ## HTML banner Based on the ad layout requested Pubnative will return banner ads in the following dimensions - [block:parameters] { "data": { "h-0": "Ad Layout", "h-1": "Asset Group", "h-2": "Dimension", "0-0": "s", "1-0": "m", "2-0": "l", "0-1": "10", "1-1": "8", "2-1": "21", "0-2": "320x50", "1-2": "300x250", "2-2": "320x480" }, "cols": 3, "rows": 3 } [/block] [block:code] { "codes": [ { "code": "##Sample HtmlBanner response - when al=s\n\n{\n \"status\": \"ok\",\n \"ads\": [\n {\n \"link\": \"http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AV\",\n \"assetgroupid\": 10, //Possible values 10,8,21 depending on the ad layout requested\n \"assets\": [\n {\n \"type\": \"htmlbanner\",\n \"data\": {\n \"w\": 320,\n \"h\": 50,\n \"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>\"\n }\n }\n ],\n \"meta\": [\n {\n \"type\": \"contentinfo\",\n \"data\": {\n \"link\": \"http://pubnative.net/content-info\",\n \"icon\": \"http://cdn.pubnative.net/static/adserver/contentinfo.png\",\n \"text\": \"Learn about this ad\"\n }\n }\n ],\n \"beacons\": [\n {\n \"type\": \"impression\",\n \"data\": {\n \"url\": \"http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455\"\n }\n }\n ]\n }\n ]\n}\n\n\n\n\n", "language": "json", "name": "Ad Layout `s` HTML Banner" }, { "code": "##Sample HtmlBanner - when al=m\n\n{\n \"status\": \"ok\",\n \"ads\": [\n {\n \"link\": \"http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AV\",\n \"assetgroupid\": 10, //Possible values 10,8,21 depending on the ad layout requested\n \"assets\": [\n {\n \"type\": \"htmlbanner\",\n \"data\": {\n \"w\": 300,\n \"h\": 250,\n \"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>\"\n }\n }\n ],\n \"meta\": [\n {\n \"type\": \"contentinfo\",\n \"data\": {\n \"link\": \"http://pubnative.net/content-info\",\n \"icon\": \"http://cdn.pubnative.net/static/adserver/contentinfo.png\",\n \"text\": \"Learn about this ad\"\n }\n }\n ],\n \"beacons\": [\n {\n \"type\": \"impression\",\n \"data\": {\n \"url\": \"http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455\"\n }\n }\n ]\n }\n ]\n}\n\n\n\n\n", "language": "json", "name": "Ad Layout `m` HTML Banner" }, { "code": "##Sample HtmlBanner - when al=l\n{\n \"status\": \"ok\",\n \"ads\": [\n {\n \"link\": \"http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AV\",\n \"assetgroupid\": 21, //Possible values 10,8,21 depending on the ad layout requested\n \"assets\": [\n {\n \"type\": \"htmlbanner\",\n \"data\": {\n \"w\": 320,\n \"h\": 480,\n \"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>\"\n }\n }\n ],\n \"meta\": [\n {\n \"type\": \"contentinfo\",\n \"data\": {\n \"link\": \"http://pubnative.net/content-info\",\n \"icon\": \"http://cdn.pubnative.net/static/adserver/contentinfo.png\",\n \"text\": \"Learn about this ad\"\n }\n }\n ],\n \"beacons\": [\n {\n \"type\": \"impression\",\n \"data\": {\n \"url\": \"http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455\"\n }\n }\n ]\n }\n ]\n}\n", "language": "json", "name": "Ad Layout `l` HTML Banner" } ] } [/block] ##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. [block:code] { "codes": [ { "code": "\"meta\": [\n {\n \"type\": \"points\",\n \"data\": {\n \"number\": 2420\n }\n },\n {\n \"type\": \"revenuemodel\",\n \"data\": {\n \"text\": \"cpa\"\n }\n },\n {\n \"type\": \"campaignid\",\n \"data\": {\n \"text\": \"3229480\"\n }\n },\n {\n \"type\": \"creativeid\",\n \"data\": {}\n },\n\t\t\t\t{\n \"type\": \"contentinfo\",\n \"data\": {\n \"link\": \"http://pubnative.net/content-info\",\n \"icon\": \"http://cdn.pubnative.net/static/adserver/pnadchoices.png\",\n \"text\": \"Learn about this ad\"\n }\n },\n {\n \"type\": \"bundleid\",\n \"data\": {}\n }\n ]", "language": "json" } ] } [/block] ## Beacon Type Pubnative response contain following beacon types: **1. Impression beacon - Type URL** [block:code] { "codes": [ { "code": "\"beacons\": [\n {\n \"type\": \"impression\",\n\t\t\t\"data\": {\n\t\t \"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\"\n\t\t\t}\n\t\t}, {\n\t\t\t\"type\": \"impression\",\n\t\t\t\"data\": {\n\t\t\t\"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\"\n }", "language": "json" } ] } [/block] **2. Impression beacon - Type JS** [block:code] { "codes": [ { "code": "\"beacons\": [\n {\n \"type\": \"impression\",\n \"data\": {\n \"js\": \"<script></script>\"\n }\n }", "language": "json" } ] } [/block] **2. Click Beacon - Type URL** [block:code] { "codes": [ { "code": "\"beacons\": [\n {\n \t\"type\": \"click\",\n\t\t\t\"data\": {\n\t\t\t\t\"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\"\n\t\t\t}\n\t\t}, {\n\t\t\t\"type\": \"click\",\n\t\t\t\"data\": {\n\t\t\t\t\"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\"\n }", "language": "json" } ] } [/block] [block:html] { "html": "<div class=\"isa_info\">\n <b>Impression and click beacons MUST be confirmed client side</b>. PubNative provides a complex mix of demand sources from premium advertisers to performance marketing partners and OpenRTB exchanges. The programmatic buyers are paying only when their impressions and clicks are confirmed in real-time. That is why it is essential to confirm the impression and click beacons in real time.\n<p>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.</p>\n<dl>\n <dt>How are impression and click beacons confirmed?</dt>\n \t<dd>\n <ul>\n <li>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.</li>\n <li>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.</li>\n </ul>\n \t</dd>\n<p><b>Note:</b> 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.</p> \n</div> " } [/block] ## Ad layout sample response Quick recap of the above-mentioned information, below is sample responses for ad layouts type - s, m, l [block:code] { "codes": [ { "code": "{\n \"status\": \"ok\",\n \"ads\": [\n {\n \"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\",\n \"assetgroupid\": 2,\n \"assets\": [\n {\n \"type\": \"icon\",\n \"data\": {\n \"w\": 80,\n \"h\": 80,\n \"url\": \"http://cdn.pubnative.net/games/icons/001/015/256/dimension_80x80.jpg?20161025074858\"\n }\n },\n {\n \"type\": \"title\",\n \"data\": {\n \"text\": \"Coin Dozer: Haunted\"\n }\n },\n {\n \"type\": \"description\",\n \"data\": {\n \"text\": \"Suchst Du eine neue, coole App? Lade mich jetzt runter.\"\n }\n },\n {\n \"type\": \"cta\",\n \"data\": {\n \"text\": \"Installieren\"\n }\n }\n ],\n \"meta\": [\n {\n \"type\": \"points\",\n \"data\": {\n \"number\": 380\n }\n },\n {\n \"type\": \"revenuemodel\",\n \"data\": {\n \"text\": \"cpa\"\n }\n },\n {\n \"type\": \"campaignid\",\n \"data\": {\n \"text\": \"4873307\"\n }\n },\n {\n \"type\": \"creativeid\",\n \"data\": {\n \"text\": \"\"\n }\n }\n ],\n \"beacons\": [\n {\n \"type\": \"impression\",\n \"data\": {\n \"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\"\n }\n }\n ]\n }\n ]\n}", "language": "json", "name": "Sample response for ad layout `s`" }, { "code": "{\n \"status\": \"ok\",\n \"ads\": [\n {\n \"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\",\n \"assetgroupid\": 5,\n \"assets\": [\n {\n \"type\": \"icon\",\n \"data\": {\n \"w\": 80,\n \"h\": 80,\n \"url\": \"http://cdn.pubnative.net/games/icons/001/005/541/dimension_80x80.jpg?20161025053515\"\n }\n },\n {\n \"type\": \"banner\",\n \"data\": {\n \"w\": 1200,\n \"h\": 627,\n \"url\": \"http://cdn.pubnative.net/games/promo_images_landscape/default/2_dimension_1200x627.jpg\"\n }\n },\n {\n \"type\": \"title\",\n \"data\": {\n \"text\": \"PAYBACK - Coupons & Gutscheine\"\n }\n },\n {\n \"type\": \"description\",\n \"data\": {\n \"text\": \"Suchst Du eine neue, coole App? Lade mich jetzt runter.\"\n }\n },\n {\n \"type\": \"rating\",\n \"data\": {\n \"number\": 4\n }\n },\n {\n \"type\": \"cta\",\n \"data\": {\n \"text\": \"Installieren\"\n }\n }\n ],\n \"meta\": [\n {\n \"type\": \"points\",\n \"data\": {\n \"number\": 860\n }\n },\n {\n \"type\": \"revenuemodel\",\n \"data\": {\n \"text\": \"cpa\"\n }\n },\n {\n \"type\": \"campaignid\",\n \"data\": {\n \"text\": \"4816214\"\n }\n },\n {\n \"type\": \"creativeid\",\n \"data\": {\n \"text\": \"\"\n }\n }\n ],\n \"beacons\": [\n {\n \"type\": \"impression\",\n \"data\": {\n \"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\"\n }\n }\n ]\n }\n ]\n}", "language": "json", "name": "Sample response for ad layout `m`" }, { "code": "{\n \"status\": \"ok\",\n \"ads\": [\n {\n \"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\",\n \"assetgroupid\": 16,\n \"assets\": [\n {\n \"type\": \"icon\",\n \"data\": {\n \"w\": 80,\n \"h\": 80,\n \"url\": \"http://cdn.pubnative.net/games/icons/001/003/592/dimension_80x80.jpg?20161025001049\"\n }\n },\n {\n \"type\": \"banner\",\n \"data\": {\n \"w\": 1200,\n \"h\": 627,\n \"url\": \"http://cdn.pubnative.net/games/promo_images_landscape/001/003/592/dimension_1200x627.jpg?20160622190318\"\n }\n },\n {\n \"type\": \"title\",\n \"data\": {\n \"text\": \"LOVOO Chat, Flirt, Neue Leute\"\n }\n },\n {\n \"type\": \"description\",\n \"data\": {\n \"text\": \"Erfolglose Flirts im Café oder doofe Anmachsprüche im Club gehören hiermit der Vergangenheit an!\"\n }\n },\n {\n \"type\": \"rating\",\n \"data\": {\n \"number\": 4\n }\n },\n {\n \"type\": \"cta\",\n \"data\": {\n \"text\": \"Installieren\"\n }\n }\n ],\n \"meta\": [\n {\n \"type\": \"creativeid\",\n \"data\": {\n \"text\": \"\"\n }\n },\n {\n \"type\": \"points\",\n \"data\": {\n \"number\": 380\n }\n },\n {\n \"type\": \"revenuemodel\",\n \"data\": {\n \"text\": \"cpa\"\n }\n },\n {\n \"type\": \"campaignid\",\n \"data\": {\n \"text\": \"4897669\"\n }\n }\n ],\n \"beacons\": [\n {\n \"type\": \"impression\",\n \"data\": {\n \"url\": \"http://tr.pubnative.net/impression?aid=1004319&t=UjDL5E6i1M2BSWmv3XSt-a-iiIT_FAmofG6DcIKtrTIzw_qtVwvNJOg0k2izojP5p_oG-39qAD2aqwnCo5RvGMzTrwesUBvnw8a4tH8zZkijFH93230GJnu3GkNTlNvWz7xvNkGhm0Cxf7QXFhKquFLj_iSP8tyCrdEfdvngSbJTo6KH1DZMgvgp7b9ppesmvr2h8RAjkbHTAMLHKU4Edx68t5EEglElXMgQSTwRPANPVWZNHSiq0s_tlb8EpIg9oD0c4RxNtBLS2o4jHBiocXdJPhL7ZDR4FUFyBHdr9qo7gjLdNtsGBFZDpW2u0sFbSo5Gz94FZxPxqv7JPOBMNBNzbhQ2vmSSIqVLROdoit8PQhQoLaHzM2lcqJU3ulPl1NwHVmBZluVnk18ODZI6IR2YFgat3dDugxaOLQw7RDEgdykmFzK98CFQCyqN&tl=444\"\n }\n }\n ]\n }\n ]\n}", "language": "json", "name": "Sample response for ad layout `l`" } ] } [/block] [block:api-header] { "type": "basic", "title": "How to use?" } [/block] * 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: [block:code] { "codes": [ { "code": "\"ads\": [\n {\n \"link\": \"http://tr.pubnative.net/click/native?aid=4&t=qyaUDc7fF-_rqXR6BLs_t9z2cpmf_SpRnCmC-r7BpFpxRSBSM_LdwFFbF5yN9Tdz7mkuMpTws22UFVb24k4TmeQRGqSStKi3CzFmqppwCiLPxGANFs88oQlWiex6kqFXZbubHWjBKb9ZdBWrKzgnCmEREdAOEMDvV3W8MVQ-loUv5cgnlQF-gXf-wsBKAytCF4m6zQN2w-TcUYkGH......\"\n", "language": "json" } ] } [/block] [block:html] { "html": "<div class=\"isa_info\">\n <b>Revenue Models Supported:</b>. \n<ul>\n <li>CPA or Cost Per Action, which means that users have to download and open th eapp for conversion</li>\n <li>CPC or Cost Per Click</li>\n <li>CPM or Cost Per Mille, which is a cost for every 1000 impresssions</li>\n</ul>\n <p> </p>\n <b>Points Calculation:</b>\n <ul>\n <li>CPA campaign: 1 point = 0.001 USD per conversion</li>\n <li>CPM campaign: 1 point = 0.001 USD per 1000 impressions</li>\n <li>CPC campaign: 1 point = 0.001 USD per click</li>\n </ul>\n <p>If the points value is 0, please send notification to the PubNative team</p>\n</div> " } [/block] ## 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. [block:html] { "html": "<div class=\"isa_info\">\n <b>Use all available parameters</b>. \n<p>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.</p>\n</div> " } [/block] ## 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 [block:api-header] { "type": "basic", "title": "Checklist Before Activation" } [/block] 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: support@pubnative.net** [block:html] { "html": "<style>\n.isa_info {\nmargin: 10px 0px !important;\npadding:12px !important;\n}\n\n.isa_info {\n color: #424242 !important;\n background-color: #dcdcdc !important;\n}\n\n.isa_info i {\n margin:10px 22px !important;\n font-size:16px !important;\n vertical-align:middle !important;\n}\n \n</style>" } [/block]

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}