{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[],"examples":{"codes":[]},"method":"post"},"next":{"description":"","pages":[]},"title":"Exchange API v1.1 (OpenRTB)","type":"endpoint","slug":"exchange-api-v1-1","excerpt":"","body":"[block:api-header]\n{\n  \"title\": \"Introduction\"\n}\n[/block]\n##**Why RTB?**\nPubNative introduces its RTB solution in order to deliver mobile ads at scale. By pushing this supply-side specification, we allow publishers to enrich their inventory and to deliver better experiences to their users. Our goal is to increase the programmatic delivery of ads by establishing a common framework on the buy-side, which will facilitate the exchange of diverse ad formats.\n\n##**Our technology**\nPubNative built its RTB platform in full respect of the “OpenRTB Native Ads API Specification Version 1.1” and “OpenRTB API Specification Version 2.3” defined by the IAB.\n[block:api-header]\n{\n  \"title\": \"NATIVE AD: Technical Integration\"\n}\n[/block]\n##**1. About the ad format**\nWe support native ads using the following components. Please keep in mind that the components must be specified in the ad request.\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"Main Image\",\n    \"h-0\": \"Component\",\n    \"h-1\": \"Description\",\n    \"h-2\": \"Standard case\",\n    \"1-0\": \"Icon Image\",\n    \"2-0\": \"Title\",\n    \"3-0\": \"Text\",\n    \"4-0\": \"Call to Action\",\n    \"5-0\": \"Star Rating\",\n    \"0-1\": \"Large image preview for the ad\",\n    \"1-1\": \"Small icon for the ad\",\n    \"2-1\": \"Headline or title for the ad\",\n    \"3-1\": \"Open text field describing the ad\",\n    \"4-1\": \"Text field for the call to action button\",\n    \"5-1\": \"For app installs, the app store rating\",\n    \"0-2\": \"Usually 1200x627px image\",\n    \"1-2\": \"Usually 80x80px image\",\n    \"2-2\": \"Text\",\n    \"3-2\": \"Text\",\n    \"4-2\": \"Text\",\n    \"5-2\": \"Rating on scale of 0~5\"\n  },\n  \"cols\": 3,\n  \"rows\": 6\n}\n[/block]\n##**2. Endpoint for Native Request**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://dsp.pubnative.net/bid/v1/request?apptoken=<APP-TOKEN>&zoneid=<YOUR-ZONE-ID>\",\n      \"language\": \"http\"\n    }\n  ]\n}\n[/block]\n* PubNative uses a latency-based load balancer-- the same endpoint works globally, regardless of location.\n* <APP-TOKEN>: can be obtained from PubNative publisher dashboard. Please consult with account manager for this.\n* <YOUR-ZONE-ID>: use default as 1\n\n##**3. Native Request Details**\n* Request Method should be POST\n* Ensure that the bid request body is sent along with the endpoint.\n* Set headers in the request to the following:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"x-openrtb-version: 2.3\\nContent-Type:application/json\\nAccept-Charset:utf-8\",\n      \"language\": \"text\",\n      \"name\": \"Header\"\n    }\n  ]\n}\n[/block]\n##**4. Sample Native Request Body**\n(If you are not sure what parameter and values to pass, check *Object: Native* section in [OpenRTB Spec v2.3](https://www.iab.com/wp-content/uploads/2015/06/OpenRTB-API-Specification-Version-2-3.pdf))\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"id\\\": \\\"30-54e260ae-7456-48de-809c-e983a32e940b\\\",\\n  \\\"tmax\\\": 1500,\\n  \\\"cur\\\": [\\n    \\\"USD\\\"\\n  ],\\n  \\\"imp\\\": [\\n    {\\n      \\\"id\\\": \\\"a672c7f1-f982-461e-8a6b-35de4acdf763\\\",\\n      \\\"instl\\\": 0,\\n      \\\"secure\\\": 0,\\n      \\\"native\\\": {\\n        \\\"request\\\": \\\"{\\\\\\\"native\\\\\\\":{\\\\\\\"ver\\\\\\\":\\\\\\\"1\\\\\\\",\\\\\\\"layout\\\\\\\":6,\\\\\\\"assets\\\\\\\":[{\\\\\\\"id\\\\\\\":0,\\\\\\\"required\\\\\\\":0,\\\\\\\"title\\\\\\\":{\\\\\\\"len\\\\\\\":100}},{\\\\\\\"id\\\\\\\":2,\\\\\\\"required\\\\\\\":1,\\\\\\\"img\\\\\\\":{\\\\\\\"type\\\\\\\":1,\\\\\\\"wmin\\\\\\\":50,\\\\\\\"hmin\\\\\\\":50}},{\\\\\\\"id\\\\\\\":3,\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":2,\\\\\\\"len\\\\\\\":90}},{\\\\\\\"id\\\\\\\":4,\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":3}},{\\\\\\\"id\\\\\\\":5,\\\\\\\" required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":12,\\\\\\\"len\\\\\\\":15}},{\\\\\\\"id\\\\\\\":1,\\\\\\\"required\\\\\\\":0,\\\\\\\"img\\\\\\\":{\\\\\\\"type\\\\\\\":3,\\\\\\\"wmin\\\\\\\":300,\\\\\\\"hmin\\\\\\\":250}}]}}\\\"\\n      },\\n      \\\"bidfloor\\\": 0.01\\n    }\\n  ],\\n  \\\"device\\\": {\\n    \\\"dnt\\\": 0,\\n    \\\"devicetype\\\": 1,\\n    \\\"geo\\\": {\\n      \\\"country\\\": \\\"USA\\\",\\n      \\\"type\\\": 2,\\n      \\\"lat\\\": 37.751,\\n      \\\"lon\\\": -97.822\\n    },\\n    \\\"connectiontype\\\": 6,\\n    \\\"language\\\": \\\"en\\\",\\n    \\\"model\\\": \\\"Nexus 5X\\\",\\n    \\\"make\\\": \\\"LGE\\\",\\n    \\\"carrier\\\": \\\"311-480\\\",\\n    \\\"didsha1\\\": \\\"e2660d7edf9f7ea18a301d5b913b5e633561d1e2\\\",\\n    \\\"ifa\\\": \\\"69144c0f-1fb5-4201-8951-5a64be39e134\\\",\\n    \\\"os\\\": \\\"android\\\",\\n    \\\"osv\\\": \\\"7.1.1\\\",\\n    \\\"ua\\\": \\\"Dalvik/2.1.0 (Linux; U; Android 7.1.1; Nexus 5X Build/N4F26O)\\\",\\n    \\\"ip\\\": \\\"174.204.16.28\\\"\\n  },\\n  \\\"at\\\": 2,\\n  \\\"bcat\\\": [\\n    \\\"IAB24\\\",\\n    \\\"IAB25\\\",\\n    \\\"IAB26\\\"\\n  ],\\n  \\\"user\\\": {\\n    \\\"id\\\": \\\"098a1c70-94db-409d-8c8e-10983e689518\\\"\\n  },\\n  \\\"app\\\": {\\n    \\\"id\\\": \\\"1008118\\\",\\n    \\\"name\\\": \\\"Test_Android\\\",\\n    \\\"bundle\\\": \\\"com.android.test\\\",\\n    \\\"cat\\\": [\\n      \\\"IAB2-1\\\",\\n      \\\"IAB2-2\\\"\\n    ],\\n    \\\"storeurl\\\": \\\"https://play.google.com/store/apps/details?id=com.android.test\\\",\\n    \\\"keywords\\\": \\\"test, android\\\",\\n    \\\"privacypolicy\\\": 1,\\n    \\\"publisher\\\": {\\n      \\\"id\\\": \\\"pub12345\\\",\\n      \\\"name\\\": \\\"Publisher A\\\"\\n    }\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"App\"\n    },\n    {\n      \"code\": \"{\\n  \\\"id\\\": \\\"30-54e260ae-7456-48de-809c-e983a32e940b\\\",\\n  \\\"tmax\\\": 1500,\\n  \\\"cur\\\": [\\n    \\\"USD\\\"\\n  ],\\n  \\\"imp\\\": [\\n    {\\n      \\\"id\\\": \\\"a672c7f1-f982-461e-8a6b-35de4acdf763\\\",\\n      \\\"instl\\\": 0,\\n      \\\"secure\\\": 0,\\n      \\\"native\\\": {\\n        \\\"request\\\": \\\"{\\\\\\\"native\\\\\\\":{\\\\\\\"ver\\\\\\\":\\\\\\\"1\\\\\\\",\\\\\\\"layout\\\\\\\":6,\\\\\\\"assets\\\\\\\":[{\\\\\\\"id\\\\\\\":0,\\\\\\\"required\\\\\\\":0,\\\\\\\"title\\\\\\\":{\\\\\\\"len\\\\\\\":100}},{\\\\\\\"id\\\\\\\":2,\\\\\\\"required\\\\\\\":1,\\\\\\\"img\\\\\\\":{\\\\\\\"type\\\\\\\":1,\\\\\\\"wmin\\\\\\\":50,\\\\\\\"hmin\\\\\\\":50}},{\\\\\\\"id\\\\\\\":3,\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":2,\\\\\\\"len\\\\\\\":90}},{\\\\\\\"id\\\\\\\":4,\\\\\\\"required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":3}},{\\\\\\\"id\\\\\\\":5,\\\\\\\" required\\\\\\\":0,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":12,\\\\\\\"len\\\\\\\":15}},{\\\\\\\"id\\\\\\\":1,\\\\\\\"required\\\\\\\":0,\\\\\\\"img\\\\\\\":{\\\\\\\"type\\\\\\\":3,\\\\\\\"wmin\\\\\\\":300,\\\\\\\"hmin\\\\\\\":250}}]}}\\\"\\n      },\\n      \\\"bidfloor\\\": 0.01\\n    }\\n  ],\\n  \\\"device\\\": {\\n    \\\"dnt\\\": 0,\\n    \\\"devicetype\\\": 1,\\n    \\\"geo\\\": {\\n      \\\"country\\\": \\\"USA\\\",\\n      \\\"type\\\": 2,\\n      \\\"lat\\\": 37.751,\\n      \\\"lon\\\": -97.822\\n    },\\n    \\\"connectiontype\\\": 6,\\n    \\\"language\\\": \\\"en\\\",\\n    \\\"model\\\": \\\"Nexus 5X\\\",\\n    \\\"make\\\": \\\"LGE\\\",\\n    \\\"carrier\\\": \\\"311-480\\\",\\n    \\\"didsha1\\\": \\\"e2660d7edf9f7ea18a301d5b913b5e633561d1e2\\\",\\n    \\\"ifa\\\": \\\"69144c0f-1fb5-4201-8951-5a64be39e134\\\",\\n    \\\"os\\\": \\\"android\\\",\\n    \\\"osv\\\": \\\"7.1.1\\\",\\n    \\\"ua\\\": \\\"Dalvik/2.1.0 (Linux; U; Android 7.1.1; Nexus 5X Build/N4F26O)\\\",\\n    \\\"ip\\\": \\\"174.204.16.28\\\"\\n  },\\n  \\\"at\\\": 2,\\n  \\\"bcat\\\": [\\n    \\\"IAB24\\\",\\n    \\\"IAB25\\\",\\n    \\\"IAB26\\\"\\n  ],\\n  \\\"user\\\": {\\n    \\\"id\\\": \\\"098a1c70-94db-409d-8c8e-10983e689518\\\"\\n  },\\n  \\\"site\\\": {\\n    \\\"id\\\": \\\"1345135123\\\",\\n    \\\"name\\\": \\\"Site ABCD\\\",\\n    \\\"domain\\\": \\\"siteabcd.com\\\",\\n    \\\"cat\\\": [\\n      \\\"IAB2-1\\\",\\n      \\\"IAB2-2\\\"\\n    ],\\n    \\\"page\\\": \\\"http://siteabcd.com/page.htm\\\",\\n    \\\"ref\\\": \\\"http://referringsite.com/referringpage.htm\\\",\\n    \\\"privacypolicy\\\": 1,\\n    \\\"publisher\\\": {\\n      \\\"id\\\": \\\"pub12345\\\",\\n      \\\"name\\\": \\\"Publisher A\\\"\\n    }\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Web\"\n    }\n  ]\n}\n[/block]\n##**5. Sample Native Response**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"id\\\": \\\"30-54e260ae-7456-48de-809c-e983a32e940b\\\",\\n    \\\"seatbid\\\": [\\n        {\\n            \\\"bid\\\": [\\n                {\\n                    \\\"id\\\": \\\"dfa946e82b63472984f6454567279060\\\",\\n                    \\\"impid\\\": \\\"a672c7f1-f982-461e-8a6b-35de4acdf763\\\",\\n                    \\\"price\\\": 0.01,\\n                    \\\"adid\\\": \\\"test_campaign\\\",\\n                    \\\"nurl\\\": \\\"http://got.pubnative.net/dspv1/winnotice?ap=${AUCTION_PRICE}&t=yxXyP7cxSbGUWd_HEgzcLCYrzfUnnHkCWkOzV5sOK-RgUHk1_IUtayyP-HK20Q5TQ8jNM1QNB7nszMaJcbOSRfCBsQ\\\",\\n                    \\\"adm\\\": \\\"{\\\\\\\"native\\\\\\\":{\\\\\\\"assets\\\\\\\":[{\\\\\\\"id\\\\\\\":4,\\\\\\\"data\\\\\\\":{\\\\\\\"label\\\\\\\":\\\\\\\"rating\\\\\\\",\\\\\\\"value\\\\\\\":\\\\\\\"4.50\\\\\\\"}},{\\\\\\\"id\\\\\\\":5,\\\\\\\"data\\\\\\\":{\\\\\\\"label\\\\\\\":\\\\\\\"cta\\\\\\\",\\\\\\\"value\\\\\\\":\\\\\\\"Test me\\\\\\\"}},{\\\\\\\"id\\\\\\\":1,\\\\\\\"img\\\\\\\":{\\\\\\\"url\\\\\\\":\\\\\\\"http://cdn.pubnative.net/assets/mock_main_image.jpg\\\\\\\",\\\\\\\"w\\\\\\\":300,\\\\\\\"h\\\\\\\":250}},{\\\\\\\"id\\\\\\\":0,\\\\\\\"title\\\\\\\":{\\\\\\\"text\\\\\\\":\\\\\\\"PubNative Content Info\\\\\\\"}},{\\\\\\\"id\\\\\\\":2,\\\\\\\"required\\\\\\\":1,\\\\\\\"img\\\\\\\":{\\\\\\\"url\\\\\\\":\\\\\\\"http://cdn.pubnative.net/assets/mock_icon.jpg\\\\\\\",\\\\\\\"w\\\\\\\":50,\\\\\\\"h\\\\\\\":50}},{\\\\\\\"id\\\\\\\":3,\\\\\\\"data\\\\\\\":{\\\\\\\"label\\\\\\\":\\\\\\\"description\\\\\\\",\\\\\\\"value\\\\\\\":\\\\\\\"Pubnative Test Ad\\\\\\\"}}],\\\\\\\"link\\\\\\\":{\\\\\\\"url\\\\\\\":\\\\\\\"http://got.pubnative.net/click/rtb?aid=1008118&t=cD2xSi4VtfNdWk0_gVrQCOhJxwdrTFZXe9VKQYhA2YUBcRZPEWsJOt4ilYasAKbyuKTruh_v4lJNr7zUc9W1u8gev2eaaMHdGgsuiwQtbFxbyoaAVNEUJFpx0E_Hdvmpx7qgxkQKKNekewZwJApED6F7NalLG4LLYI4Z031WOfRT7oi7Nfkun-7jdE1L03QppuY6aruKsdsG-aexh4lqFnFGZX0URfG_Ftai7ua6fkDnr8-yiXd-yMXhSQjtfmFbNLyQSMPX_azTpcIT1muZrmPvJ4_S_Q_gY8KUf5J1fidnfS1jN3LOeW84GxCBnpjnzSRurVoS-wSzygvkt4LU15JTWHTWVEaVEFxB1W-vK01UskrQn-1hImd8Gtp6gy39ISYlhWkbTePjQrbcp54AjT9HTR6B4NWviYbG9fEBmcDpubEnGiBIztOYa_hmOtw1mVxszCa4FgaC2M5jwltbx1iuByfcGVgIiQxAkltWvwDpLwIAMJ8CzOXOFSY5fI0dKnFygDHimM7vMr7DcGZODWWnb-c6F6kaGelfLH_eoSc2tVEnbVVpB3mvs6mOZIE9FUms6y2Epc5MQW5IJdOEntRZryYNQFUJImxKC9_BVAdx2_V_8-93kc9TZkWWoZRPhoxhIA\\\\\\\",\\\\\\\"clicktrackers\\\\\\\":[\\\\\\\"http://mock-dsp.pubnative.net/tracker/clk?app_id=1008118&beacon=1&p=${AUCTION_PRICE}\\\\\\\",\\\\\\\"http://mock-dsp.pubnative.net/tracker/clk?app_id=1008118&beacon=2&p=${AUCTION_PRICE}\\\\\\\"]},\\\\\\\"imptrackers\\\\\\\":[\\\\\\\"http://got.pubnative.net/rtb/beacon?t=WiNGlVZWd1t8gxUdC3ls2XgFJ4TyNoXEamlxzu91qGjifY8KgCZJeaxcUGO51h5Gt6VZyxh8nySQG1VXFoywXwII--ILXJhWsfp_zx671xBw1ScTwvwM3gkLlTSqRKYZBYCmoPFyUGng&p=${AUCTION_PRICE}\\\\\\\",\\\\\\\"http://got.pubnative.net/rtb/beacon?t=1x6SLfSJJvo7J7Dv0FppBNrTBsSacqRKY_cE53bY3FAsl1XeACKaIwQXqeDn4Z6etV6PKOOVw3jz0tUNbW_fnh8s9Ng7OaKRnZSNrwgVEQ3oNZNwEhC_sYHAxbh4ogxAhU_4ntr_JYF53CuegNVYDwE&p=${AUCTION_PRICE}\\\\\\\",\\\\\\\"http://got.pubnative.net/rtb/beacon?t=nhiwXs2HODx6mYKtA13pGIUJ7fb7Oq7hy4cLUVmGeTBUIgMSkausUe9sdZu1d-F-BEH6LiS3yOBvNOGgD3T0FpPEU3ytfwdjXP3cVKMYJMP3kyYiFG7ON6ys0ff-jCXZ0tE3_1Sx0PeDscHotcwbkCs&p=${AUCTION_PRICE}\\\\\\\",\\\\\\\"http://got.pubnative.net/rtb/beacon?t=SucIlpiKbu1CTkNjL6ED63xWY-PMR79WINYBQ1E2pUS5T-BtSMM5Y1kPtS4qfljeH536uGl5hsVgD9fHwpPRfAyih4GZCZCmtYwl2YcFKVX2ZbEj_2zjZJw6-nu71GyRTJwZ1HRtXwn9WpQ-RnRjf0I&p=${AUCTION_PRICE}\\\\\\\",\\\\\\\"http://got.pubnative.net/rtb/beacon?t=29jxnKwqwMhz-57j9y1RlkWSVqk3y-E7LFDUPJl02TqvEVP5S6xovuVcFBC4GLvOPqLoA6AhwuX34s-w3u-s5_DGvA7rxCL6lO_h1Guu593pIrQAu6jWgb5O6jZpK-Ouf6BKHds0RLAxiP5DHymUa_U&p=${AUCTION_PRICE}\\\\\\\",\\\\\\\"http://got.pubnative.net/rtb/beacon?t=6PsrSiuXp1Hly-BHjzlrz6DJOADMcw27k4JqhSbnHPVLKHCxhxUnnfKV6ZsJUlYk-qUYwsUHBGxDa6Q8FrE-wpd1sOuuuQyxpHJZ8McJa0h4i0koXkMp6zxfIv4peCr8fIlpnmkvLG_Dfzi8ZvCHeZc&p=${AUCTION_PRICE}\\\\\\\",\\\\\\\"http://got.pubnative.net/rtb/beacon?t=ImmP3n_EwTQCjK0dyw-E_wrxlbMTwUXbupO2w_pWo1B5HGetFH11yxjaJx6DAehfPRl7X0iXa7Em4CGRi6IT43vVere1CVEsv-vWC3nqNk10495KYVxMeTqF7X66Cs-wh6uQr8bJ4ERAN57aV0PKhm4&p=${AUCTION_PRICE}\\\\\\\",\\\\\\\"http://got.pubnative.net/rtb/beacon?t=uSIMS1wS-Of4KC8k6mjAzfm1x6Ug31M1HXABxPFm_ypuPPvIi6Y5khwb3z6O7OFd1Uu3HExuuxjrBYlnd6KLjg_WrO6-qnX0Nc2OIGKiQ4ka7xvZfvsbT-CN0hzAJ5UPBnfA_ImBLTWYXL4S0WFdVZ0&p=${AUCTION_PRICE}\\\\\\\",\\\\\\\"http://got.pubnative.net/rtb/beacon?t=o1XOQYNBrKTI_aQvuHjBZnI8jCkr59T5SW6X1f9fl1eUx6JmcDBBniwyDNBUkdptKqmlvcRqF5oTZE2WrkgQIXKBvwyU-RnVO0HucN7dGU3QKAcoyOcZMJDIpoxSu79QSKCJLIWaAM94N1NqbxsEKHA&p=${AUCTION_PRICE}\\\\\\\",\\\\\\\"http://got.pubnative.net/rtb/beacon?t=ibTKopug071TDzPZwSspeOdWqA6RU3NMjB2-jm8gdpjTJkFzh36c46e8jncCotz3NJG7ZmUQbiJKfKzC6eDxPKsjNQ_lvv_ius4FSgraE3PvTdeigRYYD5TzRemX0JxZjZkh2VkK3zyTi6kXAMmW7qg&p=${AUCTION_PRICE}\\\\\\\",\\\\\\\"http://got.pubnative.net/rtb/beacon?t=fOzwTvtgf6exzog8i-6ZTKgeLRDMcT_wmWpadJmAaARQzFXvddjEv0do5Im6ZjcAb968ca89O9Re4a4Fin6c3-53azxNndQkceJJ_oxmOzMirNawyQn_2zAvcbrm2lc3FIQq0NHDr-SdQoSMmp_I00xt&p=${AUCTION_PRICE}\\\\\\\",\\\\\\\"http://got.pubnative.net/rtb/beacon?t=TRgZZa2qAjJyiYM0B9r4InX6Dpm9X0TlYJQueTy0v5OyYZ8KRzZzY12j1G3QaFsd7DrRZDBy3T8P9kD-wpzPQx5NWOtaNi8hJAlm4budhF1nJBJ8QAbTbSESCkuU7MkDeAQlr4uzbmNk9VSKO0MOLbsaUdIFyGS2k9QyfqFRc3DWfJN_HK2owtu_34l_B__LNlBnI5198IzcBGptCVZwkhR46PWY7SN1SjtaLUAR1Nb6yes4DuXu3nv9OmvNMYGk6LXdA4Tjne7Hkg3FD_-pyuMNyA4CU54JQiSWkW3vtJvIHzNPDuzzhUlwrvMVQB9etXQPKnIsRlIoehiZ03BPRo5pCWsL5aLCjworyAE4QWEJHGZAJT3Iycp5Mxdpar2aJdLzxTGY93gDZw9q6CUIf5911UP8cjpR7pvprsHkDUz-iJv91yZEdGffqeIZjA2w3fg-Z76enbtophEmlfcudpQTZXyflmbIaikdhQAm2GANstvqcjunbKrL17FQiQ7sXDsepLoqztJPqRNzVbKUFVA23SZjLzJ7F246uQ8ATU0Lzx1Es9eeXJ80VaCrMatScH-g09SrMf8xfPMpKnBrx2QgIcTPeU5Mm_2_zkDShLkcy8EzFDfZe8I3wZ34yRhFaz1pgPc_aAmgIXJ1wRSqv9HHgxuuyfskbx27VJ-gvD9CKlpplRuNERO48s-xFfUN20KlLpQEVtc2VchE57EYpcOXvrYwRxDq0PpoRYCJt2YkoPCx91P-aRy8TnSOO8RXQJTrhNkT_fWgCZL-e6nihvtkmN-S7rSERKgR4eS8fSLSLWwow8Dp-lMWcckDWoKH5Kdy5Ky5n59Pwggz_cGBKGyQCSzoPAY6tc_objgDNwT2JwwU1m06s6kotvVsn08Qp--nRlp9u8qj7sg_J1LSjdPFxtSUXf11PvdpLycDM_84-30SV5kqBOjC28L9E4QYsXXWBB_pcrF6ybkW8HSIYiIcWnz-QiVMOUBnTVcdWq-FbHZd4RGswbCyG65mBXPL_EAJljSd3wl7psET-4KGcs-Pj68_oIcpYjD9XzoBGyQioKaz9wyXOsJiS-xbeuEQ-j195_6pPKm3_94j4ZkX80x-1cfrVEkpXCNfW_EXEX9hER3EuL87lvLW0Ii-Ycw3pa50SiOFM4Z3Ye9zzmiJ2mjILq_lAqL0KqcoUE3bzrjHc_ES_6oiPEdD1lgulkVB3iFZnLQhF4t6jUKFbaCcgYixtehps-YnZSs2YXbmZofRGlza0N5u5AW-UbOf-DPR-4luoR917RHk3YNVTdgqk1gCamgudqhI&p=${AUCTION_PRICE}\\\\\\\"]}}\\\",\\n                    \\\"adomain\\\": [\\n                        \\\"pubnative.net\\\"\\n                    ],\\n                    \\\"iurl\\\": \\\"http://got.pubnative.net/rtb/beacon?t=HH1LxYlb8NXCLx_kb5fPzSWGJJtDDV48jm6AuR6VIXXCTI2qjB6u7XADoev1LTQSSRWm8YiNUhLPUD3x2pbTZN4VI1su0efy4HsZhf71njM-vtBTf_eNj_xQZamn0Z_vrV4yXk6syg2E&p=${AUCTION_PRICE}\\\",\\n                    \\\"cid\\\": \\\"test_campaign\\\",\\n                    \\\"crid\\\": \\\"test_creative\\\",\\n                    \\\"attr\\\": [\\n                        4\\n                    ]\\n                }\\n            ]\\n        }\\n    ],\\n    \\\"cur\\\": \\\"USD\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"STANDARD AD: Technical Integration\"\n}\n[/block]\n##**1. About the ad format**\nWe currently support standard format ads (a.k.a \"display\") using the following ad sizes. Please keep in mind that these components must be specified in the ad request.\n\n* 160 x 600\n* 250 x 250\n* 300 x 50\n* 300 x 250\n* 300 x 600\n* 320 x 50\n* 320 x 100\n* 320 x 480\n* 480 x 320\n* 728 x 90\n* 768 x 1024\n* 1024 x 768\n\n##**2. Endpoint for Standard Request**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://dsp.pubnative.net/bid/v1/request?apptoken=<APP-TOKEN>&zoneid=<YOUR-ZONE-ID>\",\n      \"language\": \"http\"\n    }\n  ]\n}\n[/block]\n* PubNative uses a latency-based load balancer-- the same endpoint works globally, regardless of location.\n* <APP-TOKEN>: can be obtained from PubNative publisher dashboard. Please consult with account manager for this.\n* <YOUR-ZONE-ID>: use default as 1\n\n##**3. Standard Request Details**\n* Request Method should be POST\n* Ensure that the bid request is in the body of the request\n* Set headers in the request to the following:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"x-openrtb-version: 2.3\\nContent-Type:application/json\\nAccept-Charset:utf-8\",\n      \"language\": \"text\",\n      \"name\": \"Header\"\n    }\n  ]\n}\n[/block]\n##**4. Sample Standard Request Body**\n(If you are not sure what parameter and values to pass, check *Object: Banner* section in [OpenRTB Spec v2.3](https://www.iab.com/wp-content/uploads/2015/06/OpenRTB-API-Specification-Version-2-3.pdf))\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"id\\\": \\\"92d6421e44a44dff9f05b29be0ca5bef\\\",\\n  \\\"imp\\\": [\\n    {\\n      \\\"id\\\": \\\"94628ee5-fe99-436d-94b5-f3270ad06529\\\",\\n      \\\"banner\\\": {\\n        \\\"w\\\": 300,\\n        \\\"h\\\": 250\\n      },\\n      \\\"tagid\\\": \\\"1\\\",\\n      \\\"bidfloor\\\": 0.01,\\n      \\\"bidfloorcurdan\\\": \\\"USD\\\",\\n      \\\"secure\\\": 1\\n    }\\n  ],\\n  \\\"app\\\": {\\n    \\\"id\\\": \\\"1008118\\\",\\n    \\\"name\\\": \\\"Test_Android\\\",\\n    \\\"bundle\\\": \\\"com.android.test\\\",\\n    \\\"cat\\\": [\\n      \\\"IAB2-1\\\",\\n      \\\"IAB2-2\\\"\\n    ],\\n    \\\"storeurl\\\": \\\"https://play.google.com/store/apps/details?id=com.android.test\\\",\\n    \\\"keywords\\\": \\\"test, android\\\",\\n    \\\"privacypolicy\\\": 1,\\n    \\\"publisher\\\": {\\n      \\\"id\\\": \\\"pub12345\\\",\\n      \\\"name\\\": \\\"Publisher A\\\"\\n    }\\n  },\\n  \\\"device\\\": {\\n    \\\"ua\\\": \\\"Dalvik/2.1.0 (Linux; U; Android 6.0; MotoG3 Build/MPI24.65-25)\\\",\\n    \\\"ip\\\": \\\"107.219.186.28\\\",\\n    \\\"geo\\\": {\\n      \\\"lat\\\": 33.9775,\\n      \\\"lon\\\": -118.2133,\\n      \\\"country\\\": \\\"USA\\\",\\n      \\\"region\\\": \\\"CA\\\",\\n      \\\"city\\\": \\\"los angeles\\\",\\n      \\\"zip\\\": \\\"90001\\\",\\n      \\\"type\\\": 1\\n    },\\n    \\\"carrier\\\": \\\"att internet services\\\",\\n    \\\"language\\\": \\\"en\\\",\\n    \\\"model\\\": \\\"Moto G3\\\",\\n    \\\"os\\\": \\\"Android\\\",\\n    \\\"osv\\\": \\\"6.0\\\",\\n    \\\"connectiontype\\\": 2,\\n    \\\"devicetype\\\": 1,\\n    \\\"ifa\\\": \\\"03F9F0E4-937D-4F85-9275-F530E0107B2F\\\"\\n  },\\n  \\\"user\\\": {\\n    \\\"id\\\": \\\"50cf7979-18a7-51dd-9645-091009ad842f\\\"\\n  },\\n  \\\"at\\\": 2,\\n  \\\"tmax\\\": 1500,\\n  \\\"allimps\\\": 0,\\n  \\\"cur\\\": [\\n    \\\"USD\\\"\\n  ],\\n  \\\"bcat\\\": [\\n    \\\"IAB24\\\",\\n    \\\"IAB25\\\",\\n    \\\"IAB26\\\"\\n  ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"App\"\n    },\n    {\n      \"code\": \"{\\n  \\\"id\\\": \\\"92d6421e44a44dff9f05b29be0ca5bef\\\",\\n  \\\"imp\\\": [\\n    {\\n      \\\"id\\\": \\\"94628ee5-fe99-436d-94b5-f3270ad06529\\\",\\n      \\\"banner\\\": {\\n        \\\"w\\\": 300,\\n        \\\"h\\\": 250\\n      },\\n      \\\"tagid\\\": \\\"1\\\",\\n      \\\"bidfloor\\\": 0.01,\\n      \\\"bidfloorcurdan\\\": \\\"USD\\\"\\n    }\\n  ],\\n  \\\"site\\\": {\\n    \\\"id\\\": \\\"1345135123\\\",\\n    \\\"name\\\": \\\"Site ABCD\\\",\\n    \\\"domain\\\": \\\"siteabcd.com.com\\\",\\n    \\\"cat\\\": [\\n      \\\"IAB2-1\\\",\\n      \\\"IAB2-2\\\"\\n    ],\\n    \\\"page\\\": \\\"http://siteabcd.com/page.htm\\\",\\n    \\\"ref\\\": \\\"http://referringsite.com/referringpage.htm\\\",\\n    \\\"privacypolicy\\\": 1,\\n    \\\"publisher\\\": {\\n      \\\"id\\\": \\\"pub12345\\\",\\n      \\\"name\\\": \\\"Publisher A\\\"\\n    }\\n  },\\n  \\\"device\\\": {\\n    \\\"ua\\\": \\\"Dalvik/2.1.0 (Linux; U; Android 6.0; MotoG3 Build/MPI24.65-25)\\\",\\n    \\\"ip\\\": \\\"107.219.186.28\\\",\\n    \\\"geo\\\": {\\n      \\\"lat\\\": 33.9775,\\n      \\\"lon\\\": -118.2133,\\n      \\\"country\\\": \\\"USA\\\",\\n      \\\"region\\\": \\\"CA\\\",\\n      \\\"city\\\": \\\"los angeles\\\",\\n      \\\"zip\\\": \\\"90001\\\",\\n      \\\"type\\\": 1\\n    },\\n    \\\"carrier\\\": \\\"att internet services\\\",\\n    \\\"language\\\": \\\"en\\\",\\n    \\\"model\\\": \\\"Moto G3\\\",\\n    \\\"os\\\": \\\"Android\\\",\\n    \\\"osv\\\": \\\"6.0\\\",\\n    \\\"connectiontype\\\": 2,\\n    \\\"devicetype\\\": 1,\\n    \\\"ifa\\\": \\\"03F9F0E4-937D-4F85-9275-F530E0107B2F\\\"\\n  },\\n  \\\"user\\\": {\\n    \\\"id\\\": \\\"50cf7979-18a7-51dd-9645-091009ad842f\\\"\\n  },\\n  \\\"at\\\": 2,\\n  \\\"tmax\\\": 1500,\\n  \\\"allimps\\\": 0,\\n  \\\"cur\\\": [\\n    \\\"USD\\\"\\n  ],\\n  \\\"bcat\\\": [\\n    \\\"IAB24\\\",\\n    \\\"IAB25\\\",\\n    \\\"IAB26\\\"\\n  ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Web\"\n    }\n  ]\n}\n[/block]\n##**5. Sample Standard Response**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"id\\\": \\\"92d6421e44a44dff9f05b29be0ca5bef\\\",\\n    \\\"seatbid\\\": [\\n        {\\n            \\\"bid\\\": [\\n                {\\n                    \\\"id\\\": \\\"9cafcb3224fb45839f509abcca974f5c\\\",\\n                    \\\"impid\\\": \\\"94628ee5-fe99-436d-94b5-f3270ad06529\\\",\\n                    \\\"price\\\": 0.01,\\n                    \\\"adid\\\": \\\"test_campaign\\\",\\n                    \\\"nurl\\\": \\\"https://got.pubnative.net/dspv1/winnotice?ap=${AUCTION_PRICE}&t=8m0OJBZ7871n3RGbrC6jz8mmgocK3okt1DBd_36kZURw8Vf56tf2wDF-Nd7e4i1XnxggaauMDjNEst1xmIrGW-JitQ\\\",\\n                    \\\"adm\\\": \\\"<a href=\\\\\\\"http://ads.com/click/112770_1386565997\\\\\\\"><img src=\\\\\\\"https://cdn.pubnative.net/widget/v3/assets/300x250.jpg\\\\\\\" width=\\\\\\\"300\\\\\\\" height=\\\\\\\"250\\\\\\\" border=\\\\\\\"0\\\\\\\" alt=\\\\\\\"Advertisement\\\\\\\" /></a><img src=\\\\\\\"http://mock-dsp.pubnative.net/tracker/nurl?app_id=1008118&p=${AUCTION_PRICE}\\\\\\\" style=\\\\\\\"display:none\\\\\\\"/><img src=\\\\\\\"https://got.pubnative.net/impression?aid=1008118&t=QduxwF1RKZT6blfGfU2pjf5vOxe3GWrj9k9Fy8xHWoclDkRFCCqNXV-HcDU74JlYzXikknQ5ndfxRfkLTXrlUIpNLZTtR5sJW_ynhlClj9yVphyIxT-E21TVNjyEYPdjDfpx-ruNp7_xkN8zkGCfq6eqOoZmASdD7ZxUNeL52IsWEhrkRxOIGpwuiXSxI-M7taWBMF3eEB6ZMvW7Sh2rawLmjL1i8tCd-62MVdY4Z2wIQr7CkD6Nm7UDnUs4bKGNrVn1Y7wwnpl9iEo5UGuqCstkuMugwxwxT__qtdrnIO13GkzAR4qpKVfaaK15xJjJn9CRAbx88jsWAYLwpcAXOcFztVOLFbEc-9nJryuMz32DlHd_ghHCHTRikA_olUFoC9gpnlkEp16a4X5OgbOuGtg5ZOEOjJ22BHDKw9jbdjy_eQY-ClBwFUFSolO6hl8F-AHkw3S3mnM-RC1E89KdX9I19Esdme7QIJmhcnQS5qZYJWiLTiwc-rzpb-QXxlG0SK0WT1iqQBO8JYjD8CYgzlvsIsDCa5_BuUXtV8__8_zpveVt0jgYQhwDrl4vWI4aTmMGi8PyDemEBhPufmsra6jrKwZ9ZOSmxsBppJk3YJgJE4uSwWiBw91GSxgHj8kUGaOREqsC9KGLm9ABcqtm-ImoCYas1ZeiyilfInrxUTqBStqIDbgqbROoTW8GhdySNX2OE7nTEDQ1hqkSVqLuJVM0i4-Iu7BEzOBa8pIaHSPKrhHlzVkdbWQdcDqI7O1Y16aK6rrenRsC5-eWmCPAsCuTQ7-_PGUMrFYqZFKHowPzd-Mwnil_Ne16&ap=${AUCTION_PRICE}&px=1\\\\\\\" style=\\\\\\\"display:none\\\\\\\"/>\\\",\\n                    \\\"adomain\\\": [\\n                        \\\"pubnative.net\\\"\\n                    ],\\n                    \\\"iurl\\\": \\\"https://got.pubnative.net/rtb/beacon?t=q8JQ4OLM0au1mRj81xoNIg6cYepOvPKYSoF1PBC1Xhlxfdb7UqNeHKEqdz54MIM4-NJC6KbcbcQXYILR1H9mTAu07JwrdH7v0RFoxv9XKXpdwDAaRVaMFvQV5n_5uLmFR-6_-THn-ZOU&p=${AUCTION_PRICE}\\\",\\n                    \\\"cid\\\": \\\"test_campaign\\\",\\n                    \\\"crid\\\": \\\"test_creative\\\",\\n                    \\\"attr\\\": [\\n                        4\\n                    ]\\n                }\\n            ]\\n        }\\n    ],\\n    \\\"cur\\\": \\\"USD\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"VIDEO AD: Technical Integration\"\n}\n[/block]\n##**1. About the ad format**\nWe currently support video ads using the following ad sizes. Please keep in mind that these components must be specified in the ad request.\n\n* 320 x 480\n* 480 x 320\n* 300 x 250\n* 1024 x 768\n* 768 x 1024\n\nNOTE: the ads will be in VAST 2.0 and VAST Wrapper format. VPAID is not supported at the moment.\n\n##**2. Endpoint for Video Request**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://dsp.pubnative.net/bid/v1/request?apptoken=<APP-TOKEN>&zoneid=<YOUR-ZONE-ID>\",\n      \"language\": \"http\"\n    }\n  ]\n}\n[/block]\n* PubNative uses a latency-based load balancer-- the same endpoint works globally, regardless of location.\n* <APP-TOKEN>: can be obtained from PubNative publisher dashboard. Please consult with account manager for this.\n* <YOUR-ZONE-ID>: use default as 1\n\n##**3. Standard Video Request Details**\n* Request Method should be POST\n* Ensure that the bid request is in the body of the request\n* Set headers in the request to the following:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"x-openrtb-version: 2.3\\nContent-Type:application/json\\nAccept-Charset:utf-8\",\n      \"language\": \"text\",\n      \"name\": \"Header\"\n    }\n  ]\n}\n[/block]\n##**4. Sample Video Request Body**\n(If you are not sure what parameter and values to pass, check *Object: Video* section in [OpenRTB Spec v2.3](https://www.iab.com/wp-content/uploads/2015/06/OpenRTB-API-Specification-Version-2-3.pdf))\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"id\\\": \\\"5de66583-4534-4df8-a9ee-0feb2116bb5b\\\",\\n  \\\"imp\\\": [\\n    {\\n      \\\"id\\\": \\\"0526d52d-c988-45db-b911-d128e6e47a29\\\",\\n      \\\"video\\\": {\\n        \\\"mimes\\\": [\\n          \\\"video/mp4\\\"\\n        ],\\n        \\\"minduration\\\": 5,\\n        \\\"maxduration\\\": 30,\\n        \\\"protocols\\\": [\\n          1,\\n          2,\\n          3,\\n          4,\\n          5,\\n          6\\n        ],\\n        \\\"w\\\": 320,\\n        \\\"h\\\": 568,\\n        \\\"linearity\\\": 1,\\n        \\\"playbackmethod\\\": [\\n          1,\\n          2,\\n          3,\\n          4\\n        ],\\n        \\\"delivery\\\": [\\n          1,\\n          2\\n        ],\\n        \\\"api\\\": [\\n          3,\\n          5\\n        ]\\n      },\\n      \\\"displaymanager\\\": \\\"sampledisplaymanager\\\",\\n      \\\"displaymanagerver\\\": \\\"2.0.0\\\",\\n      \\\"instl\\\": 1,\\n      \\\"tagid\\\": \\\"35\\\",\\n      \\\"bidfloor\\\": 0.01,\\n      \\\"bidfloorcur\\\": \\\"USD\\\"\\n    }\\n  ],\\n  \\\"app\\\": {\\n    \\\"id\\\": \\\"66755\\\",\\n    \\\"name\\\": \\\"Meloman bykov\\\",\\n    \\\"bundle\\\": \\\"1210207476\\\",\\n    \\\"storeurl\\\": \\\"https://itunes.apple.com/us/app/meloman-great-player/id1210207476?mt=8&uo=4\\\",\\n    \\\"cat\\\": [\\n      \\\"IAB14\\\",\\n      \\\"IAB1-6\\\"\\n    ],\\n    \\\"ver\\\": \\\"1.0\\\",\\n    \\\"privacypolicy\\\": 0,\\n    \\\"paid\\\": 0,\\n    \\\"publisher\\\": {\\n      \\\"id\\\": \\\"1582\\\",\\n      \\\"name\\\": \\\"Роман\\\"\\n    },\\n    \\\"ext\\\": {\\n      \\\"sdk\\\": \\\"2.0.0\\\",\\n      \\\"session_uptime\\\": 30,\\n      \\\"session_id\\\": 9,\\n      \\\"app_uptime\\\": 501,\\n      \\\"impressions_count\\\": 3,\\n      \\\"clicks_count\\\": 0,\\n      \\\"bcat\\\": [],\\n      \\\"badv\\\": [],\\n      \\\"packagename\\\": \\\"com.bykov.meloman\\\"\\n    }\\n  },\\n  \\\"device\\\": {\\n    \\\"ua\\\": \\\"Mozilla/5.0 (iPhone; CPU iPhone OS 10_2 like Mac OS X) AppleWebKit/602.3.12 (KHTML, like Gecko) Mobile/14C89\\\",\\n    \\\"geo\\\": {\\n      \\\"lat\\\": 58.5539,\\n      \\\"lon\\\": 50.0399,\\n      \\\"type\\\": 2,\\n      \\\"country\\\": \\\"USA\\\",\\n      \\\"zip\\\": \\\"613043\\\",\\n      \\\"utcoffset\\\": 180\\n    },\\n    \\\"lmt\\\": 0,\\n    \\\"ip\\\": \\\"50.62.160.240\\\",\\n    \\\"devicetype\\\": 4,\\n    \\\"make\\\": \\\"Apple\\\",\\n    \\\"model\\\": \\\"x86_64\\\",\\n    \\\"os\\\": \\\"iOS\\\",\\n    \\\"osv\\\": \\\"10.2\\\",\\n    \\\"hwv\\\": \\\"x86_64\\\",\\n    \\\"h\\\": 568,\\n    \\\"w\\\": 320,\\n    \\\"ppi\\\": 326,\\n    \\\"pxratio\\\": 2,\\n    \\\"js\\\": 1,\\n    \\\"connectiontype\\\": 2,\\n    \\\"ifa\\\": \\\"0C231BF4-9256-4196-96CF-A1D12B5297CF\\\",\\n    \\\"ext\\\": {\\n      \\\"battery\\\": -100,\\n      \\\"rooted\\\": \\\"false\\\"\\n    }\\n  },\\n  \\\"user\\\": {\\n    \\\"gender\\\": \\\"O\\\",\\n    \\\"geo\\\": {\\n      \\\"lat\\\": 58.5539,\\n      \\\"lon\\\": 50.0399,\\n      \\\"type\\\": 2,\\n      \\\"country\\\": \\\"USA\\\",\\n      \\\"zip\\\": \\\"613043\\\",\\n      \\\"utcoffset\\\": 180\\n    }\\n  },\\n  \\\"at\\\": 2,\\n  \\\"tmax\\\": 1500,\\n  \\\"allimps\\\": 0,\\n  \\\"cur\\\": [\\n    \\\"USD\\\"\\n  ],\\n  \\\"bcat\\\": [],\\n  \\\"badv\\\": [],\\n  \\\"regs\\\": {\\n    \\\"coppa\\\": 0\\n  }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n##**5. Sample Video Response**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"id\\\": \\\"c8c055a5d10c11e7962ba0369fcef2b0\\\",\\n  \\\"seatbid\\\": [\\n    {\\n      \\\"bid\\\": [\\n        {\\n          \\\"id\\\": \\\"d8b8cc4b9e2943b2a415b33fe5ff5c98\\\",\\n          \\\"impid\\\": \\\"1\\\",\\n          \\\"price\\\": 15.11,\\n          \\\"adid\\\": \\\"10993\\\",\\n          \\\"nurl\\\": \\\"https://got.pubnative.net/dspv1/winnotice?ap=${AUCTION_PRICE}&t=9IFYOZB7A70cs4zY0a0dkqqNS1twbmXgVJQWB4cWWS3nWuNx4imL6qSyPY0REInW-V3Zx6L8P_oSnRmDToc7H1DpUObPGXqRSv_1Q7VMtvcWLm9MtKSlJvd4J7YxJxRiupVIVnxP\\\",\\n          \\\"adm\\\": \\\"<VAST version=\\\\\\\"2.0\\\\\\\"><Ad id=\\\\\\\"5e978f83-5e22-467e-8849-be6d3ca3875c\\\\\\\"><Wrapper><VASTAdTagURI>https://ev.us-east-1.rtb.test.com/e/rt62YwO_KIYl-tUe35H5gTavB6TCDf9Zqg7JNw_3QSWy-4oQNnIywyXnpM9NEv84ubQGKfFJHED44TU5JOLQ9BDqmmy7Oja51gQhp0RHxcA/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_load?_p=${AUCTION_PRICE}</VASTAdTagURI><Error>https://ev.us-east-1.rtb.test.com/n/RXv-lVEL8gNeYgD3wWLv_PBjfvmTgBQcsyw_pp0dbIM/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_errors?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_ecode=[ERRORCODE]</Error><AdSystem>ACK17</AdSystem><Impression id=\\\\\\\"imp_xbint\\\\\\\">https://ev.us-east-1.rtb.test.com/n/EylbPpwt6MYAIh5LuxrHTdTnzx3Kz9mBSdJQ01EfTDQAPQtIWNF6KiVIXLasCKC2/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_impressions?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__</Impression><Impression>https://ev.us-east-1.rtb.test.com/n/NTMV1bn1YL-JNSzHfwYFkbSkVRwzhEmrXgeVxcIHs8k/ozx79l-aac4-qewQgVjoNqaoxpI34g/wins?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__</Impression><Impression>https://got.pubnative.net/impression?aid=1028502&amp;t=ILxkuQRoALEupL4oO-kXLbM74iMj1zJsB61BiPM8yj640ulmwYqNqzrX6GhWLHEh2iDnr5AA9ywk6aWYmCffsTX88CeqcboSgi0J1h9VX24IO12sukzw8DU8x-k8Z7CIwQFS1Canu6sIyrjwsnPfO3_P-R9KWTWU46oy-5WsoiqptKxSQmHTR3hWamhURipTdmE9xVdQKqClJaHld5Ix58eUgNWIr5LDZpgGhgqgPpLMwzC5wi4IZ_7qkcTyxOru1vDt4oYjybKEHU3g7cjfmrSbNKU4v03sW-63j0pESbq5IlAZYVySNuS2ENy_0XGaEB2-N7eBuFH8tTifGzGZBR43stDrNM2rWZ8M1jrXC1KWshiQ_wbEtYIitOIMvdkEZkExIg7idxE8fjmh6yxfg5uaO2mmJQJbOhCJRlGuY9P8FBeGw5jMwKLmY1aBCVW7eXwPETGBMRKb2sLxjozl2IQZ11oaQuly0nJXfgkog4RbgrNeCXrsQKAc2m_k6LVQl1_7Hhk-nnZNocLu1KYzgSU2bYXy19fcb7Np9UsNjxkeAOsLkumxbav66j3QwSWeQJeiPp7mdfEzpUoakxL6PUpSePOG_-MHoI_dP5DSuDGj_D_ufU_FQEeAB7sQk8MV996W1Ed4nsFwGPr0ayxwGB-lmHK5Krv38MnxkQzPhJr8IvRsH24EVZq5dTv28wvtK1aEAmSkFrVgErUssIOacXPOToO2xkipaDsQM428zfRncBOivFnQUIPBXAfE1NH01lRroghHWMrUMynf3aA3H2fOA1Prjn9l7RjVmHgRLw6t-EOpNg&amp;ap=${AUCTION_PRICE}</Impression><Creatives><Creative AdID=\\\\\\\"5e978f83-5e22-467e-8849-be6d3ca3875c\\\\\\\"><Linear><Duration></Duration><TrackingEvents><Tracking event=\\\\\\\"cretiveView\\\\\\\">https://ev.us-east-1.rtb.test.com/n/JBj68Uji5gzX6UL1BWky8R82bzUGQUFhRQsABnNc7nySVXuXc3hm8AcnwqnbqRfa/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_cretive_view?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"start\\\\\\\">https://ev.us-east-1.rtb.test.com/n/Y1VXvgvBb2GPp4frrJEGzBhudiyulOVKUw1tsSrr9NY/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_start?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"midpoint\\\\\\\">https://ev.us-east-1.rtb.test.com/n/bdAUw_6hfCJeLX3j2DFeD7q7l1qS1dyHjKMpeAWD0mn8EhrVdefcRLxXjSSRaPfU/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_midpoint?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"firstQuartile\\\\\\\">https://ev.us-east-1.rtb.test.com/n/ZnvPDuZG7yOIJ451myf_avNT7Sy1NvObg-TqyuJBGTItcacSR_sKmY6t-UKhVilu/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_first_quartile?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"thirdQuartile\\\\\\\">https://ev.us-east-1.rtb.test.com/n/n-fbTKEXBCATss2GQnaLvM_gpY5btofEPVvnsoutCR5r5u0deW7wKRxq_m-0kcsf/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_third_quartile?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"complete\\\\\\\">https://ev.us-east-1.rtb.test.com/n/uIHzpTyQ2t2STsOietSjYpbaVPOoYR8n2DMgxEiajh1W4rG8E0sCpfJ0_SplLu3v/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_complete?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"mute\\\\\\\">https://ev.us-east-1.rtb.test.com/n/6llhwVahy2ttfckeH-LcYFfYDYPtTwxeiLN2NxB-eGE/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_mute?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"unmute\\\\\\\">https://ev.us-east-1.rtb.test.com/n/_R57PRSyAPu_RJ509T9wmDrlwM-Kk25vkgeSJgVKRec/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_unmute?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"pause\\\\\\\">https://ev.us-east-1.rtb.test.com/n/grQejXYWyqJpQMbhs3hTZynezWy2T0mzp_MP9uJBfnc/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_pause?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"rewind\\\\\\\">https://ev.us-east-1.rtb.test.com/n/OWoH1BWcu3c1oC1Mpe1naLIFze6QEfd4CEM_12URUXc/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_rewind?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"resume\\\\\\\">https://ev.us-east-1.rtb.test.com/n/BkiMnvADntSiI5xwDZZEGnrrMq-w8Svlelcs8i8UJ_U/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_resume?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"fullscreen\\\\\\\">https://ev.us-east-1.rtb.test.com/n/Eq7IkAOfW5kOtDVhyR3QSIEHjalxt11HGhXguIGioBCEKHkgYPdUnPe6FRvu3pDK/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_fullscreen?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"expand\\\\\\\">https://ev.us-east-1.rtb.test.com/n/U6rti4-UuUvws7GAvC9IzeqtodfYrriHAAYUE5K1S78/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_expand?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"collapse\\\\\\\">https://ev.us-east-1.rtb.test.com/n/pACzH5io46wB1A4FjT5giophIEzXLdBENRgtxELI-MX0zGBCk1MkoY9i3otiWgyr/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_collapse?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\\\\\"close\\\\\\\">https://ev.us-east-1.rtb.test.com/n/m61eNYQ7360IqCOgP3tcixQdHgMTYm2DXyJ4GZJaQCg/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_close?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking></TrackingEvents><VideoClicks><ClickTracking>https://ev.us-east-1.rtb.test.com/n/uD3QvdI-eB-mjDRr1_RK_qexB_c46Tv8M_1jpnZb8lQ/ozx79l-aac4-qewQgVjoNqaoxpI34g/clicks?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__</ClickTracking></VideoClicks><MediaFiles></MediaFiles></Linear></Creative></Creatives></Wrapper></Ad></VAST>\\\",\\n          \\\"adomain\\\": [\\n            \\\"pubnativetestad.com\\\"\\n          ],\\n          \\\"cid\\\": \\\"10993\\\",\\n          \\\"crid\\\": \\\"4342184916255\\\",\\n          \\\"attr\\\": [\\n            4\\n          ]\\n        }\\n      ]\\n    }\\n  ],\\n  \\\"cur\\\": \\\"USD\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"CHECKLIST BEFORE GOING LIVE\",\n  \"body\": \"1. Are you using the <APP-TOKEN> of your account?\\n2. Are you requesting the ad format you need? (NATIVE/STANDARD/VIDEO)\\n3. Are you replacing {AUCTION_PRICE} in the bid response when serving the ad?\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Get Started\"\n}\n[/block]\nTo get started or to receive more information, contact us at info:::at:::pubnative.net\n[block:api-header]\n{\n  \"title\": \"Version History\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Version\",\n    \"h-1\": \"Changes\",\n    \"0-0\": \"1.0\",\n    \"1-0\": \"1.1\",\n    \"0-1\": \"Onboarding Process\",\n    \"1-1\": \"Support for Standard Formats\",\n    \"2-0\": \"1.2\",\n    \"2-1\": \"Update for sizes and spec details.\"\n  },\n  \"cols\": 2,\n  \"rows\": 3\n}\n[/block]","updates":[],"order":18,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5a1fd0878f8c6c0012a6d9a1","project":"574ff4bd3fa1870e00889ba6","version":{"version":"3.0","version_clean":"3.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["574ff4bd3fa1870e00889baa","577278ecdceb570e003a9001","577279865617b117009e643f","577279985617b117009e6440","577279bc8c48e00e00503504","5774fe18605b770e0037be8a","577ce3ad87acf617003c4187","577f8476a77c700e006a6c52","57b486ae0d2b640e00e9d3f5","57b722133d3e620e004ec74b","57bd95f00fe3a00e003e2cc5","57c8349359cd4b0e00b888ef","57c8349b5754fa1700b12242","57cedb0bad483e0e00890239","57cedbe807d7ea0e00e438cc","57d82967156ef72b007ffcd8","58ee353ad1ee2f0f0034a13d","596623221738df00298622a5","59a51730192dba000fc9ca38","59a8129f1e7b26000fa0fb1a","5a0322bf044b6f001c236e36","5a79897c5b6e430030746df6","5a79898c2b2d5f0012cbab63","5ab3b5e3d2d1e2006252a8f2","5b1a43bd678eab0003aa54a4","5b6d95e29d346300038baff3","5c77d3a1e0794000451bced2","5e902519bb65b200466e7957","5f228f5bd6a1cc0024afda30"],"_id":"574ff4bd3fa1870e00889ba9","createdAt":"2016-06-02T08:56:29.492Z","project":"574ff4bd3fa1870e00889ba6","releaseDate":"2016-06-02T08:56:29.492Z","__v":29},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"[PUBLISHER] API Documentation","slug":"api-documentation","order":1,"from_sync":false,"reference":true,"_id":"5774fe18605b770e0037be8a","__v":0,"project":"574ff4bd3fa1870e00889ba6","version":"574ff4bd3fa1870e00889ba9","createdAt":"2016-06-30T11:10:16.206Z"},"user":"59aebb87fde5ab002740a01c","createdAt":"2017-11-30T09:33:59.694Z","githubsync":"","__v":0,"parentDoc":null}

