Additional Request Parameters

ParameterFormatDescription
idfaString.
Required when request generated from a Apple device
Apple ID for Advertising.
gidString.
Required when request generated from a Android device
Google Android ID for Advertising.
srviBoolean1 - server to server integration. If set to 1, need to pass set ip and ua.
uidStringUser identifier. Recommended when idfa and gid cannot be passed
adcountStringNumber of Apps to return. Possible values: 1 (default) to 20
uaStringUser Agent String. Required when srvi is set to 1.
ipStringIP address of the client device
localeStringThe locale used. i.e. DE
latStringThe current latitude of the requesting device. Don´t send param if value is unknown.
longStringThe current longitude of the requesting device. Don't send param if value is unknown.
genderStringUser's gender. Possible values: "m", "f"
ageStringUser's age
coppaStringFlag indicating if this request is subject to the COPPA regulations established by the FTC, where 0 = no, 1 = yes.
bundleidStringThe bundle identifier of the requesting app. i.e. com.my.app, 422689480
keywordsStringA comma separated list of keywords
secureStringDefault http; can use https secure parameter for overriding
idfamd5StringApple ID for Advertising (md5)
idfasha1StringApple ID for Advertising (sha1)
gidmd5StringAndroid Advertiser Id(md5)
gidsha1StringAndroid Advertiser Id(sha1)
Ad layouts

Ad layouts is a standardized way of requesting specific assets depending upon the size or type of your placement. Possible values s, m, l. (s - small, m - medium, l - large)
Each ad layout consists of a set of asset groups. Each asset group consists of a collection of assets. Possible assets served: icon, banner, title, description, rating, CTA

Response

Response structure

Field/ObjectDescriptionFormat
linkClick through URLstring
assets objectAsset object contains information of all assets requested via the 'al' parameter.object
meta objectMeta object contains information of all meta properties requested via the 'mf' parameterobject
beacons objectBeacons Object contains URL beacon used to confirm impressionsurl

Native Ads

Pubnative serves native ads for each ad layout - s, m, l. Native ads are returned in the form of different assets.

Possible Asset Types returned by Pubnative -

  • Publisher should support the following asset type:
    icon, title, description, rating, banner.
  • The asset type will be mentioned explicitly. Sample asset responses have been mentioned below.
##Sample Icon Asset
{
          "type": "icon",
          "data": {
            "w": 80,
            "h": 80,
            "url": "http://cdn.pubnative.net/games/icons/001/010/700/dimension_80x80.jpg?20160706190952"
          }
        }

##Sample Banner Asset
{
          "type": "banner",
          "data": {
            "w": 1200,
            "h": 627,
            "url": "http://cdn.pubnative.net/games/promo_images_landscape/001/010/700/dimension_1200x627.jpg?20160622183653"
          }
}
##Sample Title Asset
{
          "type": "title",
          "data": {
            "text": "Sonax Scheiben- und FensterTuch 1 Stück"
          }
}
##Sample Description Asset
        
{
          "type": "description",
          "data": {
                        "text": "Suchst Du eine neue, coole App? Lade mich jetzt runter."
                    }
}

##Sample CTA Asset
{
          "type": "cta",
          "data": {
            "text": "Learn More"
          }
}

Banner Ads

Pubnative serves banner ads for each ad layout - s, m, l.

👍

Access banner Ads

By default, Pubnative only serves native ads. If you would like us to start returning banner ads please contact our Account Manager. Please refer to the below section for more details -

  • HTML banner

Based on the ad layout requested Pubnative will return banner ads in the following dimensions.

Ad LayoutAsset GroupDimension
s10320x50
m8300x250
l21320x480
##Sample HtmlBanner response - when al=s

{
  "status": "ok",
  "ads": [
    {
      "link": "http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AV",
       "assetgroupid": 10, //Possible values 10,8,21 depending on the ad layout requested
      "assets": [
        {
          "type": "htmlbanner",
          "data": {
            "w": 320,
            "h": 50,
            "html": "<span class=\"PubAPIAd\"><STYLE>body{margin: auto;}</STYLE><DIV><A target=\"_blank\" href=\"http://track.pubmatic.com/AdServer/AdDisplayTrackerServlet?clickData=JnB1YklkPTE1NTk3NSZzaXRlSWQ9MTU5NjA2JmFkSWQ9ODIwMjE1JmthZHNpemVpZD05JnRsZElkPTAmY2FtcGFpZ25JZD0xNTIwOCZjcmVhdGl2ZUlkPTAmYWRTZXJ2ZXJJZD0yNDMmaW1waWQ9MkY4QjNBMTktQ0EyNy00MzEzLUE1RTEtMEIyNkQ4QzRBNzNEJm1vYmZsYWc9MSZpc21vYmlsZWFwcD0xJmNhcnJpZXJpZD0xNTAmcGFzc2JhY2s9MA==_url=http%3A%2F%2Fclickus.basebanner.com%2Fst%3Fcipid%3D2621000%26excid%3D23%26ttype%3D1%26dast%3Dv1_2621000_-1_3o1_884DB89344267722021886610003__4230937_14ch7_778_884DB8934426772201993852600_n_0_-7041993656288223481_820215____2g_4oa7_0_%26cipp%3D0.0219582271%26excid%3D23%26cisid%3D884DB89344267722021886610003%26pix%3D31581939%26tgt%3Dhttps%253A%252F%252Fwww.glassesusa.com%252Fcoupons-and-promotions%253Fsr%253D7742381\"><IMG border=0 width=300 height=250 id=\"_ci4230937_b4074867\" alt=\"\" src=\"http://d94r1llj8z8wm.clossudfront.net/uploads/1456266446847_300x250-mirror.gif\"/></A>\r\n</DIV>\r\n<script type=\"text/javascript\" src=\"http://imprusmp.basssssebanner.com/st?cipid=2621000&ttype=0&cirid=884DB8934426772201993852600&cicmp=1192487&cijs=1&dast=bXRtZGxpZD0zMjAzMTAwMjU4NyZjbXQ9LTEmZnJtaT0wJm1tdD0tMSZwcnJwPTEwMDAwMC4wJnBmcnA9LTEuMCZleGNpZD0U5OTgwMzQwNDYmc2VydmluZ0RvbWFpbj1iYXNlYmFubmVyLmNvbSZsYXQ9NDkuNDU2MyZsb25nPTguMDgxNCZjaXRicD0wLjAyNTE1Mzg0NjE1Mzg0NjE1&cipp=0.0219582271&excid=23\"></script></span>"
          }
        }
      ],
      "meta": [
        {
          "type": "contentinfo",
          "data": {
            "link": "http://pubnative.net/content-info",
            "icon": "http://cdn.pubnative.net/static/adserver/contentinfo.png",
            "text": "Learn about this ad"
          }
        }
      ],
      "beacons": [
        {
          "type": "impression",
          "data": {
            "url": "http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455"
          }
        }
      ]
    }
  ]
}
##Sample HtmlBanner - when al=m

