{"_id":"5980886f93b4520014f57787","project":"574ff4bd3fa1870e00889ba6","version":{"_id":"574ff4bd3fa1870e00889ba9","project":"574ff4bd3fa1870e00889ba6","__v":24,"createdAt":"2016-06-02T08:56:29.492Z","releaseDate":"2016-06-02T08:56:29.492Z","categories":["574ff4bd3fa1870e00889baa","577278ecdceb570e003a9001","577279865617b117009e643f","577279985617b117009e6440","577279bc8c48e00e00503504","5774fe18605b770e0037be8a","577ce3ad87acf617003c4187","577f8476a77c700e006a6c52","57b486ae0d2b640e00e9d3f5","57b722133d3e620e004ec74b","57bd95f00fe3a00e003e2cc5","57c8349359cd4b0e00b888ef","57c8349b5754fa1700b12242","57cedb0bad483e0e00890239","57cedbe807d7ea0e00e438cc","57d82967156ef72b007ffcd8","58ee353ad1ee2f0f0034a13d","596623221738df00298622a5","59a51730192dba000fc9ca38","59a8129f1e7b26000fa0fb1a","5a0322bf044b6f001c236e36","5a79897c5b6e430030746df6","5a79898c2b2d5f0012cbab63","5ab3b5e3d2d1e2006252a8f2"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"3.0.0","version":"3.0"},"category":{"_id":"57b722133d3e620e004ec74b","__v":0,"version":"574ff4bd3fa1870e00889ba9","project":"574ff4bd3fa1870e00889ba6","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-08-19T15:13:23.417Z","from_sync":false,"order":9,"slug":"ios-native-ads-mediation-layer","title":"iOS SDK"},"user":"5770fa1ce5a0000e0023c680","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-08-01T13:55:59.541Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":12,"body":"This guide is intended for publishers who are interested in serving;\n\n* Native Ads\n* Banner Ads\n* MRect Ads\n* Fullscreen Interstitials\n\nfrom PubNative using the **MoPub** mediation network. This document will help setting up of the mediation adapter with your iOS application and set up any additional request parameters.\n[block:api-header]\n{\n  \"title\": \"Requirements\"\n}\n[/block]\n* MoPub iOS SDK\n* PubNative iOS SDK\n* PubNative MoPub iOS Adapter\n* An App Token obtained from PubNative Dashboard\n* A Placement Name configured and obtained from the PubNative Dashboard\n\n**Note:** At the moment, this adapter project is supporting the versions down below:\n* **Pubnative.framework:** 2.0.1\n* **MoPub:** 4.16.0\n* **iOS:** Base SDK supports 8.0 and up. Full-featured SDK supports 9.0 and up.\n[block:api-header]\n{\n  \"title\": \"Install MoPub iOS SDK\"\n}\n[/block]\n[Download](https://github.com/mopub/mopub-ios-sdk) and install the MoPub iOS SDK as described in the [MoPub Wiki](https://github.com/mopub/mopub-ios-sdk/wiki#download-the-mopub-ios-sdk).\n\n**Note:** If you plan to use Native Ads, please implement MoPub Native in your project.\n[block:api-header]\n{\n  \"title\": \"Install PubNative iOS SDK\"\n}\n[/block]\n[Download](https://github.com/pubnative/pubnative-ios-sdk/releases) and install the PubNative iOS SDK as described in [here](http://developers.pubnative.net/docs/for-developers-1#install-pubnative-sdk).\n\n**Important Note:** PubNative iOS SDK supports iOS 8.0 and up. Full-featured SDK supports iOS 9.0 and up.\n[block:api-header]\n{\n  \"title\": \"Install PubNative MoPub iOS Adapter\"\n}\n[/block]\n* [Download](https://github.com/pubnative/pubnative-ios-sdk-adapters) PubNative MoPub adapter files and add them to your project. \n\n* To do this, drag and drop the **mopub** folder into your Xcode application group. _**(Be sure to check the \"Copy items into destination group's folder\" option).**_\n[block:api-header]\n{\n  \"title\": \"Configuring Custom Events\"\n}\n[/block]\nPubNative MoPub iOS Adapter supports the following ad formats:\n\n  * [Native](http://developers.pubnative.net/v3.0/docs/mopub-adapter-2#adding-a-custom-event-of-native)\n  * [Banner](http://developers.pubnative.net/v3.0/docs/mopub-adapter-2#adding-a-custom-event-of-banner)\n  * [MRect](http://developers.pubnative.net/v3.0/docs/mopub-adapter-2#adding-a-custom-event-of-mrect) \n  * [Interstitial](http://developers.pubnative.net/v3.0/docs/mopub-adapter-2#adding-a-custom-event-of-interstitial)\n[block:api-header]\n{\n  \"title\": \"Adding a Custom Event of Native\"\n}\n[/block]\n1. Log into your MoPub account.\n2. Navigate to the **Networks** tab and click **Add a Network**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/42064a8-Netwokr.png\",\n        \"Netwokr.png\",\n        682,\n        162,\n        \"#2e2f36\"\n      ]\n    }\n  ]\n}\n[/block]\n3. Under **Additional Networks**, click **Custom Native Network** *(for mediation of Native format)*.\n           \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/347f8af-native.png\",\n        \"native.png\",\n        689,\n        721,\n        \"#315e82\"\n      ]\n    }\n  ]\n}\n[/block]\n4. Under **Set up Custom Native Network**, fill in **‘PubNative’** in the **Title** field.\n          \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1e2e802-custom.png\",\n        \"custom.png\",\n        767,\n        170,\n        \"#ddd9d7\"\n      ]\n    }\n  ]\n}\n[/block]\n5. Under the **Set Up your Inventory**, select the ad units where you want to show PubNative Native Ads, and fill in the appropriate class name under the **Custom Event Class** and App Token ID with Placement Name under **Custom Event Class Data**.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"PNMPNativeCustomEvent\",\n      \"language\": \"text\",\n      \"name\": \"Custom Event Class\"\n    }\n  ]\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\\"app_token\\\":\\\"YOUR-APP-TOKEN-ID\\\", \\\"placement\\\":\\\"YOUR-PLACEMENT-NAME\\\"}\",\n      \"language\": \"text\",\n      \"name\": \"Custom Event Class Data\"\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c45fa6f-iOS_Native.png\",\n        \"iOS Native.png\",\n        946,\n        189,\n        \"#efedee\"\n      ]\n    }\n  ]\n}\n[/block]\n6. Click **Save and Continue **.\n7. Click the **PubNative** network and make sure the **Run** button is active.\n\n \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4e7abd0-activate.png\",\n        \"activate.png\",\n        318,\n        148,\n        \"#f0f6f6\"\n      ]\n    }\n  ]\n}\n[/block]\n8. Testing Your Application: with the above steps, you can start receiving PubNative ads through the MoPub Dashboard.\n\n[block:api-header]\n{\n  \"title\": \"Adding a Custom Event of Banner\"\n}\n[/block]\n1. Log into your MoPub account.\n2. Navigate to the **Networks** tab and click **Add a Network**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/454a609-Netwokr.png\",\n        \"Netwokr.png\",\n        682,\n        162,\n        \"#2e2f36\"\n      ]\n    }\n  ]\n}\n[/block]\n3. Under **Additional Networks**, click **Custom Native Network** *(for mediation of Banner  format)*.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/adb1685-native.png\",\n        \"native.png\",\n        689,\n        721,\n        \"#315e82\"\n      ]\n    }\n  ]\n}\n[/block]\n4. Under **Setup Custom Native Network**, fill in **‘PubNative’** in the **Title** field.\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/29f0811-custom.png\",\n        \"custom.png\",\n        767,\n        170,\n        \"#ddd9d7\"\n      ]\n    }\n  ]\n}\n[/block]\n5. Under the **Set Up your Inventory**, select the ad units where you want to show PubNative Banner Ads, and fill in the appropriate class name under the **Custom Event Class** and App Token ID with Placement Name under **Custom Event Class Data**.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"PNMPBannerCustomEvent\",\n      \"language\": \"text\",\n      \"name\": \"Custom Event Class\"\n    }\n  ]\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\\"app_token\\\":\\\"YOUR-APP-TOKEN-ID\\\", \\\"placement\\\":\\\"YOUR-PLACEMENT-NAME\\\"}\",\n      \"language\": \"text\",\n      \"name\": \"Custom Event Class Data\"\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/07151c3-iOS_Banner.png\",\n        \"iOS Banner.png\",\n        961,\n        181,\n        \"#eaeaea\"\n      ]\n    }\n  ]\n}\n[/block]\n6. Click **Save and Continue **.\n7. Click the **PubNative** network and make sure the **Run** button is active.\n\n \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/f1eb35e-activate.png\",\n        \"activate.png\",\n        318,\n        148,\n        \"#f0f6f6\"\n      ]\n    }\n  ]\n}\n[/block]\n8. Testing Your Application: with the above steps, you can start receiving PubNative ads through the MoPub Dashboard.\n\n[block:api-header]\n{\n  \"title\": \"Adding a Custom Event of MRect\"\n}\n[/block]\nSame procedure as for Banners. The only difference is that you need to configure it for Medium placements.\n[block:api-header]\n{\n  \"title\": \"Adding a Custom Event of Interstitial\"\n}\n[/block]\n1.\tLog into your MoPub account.\n2.\tNavigate to the **Networks** tab and click **Add a Network**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/527b47e-Netwokr.png\",\n        \"Netwokr.png\",\n        682,\n        162,\n        \"#2e2f36\"\n      ]\n    }\n  ]\n}\n[/block]\n3. Under **Additional Networks**, click **Custom Native Network** *(for mediation of Interstitial format)*.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1f1331a-native.png\",\n        \"native.png\",\n        689,\n        721,\n        \"#315e82\"\n      ]\n    }\n  ]\n}\n[/block]\n4. Under **Setup Custom Native Network**, fill in **‘PubNative’** in the **Title** field.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/df2bdc7-custom.png\",\n        \"custom.png\",\n        767,\n        170,\n        \"#ddd9d7\"\n      ]\n    }\n  ]\n}\n[/block]\n5. Under the **Set Up your Inventory**, select the ad units where you want to show PubNative Fullscreen Ads, and fill in the appropriate class name under the **Custom Event Class** and App Token ID with Placement Name under **Custom Event Class Data**.\n\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"PNMPInterstitialCustomEvent\",\n      \"language\": \"text\",\n      \"name\": \"Custom Event Class\"\n    }\n  ]\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\\"app_token\\\":\\\"YOUR-APP-TOKEN-ID\\\", \\\"placement\\\":\\\"YOUR-PLACEMENT-NAME\\\"}\",\n      \"language\": \"text\",\n      \"name\": \"Custom Event Class Data\"\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/b83f9eb-iOS_Interstitial.png\",\n        \"iOS Interstitial.png\",\n        955,\n        171,\n        \"#edebeb\"\n      ]\n    }\n  ]\n}\n[/block]\n6. Click **Save and Continue **.\n7. Click the **PubNative** network and make sure the **Run** button is active.\n\n \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/37f4e6e-activate.png\",\n        \"activate.png\",\n        318,\n        148,\n        \"#f0f6f6\"\n      ]\n    }\n  ]\n}\n[/block]\n8. Testing Your Application: with the above steps, you can start receiving PubNative ads through the MoPub Dashboard.","excerpt":"","slug":"mopub-adapter-2","type":"basic","title":"MoPub Adapter iOS"}
This guide is intended for publishers who are interested in serving; * Native Ads * Banner Ads * MRect Ads * Fullscreen Interstitials from PubNative using the **MoPub** mediation network. This document will help setting up of the mediation adapter with your iOS application and set up any additional request parameters. [block:api-header] { "title": "Requirements" } [/block] * MoPub iOS SDK * PubNative iOS SDK * PubNative MoPub iOS Adapter * An App Token obtained from PubNative Dashboard * A Placement Name configured and obtained from the PubNative Dashboard **Note:** At the moment, this adapter project is supporting the versions down below: * **Pubnative.framework:** 2.0.1 * **MoPub:** 4.16.0 * **iOS:** Base SDK supports 8.0 and up. Full-featured SDK supports 9.0 and up. [block:api-header] { "title": "Install MoPub iOS SDK" } [/block] [Download](https://github.com/mopub/mopub-ios-sdk) and install the MoPub iOS SDK as described in the [MoPub Wiki](https://github.com/mopub/mopub-ios-sdk/wiki#download-the-mopub-ios-sdk). **Note:** If you plan to use Native Ads, please implement MoPub Native in your project. [block:api-header] { "title": "Install PubNative iOS SDK" } [/block] [Download](https://github.com/pubnative/pubnative-ios-sdk/releases) and install the PubNative iOS SDK as described in [here](http://developers.pubnative.net/docs/for-developers-1#install-pubnative-sdk). **Important Note:** PubNative iOS SDK supports iOS 8.0 and up. Full-featured SDK supports iOS 9.0 and up. [block:api-header] { "title": "Install PubNative MoPub iOS Adapter" } [/block] * [Download](https://github.com/pubnative/pubnative-ios-sdk-adapters) PubNative MoPub adapter files and add them to your project. * To do this, drag and drop the **mopub** folder into your Xcode application group. _**(Be sure to check the "Copy items into destination group's folder" option).**_ [block:api-header] { "title": "Configuring Custom Events" } [/block] PubNative MoPub iOS Adapter supports the following ad formats: * [Native](http://developers.pubnative.net/v3.0/docs/mopub-adapter-2#adding-a-custom-event-of-native) * [Banner](http://developers.pubnative.net/v3.0/docs/mopub-adapter-2#adding-a-custom-event-of-banner) * [MRect](http://developers.pubnative.net/v3.0/docs/mopub-adapter-2#adding-a-custom-event-of-mrect) * [Interstitial](http://developers.pubnative.net/v3.0/docs/mopub-adapter-2#adding-a-custom-event-of-interstitial) [block:api-header] { "title": "Adding a Custom Event of Native" } [/block] 1. Log into your MoPub account. 2. Navigate to the **Networks** tab and click **Add a Network**. [block:image] { "images": [ { "image": [ "https://files.readme.io/42064a8-Netwokr.png", "Netwokr.png", 682, 162, "#2e2f36" ] } ] } [/block] 3. Under **Additional Networks**, click **Custom Native Network** *(for mediation of Native format)*. [block:image] { "images": [ { "image": [ "https://files.readme.io/347f8af-native.png", "native.png", 689, 721, "#315e82" ] } ] } [/block] 4. Under **Set up Custom Native Network**, fill in **‘PubNative’** in the **Title** field. [block:image] { "images": [ { "image": [ "https://files.readme.io/1e2e802-custom.png", "custom.png", 767, 170, "#ddd9d7" ] } ] } [/block] 5. Under the **Set Up your Inventory**, select the ad units where you want to show PubNative Native Ads, and fill in the appropriate class name under the **Custom Event Class** and App Token ID with Placement Name under **Custom Event Class Data**. [block:code] { "codes": [ { "code": "PNMPNativeCustomEvent", "language": "text", "name": "Custom Event Class" } ] } [/block] [block:code] { "codes": [ { "code": "{\"app_token\":\"YOUR-APP-TOKEN-ID\", \"placement\":\"YOUR-PLACEMENT-NAME\"}", "language": "text", "name": "Custom Event Class Data" } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/c45fa6f-iOS_Native.png", "iOS Native.png", 946, 189, "#efedee" ] } ] } [/block] 6. Click **Save and Continue **. 7. Click the **PubNative** network and make sure the **Run** button is active. [block:image] { "images": [ { "image": [ "https://files.readme.io/4e7abd0-activate.png", "activate.png", 318, 148, "#f0f6f6" ] } ] } [/block] 8. Testing Your Application: with the above steps, you can start receiving PubNative ads through the MoPub Dashboard. [block:api-header] { "title": "Adding a Custom Event of Banner" } [/block] 1. Log into your MoPub account. 2. Navigate to the **Networks** tab and click **Add a Network**. [block:image] { "images": [ { "image": [ "https://files.readme.io/454a609-Netwokr.png", "Netwokr.png", 682, 162, "#2e2f36" ] } ] } [/block] 3. Under **Additional Networks**, click **Custom Native Network** *(for mediation of Banner format)*. [block:image] { "images": [ { "image": [ "https://files.readme.io/adb1685-native.png", "native.png", 689, 721, "#315e82" ] } ] } [/block] 4. Under **Setup Custom Native Network**, fill in **‘PubNative’** in the **Title** field. [block:image] { "images": [ { "image": [ "https://files.readme.io/29f0811-custom.png", "custom.png", 767, 170, "#ddd9d7" ] } ] } [/block] 5. Under the **Set Up your Inventory**, select the ad units where you want to show PubNative Banner Ads, and fill in the appropriate class name under the **Custom Event Class** and App Token ID with Placement Name under **Custom Event Class Data**. [block:code] { "codes": [ { "code": "PNMPBannerCustomEvent", "language": "text", "name": "Custom Event Class" } ] } [/block] [block:code] { "codes": [ { "code": "{\"app_token\":\"YOUR-APP-TOKEN-ID\", \"placement\":\"YOUR-PLACEMENT-NAME\"}", "language": "text", "name": "Custom Event Class Data" } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/07151c3-iOS_Banner.png", "iOS Banner.png", 961, 181, "#eaeaea" ] } ] } [/block] 6. Click **Save and Continue **. 7. Click the **PubNative** network and make sure the **Run** button is active. [block:image] { "images": [ { "image": [ "https://files.readme.io/f1eb35e-activate.png", "activate.png", 318, 148, "#f0f6f6" ] } ] } [/block] 8. Testing Your Application: with the above steps, you can start receiving PubNative ads through the MoPub Dashboard. [block:api-header] { "title": "Adding a Custom Event of MRect" } [/block] Same procedure as for Banners. The only difference is that you need to configure it for Medium placements. [block:api-header] { "title": "Adding a Custom Event of Interstitial" } [/block] 1. Log into your MoPub account. 2. Navigate to the **Networks** tab and click **Add a Network**. [block:image] { "images": [ { "image": [ "https://files.readme.io/527b47e-Netwokr.png", "Netwokr.png", 682, 162, "#2e2f36" ] } ] } [/block] 3. Under **Additional Networks**, click **Custom Native Network** *(for mediation of Interstitial format)*. [block:image] { "images": [ { "image": [ "https://files.readme.io/1f1331a-native.png", "native.png", 689, 721, "#315e82" ] } ] } [/block] 4. Under **Setup Custom Native Network**, fill in **‘PubNative’** in the **Title** field. [block:image] { "images": [ { "image": [ "https://files.readme.io/df2bdc7-custom.png", "custom.png", 767, 170, "#ddd9d7" ] } ] } [/block] 5. Under the **Set Up your Inventory**, select the ad units where you want to show PubNative Fullscreen Ads, and fill in the appropriate class name under the **Custom Event Class** and App Token ID with Placement Name under **Custom Event Class Data**. [block:code] { "codes": [ { "code": "PNMPInterstitialCustomEvent", "language": "text", "name": "Custom Event Class" } ] } [/block] [block:code] { "codes": [ { "code": "{\"app_token\":\"YOUR-APP-TOKEN-ID\", \"placement\":\"YOUR-PLACEMENT-NAME\"}", "language": "text", "name": "Custom Event Class Data" } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/b83f9eb-iOS_Interstitial.png", "iOS Interstitial.png", 955, 171, "#edebeb" ] } ] } [/block] 6. Click **Save and Continue **. 7. Click the **PubNative** network and make sure the **Run** button is active. [block:image] { "images": [ { "image": [ "https://files.readme.io/37f4e6e-activate.png", "activate.png", 318, 148, "#f0f6f6" ] } ] } [/block] 8. Testing Your Application: with the above steps, you can start receiving PubNative ads through the MoPub Dashboard.