{"_id":"5980886f93b4520014f57787","project":"574ff4bd3fa1870e00889ba6","version":{"_id":"574ff4bd3fa1870e00889ba9","project":"574ff4bd3fa1870e00889ba6","__v":20,"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"],"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 native ads, banner ads, MRect ads and fullscreen interstitials from PubNative using the MoPub mediation network. This document will include help the setting up of the mediation adapter with your iOS application and setting 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[block:api-header]\n{\n  \"title\": \"MoPub iOS SDK\"\n}\n[/block]\n  * [Download](https://github.com/mopub/mopub-ios-sdk/wiki/GettingStarted#download-the-mopub-ios-sdk) and install the MoPub iOS SDK as described in the [MoPub Wiki](https://github.com/mopub/mopub-ios-sdk/wiki)\n  * Implement MoPub Native in your project (if you plan to use native ads).\n[block:api-header]\n{\n  \"title\": \"PubNative iOS SDK\"\n}\n[/block]\nYou can add Pubnative SDK in your project in two ways:\n  * If you are using iOS 8+, then simply add **Pubnative.framework** to your project. To do this,  click on your on your application's target, then click on Build Phases and expand the Embedded Binaries group. Add **Pubnative.framework** file here\n  * If you are using iOS version below the 8, you can integrate our SDK inside your project, but manually by cloning the repository and drag'n'drop folder **sdk/sdk** into your app (be sure to check the \"Copy items into destination group's folder\" option).\n\n[block:api-header]\n{\n  \"title\": \"PubNative MoPub iOS Adapter\"\n}\n[/block]\nDownload Pubnative MoPub adapter files and add them into your project. To do this drag the **mopub** folder into your Xcode application group (be sure to check the \"Copy items into destination group's folder\" option).\n\n[block:api-header]\n{\n  \"title\": \"Configuring a Custom Event\"\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-for-mediation-of-native)\n  * [Banner](http://developers.pubnative.net/v3.0/docs/mopub-adapter-2#adding-a-custom-event-for-mediation-of-banners)\n  * [Mrect](http://developers.pubnative.net/docs/mopub-adapter-2#adding-a-custom-event-for-mediation-of-mrect) \n  * [Interstitial](http://developers.pubnative.net/v3.0/docs/mopub-adapter-2#adding-a-custom-event-for-mediation-of-interstitia)\n[block:api-header]\n{\n  \"title\": \"Adding a Custom Event for mediation of Native\"\n}\n[/block]\n1.\tLog into your MoPub account\n\n2.\tNavigate to the **Networks** tab and click **Add a Network**\n           \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.\tUnder **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.\tUnder **Setup 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.\tUnder 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\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.\tClick **Save and Continue **\n \n\n7.\tClick 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.\tTesting 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 for mediation of Banners\"\n}\n[/block]\n1.\tLog into your MoPub account\n\n2.\tNavigate to the **Networks** tab and click **Add a Network**\n\n\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.\tUnder **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.\tUnder **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.\tUnder 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.\tClick **Save and Continue **\n \n\n7.\tClick 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.\tTesting 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 for mediation 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 for mediation of Interstitials\"\n}\n[/block]\n1.\tLog into your MoPub account\n\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.\tUnder **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.\tUnder **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.\tUnder 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\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.\tClick **Save and Continue **\n \n\n7.\tClick 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.\tTesting 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 and fullscreen interstitials from PubNative using the MoPub mediation network. This document will include help the setting up of the mediation adapter with your iOS application and setting 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 [block:api-header] { "title": "MoPub iOS SDK" } [/block] * [Download](https://github.com/mopub/mopub-ios-sdk/wiki/GettingStarted#download-the-mopub-ios-sdk) and install the MoPub iOS SDK as described in the [MoPub Wiki](https://github.com/mopub/mopub-ios-sdk/wiki) * Implement MoPub Native in your project (if you plan to use native ads). [block:api-header] { "title": "PubNative iOS SDK" } [/block] You can add Pubnative SDK in your project in two ways: * If you are using iOS 8+, then simply add **Pubnative.framework** to your project. To do this, click on your on your application's target, then click on Build Phases and expand the Embedded Binaries group. Add **Pubnative.framework** file here * If you are using iOS version below the 8, you can integrate our SDK inside your project, but manually by cloning the repository and drag'n'drop folder **sdk/sdk** into your app (be sure to check the "Copy items into destination group's folder" option). [block:api-header] { "title": "PubNative MoPub iOS Adapter" } [/block] Download Pubnative MoPub adapter files and add them into your project. To do this drag 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 a Custom Event" } [/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-for-mediation-of-native) * [Banner](http://developers.pubnative.net/v3.0/docs/mopub-adapter-2#adding-a-custom-event-for-mediation-of-banners) * [Mrect](http://developers.pubnative.net/docs/mopub-adapter-2#adding-a-custom-event-for-mediation-of-mrect) * [Interstitial](http://developers.pubnative.net/v3.0/docs/mopub-adapter-2#adding-a-custom-event-for-mediation-of-interstitia) [block:api-header] { "title": "Adding a Custom Event for mediation 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 **Setup 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 for mediation of Banners" } [/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 for mediation 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 for mediation of Interstitials" } [/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