{
  "status": "ok",
  "ads": [
    {
      "link": "http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AV",
       "assetgroupid": 10, //Possible values 10,8,21 depending on the ad layout requested
      "assets": [
        {
          "type": "htmlbanner",
          "data": {
            "w": 300,
            "h": 250,
            "html": "<span class=\"PubAPIAd\"><STYLE>body{margin: auto;}</STYLE><DIV><A target=\"_blank\" href=\"http://track.pubmatic.com/AdServer/AdDisplayTrackerServlet?clickData=JnB1YklkPTE1NTk3NSZzaXRlSWQ9MTU5NjA2JmFkSWQ9ODIwMjE1JmthZHNpemVpZD05JnRsZElkPTAmY2FtcGFpZ25JZD0xNTIwOCZjcmVhdGl2ZUlkPTAmYWRTZXJ2ZXJJZD0yNDMmaW1waWQ9MkY4QjNBMTktQ0EyNy00MzEzLUE1RTEtMEIyNkQ4QzRBNzNEJm1vYmZsYWc9MSZpc21vYmlsZWFwcD0xJmNhcnJpZXJpZD0xNTAmcGFzc2JhY2s9MA==_url=http%3A%2F%2Fclickus.basebanner.com%2Fst%3Fcipid%3D2621000%26excid%3D23%26ttype%3D1%26dast%3Dv1_2621000_-1_3o1_884DB89344267722021886610003__4230937_14ch7_778_884DB8934426772201993852600_n_0_-7041993656288223481_820215____2g_4oa7_0_%26cipp%3D0.0219582271%26excid%3D23%26cisid%3D884DB89344267722021886610003%26pix%3D31581939%26tgt%3Dhttps%253A%252F%252Fwww.glassesusa.com%252Fcoupons-and-promotions%253Fsr%253D7742381\"><IMG border=0 width=300 height=250 id=\"_ci4230937_b4074867\" alt=\"\" src=\"http://d94r1llj8z8wm.clossudfront.net/uploads/1456266446847_300x250-mirror.gif\"/></A>\r\n</DIV>\r\n<script type=\"text/javascript\" src=\"http://imprusmp.basssssebanner.com/st?cipid=2621000&ttype=0&cirid=884DB8934426772201993852600&cicmp=1192487&cijs=1&dast=bXRtZGxpZD0zMjAzMTAwMjU4NyZjbXQ9LTEmZnJtaT0wJm1tdD0tMSZwcnJwPTEwMDAwMC4wJnBmcnA9LTEuMCZleGNpZD0U5OTgwMzQwNDYmc2VydmluZ0RvbWFpbj1iYXNlYmFubmVyLmNvbSZsYXQ9NDkuNDU2MyZsb25nPTguMDgxNCZjaXRicD0wLjAyNTE1Mzg0NjE1Mzg0NjE1&cipp=0.0219582271&excid=23\"></script></span>"
          }
        }
      ],
      "meta": [
        {
          "type": "contentinfo",
          "data": {
            "link": "http://pubnative.net/content-info",
            "icon": "http://cdn.pubnative.net/static/adserver/contentinfo.png",
            "text": "Learn about this ad"
          }
        }
      ],
      "beacons": [
        {
          "type": "impression",
          "data": {
            "url": "http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455"
          }
        }
      ]
    }
  ]
}
##Sample HtmlBanner - when al=l
{
  "status": "ok",
  "ads": [
    {
      "link": "http://tr.pubnative.net/click/native?aid=1004319&t=Ytcxi7HqG6vUQkAMjLX-lvEUigvR7aW46OeRj07vFlB3wXpkUpGhli6jJzvefU_AV",
       "assetgroupid": 21, //Possible values 10,8,21 depending on the ad layout requested
      "assets": [
        {
          "type": "htmlbanner",
          "data": {
            "w": 320,
            "h": 480,
            "html": "<span class=\"PubAPIAd\"><STYLE>body{margin: auto;}</STYLE><DIV><A target=\"_blank\" href=\"http://track.pubmatic.com/AdServer/AdDisplayTrackerServlet?clickData=JnB1YklkPTE1NTk3NSZzaXRlSWQ9MTU5NjA2JmFkSWQ9ODIwMjE1JmthZHNpemVpZD05JnRsZElkPTAmY2FtcGFpZ25JZD0xNTIwOCZjcmVhdGl2ZUlkPTAmYWRTZXJ2ZXJJZD0yNDMmaW1waWQ9MkY4QjNBMTktQ0EyNy00MzEzLUE1RTEtMEIyNkQ4QzRBNzNEJm1vYmZsYWc9MSZpc21vYmlsZWFwcD0xJmNhcnJpZXJpZD0xNTAmcGFzc2JhY2s9MA==_url=http%3A%2F%2Fclickus.basebanner.com%2Fst%3Fcipid%3D2621000%26excid%3D23%26ttype%3D1%26dast%3Dv1_2621000_-1_3o1_884DB89344267722021886610003__4230937_14ch7_778_884DB8934426772201993852600_n_0_-7041993656288223481_820215____2g_4oa7_0_%26cipp%3D0.0219582271%26excid%3D23%26cisid%3D884DB89344267722021886610003%26pix%3D31581939%26tgt%3Dhttps%253A%252F%252Fwww.glassesusa.com%252Fcoupons-and-promotions%253Fsr%253D7742381\"><IMG border=0 width=300 height=250 id=\"_ci4230937_b4074867\" alt=\"\" src=\"http://d94r1llj8z8wm.clossudfront.net/uploads/1456266446847_300x250-mirror.gif\"/></A>\r\n</DIV>\r\n<script type=\"text/javascript\" src=\"http://imprusmp.basssssebanner.com/st?cipid=2621000&ttype=0&cirid=884DB8934426772201993852600&cicmp=1192487&cijs=1&dast=bXRtZGxpZD0zMjAzMTAwMjU4NyZjbXQ9LTEmZnJtaT0wJm1tdD0tMSZwcnJwPTEwMDAwMC4wJnBmcnA9LTEuMCZleGNpZD0U5OTgwMzQwNDYmc2VydmluZ0RvbWFpbj1iYXNlYmFubmVyLmNvbSZsYXQ9NDkuNDU2MyZsb25nPTguMDgxNCZjaXRicD0wLjAyNTE1Mzg0NjE1Mzg0NjE1&cipp=0.0219582271&excid=23\"></script></span>"
          }
        }
      ],
      "meta": [
        {
          "type": "contentinfo",
          "data": {
            "link": "http://pubnative.net/content-info",
            "icon": "http://cdn.pubnative.net/static/adserver/contentinfo.png",
            "text": "Learn about this ad"
          }
        }
      ],
      "beacons": [
        {
          "type": "impression",
          "data": {
            "url": "http://tr.pubnative.net/impression?aid=1004319&t=DDbBpGKNrOZkge-rI7zebIGRCGY_DUv5GJaD6mQFDbVniFdwiY_aC1A3Ymbaf3jYa5_5XZs2DVruCYcxB7Xq16jTxz9WNOTRkLxY24zSYV50Uc6YM7nSAFCx6e_DiosLnLxbc1wEpBHTvUbY7qg4jj9nfbRTMHzmVZxCZFSWxsbJUGu3WJoTComKbf_ZFBJpbJin377esONqXuSrB6lrt5oZVeqkwOT7qeqGTs8vJfBl_Uact1Lweed6FBeNg044iVR16AQB7R1Elav6wlK4fWOB19ikaMSYgOyllDE7ybUcqsDd9i8cAuUPGuVJGdhj3m2awYJngo5OBd8DBD2UtcmwYwhjvx1FtACEVAzJ2VR7WkbwiTRdDkyOAwO75rDbQkAIvUbpEeiS6A5HfH658bhsRq86mWGDeltVSD8uqmgpK1y6Zng0lAveIc9D0x-xBvNVMsA&tl=455"
          }
        }
      ]
    }
  ]
}
  • Video format (VAST Creatives)