postExchange API v1.1 (OpenRTB)


[block:api-header] { "title": "Introduction" } [/block] ##**Why RTB?** PubNative introduces its RTB solution in order to deliver mobile ads at scale. By pushing this supply-side specification, we allow publishers to enrich their inventory and to deliver better experiences to their users. Our goal is to increase the programmatic delivery of ads by establishing a common framework on the buy-side, which will facilitate the exchange of diverse ad formats. ##**Our technology** PubNative built its RTB platform in full respect of the “OpenRTB Native Ads API Specification Version 1.1” and “OpenRTB API Specification Version 2.3” defined by the IAB. [block:api-header] { "title": "NATIVE AD: Technical Integration" } [/block] ##**1. About the ad format** We support native ads using the following components. Please keep in mind that the components must be specified in the ad request. [block:parameters] { "data": { "0-0": "Main Image", "h-0": "Component", "h-1": "Description", "h-2": "Standard case", "1-0": "Icon Image", "2-0": "Title", "3-0": "Text", "4-0": "Call to Action", "5-0": "Star Rating", "0-1": "Large image preview for the ad", "1-1": "Small icon for the ad", "2-1": "Headline or title for the ad", "3-1": "Open text field describing the ad", "4-1": "Text field for the call to action button", "5-1": "For app installs, the app store rating", "0-2": "Usually 1200x627px image", "1-2": "Usually 80x80px image", "2-2": "Text", "3-2": "Text", "4-2": "Text", "5-2": "Rating on scale of 0~5" }, "cols": 3, "rows": 6 } [/block] ##**2. Endpoint for Native Request** [block:code] { "codes": [ { "code": "https://dsp.pubnative.net/bid/v1/request?apptoken=<APP-TOKEN>&zoneid=<YOUR-ZONE-ID>", "language": "http" } ] } [/block] * PubNative uses a latency-based load balancer-- the same endpoint works globally, regardless of location. * <APP-TOKEN>: can be obtained from PubNative publisher dashboard. Please consult with account manager for this. * <YOUR-ZONE-ID>: use default as 1 ##**3. Native Request Details** * Request Method should be POST * Ensure that the bid request body is sent along with the endpoint. * Set headers in the request to the following: [block:code] { "codes": [ { "code": "x-openrtb-version: 2.3\nContent-Type:application/json\nAccept-Charset:utf-8", "language": "text", "name": "Header" } ] } [/block] ##**4. Sample Native Request Body** (If you are not sure what parameter and values to pass, check *Object: Native* section in [OpenRTB Spec v2.3](https://www.iab.com/wp-content/uploads/2015/06/OpenRTB-API-Specification-Version-2-3.pdf)) [block:code] { "codes": [ { "code": "{\n \"id\": \"30-54e260ae-7456-48de-809c-e983a32e940b\",\n \"tmax\": 1500,\n \"cur\": [\n \"USD\"\n ],\n \"imp\": [\n {\n \"id\": \"a672c7f1-f982-461e-8a6b-35de4acdf763\",\n \"instl\": 0,\n \"secure\": 0,\n \"native\": {\n \"request\": \"{\\\"native\\\":{\\\"ver\\\":\\\"1\\\",\\\"layout\\\":6,\\\"assets\\\":[{\\\"id\\\":0,\\\"required\\\":0,\\\"title\\\":{\\\"len\\\":100}},{\\\"id\\\":2,\\\"required\\\":1,\\\"img\\\":{\\\"type\\\":1,\\\"wmin\\\":50,\\\"hmin\\\":50}},{\\\"id\\\":3,\\\"required\\\":0,\\\"data\\\":{\\\"type\\\":2,\\\"len\\\":90}},{\\\"id\\\":4,\\\"required\\\":0,\\\"data\\\":{\\\"type\\\":3}},{\\\"id\\\":5,\\\" required\\\":0,\\\"data\\\":{\\\"type\\\":12,\\\"len\\\":15}},{\\\"id\\\":1,\\\"required\\\":0,\\\"img\\\":{\\\"type\\\":3,\\\"wmin\\\":300,\\\"hmin\\\":250}}]}}\"\n },\n \"bidfloor\": 0.01\n }\n ],\n \"device\": {\n \"dnt\": 0,\n \"devicetype\": 1,\n \"geo\": {\n \"country\": \"USA\",\n \"type\": 2,\n \"lat\": 37.751,\n \"lon\": -97.822\n },\n \"connectiontype\": 6,\n \"language\": \"en\",\n \"model\": \"Nexus 5X\",\n \"make\": \"LGE\",\n \"carrier\": \"311-480\",\n \"didsha1\": \"e2660d7edf9f7ea18a301d5b913b5e633561d1e2\",\n \"ifa\": \"69144c0f-1fb5-4201-8951-5a64be39e134\",\n \"os\": \"android\",\n \"osv\": \"7.1.1\",\n \"ua\": \"Dalvik/2.1.0 (Linux; U; Android 7.1.1; Nexus 5X Build/N4F26O)\",\n \"ip\": \"174.204.16.28\"\n },\n \"at\": 2,\n \"bcat\": [\n \"IAB24\",\n \"IAB25\",\n \"IAB26\"\n ],\n \"user\": {\n \"id\": \"098a1c70-94db-409d-8c8e-10983e689518\"\n },\n \"app\": {\n \"id\": \"1008118\",\n \"name\": \"Test_Android\",\n \"bundle\": \"com.android.test\",\n \"cat\": [\n \"IAB2-1\",\n \"IAB2-2\"\n ],\n \"storeurl\": \"https://play.google.com/store/apps/details?id=com.android.test\",\n \"keywords\": \"test, android\",\n \"privacypolicy\": 1,\n \"publisher\": {\n \"id\": \"pub12345\",\n \"name\": \"Publisher A\"\n }\n }\n}", "language": "json", "name": "App" }, { "code": "{\n \"id\": \"30-54e260ae-7456-48de-809c-e983a32e940b\",\n \"tmax\": 1500,\n \"cur\": [\n \"USD\"\n ],\n \"imp\": [\n {\n \"id\": \"a672c7f1-f982-461e-8a6b-35de4acdf763\",\n \"instl\": 0,\n \"secure\": 0,\n \"native\": {\n \"request\": \"{\\\"native\\\":{\\\"ver\\\":\\\"1\\\",\\\"layout\\\":6,\\\"assets\\\":[{\\\"id\\\":0,\\\"required\\\":0,\\\"title\\\":{\\\"len\\\":100}},{\\\"id\\\":2,\\\"required\\\":1,\\\"img\\\":{\\\"type\\\":1,\\\"wmin\\\":50,\\\"hmin\\\":50}},{\\\"id\\\":3,\\\"required\\\":0,\\\"data\\\":{\\\"type\\\":2,\\\"len\\\":90}},{\\\"id\\\":4,\\\"required\\\":0,\\\"data\\\":{\\\"type\\\":3}},{\\\"id\\\":5,\\\" required\\\":0,\\\"data\\\":{\\\"type\\\":12,\\\"len\\\":15}},{\\\"id\\\":1,\\\"required\\\":0,\\\"img\\\":{\\\"type\\\":3,\\\"wmin\\\":300,\\\"hmin\\\":250}}]}}\"\n },\n \"bidfloor\": 0.01\n }\n ],\n \"device\": {\n \"dnt\": 0,\n \"devicetype\": 1,\n \"geo\": {\n \"country\": \"USA\",\n \"type\": 2,\n \"lat\": 37.751,\n \"lon\": -97.822\n },\n \"connectiontype\": 6,\n \"language\": \"en\",\n \"model\": \"Nexus 5X\",\n \"make\": \"LGE\",\n \"carrier\": \"311-480\",\n \"didsha1\": \"e2660d7edf9f7ea18a301d5b913b5e633561d1e2\",\n \"ifa\": \"69144c0f-1fb5-4201-8951-5a64be39e134\",\n \"os\": \"android\",\n \"osv\": \"7.1.1\",\n \"ua\": \"Dalvik/2.1.0 (Linux; U; Android 7.1.1; Nexus 5X Build/N4F26O)\",\n \"ip\": \"174.204.16.28\"\n },\n \"at\": 2,\n \"bcat\": [\n \"IAB24\",\n \"IAB25\",\n \"IAB26\"\n ],\n \"user\": {\n \"id\": \"098a1c70-94db-409d-8c8e-10983e689518\"\n },\n \"site\": {\n \"id\": \"1345135123\",\n \"name\": \"Site ABCD\",\n \"domain\": \"siteabcd.com\",\n \"cat\": [\n \"IAB2-1\",\n \"IAB2-2\"\n ],\n \"page\": \"http://siteabcd.com/page.htm\",\n \"ref\": \"http://referringsite.com/referringpage.htm\",\n \"privacypolicy\": 1,\n \"publisher\": {\n \"id\": \"pub12345\",\n \"name\": \"Publisher A\"\n }\n }\n}", "language": "json", "name": "Web" } ] } [/block] ##**5. Sample Native Response** [block:code] { "codes": [ { "code": "{\n \"id\": \"30-54e260ae-7456-48de-809c-e983a32e940b\",\n \"seatbid\": [\n {\n \"bid\": [\n {\n \"id\": \"dfa946e82b63472984f6454567279060\",\n \"impid\": \"a672c7f1-f982-461e-8a6b-35de4acdf763\",\n \"price\": 0.01,\n \"adid\": \"test_campaign\",\n \"nurl\": \"http://got.pubnative.net/dspv1/winnotice?ap=${AUCTION_PRICE}&t=yxXyP7cxSbGUWd_HEgzcLCYrzfUnnHkCWkOzV5sOK-RgUHk1_IUtayyP-HK20Q5TQ8jNM1QNB7nszMaJcbOSRfCBsQ\",\n \"adm\": \"{\\\"native\\\":{\\\"assets\\\":[{\\\"id\\\":4,\\\"data\\\":{\\\"label\\\":\\\"rating\\\",\\\"value\\\":\\\"4.50\\\"}},{\\\"id\\\":5,\\\"data\\\":{\\\"label\\\":\\\"cta\\\",\\\"value\\\":\\\"Test me\\\"}},{\\\"id\\\":1,\\\"img\\\":{\\\"url\\\":\\\"http://cdn.pubnative.net/assets/mock_main_image.jpg\\\",\\\"w\\\":300,\\\"h\\\":250}},{\\\"id\\\":0,\\\"title\\\":{\\\"text\\\":\\\"PubNative Content Info\\\"}},{\\\"id\\\":2,\\\"required\\\":1,\\\"img\\\":{\\\"url\\\":\\\"http://cdn.pubnative.net/assets/mock_icon.jpg\\\",\\\"w\\\":50,\\\"h\\\":50}},{\\\"id\\\":3,\\\"data\\\":{\\\"label\\\":\\\"description\\\",\\\"value\\\":\\\"Pubnative Test Ad\\\"}}],\\\"link\\\":{\\\"url\\\":\\\"http://got.pubnative.net/click/rtb?aid=1008118&t=cD2xSi4VtfNdWk0_gVrQCOhJxwdrTFZXe9VKQYhA2YUBcRZPEWsJOt4ilYasAKbyuKTruh_v4lJNr7zUc9W1u8gev2eaaMHdGgsuiwQtbFxbyoaAVNEUJFpx0E_Hdvmpx7qgxkQKKNekewZwJApED6F7NalLG4LLYI4Z031WOfRT7oi7Nfkun-7jdE1L03QppuY6aruKsdsG-aexh4lqFnFGZX0URfG_Ftai7ua6fkDnr8-yiXd-yMXhSQjtfmFbNLyQSMPX_azTpcIT1muZrmPvJ4_S_Q_gY8KUf5J1fidnfS1jN3LOeW84GxCBnpjnzSRurVoS-wSzygvkt4LU15JTWHTWVEaVEFxB1W-vK01UskrQn-1hImd8Gtp6gy39ISYlhWkbTePjQrbcp54AjT9HTR6B4NWviYbG9fEBmcDpubEnGiBIztOYa_hmOtw1mVxszCa4FgaC2M5jwltbx1iuByfcGVgIiQxAkltWvwDpLwIAMJ8CzOXOFSY5fI0dKnFygDHimM7vMr7DcGZODWWnb-c6F6kaGelfLH_eoSc2tVEnbVVpB3mvs6mOZIE9FUms6y2Epc5MQW5IJdOEntRZryYNQFUJImxKC9_BVAdx2_V_8-93kc9TZkWWoZRPhoxhIA\\\",\\\"clicktrackers\\\":[\\\"http://mock-dsp.pubnative.net/tracker/clk?app_id=1008118&beacon=1&p=${AUCTION_PRICE}\\\",\\\"http://mock-dsp.pubnative.net/tracker/clk?app_id=1008118&beacon=2&p=${AUCTION_PRICE}\\\"]},\\\"imptrackers\\\":[\\\"http://got.pubnative.net/rtb/beacon?t=WiNGlVZWd1t8gxUdC3ls2XgFJ4TyNoXEamlxzu91qGjifY8KgCZJeaxcUGO51h5Gt6VZyxh8nySQG1VXFoywXwII--ILXJhWsfp_zx671xBw1ScTwvwM3gkLlTSqRKYZBYCmoPFyUGng&p=${AUCTION_PRICE}\\\",\\\"http://got.pubnative.net/rtb/beacon?t=1x6SLfSJJvo7J7Dv0FppBNrTBsSacqRKY_cE53bY3FAsl1XeACKaIwQXqeDn4Z6etV6PKOOVw3jz0tUNbW_fnh8s9Ng7OaKRnZSNrwgVEQ3oNZNwEhC_sYHAxbh4ogxAhU_4ntr_JYF53CuegNVYDwE&p=${AUCTION_PRICE}\\\",\\\"http://got.pubnative.net/rtb/beacon?t=nhiwXs2HODx6mYKtA13pGIUJ7fb7Oq7hy4cLUVmGeTBUIgMSkausUe9sdZu1d-F-BEH6LiS3yOBvNOGgD3T0FpPEU3ytfwdjXP3cVKMYJMP3kyYiFG7ON6ys0ff-jCXZ0tE3_1Sx0PeDscHotcwbkCs&p=${AUCTION_PRICE}\\\",\\\"http://got.pubnative.net/rtb/beacon?t=SucIlpiKbu1CTkNjL6ED63xWY-PMR79WINYBQ1E2pUS5T-BtSMM5Y1kPtS4qfljeH536uGl5hsVgD9fHwpPRfAyih4GZCZCmtYwl2YcFKVX2ZbEj_2zjZJw6-nu71GyRTJwZ1HRtXwn9WpQ-RnRjf0I&p=${AUCTION_PRICE}\\\",\\\"http://got.pubnative.net/rtb/beacon?t=29jxnKwqwMhz-57j9y1RlkWSVqk3y-E7LFDUPJl02TqvEVP5S6xovuVcFBC4GLvOPqLoA6AhwuX34s-w3u-s5_DGvA7rxCL6lO_h1Guu593pIrQAu6jWgb5O6jZpK-Ouf6BKHds0RLAxiP5DHymUa_U&p=${AUCTION_PRICE}\\\",\\\"http://got.pubnative.net/rtb/beacon?t=6PsrSiuXp1Hly-BHjzlrz6DJOADMcw27k4JqhSbnHPVLKHCxhxUnnfKV6ZsJUlYk-qUYwsUHBGxDa6Q8FrE-wpd1sOuuuQyxpHJZ8McJa0h4i0koXkMp6zxfIv4peCr8fIlpnmkvLG_Dfzi8ZvCHeZc&p=${AUCTION_PRICE}\\\",\\\"http://got.pubnative.net/rtb/beacon?t=ImmP3n_EwTQCjK0dyw-E_wrxlbMTwUXbupO2w_pWo1B5HGetFH11yxjaJx6DAehfPRl7X0iXa7Em4CGRi6IT43vVere1CVEsv-vWC3nqNk10495KYVxMeTqF7X66Cs-wh6uQr8bJ4ERAN57aV0PKhm4&p=${AUCTION_PRICE}\\\",\\\"http://got.pubnative.net/rtb/beacon?t=uSIMS1wS-Of4KC8k6mjAzfm1x6Ug31M1HXABxPFm_ypuPPvIi6Y5khwb3z6O7OFd1Uu3HExuuxjrBYlnd6KLjg_WrO6-qnX0Nc2OIGKiQ4ka7xvZfvsbT-CN0hzAJ5UPBnfA_ImBLTWYXL4S0WFdVZ0&p=${AUCTION_PRICE}\\\",\\\"http://got.pubnative.net/rtb/beacon?t=o1XOQYNBrKTI_aQvuHjBZnI8jCkr59T5SW6X1f9fl1eUx6JmcDBBniwyDNBUkdptKqmlvcRqF5oTZE2WrkgQIXKBvwyU-RnVO0HucN7dGU3QKAcoyOcZMJDIpoxSu79QSKCJLIWaAM94N1NqbxsEKHA&p=${AUCTION_PRICE}\\\",\\\"http://got.pubnative.net/rtb/beacon?t=ibTKopug071TDzPZwSspeOdWqA6RU3NMjB2-jm8gdpjTJkFzh36c46e8jncCotz3NJG7ZmUQbiJKfKzC6eDxPKsjNQ_lvv_ius4FSgraE3PvTdeigRYYD5TzRemX0JxZjZkh2VkK3zyTi6kXAMmW7qg&p=${AUCTION_PRICE}\\\",\\\"http://got.pubnative.net/rtb/beacon?t=fOzwTvtgf6exzog8i-6ZTKgeLRDMcT_wmWpadJmAaARQzFXvddjEv0do5Im6ZjcAb968ca89O9Re4a4Fin6c3-53azxNndQkceJJ_oxmOzMirNawyQn_2zAvcbrm2lc3FIQq0NHDr-SdQoSMmp_I00xt&p=${AUCTION_PRICE}\\\",\\\"http://got.pubnative.net/rtb/beacon?t=TRgZZa2qAjJyiYM0B9r4InX6Dpm9X0TlYJQueTy0v5OyYZ8KRzZzY12j1G3QaFsd7DrRZDBy3T8P9kD-wpzPQx5NWOtaNi8hJAlm4budhF1nJBJ8QAbTbSESCkuU7MkDeAQlr4uzbmNk9VSKO0MOLbsaUdIFyGS2k9QyfqFRc3DWfJN_HK2owtu_34l_B__LNlBnI5198IzcBGptCVZwkhR46PWY7SN1SjtaLUAR1Nb6yes4DuXu3nv9OmvNMYGk6LXdA4Tjne7Hkg3FD_-pyuMNyA4CU54JQiSWkW3vtJvIHzNPDuzzhUlwrvMVQB9etXQPKnIsRlIoehiZ03BPRo5pCWsL5aLCjworyAE4QWEJHGZAJT3Iycp5Mxdpar2aJdLzxTGY93gDZw9q6CUIf5911UP8cjpR7pvprsHkDUz-iJv91yZEdGffqeIZjA2w3fg-Z76enbtophEmlfcudpQTZXyflmbIaikdhQAm2GANstvqcjunbKrL17FQiQ7sXDsepLoqztJPqRNzVbKUFVA23SZjLzJ7F246uQ8ATU0Lzx1Es9eeXJ80VaCrMatScH-g09SrMf8xfPMpKnBrx2QgIcTPeU5Mm_2_zkDShLkcy8EzFDfZe8I3wZ34yRhFaz1pgPc_aAmgIXJ1wRSqv9HHgxuuyfskbx27VJ-gvD9CKlpplRuNERO48s-xFfUN20KlLpQEVtc2VchE57EYpcOXvrYwRxDq0PpoRYCJt2YkoPCx91P-aRy8TnSOO8RXQJTrhNkT_fWgCZL-e6nihvtkmN-S7rSERKgR4eS8fSLSLWwow8Dp-lMWcckDWoKH5Kdy5Ky5n59Pwggz_cGBKGyQCSzoPAY6tc_objgDNwT2JwwU1m06s6kotvVsn08Qp--nRlp9u8qj7sg_J1LSjdPFxtSUXf11PvdpLycDM_84-30SV5kqBOjC28L9E4QYsXXWBB_pcrF6ybkW8HSIYiIcWnz-QiVMOUBnTVcdWq-FbHZd4RGswbCyG65mBXPL_EAJljSd3wl7psET-4KGcs-Pj68_oIcpYjD9XzoBGyQioKaz9wyXOsJiS-xbeuEQ-j195_6pPKm3_94j4ZkX80x-1cfrVEkpXCNfW_EXEX9hER3EuL87lvLW0Ii-Ycw3pa50SiOFM4Z3Ye9zzmiJ2mjILq_lAqL0KqcoUE3bzrjHc_ES_6oiPEdD1lgulkVB3iFZnLQhF4t6jUKFbaCcgYixtehps-YnZSs2YXbmZofRGlza0N5u5AW-UbOf-DPR-4luoR917RHk3YNVTdgqk1gCamgudqhI&p=${AUCTION_PRICE}\\\"]}}\",\n \"adomain\": [\n \"pubnative.net\"\n ],\n \"iurl\": \"http://got.pubnative.net/rtb/beacon?t=HH1LxYlb8NXCLx_kb5fPzSWGJJtDDV48jm6AuR6VIXXCTI2qjB6u7XADoev1LTQSSRWm8YiNUhLPUD3x2pbTZN4VI1su0efy4HsZhf71njM-vtBTf_eNj_xQZamn0Z_vrV4yXk6syg2E&p=${AUCTION_PRICE}\",\n \"cid\": \"test_campaign\",\n \"crid\": \"test_creative\",\n \"attr\": [\n 4\n ]\n }\n ]\n }\n ],\n \"cur\": \"USD\"\n}", "language": "json" } ] } [/block] [block:api-header] { "title": "STANDARD AD: Technical Integration" } [/block] ##**1. About the ad format** We currently support standard format ads (a.k.a "display") using the following ad sizes. Please keep in mind that these components must be specified in the ad request. * 160 x 600 * 250 x 250 * 300 x 50 * 300 x 250 * 300 x 600 * 320 x 50 * 320 x 100 * 320 x 480 * 480 x 320 * 728 x 90 * 768 x 1024 * 1024 x 768 ##**2. Endpoint for Standard Request** [block:code] { "codes": [ { "code": "https://dsp.pubnative.net/bid/v1/request?apptoken=<APP-TOKEN>&zoneid=<YOUR-ZONE-ID>", "language": "http" } ] } [/block] * PubNative uses a latency-based load balancer-- the same endpoint works globally, regardless of location. * <APP-TOKEN>: can be obtained from PubNative publisher dashboard. Please consult with account manager for this. * <YOUR-ZONE-ID>: use default as 1 ##**3. Standard Request Details** * Request Method should be POST * Ensure that the bid request is in the body of the request * Set headers in the request to the following: [block:code] { "codes": [ { "code": "x-openrtb-version: 2.3\nContent-Type:application/json\nAccept-Charset:utf-8", "language": "text", "name": "Header" } ] } [/block] ##**4. Sample Standard Request Body** (If you are not sure what parameter and values to pass, check *Object: Banner* section in [OpenRTB Spec v2.3](https://www.iab.com/wp-content/uploads/2015/06/OpenRTB-API-Specification-Version-2-3.pdf)) [block:code] { "codes": [ { "code": "{\n \"id\": \"92d6421e44a44dff9f05b29be0ca5bef\",\n \"imp\": [\n {\n \"id\": \"94628ee5-fe99-436d-94b5-f3270ad06529\",\n \"banner\": {\n \"w\": 300,\n \"h\": 250\n },\n \"tagid\": \"1\",\n \"bidfloor\": 0.01,\n \"bidfloorcurdan\": \"USD\",\n \"secure\": 1\n }\n ],\n \"app\": {\n \"id\": \"1008118\",\n \"name\": \"Test_Android\",\n \"bundle\": \"com.android.test\",\n \"cat\": [\n \"IAB2-1\",\n \"IAB2-2\"\n ],\n \"storeurl\": \"https://play.google.com/store/apps/details?id=com.android.test\",\n \"keywords\": \"test, android\",\n \"privacypolicy\": 1,\n \"publisher\": {\n \"id\": \"pub12345\",\n \"name\": \"Publisher A\"\n }\n },\n \"device\": {\n \"ua\": \"Dalvik/2.1.0 (Linux; U; Android 6.0; MotoG3 Build/MPI24.65-25)\",\n \"ip\": \"107.219.186.28\",\n \"geo\": {\n \"lat\": 33.9775,\n \"lon\": -118.2133,\n \"country\": \"USA\",\n \"region\": \"CA\",\n \"city\": \"los angeles\",\n \"zip\": \"90001\",\n \"type\": 1\n },\n \"carrier\": \"att internet services\",\n \"language\": \"en\",\n \"model\": \"Moto G3\",\n \"os\": \"Android\",\n \"osv\": \"6.0\",\n \"connectiontype\": 2,\n \"devicetype\": 1,\n \"ifa\": \"03F9F0E4-937D-4F85-9275-F530E0107B2F\"\n },\n \"user\": {\n \"id\": \"50cf7979-18a7-51dd-9645-091009ad842f\"\n },\n \"at\": 2,\n \"tmax\": 1500,\n \"allimps\": 0,\n \"cur\": [\n \"USD\"\n ],\n \"bcat\": [\n \"IAB24\",\n \"IAB25\",\n \"IAB26\"\n ]\n}", "language": "json", "name": "App" }, { "code": "{\n \"id\": \"92d6421e44a44dff9f05b29be0ca5bef\",\n \"imp\": [\n {\n \"id\": \"94628ee5-fe99-436d-94b5-f3270ad06529\",\n \"banner\": {\n \"w\": 300,\n \"h\": 250\n },\n \"tagid\": \"1\",\n \"bidfloor\": 0.01,\n \"bidfloorcurdan\": \"USD\"\n }\n ],\n \"site\": {\n \"id\": \"1345135123\",\n \"name\": \"Site ABCD\",\n \"domain\": \"siteabcd.com.com\",\n \"cat\": [\n \"IAB2-1\",\n \"IAB2-2\"\n ],\n \"page\": \"http://siteabcd.com/page.htm\",\n \"ref\": \"http://referringsite.com/referringpage.htm\",\n \"privacypolicy\": 1,\n \"publisher\": {\n \"id\": \"pub12345\",\n \"name\": \"Publisher A\"\n }\n },\n \"device\": {\n \"ua\": \"Dalvik/2.1.0 (Linux; U; Android 6.0; MotoG3 Build/MPI24.65-25)\",\n \"ip\": \"107.219.186.28\",\n \"geo\": {\n \"lat\": 33.9775,\n \"lon\": -118.2133,\n \"country\": \"USA\",\n \"region\": \"CA\",\n \"city\": \"los angeles\",\n \"zip\": \"90001\",\n \"type\": 1\n },\n \"carrier\": \"att internet services\",\n \"language\": \"en\",\n \"model\": \"Moto G3\",\n \"os\": \"Android\",\n \"osv\": \"6.0\",\n \"connectiontype\": 2,\n \"devicetype\": 1,\n \"ifa\": \"03F9F0E4-937D-4F85-9275-F530E0107B2F\"\n },\n \"user\": {\n \"id\": \"50cf7979-18a7-51dd-9645-091009ad842f\"\n },\n \"at\": 2,\n \"tmax\": 1500,\n \"allimps\": 0,\n \"cur\": [\n \"USD\"\n ],\n \"bcat\": [\n \"IAB24\",\n \"IAB25\",\n \"IAB26\"\n ]\n}", "language": "json", "name": "Web" } ] } [/block] ##**5. Sample Standard Response** [block:code] { "codes": [ { "code": "{\n \"id\": \"92d6421e44a44dff9f05b29be0ca5bef\",\n \"seatbid\": [\n {\n \"bid\": [\n {\n \"id\": \"9cafcb3224fb45839f509abcca974f5c\",\n \"impid\": \"94628ee5-fe99-436d-94b5-f3270ad06529\",\n \"price\": 0.01,\n \"adid\": \"test_campaign\",\n \"nurl\": \"https://got.pubnative.net/dspv1/winnotice?ap=${AUCTION_PRICE}&t=8m0OJBZ7871n3RGbrC6jz8mmgocK3okt1DBd_36kZURw8Vf56tf2wDF-Nd7e4i1XnxggaauMDjNEst1xmIrGW-JitQ\",\n \"adm\": \"<a href=\\\"http://ads.com/click/112770_1386565997\\\"><img src=\\\"https://cdn.pubnative.net/widget/v3/assets/300x250.jpg\\\" width=\\\"300\\\" height=\\\"250\\\" border=\\\"0\\\" alt=\\\"Advertisement\\\" /></a><img src=\\\"http://mock-dsp.pubnative.net/tracker/nurl?app_id=1008118&p=${AUCTION_PRICE}\\\" style=\\\"display:none\\\"/><img src=\\\"https://got.pubnative.net/impression?aid=1008118&t=QduxwF1RKZT6blfGfU2pjf5vOxe3GWrj9k9Fy8xHWoclDkRFCCqNXV-HcDU74JlYzXikknQ5ndfxRfkLTXrlUIpNLZTtR5sJW_ynhlClj9yVphyIxT-E21TVNjyEYPdjDfpx-ruNp7_xkN8zkGCfq6eqOoZmASdD7ZxUNeL52IsWEhrkRxOIGpwuiXSxI-M7taWBMF3eEB6ZMvW7Sh2rawLmjL1i8tCd-62MVdY4Z2wIQr7CkD6Nm7UDnUs4bKGNrVn1Y7wwnpl9iEo5UGuqCstkuMugwxwxT__qtdrnIO13GkzAR4qpKVfaaK15xJjJn9CRAbx88jsWAYLwpcAXOcFztVOLFbEc-9nJryuMz32DlHd_ghHCHTRikA_olUFoC9gpnlkEp16a4X5OgbOuGtg5ZOEOjJ22BHDKw9jbdjy_eQY-ClBwFUFSolO6hl8F-AHkw3S3mnM-RC1E89KdX9I19Esdme7QIJmhcnQS5qZYJWiLTiwc-rzpb-QXxlG0SK0WT1iqQBO8JYjD8CYgzlvsIsDCa5_BuUXtV8__8_zpveVt0jgYQhwDrl4vWI4aTmMGi8PyDemEBhPufmsra6jrKwZ9ZOSmxsBppJk3YJgJE4uSwWiBw91GSxgHj8kUGaOREqsC9KGLm9ABcqtm-ImoCYas1ZeiyilfInrxUTqBStqIDbgqbROoTW8GhdySNX2OE7nTEDQ1hqkSVqLuJVM0i4-Iu7BEzOBa8pIaHSPKrhHlzVkdbWQdcDqI7O1Y16aK6rrenRsC5-eWmCPAsCuTQ7-_PGUMrFYqZFKHowPzd-Mwnil_Ne16&ap=${AUCTION_PRICE}&px=1\\\" style=\\\"display:none\\\"/>\",\n \"adomain\": [\n \"pubnative.net\"\n ],\n \"iurl\": \"https://got.pubnative.net/rtb/beacon?t=q8JQ4OLM0au1mRj81xoNIg6cYepOvPKYSoF1PBC1Xhlxfdb7UqNeHKEqdz54MIM4-NJC6KbcbcQXYILR1H9mTAu07JwrdH7v0RFoxv9XKXpdwDAaRVaMFvQV5n_5uLmFR-6_-THn-ZOU&p=${AUCTION_PRICE}\",\n \"cid\": \"test_campaign\",\n \"crid\": \"test_creative\",\n \"attr\": [\n 4\n ]\n }\n ]\n }\n ],\n \"cur\": \"USD\"\n}", "language": "json" } ] } [/block] [block:api-header] { "title": "VIDEO AD: Technical Integration" } [/block] ##**1. About the ad format** We currently support video ads using the following ad sizes. Please keep in mind that these components must be specified in the ad request. * 320 x 480 * 480 x 320 * 300 x 250 * 1024 x 768 * 768 x 1024 NOTE: the ads will be in VAST 2.0 and VAST Wrapper format. VPAID is not supported at the moment. ##**2. Endpoint for Video Request** [block:code] { "codes": [ { "code": "https://dsp.pubnative.net/bid/v1/request?apptoken=<APP-TOKEN>&zoneid=<YOUR-ZONE-ID>", "language": "http" } ] } [/block] * PubNative uses a latency-based load balancer-- the same endpoint works globally, regardless of location. * <APP-TOKEN>: can be obtained from PubNative publisher dashboard. Please consult with account manager for this. * <YOUR-ZONE-ID>: use default as 1 ##**3. Standard Video Request Details** * Request Method should be POST * Ensure that the bid request is in the body of the request * Set headers in the request to the following: [block:code] { "codes": [ { "code": "x-openrtb-version: 2.3\nContent-Type:application/json\nAccept-Charset:utf-8", "language": "text", "name": "Header" } ] } [/block] ##**4. Sample Video Request Body** (If you are not sure what parameter and values to pass, check *Object: Video* section in [OpenRTB Spec v2.3](https://www.iab.com/wp-content/uploads/2015/06/OpenRTB-API-Specification-Version-2-3.pdf)) [block:code] { "codes": [ { "code": "{\n \"id\": \"5de66583-4534-4df8-a9ee-0feb2116bb5b\",\n \"imp\": [\n {\n \"id\": \"0526d52d-c988-45db-b911-d128e6e47a29\",\n \"video\": {\n \"mimes\": [\n \"video/mp4\"\n ],\n \"minduration\": 5,\n \"maxduration\": 30,\n \"protocols\": [\n 1,\n 2,\n 3,\n 4,\n 5,\n 6\n ],\n \"w\": 320,\n \"h\": 568,\n \"linearity\": 1,\n \"playbackmethod\": [\n 1,\n 2,\n 3,\n 4\n ],\n \"delivery\": [\n 1,\n 2\n ],\n \"api\": [\n 3,\n 5\n ]\n },\n \"displaymanager\": \"sampledisplaymanager\",\n \"displaymanagerver\": \"2.0.0\",\n \"instl\": 1,\n \"tagid\": \"35\",\n \"bidfloor\": 0.01,\n \"bidfloorcur\": \"USD\"\n }\n ],\n \"app\": {\n \"id\": \"66755\",\n \"name\": \"Meloman bykov\",\n \"bundle\": \"1210207476\",\n \"storeurl\": \"https://itunes.apple.com/us/app/meloman-great-player/id1210207476?mt=8&uo=4\",\n \"cat\": [\n \"IAB14\",\n \"IAB1-6\"\n ],\n \"ver\": \"1.0\",\n \"privacypolicy\": 0,\n \"paid\": 0,\n \"publisher\": {\n \"id\": \"1582\",\n \"name\": \"Роман\"\n },\n \"ext\": {\n \"sdk\": \"2.0.0\",\n \"session_uptime\": 30,\n \"session_id\": 9,\n \"app_uptime\": 501,\n \"impressions_count\": 3,\n \"clicks_count\": 0,\n \"bcat\": [],\n \"badv\": [],\n \"packagename\": \"com.bykov.meloman\"\n }\n },\n \"device\": {\n \"ua\": \"Mozilla/5.0 (iPhone; CPU iPhone OS 10_2 like Mac OS X) AppleWebKit/602.3.12 (KHTML, like Gecko) Mobile/14C89\",\n \"geo\": {\n \"lat\": 58.5539,\n \"lon\": 50.0399,\n \"type\": 2,\n \"country\": \"USA\",\n \"zip\": \"613043\",\n \"utcoffset\": 180\n },\n \"lmt\": 0,\n \"ip\": \"50.62.160.240\",\n \"devicetype\": 4,\n \"make\": \"Apple\",\n \"model\": \"x86_64\",\n \"os\": \"iOS\",\n \"osv\": \"10.2\",\n \"hwv\": \"x86_64\",\n \"h\": 568,\n \"w\": 320,\n \"ppi\": 326,\n \"pxratio\": 2,\n \"js\": 1,\n \"connectiontype\": 2,\n \"ifa\": \"0C231BF4-9256-4196-96CF-A1D12B5297CF\",\n \"ext\": {\n \"battery\": -100,\n \"rooted\": \"false\"\n }\n },\n \"user\": {\n \"gender\": \"O\",\n \"geo\": {\n \"lat\": 58.5539,\n \"lon\": 50.0399,\n \"type\": 2,\n \"country\": \"USA\",\n \"zip\": \"613043\",\n \"utcoffset\": 180\n }\n },\n \"at\": 2,\n \"tmax\": 1500,\n \"allimps\": 0,\n \"cur\": [\n \"USD\"\n ],\n \"bcat\": [],\n \"badv\": [],\n \"regs\": {\n \"coppa\": 0\n }\n}", "language": "json" } ] } [/block] ##**5. Sample Video Response** [block:code] { "codes": [ { "code": "{\n \"id\": \"c8c055a5d10c11e7962ba0369fcef2b0\",\n \"seatbid\": [\n {\n \"bid\": [\n {\n \"id\": \"d8b8cc4b9e2943b2a415b33fe5ff5c98\",\n \"impid\": \"1\",\n \"price\": 15.11,\n \"adid\": \"10993\",\n \"nurl\": \"https://got.pubnative.net/dspv1/winnotice?ap=${AUCTION_PRICE}&t=9IFYOZB7A70cs4zY0a0dkqqNS1twbmXgVJQWB4cWWS3nWuNx4imL6qSyPY0REInW-V3Zx6L8P_oSnRmDToc7H1DpUObPGXqRSv_1Q7VMtvcWLm9MtKSlJvd4J7YxJxRiupVIVnxP\",\n \"adm\": \"<VAST version=\\\"2.0\\\"><Ad id=\\\"5e978f83-5e22-467e-8849-be6d3ca3875c\\\"><Wrapper><VASTAdTagURI>https://ev.us-east-1.rtb.test.com/e/rt62YwO_KIYl-tUe35H5gTavB6TCDf9Zqg7JNw_3QSWy-4oQNnIywyXnpM9NEv84ubQGKfFJHED44TU5JOLQ9BDqmmy7Oja51gQhp0RHxcA/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_load?_p=${AUCTION_PRICE}</VASTAdTagURI><Error>https://ev.us-east-1.rtb.test.com/n/RXv-lVEL8gNeYgD3wWLv_PBjfvmTgBQcsyw_pp0dbIM/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_errors?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_ecode=[ERRORCODE]</Error><AdSystem>ACK17</AdSystem><Impression id=\\\"imp_xbint\\\">https://ev.us-east-1.rtb.test.com/n/EylbPpwt6MYAIh5LuxrHTdTnzx3Kz9mBSdJQ01EfTDQAPQtIWNF6KiVIXLasCKC2/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_impressions?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__</Impression><Impression>https://ev.us-east-1.rtb.test.com/n/NTMV1bn1YL-JNSzHfwYFkbSkVRwzhEmrXgeVxcIHs8k/ozx79l-aac4-qewQgVjoNqaoxpI34g/wins?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__</Impression><Impression>https://got.pubnative.net/impression?aid=1028502&amp;t=ILxkuQRoALEupL4oO-kXLbM74iMj1zJsB61BiPM8yj640ulmwYqNqzrX6GhWLHEh2iDnr5AA9ywk6aWYmCffsTX88CeqcboSgi0J1h9VX24IO12sukzw8DU8x-k8Z7CIwQFS1Canu6sIyrjwsnPfO3_P-R9KWTWU46oy-5WsoiqptKxSQmHTR3hWamhURipTdmE9xVdQKqClJaHld5Ix58eUgNWIr5LDZpgGhgqgPpLMwzC5wi4IZ_7qkcTyxOru1vDt4oYjybKEHU3g7cjfmrSbNKU4v03sW-63j0pESbq5IlAZYVySNuS2ENy_0XGaEB2-N7eBuFH8tTifGzGZBR43stDrNM2rWZ8M1jrXC1KWshiQ_wbEtYIitOIMvdkEZkExIg7idxE8fjmh6yxfg5uaO2mmJQJbOhCJRlGuY9P8FBeGw5jMwKLmY1aBCVW7eXwPETGBMRKb2sLxjozl2IQZ11oaQuly0nJXfgkog4RbgrNeCXrsQKAc2m_k6LVQl1_7Hhk-nnZNocLu1KYzgSU2bYXy19fcb7Np9UsNjxkeAOsLkumxbav66j3QwSWeQJeiPp7mdfEzpUoakxL6PUpSePOG_-MHoI_dP5DSuDGj_D_ufU_FQEeAB7sQk8MV996W1Ed4nsFwGPr0ayxwGB-lmHK5Krv38MnxkQzPhJr8IvRsH24EVZq5dTv28wvtK1aEAmSkFrVgErUssIOacXPOToO2xkipaDsQM428zfRncBOivFnQUIPBXAfE1NH01lRroghHWMrUMynf3aA3H2fOA1Prjn9l7RjVmHgRLw6t-EOpNg&amp;ap=${AUCTION_PRICE}</Impression><Creatives><Creative AdID=\\\"5e978f83-5e22-467e-8849-be6d3ca3875c\\\"><Linear><Duration></Duration><TrackingEvents><Tracking event=\\\"cretiveView\\\">https://ev.us-east-1.rtb.test.com/n/JBj68Uji5gzX6UL1BWky8R82bzUGQUFhRQsABnNc7nySVXuXc3hm8AcnwqnbqRfa/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_cretive_view?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"start\\\">https://ev.us-east-1.rtb.test.com/n/Y1VXvgvBb2GPp4frrJEGzBhudiyulOVKUw1tsSrr9NY/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_start?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"midpoint\\\">https://ev.us-east-1.rtb.test.com/n/bdAUw_6hfCJeLX3j2DFeD7q7l1qS1dyHjKMpeAWD0mn8EhrVdefcRLxXjSSRaPfU/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_midpoint?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"firstQuartile\\\">https://ev.us-east-1.rtb.test.com/n/ZnvPDuZG7yOIJ451myf_avNT7Sy1NvObg-TqyuJBGTItcacSR_sKmY6t-UKhVilu/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_first_quartile?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"thirdQuartile\\\">https://ev.us-east-1.rtb.test.com/n/n-fbTKEXBCATss2GQnaLvM_gpY5btofEPVvnsoutCR5r5u0deW7wKRxq_m-0kcsf/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_third_quartile?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"complete\\\">https://ev.us-east-1.rtb.test.com/n/uIHzpTyQ2t2STsOietSjYpbaVPOoYR8n2DMgxEiajh1W4rG8E0sCpfJ0_SplLu3v/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_complete?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"mute\\\">https://ev.us-east-1.rtb.test.com/n/6llhwVahy2ttfckeH-LcYFfYDYPtTwxeiLN2NxB-eGE/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_mute?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"unmute\\\">https://ev.us-east-1.rtb.test.com/n/_R57PRSyAPu_RJ509T9wmDrlwM-Kk25vkgeSJgVKRec/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_unmute?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"pause\\\">https://ev.us-east-1.rtb.test.com/n/grQejXYWyqJpQMbhs3hTZynezWy2T0mzp_MP9uJBfnc/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_pause?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"rewind\\\">https://ev.us-east-1.rtb.test.com/n/OWoH1BWcu3c1oC1Mpe1naLIFze6QEfd4CEM_12URUXc/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_rewind?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"resume\\\">https://ev.us-east-1.rtb.test.com/n/BkiMnvADntSiI5xwDZZEGnrrMq-w8Svlelcs8i8UJ_U/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_resume?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"fullscreen\\\">https://ev.us-east-1.rtb.test.com/n/Eq7IkAOfW5kOtDVhyR3QSIEHjalxt11HGhXguIGioBCEKHkgYPdUnPe6FRvu3pDK/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_fullscreen?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"expand\\\">https://ev.us-east-1.rtb.test.com/n/U6rti4-UuUvws7GAvC9IzeqtodfYrriHAAYUE5K1S78/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_expand?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"collapse\\\">https://ev.us-east-1.rtb.test.com/n/pACzH5io46wB1A4FjT5giophIEzXLdBENRgtxELI-MX0zGBCk1MkoY9i3otiWgyr/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_collapse?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking><Tracking event=\\\"close\\\">https://ev.us-east-1.rtb.test.com/n/m61eNYQ7360IqCOgP3tcixQdHgMTYm2DXyJ4GZJaQCg/ozx79l-aac4-qewQgVjoNqaoxpI34g/vast_close?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__&amp;_cph=[CONTENTPLAYHEAD]</Tracking></TrackingEvents><VideoClicks><ClickTracking>https://ev.us-east-1.rtb.test.com/n/uD3QvdI-eB-mjDRr1_RK_qexB_c46Tv8M_1jpnZb8lQ/ozx79l-aac4-qewQgVjoNqaoxpI34g/clicks?_p=${AUCTION_PRICE}&amp;_s=__RF_REPORTED__</ClickTracking></VideoClicks><MediaFiles></MediaFiles></Linear></Creative></Creatives></Wrapper></Ad></VAST>\",\n \"adomain\": [\n \"pubnativetestad.com\"\n ],\n \"cid\": \"10993\",\n \"crid\": \"4342184916255\",\n \"attr\": [\n 4\n ]\n }\n ]\n }\n ],\n \"cur\": \"USD\"\n}", "language": "json" } ] } [/block] [block:callout] { "type": "warning", "title": "CHECKLIST BEFORE GOING LIVE", "body": "1. Are you using the <APP-TOKEN> of your account?\n2. Are you requesting the ad format you need? (NATIVE/STANDARD/VIDEO)\n3. Are you replacing {AUCTION_PRICE} in the bid response when serving the ad?" } [/block] [block:api-header] { "title": "Get Started" } [/block] To get started or to receive more information, contact us at [email protected] [block:api-header] { "title": "Version History" } [/block] [block:parameters] { "data": { "h-0": "Version", "h-1": "Changes", "0-0": "1.0", "1-0": "1.1", "0-1": "Onboarding Process", "1-1": "Support for Standard Formats", "2-0": "1.2", "2-1": "Update for sizes and spec details." }, "cols": 2, "rows": 3 } [/block]