{"_id":"57b486fc6f47ab200024742a","__v":0,"parentDoc":null,"category":{"_id":"57b486ae0d2b640e00e9d3f5","__v":0,"project":"574ff4bd3fa1870e00889ba6","version":"574ff4bd3fa1870e00889ba9","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-08-17T15:45:50.062Z","from_sync":false,"order":7,"slug":"native-ads-mediation-layer","title":"Android Native Ads Mediation Layer"},"user":"5770dd042659e20e00c90a98","version":{"_id":"574ff4bd3fa1870e00889ba9","project":"574ff4bd3fa1870e00889ba6","__v":17,"createdAt":"2016-06-02T08:56:29.492Z","releaseDate":"2016-06-02T08:56:29.492Z","categories":["574ff4bd3fa1870e00889baa","577278ecdceb570e003a9001","577279865617b117009e643f","577279985617b117009e6440","577279bc8c48e00e00503504","5774fe18605b770e0037be8a","577ce3ad87acf617003c4187","577f8476a77c700e006a6c52","57b486ae0d2b640e00e9d3f5","57b722133d3e620e004ec74b","57bd95f00fe3a00e003e2cc5","57c8349359cd4b0e00b888ef","57c8349b5754fa1700b12242","57cedb0bad483e0e00890239","57cedbe807d7ea0e00e438cc","57d82967156ef72b007ffcd8","58ee353ad1ee2f0f0034a13d"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"3.0.0","version":"3.0"},"project":"574ff4bd3fa1870e00889ba6","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-08-17T15:47:08.362Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"The PubNative Mediation User Interface consists of the Placements, Networkds, Network's Priorities, Visibility and User Segments tabs. The Mediation dashboard allows you to enable control and plan your app monetization strategy.  You can view, manage and regulate all of your app revenue data in one ultimate dashboard - which includes Ad Networks setup, PubNative's exclusive demand sources and ad targeting.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"1. App Placements\"\n}\n[/block]\nYou can configure different placements within your app in the section called Placements.  Each placement can have only one ad format ocnfigured at a given point of time.  Formats that can be applied include the Native Icon and the Native Banner. Once you have configured a placement in the PubNative dashboard, an ID will be generated and assigned to this placement. Thus, you can control, edit, and view the placements and the formats within your app as per the performance of each of these placements.\n\nIt is mandatory to have at least one Placement to use the mediation layer.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/67f6d4e-1.PNG\",\n        \"1.PNG\",\n        611,\n        109,\n        \"#e7e8e9\"\n      ]\n    }\n  ]\n}\n[/block]\nExamples of the Native Banner and Native Icon formats are below:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2554777-NATIVE_BANNER.PNG\",\n        \"NATIVE BANNER.PNG\",\n        283,\n        442,\n        \"#cedbca\"\n      ],\n      \"caption\": \"Native Banner\"\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/51e258b-native_icon.PNG\",\n        \"native icon.PNG\",\n        244,\n        437,\n        \"#265c83\"\n      ],\n      \"caption\": \"Native Icon\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"2. Networks\"\n}\n[/block]\nPubNative allows you to configure and manage Ad Networks in the Networks section, once you have everything set up at the ad network's end (refer to Prerequisites for Integrating PubNative Mediation Layer).\n\n##Configuring a Network\n\n1. Assign a Name to the Network that you have selected\n2. Depending on the network that you choose to configure, it is mandatory that you provide different parameters for Reporting and Mediation purposes\na. Requirements for Facebook:\n        •  Placement ID\n        •  App ID\n        •  App Secret\nb. Requirements for Yahoo's flurry\n        •  API Key\n        •  Adspace Name\n        •  Adspace ID\n        •  API access code\nc. Requirements for Yahoo via Gemini API\n        •  API Key\n        •  Adspace Name\n        •  Consumer Key\n        •  Consumer Secret\n        •  Publisher ID\n        •  Section ID\nd. Refresh Token Requirements for AdMob\n        •  Ad Unit ID\n        •  Client Key\n        •  Client Secret\ne. Requirements for PubNative\n        •  Will be automatically integrated for reporting purpose\n        •  Refer to Advanced Customization section for more detailed configuration\n\nClick on Submit after filling in the required parameters\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7f057f5-1.PNG\",\n        \"1.PNG\",\n        597,\n        146,\n        \"#e6e6e7\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"3. Network's Priorities\"\n}\n[/block]\nNetworks Priorities section allows publishers to assign priority to a combination of different placements, segments, ad networks and geographies according to a waterfall system. An eCPM value is assigned to each combination and the network ads are fetched according to the eCPM order assigned from highest to the lowest.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/b4af590-1.PNG\",\n        \"1.PNG\",\n        523,\n        252,\n        \"#eaebea\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"4. Visibility\"\n}\n[/block]\nPubNative allows you to control the visibility of your ads by selecting how many times you wish to show an ad in each placement/segment combination or by hiding all the ads in a particular placement/segment combination.\n\n##Configuring Visibility of Ads.  Select an Action:\n1. Hide\n     a. 'Hide' will block all the ads\n     b. Select a placement where you wish to block ads \n     c. Select any particular 'User Segment' where you wish to block the ads      \n     d. Select the Countries where you wish to block the ads\n     e. Submit\n2. Limit\n     a. 'Limit' will limit the ads according to your preference\n     b. Select a placement where you wish to block ads\n     c. Select any particular 'User Segment' where you wish to block the ads\n     d. Select the Countries where you wish to block the ads\n     e. Two options are provided for limiting the Frequency and Pacing of Ads:\n          You can select to show no more than 'a number' of ads for 1 'hour/day'\n          You can limit the pacing of each ad per 'minute/hour'\n     f. Submit\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/51a49a8-1.PNG\",\n        \"1.PNG\",\n        665,\n        179,\n        \"#e3e4e4\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"5. User Segments\"\n}\n[/block]\nPubNative dashboard allows you to group your inventory into user segments. User Segments are a share of your inventory that can be targeted on the basis of different rules such as Age, Connection type, Gender, Device, Context, Min OS Version, Max OS Version, ISP, Country, Region, and City. Each Segment can consist of one or more rules that can be strict or flexible depending on what you choose.  \n\n##Creating a User Segment\n1. Provide a name for the User Segment that you wish to create\n2. Choose Apply to 'All' or 'Any'\n     a. If you choose 'All' then all the rules chosen will have to be true for every segment\n     b. If you choose 'Any' then only one rule, if true, will be a sufficient condition\n3. Select keys example:\n     a. Age\n     b. Select an operator\n     c. Enter a value\n     d. Apply\n\nYou can add multiple rules to one segment.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/9bb09d4-Capture.PNG\",\n        \"Capture.PNG\",\n        832,\n        229,\n        \"#e5e5e3\"\n      ]\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"mediation-ui-setup","type":"basic","title":"Mediation UI Setup"}

Mediation UI Setup


The PubNative Mediation User Interface consists of the Placements, Networkds, Network's Priorities, Visibility and User Segments tabs. The Mediation dashboard allows you to enable control and plan your app monetization strategy. You can view, manage and regulate all of your app revenue data in one ultimate dashboard - which includes Ad Networks setup, PubNative's exclusive demand sources and ad targeting. [block:api-header] { "type": "basic", "title": "1. App Placements" } [/block] You can configure different placements within your app in the section called Placements. Each placement can have only one ad format ocnfigured at a given point of time. Formats that can be applied include the Native Icon and the Native Banner. Once you have configured a placement in the PubNative dashboard, an ID will be generated and assigned to this placement. Thus, you can control, edit, and view the placements and the formats within your app as per the performance of each of these placements. It is mandatory to have at least one Placement to use the mediation layer. [block:image] { "images": [ { "image": [ "https://files.readme.io/67f6d4e-1.PNG", "1.PNG", 611, 109, "#e7e8e9" ] } ] } [/block] Examples of the Native Banner and Native Icon formats are below: [block:image] { "images": [ { "image": [ "https://files.readme.io/2554777-NATIVE_BANNER.PNG", "NATIVE BANNER.PNG", 283, 442, "#cedbca" ], "caption": "Native Banner" } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/51e258b-native_icon.PNG", "native icon.PNG", 244, 437, "#265c83" ], "caption": "Native Icon" } ] } [/block] [block:api-header] { "type": "basic", "title": "2. Networks" } [/block] PubNative allows you to configure and manage Ad Networks in the Networks section, once you have everything set up at the ad network's end (refer to Prerequisites for Integrating PubNative Mediation Layer). ##Configuring a Network 1. Assign a Name to the Network that you have selected 2. Depending on the network that you choose to configure, it is mandatory that you provide different parameters for Reporting and Mediation purposes a. Requirements for Facebook: • Placement ID • App ID • App Secret b. Requirements for Yahoo's flurry • API Key • Adspace Name • Adspace ID • API access code c. Requirements for Yahoo via Gemini API • API Key • Adspace Name • Consumer Key • Consumer Secret • Publisher ID • Section ID d. Refresh Token Requirements for AdMob • Ad Unit ID • Client Key • Client Secret e. Requirements for PubNative • Will be automatically integrated for reporting purpose • Refer to Advanced Customization section for more detailed configuration Click on Submit after filling in the required parameters [block:image] { "images": [ { "image": [ "https://files.readme.io/7f057f5-1.PNG", "1.PNG", 597, 146, "#e6e6e7" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "3. Network's Priorities" } [/block] Networks Priorities section allows publishers to assign priority to a combination of different placements, segments, ad networks and geographies according to a waterfall system. An eCPM value is assigned to each combination and the network ads are fetched according to the eCPM order assigned from highest to the lowest. [block:image] { "images": [ { "image": [ "https://files.readme.io/b4af590-1.PNG", "1.PNG", 523, 252, "#eaebea" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "4. Visibility" } [/block] PubNative allows you to control the visibility of your ads by selecting how many times you wish to show an ad in each placement/segment combination or by hiding all the ads in a particular placement/segment combination. ##Configuring Visibility of Ads. Select an Action: 1. Hide a. 'Hide' will block all the ads b. Select a placement where you wish to block ads c. Select any particular 'User Segment' where you wish to block the ads d. Select the Countries where you wish to block the ads e. Submit 2. Limit a. 'Limit' will limit the ads according to your preference b. Select a placement where you wish to block ads c. Select any particular 'User Segment' where you wish to block the ads d. Select the Countries where you wish to block the ads e. Two options are provided for limiting the Frequency and Pacing of Ads: You can select to show no more than 'a number' of ads for 1 'hour/day' You can limit the pacing of each ad per 'minute/hour' f. Submit [block:image] { "images": [ { "image": [ "https://files.readme.io/51a49a8-1.PNG", "1.PNG", 665, 179, "#e3e4e4" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "5. User Segments" } [/block] PubNative dashboard allows you to group your inventory into user segments. User Segments are a share of your inventory that can be targeted on the basis of different rules such as Age, Connection type, Gender, Device, Context, Min OS Version, Max OS Version, ISP, Country, Region, and City. Each Segment can consist of one or more rules that can be strict or flexible depending on what you choose. ##Creating a User Segment 1. Provide a name for the User Segment that you wish to create 2. Choose Apply to 'All' or 'Any' a. If you choose 'All' then all the rules chosen will have to be true for every segment b. If you choose 'Any' then only one rule, if true, will be a sufficient condition 3. Select keys example: a. Age b. Select an operator c. Enter a value d. Apply You can add multiple rules to one segment. [block:image] { "images": [ { "image": [ "https://files.readme.io/9bb09d4-Capture.PNG", "Capture.PNG", 832, 229, "#e5e5e3" ] } ] } [/block]