Pubnative returns video creatives in VAST2.0 format. We serve VAST2.0 and VAST2.0 Wrapper creatives. We expect publishers to render these creatives in their own video player.
Based on the ad layout requested Pubnative will return video ads in the following dimensions -

Ad LayoutAsset GroupDimension
m4300x250(Coming soon!!)
l15320x480(Live!)
{
  "status": "ok",
  "ads": [
    {
      "assetgroupid": 15,
      "assets": [
        {
          "type": "vast2",
          "data": {
            "vast2": "<VAST version=\"2.0\"><Ad id=\"5d83bcac_194c323dac7c4150b332e94a1033ef2e\"><Wrapper><VASTAdTagURI>https://bid.g.doubleclick.net/dbm/vast?dbm_c=AKAmf-C87T4w3HHSEmovN-PWf3VXzz4hLCF-pkBlVIQiOd7NyP6gO1yjGHpD6vihgmOuATr1f4zv&amp;dbm_d=AKAmf-AFw-KaBNjQecjYvj6LQ0RjtUF7fWshsm-fQEebYgdf2P8Kp3Te6BXzne3YBGX5Bbv6tJOfRV9n9IQENOXD_2pWfbvHP8mAxlx20zefQ-fyuJHuXZZ4EJi46chDToCzH3G6HZa_YeezsctlRh1BAJmwHpUThOUm-5ky-_44ibeupgiolTZTQtcHo8yaQOCDFWQe6KrH37X_4DGypyLAog9QGZ30f6c1R8Qv6qnlhbx7a0k_YfJk5hyR0yghRoA9SV7xHNmzhm4yY3O6CydZNt-H08UmFE2RuCM2RihpW3veLVWHy4Rev5MfHPMGcOMh7MrfzIASlQyjUFJPNkx0wToAaaEQkvlir_2aFSFBJ8K0RlPlLtYouqKHJ6hND4TEpZd_Nj7XBtwe29KHFcTmgKmUgAukBcdGLfwKDgSG_DsZMVAHXDx3WcmgUFEOEIWf7sFVuuj7zS00DKkKlXhOX5rkPyybkGP9gplJKodU_UYZp9wlCszsAN-QLi0aY_rK4XNlF1YGv_p2HbUeYJBDP2BlmsBisoVpL3dSKeBiICH1WnGsA3ttNk8RaCcBBinPWhIIpgkZ08awhAI6YE7N3dmCs3Atv_XrzEB7QTZc9II-Q-C2bvZVpp0wuQLd3dhAs5H3zoveH8vPstgfX3aKvUbNwblyaTxlTAb0F6bPQEnjFtexqKdEsmI3fkrZWMniQkbVCdojtSu-Zr2G8p-ObXXDVgDila7yXheV6huWaJBVwinjgE2NZsod0Z-NFKcjWVeBrYPsAuCna5XeAPA9TwUS8kTpbhOaxSbwXksYdaacjXIz_FeC2g_e0gWwfOZDNjaOuRRwVNLBJz5ORUDXPMgzUJRhrtpPrt3u1zqXGJfjVWAPMwaymefcT4oSJphuomxDz1-SrciyUpAH5qwHqlv6-Gkab0VGNp4Rj6mydJsqgl0OuTL54JhrHnvcnTiSJ8Vs9O483ZtvFtf-9PwCZ_SxlNAK4faKJateF9t07IYT665ziM78xcF1wc3dYbTQvmCYxggE5-a3HyurPfBhSMLUBi4-k17Ae_YW_bvdnuHW4ftYnugI0CgskYnABZM4fwvMqc3xE8zefy8_3AFrcDT2vacaQFf8qi4JbNvRvy2VvVKIQcM08M_WegyJFC7lpbuDbIvk0YH29l1urEAzJKUDktbC_EYuMEk-UGGfSzn5xIpKxEE8xzmEzgaHsuZ9XhWfCKdOdO_D_3Zbc7sZwuzj7ptfguqsTll_ydUBTQbAvMEp7bGfSbSSbt5mijCu0kHaUb1gylqOjG-zTLoUOnEX0jZh-wS3ns3pyIcIm3zsvJD3pqdpf7bD9UqsZd4uyOtR7lzHONktWBmPZvUaIpdrfmyz7KBS6MXon62hNu4k83SNC-jyPosEUryS2nRtystBRYYQG_GPZ1fj5RSj2hiP1VuxqFcfehEqihCmfTocjAaQP8eDM_JTWMta8afF-xmZ8fiiiZRVX_ab_nckqFzkTBkBLDz1AzBMKAV70udTP-KrbYihfUfvqoWXmnYUhPLUNPVDvVZQU7qq33-oJBEAL_oU9xE1AxOM4fTAbuAVeOfzu5Y5K7K69gZKYXOp7KyjqGO0Bpr4VsN5uw5en1rJFcO2XZr4FQ3c2zjiDPDdrpbCUymEz7MNPzL1WLnhVa_-zqZ55FTOWoSa_jCd8XoNW6DqV9MYRkjo3-blYvjHVSv3NSq-DGz8Crn_T_TDTjPQbZoyN2ku71O0tAExIH15-wn8SF1vArw05_cuQpa5hWjw72WK4cugA3aGrofhJ6UnfmYKvE0QuEjsPF1z_TqJ2MQeUprzCmvwWkHuCkiDL40sV5pbo_-KPEMda9mIax6swFD6D1EuaNJHC53PkRIKezGMNIAFAZaWLoXMyqJg5xPAJaU&amp;cid=CAASBORo0qc</VASTAdTagURI><Error>http://gce-sc.bidswitch.net/vast_error/1ja825m-57ZZ1n2YoUucUH932hFGUPM1HouZxU1237SJTGi5Ec9JaTMFTSXVlmG8GjCNHnnt_FocRf5_Oq3g4KxN8WzjkueE7Qg4yYH4mWwmhQ25QooIExahf0Po1wu5S_6x7mPbY8vP_PnoXsGvk6diZ2O6cf-PF4bQbtheGv9czFpD-yDnQ52apB1Oj0Iw_y_UmEOLraTuZ_nt5Gv7AzOmGocuUv4OPwuRI7ng4iIHojrTzYVqah1IjQkVMdz6OLr7jV0eyUvzqXAPiM6VZg4xDizCpnzYscMnFHch9gpfb6KquosLGEaxBTRP0ZbdBzevVgHW-809O21ZlLbib9GIG2tm_oIfoaZAdFBGodud3bGUiM64UzdCI-iCpFYk3uQgvmNKwWZFqldrGhGoldE_G4TLrskpE7JC4HDdDmHsyQUkF0laTGdsnhLbZwQi-ds2WUy6ZDjeDzJ89dEsPJ91iapKOJe4iKiGwFQVJ3GNC9Ed1qbUCPZAdL2aaS8R_cgEyITJJi6CnBCXnhYhE6xjVTnTlaN-J_MSgBHjEmz_1LVEjS_hy75rpSMNdS_Fl5Odymw1BRNGBgBNbhkEWblzVH2_YT-9oluLDRB4-b7W7I9qKKOERwZKUhYzCkA75utTKcnIvX8tPA/</Error><AdSystem>BidSwitch</AdSystem><Impression>http://gce-sc.bidswitch.net/imp/0.02/BSWhttp_A_B_Badx.g.doubleclick.net_Bpagead_Badview_Cai_RCfLZnvxoYWoKwLIuWmATs-4CYAantz__RNsqmA28EGkS8QASCD__eYfYMm2po3spIQRyAEFqAMBmAQAqgSrAU__QrCFiwmkQjfmv9aPLTzUSNR__kD40dEKHgzp9FtTqR-t__HXUuo2AiQ0BDfOc-f__4H8toEnF3edCKVfsAtrDMI7DXTH4ElS7kvDe2QE0HM2HKiUYI0nCfwVDPmWwJQOBADuBZucHOELKM8DpNwkI-pcNGalkQSY1E2BrdNzmwJt8Z1sjyAZD0S7kUaPnHpnIIMAHkk1BLhv5y6i-4UjMw1QKKqhtoSFtkgNqcAE95m3kLMB4AQDiAXz6-LLA5IFBggdEAQYAZIFBggdEAEYAZIFBggeEAEYAZAGAaAGT9gGAoAH6ePOPKgHpr4bqAeeAdgHAPIHCRCT5QUY25yOJ6AIteulBLAIAtIIBwiIQBABGADyCBhiaWRkZXItcHVibmF0aXZlXzEwMTIzNzKACgSwE-3KrwPIE7jRowLQEwDYEwqCFBcaFXByZW1pdW0ucHVibmF0aXZlLm5ldA_Jsigh_Rmf23QvF89g0_Jcmd_RChdjYS1wdWItNzM1MDg5NzEzODA5OTk1OBgB_Jpr_R38_A_I_WAUCTION__PRICE_X/1ja825m-57ZZ1n2YoUucUH932hFGUPM1HouZxU1237SJTGi5Ec9JaTMFTSXVlmG8GjCNHnnt_FocRf5_Oq3g4KxN8WzjkueE7Qg4yYH4mWwmhQ25QooIExahf0Po1wu5S_6x7mPbY8vP_PnoXsGvk6diZ2O6cf-PF4bQbtheGv9czFpD-yDnQ52apB1Oj0Iw_y_UmEOLraTuZ_nt5Gv7AzOmGocuUv4OPwuRI7ng4iIHojrTzYVqah1IjQkVMdz6OLr7jV0eyUvzqXAPiM6VZg4xDizCpnzYscMnFHch9gpfb6KquosLGEaxBTRP0ZbdBzevVgHW-809O21ZlLbib9GIG2tm_oIfoaZAdFBGodud3bGUiM64UzdCI-iCpFYk3uQgvmNKwWZFqldrGhGoldE_G4TLrskpE7JC4HDdDmHsyQUkF0laTGdsnhLbZwQi-ds2WUy6ZDjeDzJ89dEsPJ91iapKOJe4iKiGwFQVJ3GNC9Ed1qbUCPZAdL2aaS8R_cgEyITJJi6CnBCXnhYhE6xjVTnTlaN-J_MSgBHjEmz_1LVEjS_hy75rpSMNdS_Fl5Odymw1BRNGBgBNbhkEWblzVH2_YT-9oluLDRB4-b7W7I9qKKOERwZKUhYzCkA75utTKcnIvX8tPA/</Impression><Impression>http://us-east-sync.bidswitch.net/sync?ssp=pubnative&amp;dsp_id=16&amp;imp=1</Impression><Creatives></Creatives></Wrapper></Ad></VAST>"
          }
        }
      ],
      "meta": [
        {
          "type": "contentinfo",
          "data": {
            "link": "https://pubnative.net/content-info",
            "icon": "https://cdn.pubnative.net/static/adserver/contentinfo.png",
            "text": "Learn about this ad"
          }
        }
      ],
      "beacons": [
        {
          "type": "impression",
          "data": {}
        },
        {
          "type": "impression",
          "data": {
            "url": "https://got.pubnative.net/impression?aid=1012372&t=_5OcHk6Z3uaDHvx1yBCL0mNzz8-Kyk0IDRfQwBzl0xgdlmhWCLwsEPcc_-HaoXdZdC9qxgw82AdEQAsi7sxZu18XBLqUQT8aDM2ndKnYe5uYaJfPwF-EuYmSzsFOe87k-Ircqf5JsPV541hXrbiN-3vFXeyA9xRO6sHQmKBC37QnVWY4HcQsyUFXua6zmKt_IrdRzzPnRWJ-yxW71YDvG0khtldXjKZ0WJ18bd0YaV_cVK_rgCQUVk2A1mwLz4rz3HW_SHdRo0PkWuHpC8bexbB-AremmW1VmA0WCqwFkL2r_3zoWDGLIM3WhAQqnJO1B6dhfArUSqdm6qvOeZ3jS5K9gBRiHo_cnyMHsnqQ6JOURT-QLmGvJ8uBt3VwOpfY-wn5FMaiYNavHSdGntVLyF6ZS13AioPqsl6wEJE3G7Dl7ubdBCiZXOLMYod_WN6N2rQJC93Vs1qp5H5lJkmFG6zwn9Zi_rK3vi6Ey4_emVp2_1H5l7csNcU2DM7ku_TXGlOv4WDgjqSmaLaQ2ZLO5KL28SaUJUmZgK6wn6Cy1k8M-WSd_KIkb6euq9fA-2IR6UHgugemQqGn2hK5J_qSOe0hPDtgriQ6RoG07s8TQVf4Yb_jhf0aPrXrNlGEI9HovGXTpMmao7eUmZEd64-tgngDt9Sj9ryjlK3wosahaL7Xr2CyQhzP7Z9d-HRLc1ebwzi2MH_wKwsym_XxrhLENPGLdapPZZha2eo1qop1QRnmU1qrGsJ0FlL8hS3x4lYFG07Z-4SJyvWlmtzP4zbvJo5bRr6iFaCgj3N9kfrhVNlIU8Uu2nf1cnxzslomaA"
          }
        },
        {
          "type": "click",
          "data": {
            "url": "https://got.pubnative.net/click/rtb?aid=1012372&t=hl6bkQhTTxTB7kpeDwKivvCdFD3G61HSmTHqrgCdNp5bNNA97sZ90dX0aEQHDwt2Bo26GwCP2fsK7im4OaE4GAgPuqfnYzcElMBfYrevrVU__T_78BUqdSQATzA0zPEM9uP19t_pV30jvn95mMBAyikD2b6msFD78gIi9FpLMhB_h0x6yLqrn3ZKNVDGUvdJcIOeaPoc9nQC34zKbEIxiXyYnSVLSkzV8GOGlpUTpAtu-kmsL9wvNS-v4_T-IBCtYt0pvbnbuy_1m8M6lLXUYq6ecp2hVzkAqWbFMEN8RHKm_5BQxgyRNArlAhtI7bpAIo-UWCo6MA5wLwLoSe8XMoxBazwcmGPJU68O6Jooedt5XKt5Kf6ssa_s5MTqPNMPAuUUnebkHx6JP8C7jUyxEB1Q2vMSxeSJM0V63FR6w2ALlwfdbiY-UsFX3AfOectnDFaTmbB_D2_xwX4OHIDBKJ9mkr4BMscb9khzGARASiQiklV29aKhRi-qOdGifRlzhk0KG1Ib0Jo"
          }
        }
      ]
    }
  ]
}

Meta types

  • 'points' specifies the payout associated with the campaign (1000 points =$1.00)
  • 'revenuemodel' is the revenue model of the campaign returned.
  • 'bundleid' is the bundle id of the app associated with the campaign.
  • 'contentinfo' provides an easy access to users to Pubnative´s privacy policy.
  • 'campaignid' is the campaign id of the app associated with the campaign.
"meta": [
        {
          "type": "points",
          "data": {
            "number": 2420
          }
        },
        {
          "type": "revenuemodel",
          "data": {
            "text": "cpa"
          }
        },
        {
          "type": "campaignid",
          "data": {
            "text": "3229480"
          }
        },
        {
          "type": "creativeid",
          "data": {}
        },
				{
          "type": "contentinfo",
          "data": {
          "link": "http://pubnative.net/content-info",
          "icon": "http://cdn.pubnative.net/static/adserver/pnadchoices.png",
          "text": "Learn about this ad"
                  }
        },
        {
        "type": "bundleid",
        "data": {}
        }
      ]

Beacon Type

Pubnative response contain following beacon types:

1. Impression beacon - Type URL

"beacons": [
        {
      "type": "impression",
			"data": {
		  "url": "http://tr.pubnative.net/impression?aid=1012003&t=uuJqdX8Q6ULYwTQwCxFTg8LdkPsKhhVL9UbAFc49jFQ6V8VFueXVyEw9w5CXp65y-FO_MkzYnsf9mCe6PPO1TzZCr-0BK3pM6Qj3cTVT6hJPGDQ-WwtnefolN05Go396WkFb0-L5b_yjE0J9X4yv46ZSEpPVx4whFUAhY0ztOdXHG7ILQe7iqYKXzAhW7UG2N4JYioWM2kXBcFB_9E8vk_Wk6wjHqPJ_gtlMuZkX3F_fp-dukRmtd4BzMlZraJg8Z7pZvFE1u0GaBaup9FYs-B26K8X9OONmEke3J5TAWhxZuqRD9c6SuYuZUhWtDJaFh5Vq4ApEuIqnb9HKt6n-zkMRPKQ8EIzYxJ-FJUNwhyVcsTqMws_udHtpZt-W68ygffT0pHiZ8DasPMgH73-Xld0uZ8qE7kHwSdWtZxB_7UPupUj-BhARg67QEQ5FwiQ_p8ghOBCGm56BhdrxinP1GQlCR2gIWrccVjSOH1MmlkQgBtjou_KCVZfzAfI2kIvWnQ6awfZo-gM3JLaooOoHJ2f81tAL_Q4LZ7fbWlJLp52b6XLeQUlPIBgPsG2WSZ0AU5j3M-6MqmxxJoRg5et9OcKmkg2Y6ovprNrvghccl9Ao&tl=620"
			}
		}, {
			"type": "impression",
			"data": {
			"url": "https://NETWORKDOMAIN/c.asm/C/t/eh069iuvof/1pym/s/1h/db/u/0/0/0/eyJVSUQiOiIzYjY3Nzg4My1kOWI3LTQ3YzctYWNjNC0wZWFmYWIzN2U0MWQiLCJHUElEIjoiM2I2Nzc4ODMtZDliNy00N2M3LWFjYzQtMGVhZmFiMzdlNDFkIn0~/08ebd7a8-0157-1000-f8f2-3e92681100d0/-1/0/14/0/0/49.43330001831055,6.849999904632568,0.0/13494882/NW/2t/0/api/3.0.0/dir/Y29tLnRocmVldXBwbHVzLlByb19TbmlwZXJfU3RpY2ttYW5fRnJlZQ~~/Fp4oFsCNtwEW3ODqzNFVN5yijIBTlGE_FBwXAAAAAAAA8D8XVfbbM2QYZT8XAAAAAAAAAAAUBBIYODVZMHJtcTlvZVcrcW94QXNOa29TSldMK0Z2eS9HQ1JMTnJvOWFJZHc3RndBU0pUdVFZS0VlZz09GAZOQVRJVkUcFAAUAhwcFoDAuJWA6uvrERbf1Oe8wtvglg8AFoD208rquMLqTBUAEgAAORXAPiEUABbE5PiK6lEUBBgYcGVyZi1hZHBvb2wxMDAxLnBlcmYudWgxFAISPBUCACwVAgBTBgA=/-1/AA==/6/40d5d6fc?m=18&ts=$TS"
          }

2. Impression beacon - Type JS

"beacons": [
         {
          "type": "impression",
          "data": {
            "js": "<script></script>"
          }
        }

2. Click Beacon - Type URL

"beacons": [
        {
         	"type": "click",
			"data": {
				"url": "https://NETWORKDOMAIN/c.asm/C/t/eh069iuvof/1pym/s/1h/db/u/0/0/0/eyJVSUQiOiIzYjY3Nzg4My1kOWI3LTQ3YzctYWNjNC0wZWFmYWIzN2U0MWQiLCJHUElEIjoiM2I2Nzc4ODMtZDliNy00N2M3LWFjYzQtMGVhZmFiMzdlNDFkIn0~/08ebd7a8-0157-1000-f8f2-3e92681100d0/-1/0/14/0/0/49.43330001831055,6.849999904632568,0.0/13494882/NW/2t/0/api/3.0.0/dir/Y29tLnRocmVldXBwbHVzLlByb19TbmlwZXJfU3RpY2ttYW5fRnJlZQ~~/Fp4oFsCNtwEW3ODqzNFVN5yijIBTlGE_FBwXAAAAAAAA8D8XVfbbM2QYZT8XAAAAAAAAAAAUBBIYODVZMHJtcTlvZVcrcW94QXNOa29TSldMK0Z2eS9HQ1JMTnJvOWFJZHc3RndBU0pUdVFZS0VlZz09GAZOQVRJVkUcFAAUAhwcFoDAuJWA6uvrERbf1Oe8wtvglg8AFoD208rquMLqTBUAEgAAORXAPiEUABbE5PiK6lEUBBgYcGVyZi1hZHBvb2wxMDAxLnBlcmYudWgxFAISPBUCACwVAgBTBgA=/-1/AA==/6/40d5d6fc?m=8&ts=$TS"
			}
		}, {
			"type": "click",
			"data": {
				"url": "https://NETWORKDOMAIN/c.asm/C/t/eh069iuvof/1pym/s/1h/db/u/0/0/0/eyJVSUQiOiIzYjY3Nzg4My1kOWI3LTQ3YzctYWNjNC0wZWFmYWIzN2U0MWQiLCJHUElEIjoiM2I2Nzc4ODMtZDliNy00N2M3LWFjYzQtMGVhZmFiMzdlNDFkIn0~/08ebd7a8-0157-1000-f8f2-3e92681100d0/-1/0/14/1/0/49.43330001831055,6.849999904632568,0.0/13494882/NW/2t/0/api/3.0.0/dir/Y29tLnRocmVldXBwbHVzLlByb19TbmlwZXJfU3RpY2ttYW5fRnJlZQ~~/Fp4oFsCNtwEW3ODqzNFVN5yijIBTlGE_FBwXAAAAAAAA8D8XVfbbM2QYZT8XAAAAAAAAAAAUBBIYODVZMHJtcTlvZVcrcW94QXNOa29TSldMK0Z2eS9HQ1JMTnJvOWFJZHc3RndBU0pUdVFZS0VlZz09GAZOQVRJVkUcFAAUAhwcFoDAuJWA6uvrERbf1Oe8wtvglg8AFoD208rquMLqTBUAEgAAORXAPiEUABbE5PiK6lEUBBgYcGVyZi1hZHBvb2wxMDAxLnBlcmYudWgxFAISPBUCACwVAgBTBgA=/-1/AA==/6/1d0f464a?at=1&am=0&ct=$TS"
          }
Impression and click beacons MUST be confirmed client side. 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.

Please be noted as soon as an impression (=creative) is shown to the user and ONLY after the ad has been viewed for 1 second should the impression be confirmed. This is the guideline is in order to respect IAB view-ability terms.

How are impression and click beacons confirmed?
  • In case the beacon is of type url, then you must send us a GET request to the URL which is specified in impression beacon client side.
  • In case the beacon is of type js, then you must render js script in a web view and confirm the impression on client side.

Note: Number of impression and click beacons depend on the demand partner. The integration must be done in such a way that the app is in a position to confirm all beacons -impression and click.

Ad layout sample response

Quick recap of the above-mentioned information, below is sample responses for ad layouts type - s, m, l

{
  "status": "ok",
  "ads": [
    {
      "link": "http://tr.pubnative.net/click/native?aid=1004319&t=PBNNoP42B6gg2CszXsw5iNfVACMYMyVebc2ZYRwotIvpS2TlCvWa1_eqt8uFRF7nNkhLhkaXWNbblY5O905LWcD-1nMfkNFWd_A9lVFIQ0SRPc61vwegFYgt2OLK2UH1GysruFec3CvRs_0lMzDyEwvAWmP8CFK70pmXUuD3Lsk3vXJ6Hk3AF5CpOzTRs_0N12PZLzCzTy9I7sWAabX7LMn_RlxULMqkMQO7VD4eObrM_zLnV3udU_Vi9-k1QZ0MFr5conBgSOXd6ZjUnZ0P19fMtNxMGVeTdBuZ01z0rwk8rWASVesMfA4gZXyCd-XMt6ELofBilVnVn7weN6gNEHC-2o88Zz7F-3HVh1bzkrAjriRLhbd4UtXa6yoEJ5-lQAGZw3D5Uhjt9DAv0WnGygZR0lzrBpAhg73aCmIv8AecoU8bDOG9X8RGnQ_wnRiWXLit8ST80ahX1Kp_M-hGVX4c7-_EYeCuXwMK8zZYVKGXLrMjb6K76Rs-bSNFkZ3Sw39VeDPZ85kvtZBGXKdJ9K9SRPqxHDKBaUFebhvdY6zFqzEDE2Y6uOqHEHMUmG5SJwU-CvbMGJLpEMEvVaSlYk0mPsGlWs8us07PABws04gkzW5gn1cHjL8dnS3KKtQ",
      "assetgroupid": 2,
      "assets": [
        {
          "type": "icon",
          "data": {
            "w": 80,
            "h": 80,
            "url": "http://cdn.pubnative.net/games/icons/001/015/256/dimension_80x80.jpg?20161025074858"
          }
        },
        {
          "type": "title",
          "data": {
            "text": "Coin Dozer: Haunted"
          }
        },
        {
          "type": "description",
          "data": {
            "text": "Suchst Du eine neue, coole App? Lade mich jetzt runter."
          }
        },
        {
          "type": "cta",
          "data": {
            "text": "Installieren"
          }
        }
      ],
      "meta": [
        {
          "type": "points",
          "data": {
            "number": 380
          }
        },
        {
          "type": "revenuemodel",
          "data": {
            "text": "cpa"
          }
        },
        {
          "type": "campaignid",
          "data": {
            "text": "4873307"
          }
        },
        {
          "type": "creativeid",
          "data": {
            "text": ""
          }
        }
      ],
      "beacons": [
        {
          "type": "impression",
          "data": {
            "url": "http://tr.pubnative.net/impression?aid=1004319&t=clivZDG3sj6hnaC3hsCj4TDdfxiGcQg9LZyAKRjezva8zscP2C5DxpcIoHEGIZjWSlKglkRZIIwgGWiwAJvk83hm0sI_9hr7DA-N0YTeorSVnRak-_1slLYF_Jox41g9_bCB5xCg0OywJEYgwHdgbJr3SuiaSuXDwPykXAK3q5dCcJWNcZyzmoUKeb3qL8HIKqRXR_M9o20I5941lKdzTtoLCHjERo92BGAGIl1v_U2CMePaF4lks1__FZHs0m5JUnZlMVGVwNwPnWVlmqLHUuFI3k8Yl3kmPHLfTqyjPDa2SM8KlYgb1UcZd55J1K-iyw4_e0Xi0i8rFZfPR5l_bg1l5lXEtFirkcIPBy6vNoe2k-h3XNjqzkCKXFaVlCK6G3yYxdk0ttKEX5LVB8wDHeeg9qDUUIOJvapCH46XdYjBggQ2Dmv-PYXyv0PW&tl=444"
          }
        }
      ]
    }
  ]
}
{
  "status": "ok",
  "ads": [
    {
      "link": "http://tr.pubnative.net/click/native?aid=1004319&t=S1c6jpWDjvV277qb1VNHhR-5qu3KQC2A2IIqylLkMXw8hVcBVeuCBjevqunqqekShO4FPgI3Q5W5Q1p1XOCkcSgsB5MHOIcxnF7aw6X_xy9rNUIZQx69QdseEnFBW-OEShmUoXvPNPWo5SsSPbyjJzG55OwQmggKEUa2IJK0Nk6Z35sk81BRibJ_BRm0wqnkLoiujE1C64hN8XSFfn2ex7R7FbcULVLad3cJ93zydGYtUTsIb1ckdwT8UhV02MdqgLBpy2S8sOZ9i6PnI5IRTNaSOjEL-z-jWOOl0LHHacC4D0pyiwZG58-qL0Rggiev4LL87z2Q6c3dGT83mQ3SquYnLRokhM0rmjV255c3GfCxy_E2B1nuvzWEfuivCSTQzjvlId4GfV73CXLmIF1s-mSATQ6lspLNSPmjnJ-umC_A6CUMkW9Dkyqy1123X9F2N9Ovh0N9cRuRTi_PVCy1Locvd7l7knwOXAi8mQNQiOALwfWPrXxJzxxoaELZ-5K6LcHFOoUsJ5RkBYMGOkqv62zkNmH78q1p-A4IuxVYMod6k4LTYMO0r8Z0HkvrUhxS_CTemd233wKlACqjZEURIM9zbSJxcMkobQuczwoVbU83RFx0yVp76D2GIPFKMiyZaA25j0KW3A3GwaVHTSH8e27JFeJA8wEhU_SRBebHqJOLf0-csgw00Zkv_jVjL0vjM9VIBaCwlLZe6CRam3jhUCnLfRqwwqPUCQrYMF1PcFWQyzXPOnO4cVM",
      "assetgroupid": 5,
      "assets": [
        {
          "type": "icon",
          "data": {
            "w": 80,
            "h": 80,
            "url": "http://cdn.pubnative.net/games/icons/001/005/541/dimension_80x80.jpg?20161025053515"
          }
        },
        {
          "type": "banner",
          "data": {
            "w": 1200,
            "h": 627,
            "url": "http://cdn.pubnative.net/games/promo_images_landscape/default/2_dimension_1200x627.jpg"
          }
        },
        {
          "type": "title",
          "data": {
            "text": "PAYBACK - Coupons & Gutscheine"
          }
        },
        {
          "type": "description",
          "data": {
            "text": "Suchst Du eine neue, coole App? Lade mich jetzt runter."
          }
        },
        {
          "type": "rating",
          "data": {
            "number": 4
          }
        },
        {
          "type": "cta",
          "data": {
            "text": "Installieren"
          }
        }
      ],
      "meta": [
        {
          "type": "points",
          "data": {
            "number": 860
          }
        },
        {
          "type": "revenuemodel",
          "data": {
            "text": "cpa"
          }
        },
        {
          "type": "campaignid",
          "data": {
            "text": "4816214"
          }
        },
        {
          "type": "creativeid",
          "data": {
            "text": ""
          }
        }
      ],
      "beacons": [
        {
          "type": "impression",
          "data": {
            "url": "http://tr.pubnative.net/impression?aid=1004319&t=8D8fP-_cgXz0eiwyZEf44aU_4ViDXgHXWrhBHq-GdMOMiQ96D7T4HPJUbb-0jF2-8WMB6uX5d_rH4x4LdmfkP2uy9O-_IeTl9P2yh8xp4Faf6rcbO3XRHdeanIoq_9qOUHbbbMjVzj-MIWE9Bw-S5i4_01hoclRwSAwnAHN5_xUfZlcM3M2vd2ZFybZxOVm9-iKYZvBwVzgB4G4PMDILTfAuEwpgDLOjGEBv10PX-TRZrm98BLkS2qndZMBQSmMW3E4MsccbR6Wtrzke0Cm0zl_OL9AEFjCE4HqKZd1dX_1XMXQewUSc1jgy9QRtIR7bcOvqjZm_xGbXDgXQf7MnEVnROVKvNHBJPiN2UPUFz7Rrv3KyJ2HI0h2T3eyY_ODID6M&tl=387"
          }
        }
      ]
    }
  ]
}
{
  "status": "ok",
  "ads": [
    {
      "link": "http://tr.pubnative.net/click/native?aid=1004319&t=FmOB-EgqTQRg4Xs5I4jssBpFtYzpCsDv067_lI24m2ZvcYNnEMOREUiVo0Ztge_zXjOfxN2abqUP9OansDd4y2pIQ55nJeUSyMeaGAmMJQc_sVCiOQD5OXjgzl5tjmS5owrOkRh8e58dUl-dO0GVb3wSWa8_oQk3iAyl7527oF0Vmn6rmxChYxGU0rm8IbqSnFBUpqYLpOV4Ui7mt_hjavV9naSLYNCcngrTaSYqI8IGPSRMQn1ovGAlUdfjkONoGGBMI0XKvhylY_MXVllSThRSwvPucF128lNR1bG6CjNXaJtlCNICpy179uACP_Rh0Av5vb4rW01EecwhZTpEGmaFQLraZwl_USAlXZXWgmdb8tSBfAXBOW8300F0P2a8bpnJAB48gbVG_0ETbJky4keXXrRmiBHF89w-w3hmU1-rAadd--xvV8cwxb6sV7MDGOx4iuHvZhKeEn4frvmB2xGMDBJtdcbmYi73bQwg5blWtTIgjMpHLHddCKs_GjqqsH7fbY_yDSkzEYyspOdcEho2iQsHQAgk5ZPZrv0fq1aUgc0zQNTyrKgka1ENgxoOMScIqRVe-qBT0bAwVochl6-ar5xd3y3lGGKEG3K0hC0rM7aoJio7dcdBSh1lKfNMonwpK2g-wmVao9vT1VUp9g0bJneu4A5sImgT3cbNIUohqlFVs1Tm2LA50Mnu1Va1QLKH56ge1rTd_VbqwzRY9vOaUVQmUnPtMy_mC_W1iCpyAOCmo0tsoB0FE23SxXxIH_J6",
      "assetgroupid": 16,
      "assets": [
        {
          "type": "icon",
          "data": {
            "w": 80,
            "h": 80,
            "url": "http://cdn.pubnative.net/games/icons/001/003/592/dimension_80x80.jpg?20161025001049"
          }
        },
        {
          "type": "banner",
          "data": {
            "w": 1200,
            "h": 627,
            "url": "http://cdn.pubnative.net/games/promo_images_landscape/001/003/592/dimension_1200x627.jpg?20160622190318"
          }
        },
        {
          "type": "title",
          "data": {
            "text": "LOVOO Chat, Flirt, Neue Leute"
          }
        },
        {
          "type": "description",
          "data": {
            "text": "Erfolglose Flirts im Café oder doofe Anmachsprüche im Club gehören hiermit der Vergangenheit an!"
          }
        },
        {
          "type": "rating",
          "data": {
            "number": 4
          }
        },
        {
          "type": "cta",
          "data": {
            "text": "Installieren"
          }
        }
      ],
      "meta": [
        {
          "type": "creativeid",
          "data": {
            "text": ""
          }
        },
        {
          "type": "points",
          "data": {
            "number": 380
          }
        },
        {
          "type": "revenuemodel",
          "data": {
            "text": "cpa"
          }
        },
        {
          "type": "campaignid",
          "data": {
            "text": "4897669"
          }
        }
      ],
      "beacons": [
        {
          "type": "impression",
          "data": {
            "url": "http://tr.pubnative.net/impression?aid=1004319&t=UjDL5E6i1M2BSWmv3XSt-a-iiIT_FAmofG6DcIKtrTIzw_qtVwvNJOg0k2izojP5p_oG-39qAD2aqwnCo5RvGMzTrwesUBvnw8a4tH8zZkijFH93230GJnu3GkNTlNvWz7xvNkGhm0Cxf7QXFhKquFLj_iSP8tyCrdEfdvngSbJTo6KH1DZMgvgp7b9ppesmvr2h8RAjkbHTAMLHKU4Edx68t5EEglElXMgQSTwRPANPVWZNHSiq0s_tlb8EpIg9oD0c4RxNtBLS2o4jHBiocXdJPhL7ZDR4FUFyBHdr9qo7gjLdNtsGBFZDpW2u0sFbSo5Gz94FZxPxqv7JPOBMNBNzbhQ2vmSSIqVLROdoit8PQhQoLaHzM2lcqJU3ulPl1NwHVmBZluVnk18ODZI6IR2YFgat3dDugxaOLQw7RDEgdykmFzK98CFQCyqN&tl=444"
          }
        }
      ]
    }
  ]
}

How to use?

  • The server generates a GET request to the relevant ad-format together with the url param, the server returns a json response.
  • The server parses the json according to the ad-format
  • When the ad is shown, our server must be notified about the impression
  • When user clicks on the ad, the server should redirect to the URL which is specified in ad's click_url:
"ads": [
    {
      "link": "http://tr.pubnative.net/click/native?aid=4&t=qyaUDc7fF-_rqXR6BLs_t9z2cpmf_SpRnCmC-r7BpFpxRSBSM_LdwFFbF5yN9Tdz7mkuMpTws22UFVb24k4TmeQRGqSStKi3CzFmqppwCiLPxGANFs88oQlWiex6kqFXZbubHWjBKb9ZdBWrKzgnCmEREdAOEMDvV3W8MVQ-loUv5cgnlQF-gXf-wsBKAytCF4m6zQN2w-TcUYkGH......"
Revenue Models Supported:.
  • CPA or Cost Per Action, which means that users have to download and open th eapp for conversion
  • CPC or Cost Per Click
  • CPM or Cost Per Mille, which is a cost for every 1000 impresssions

Points Calculation:
  • CPA campaign: 1 point = 0.001 USD per conversion
  • CPM campaign: 1 point = 0.001 USD per 1000 impressions
  • CPC campaign: 1 point = 0.001 USD per click

If the points value is 0, please send notification to the PubNative team

Frequently Asked Questions

1. What is impression confirmation?
When the ad is shown, our server must be notified about the impression in order to track the campaign performance correctly.

2. Why is impression confirmation required?
The impression confirmation is a critical part of RTB compliance as well as for the eCPM maximization algorithm and the impression beacon should be triggered when the user actually sees the ad. One of the reasons for this is that campaigns available via RTB are CPM based and if we do not have the impression confirmation at 'seeing' stage, then the revenue will not be counted properly.

Use all available parameters.

Please be noted that overall performance depends on the number of submitted targeting criteria. For example if you decide to share age, gender, location and other demographics in the request it makes it easier to win impressions for RTB demands so we highly recommend to send us all the parameters you can possibly send.

Adding Postback

If you wish to receive conversion postback of certain parameter you send (example: Click ID) please follow below steps:

Checklist Before Activation

After the integration is complete, all that remains is to test the integration and make sure everything is working fine. All for your users' sake.

Request

  • Your request URL includes all required parameters with correct value
  • Your request URL includes user identifiers. (Android Advertiser ID or Apple IDFA)
  • Your request URL have to include adchoices (mf=contentinfo)
  • You are sending requests when user reaches the ad inventory and with planned frequency.
  • The best practice is to request a maximum of 3 ads per user session. Ads should be refreshed after an event (click or download) or after period of non-engagement. This period depends on the length of user sessions and can be from 1 minute to 3 minutes.

Response

Your app works correctly even when there is no fill (API returns no ads). In case anything is wrong with the app PubNative can disable the fill and later enable it back on when the encountered problems are fixed.

Impression

  • You are confirming impressions when the user sees the ad for the first time for a minimum duration of 1 second.
  • You are confirming impressions immediately, in real-time.
  • You shouldn’t confirm impressions twice, even if the user sees the same ad again. One (initial) confirmation is enough.
  • You should confirm multiple impression beacons

Clicks

  • Click happens when the user clicks the advertisement which is linked with the click URL PubNative provides.
  • The click event has to be done by a genuine user and should not be an automated bot or incentivized (rewarded) click.
  • Depending on the type of campaign (app promotion or mobile landing page) the redirect behaviour should be considered
  • for App promotion campaigns, background redirect (hidden browser/webview) is permitted in order to maintain the user experience
  • for mobile landing pages, at the end of the redirect you must make sure to either show an internal browser window (better user experience) or send the user directly to the default mobile browser

Please also send your request URL to PubNative team so we can help you to make sure everything is properly setup and ready to go live!

If you have any questions, don’t hesitate to get in touch: [email protected]

Language
Click Try It! to start a request and see the response here!