{"_id":"58e35e2ae6dcd60f00b513a1","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"},"parentDoc":null,"user":"5770dd042659e20e00c90a98","__v":0,"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 SDK"},"project":"574ff4bd3fa1870e00889ba6","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-04-04T08:49:46.904Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":12,"body":"Welcome to PubNative's guite to accessing ads created by the Facebook Audience Network on your application.  Below, we will guide you through setting up ad placements on the FAN dashboard and connecting FAN'S reporting API to PubNative's unified reporting solution.\n[block:api-header]\n{\n  \"title\": \"Before Getting Started\"\n}\n[/block]\n##Integrate PubNative's Mediation SDK\nBefore we can proceed with the Flurry-specific steps, you need to integrate PubNative's Mediation SDK for one or more of the following ad types:\n* [Native Ads](http://developers.pubnative.net/v3.0/docs/ad-layouts)\n* [Small Ad Layout](http://developers.pubnative.net/v3.0/docs/standard-ad-layouts)\n* [Medium Ad Layout](http://developers.pubnative.net/v3.0/docs/medium-ad-layouts-1)\n* [Large Ad Layout](http://developers.pubnative.net/v3.0/docs/large-ad-layouts)\n\n##Integrate the FAN SDK \nBe sure to also integrate FAN's SDK for native ads on Android.\n* [FAN SDK Integration Guide for Android](https://developers.facebook.com/docs/audience-network/android-native/)\n\n##Other Prerequisites\n* You need to be logged in with your Facebook account on deverlopers.facebook.com while building your ad units-- this must be your real Facebook account, not a work or fake account as such accounts are tagged by FAN integrety systems and disabled\n* You need to have an Android app-- by the time you want to go live with FAN in your app, Android apps must be available on the Google Play store-- but no worries, you can integrate FAN and test the integration before your apps are available on the Play store.\n\n[block:api-header]\n{\n  \"title\": \"Building Ad Units with FAN\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<div class=\\\"isa_info\\\">\\n  <b>Note</b> You must be logged into Facebook to proceed\\n</div> \"\n}\n[/block]\n##Step 1\nGo to https://developers.facebook.com/apps/ and click **+Add a New App**\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3aa6aa1-1.png\",\n        \"1.png\",\n        851,\n        193,\n        \"#e9e9e9\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 2\nInput your app's display name and your contact email.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/e471ac0-2.png\",\n        \"2.png\",\n        849,\n        383,\n        \"#8f9092\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 3\nAfter selecting **Create App ID**, you will be directed to the **Product Setup** page.  Now, select **Audience Network**\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7b745b0-3.png\",\n        \"3.png\",\n        814,\n        639,\n        \"#4c5464\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 4\nSelect the **Get Started** button\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2de7ded-4.png\",\n        \"4.png\",\n        814,\n        381,\n        \"#475061\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 5\nHere, you are redirected to the **Apps** page in the Quick Start  guide for Audience Network.  Click on **Add App**\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/80f33a1-5.png\",\n        \"5.png\",\n        810,\n        450,\n        \"#ebe9e7\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 6\nFind your app's URL in the Google Play Store and paste it in the section below.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/53a2c09-6.png\",\n        \"6.png\",\n        812,\n        453,\n        \"#959596\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 7\nNow you need to create your ad placement.  Start by clicking **Create Ad Placement** in the Placements section\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/46b838a-6.png\",\n        \"6.png\",\n        800,\n        471,\n        \"#484f5d\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 8\nIn the Display Format section, select **Native**, after entering your name, and, optionally, the custom steps you want to trigger your ad.  Lastly, choose your optimization type, with explanations below:\n* Optimize for fill will yield the highest revenue\n* Optimize for CPM will give a higher price per impression, but will reduce the fill rate.  This might be the right setting if you are using mediation with multiple demand sources and are less concerned about unfilled requests.  \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/0d83dc1-8.png\",\n        \"8.png\",\n        797,\n        665,\n        \"#949494\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 9\nYou are now ready to integrate the Audience Network SDK into your app or mobile website and begin showing ads.  Follow the [implementation guide for Android.](https://developers.facebook.com/docs/audience-network/android) \n\nAt the end of this step, you should have Audience Network ads showing in at least one placement within your app or mobile website.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": []\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Additional Steps with FAN\"\n}\n[/block]\nIn order to finish setting up your app on the FAN side, you have two more steps to complete.  Click on the links below to navigate to the corresponding pages on the FAN site.\n*[ Submit your app to FAN for review](https://developers.facebook.com/docs/audience-network/getting-started#onboarding)\n* [Provide Payout Information](https://developers.facebook.com/docs/audience-network/getting-started#payout) \n[block:api-header]\n{\n  \"title\": \"Connecting FAN placement data to the PubNative Dashboard\"\n}\n[/block]\nThere are three pieces of information that we need to transcribe from your FAN dashboard into your PubNative Dashboard: \n* App ID\n* App Secret-- the token that allows PubNative to include your app's FAN performance in our unifed reporting solution\n* Placement ID\n* **Note: you define the \"name\" field yourself.**  This is a custom filed so that you can identify your app placements\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/604ddc1-fan.png\",\n        \"fan.png\",\n        1721,\n        636,\n        \"#dfdfdc\"\n      ]\n    }\n  ]\n}\n[/block]\nBelow we will guide you through finding this information in FAN's dashboard\n\n##App ID\nTo get your App ID, you can simply go to the Dashboard when your app selected in the upper left hand corner.  Your app id will be displayed with additional details in the window.  \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/b147936-1.png\",\n        \"1.png\",\n        1566,\n        430,\n        \"#505066\"\n      ]\n    }\n  ]\n}\n[/block]\n##App Secret\nTo get your App Secret, go to the dashboard, as you did to get your App ID.  Now click \"show\" next to the hidden app secret.  A box like this will appear, prompting you to reenter your Facebook Password. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5bdf086-2.png\",\n        \"2.png\",\n        930,\n        437,\n        \"#949494\"\n      ]\n    }\n  ]\n}\n[/block]\nNow the password box will close and you will be able to see your App Secret clearly displayed.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d2d90b1-3.png\",\n        \"3.png\",\n        908,\n        343,\n        \"#ebecef\"\n      ]\n    }\n  ]\n}\n[/block]\n##Placement ID\nTo get your placement ID, ensure that your app is selected in the upper left hand corner of the window.  Then Navigate to **Audience Network** in the left column under **Products**.  Now select the **Placements** sub-option.  \n\nIn the placements screen, you can see your placement's name and then the **Placement ID**, outlined below in purple.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7294fcf-4.png\",\n        \"4.png\",\n        1526,\n        623,\n        \"#ebeced\"\n      ]\n    }\n  ]\n}\n[/block]\nNow you have all the information you need to connect your placements in the PubNative Dashboard.  Happy mediating!  \n[block:html]\n{\n  \"html\": \"<style>\\n.isa_info {\\nmargin: 10px 0px !important;\\npadding:12px !important;\\n}\\n\\n.isa_info {\\n    color: #424242 !important;\\n    background-color: #dcdcdc !important;\\n}\\n\\n.isa_info i {\\n    margin:10px 22px !important;\\n    font-size:16px !important;\\n    vertical-align:middle !important;\\n}\\n  \\n</style>\"\n}\n[/block]","excerpt":"","slug":"facebook-audience-network","type":"basic","title":"Facebook Audience Network"}

Facebook Audience Network


Welcome to PubNative's guite to accessing ads created by the Facebook Audience Network on your application. Below, we will guide you through setting up ad placements on the FAN dashboard and connecting FAN'S reporting API to PubNative's unified reporting solution. [block:api-header] { "title": "Before Getting Started" } [/block] ##Integrate PubNative's Mediation SDK Before we can proceed with the Flurry-specific steps, you need to integrate PubNative's Mediation SDK for one or more of the following ad types: * [Native Ads](http://developers.pubnative.net/v3.0/docs/ad-layouts) * [Small Ad Layout](http://developers.pubnative.net/v3.0/docs/standard-ad-layouts) * [Medium Ad Layout](http://developers.pubnative.net/v3.0/docs/medium-ad-layouts-1) * [Large Ad Layout](http://developers.pubnative.net/v3.0/docs/large-ad-layouts) ##Integrate the FAN SDK Be sure to also integrate FAN's SDK for native ads on Android. * [FAN SDK Integration Guide for Android](https://developers.facebook.com/docs/audience-network/android-native/) ##Other Prerequisites * You need to be logged in with your Facebook account on deverlopers.facebook.com while building your ad units-- this must be your real Facebook account, not a work or fake account as such accounts are tagged by FAN integrety systems and disabled * You need to have an Android app-- by the time you want to go live with FAN in your app, Android apps must be available on the Google Play store-- but no worries, you can integrate FAN and test the integration before your apps are available on the Play store. [block:api-header] { "title": "Building Ad Units with FAN" } [/block] [block:html] { "html": "<div class=\"isa_info\">\n <b>Note</b> You must be logged into Facebook to proceed\n</div> " } [/block] ##Step 1 Go to https://developers.facebook.com/apps/ and click **+Add a New App** [block:image] { "images": [ { "image": [ "https://files.readme.io/3aa6aa1-1.png", "1.png", 851, 193, "#e9e9e9" ] } ] } [/block] ##Step 2 Input your app's display name and your contact email. [block:image] { "images": [ { "image": [ "https://files.readme.io/e471ac0-2.png", "2.png", 849, 383, "#8f9092" ] } ] } [/block] ##Step 3 After selecting **Create App ID**, you will be directed to the **Product Setup** page. Now, select **Audience Network** [block:image] { "images": [ { "image": [ "https://files.readme.io/7b745b0-3.png", "3.png", 814, 639, "#4c5464" ] } ] } [/block] ##Step 4 Select the **Get Started** button [block:image] { "images": [ { "image": [ "https://files.readme.io/2de7ded-4.png", "4.png", 814, 381, "#475061" ] } ] } [/block] ##Step 5 Here, you are redirected to the **Apps** page in the Quick Start guide for Audience Network. Click on **Add App** [block:image] { "images": [ { "image": [ "https://files.readme.io/80f33a1-5.png", "5.png", 810, 450, "#ebe9e7" ] } ] } [/block] ##Step 6 Find your app's URL in the Google Play Store and paste it in the section below. [block:image] { "images": [ { "image": [ "https://files.readme.io/53a2c09-6.png", "6.png", 812, 453, "#959596" ] } ] } [/block] ##Step 7 Now you need to create your ad placement. Start by clicking **Create Ad Placement** in the Placements section [block:image] { "images": [ { "image": [ "https://files.readme.io/46b838a-6.png", "6.png", 800, 471, "#484f5d" ] } ] } [/block] ##Step 8 In the Display Format section, select **Native**, after entering your name, and, optionally, the custom steps you want to trigger your ad. Lastly, choose your optimization type, with explanations below: * Optimize for fill will yield the highest revenue * Optimize for CPM will give a higher price per impression, but will reduce the fill rate. This might be the right setting if you are using mediation with multiple demand sources and are less concerned about unfilled requests. [block:image] { "images": [ { "image": [ "https://files.readme.io/0d83dc1-8.png", "8.png", 797, 665, "#949494" ] } ] } [/block] ##Step 9 You are now ready to integrate the Audience Network SDK into your app or mobile website and begin showing ads. Follow the [implementation guide for Android.](https://developers.facebook.com/docs/audience-network/android) At the end of this step, you should have Audience Network ads showing in at least one placement within your app or mobile website. [block:image] { "images": [ { "image": [] } ] } [/block] [block:api-header] { "title": "Additional Steps with FAN" } [/block] In order to finish setting up your app on the FAN side, you have two more steps to complete. Click on the links below to navigate to the corresponding pages on the FAN site. *[ Submit your app to FAN for review](https://developers.facebook.com/docs/audience-network/getting-started#onboarding) * [Provide Payout Information](https://developers.facebook.com/docs/audience-network/getting-started#payout) [block:api-header] { "title": "Connecting FAN placement data to the PubNative Dashboard" } [/block] There are three pieces of information that we need to transcribe from your FAN dashboard into your PubNative Dashboard: * App ID * App Secret-- the token that allows PubNative to include your app's FAN performance in our unifed reporting solution * Placement ID * **Note: you define the "name" field yourself.** This is a custom filed so that you can identify your app placements [block:image] { "images": [ { "image": [ "https://files.readme.io/604ddc1-fan.png", "fan.png", 1721, 636, "#dfdfdc" ] } ] } [/block] Below we will guide you through finding this information in FAN's dashboard ##App ID To get your App ID, you can simply go to the Dashboard when your app selected in the upper left hand corner. Your app id will be displayed with additional details in the window. [block:image] { "images": [ { "image": [ "https://files.readme.io/b147936-1.png", "1.png", 1566, 430, "#505066" ] } ] } [/block] ##App Secret To get your App Secret, go to the dashboard, as you did to get your App ID. Now click "show" next to the hidden app secret. A box like this will appear, prompting you to reenter your Facebook Password. [block:image] { "images": [ { "image": [ "https://files.readme.io/5bdf086-2.png", "2.png", 930, 437, "#949494" ] } ] } [/block] Now the password box will close and you will be able to see your App Secret clearly displayed. [block:image] { "images": [ { "image": [ "https://files.readme.io/d2d90b1-3.png", "3.png", 908, 343, "#ebecef" ] } ] } [/block] ##Placement ID To get your placement ID, ensure that your app is selected in the upper left hand corner of the window. Then Navigate to **Audience Network** in the left column under **Products**. Now select the **Placements** sub-option. In the placements screen, you can see your placement's name and then the **Placement ID**, outlined below in purple. [block:image] { "images": [ { "image": [ "https://files.readme.io/7294fcf-4.png", "4.png", 1526, 623, "#ebeced" ] } ] } [/block] Now you have all the information you need to connect your placements in the PubNative Dashboard. Happy mediating! [block:html] { "html": "<style>\n.isa_info {\nmargin: 10px 0px !important;\npadding:12px !important;\n}\n\n.isa_info {\n color: #424242 !important;\n background-color: #dcdcdc !important;\n}\n\n.isa_info i {\n margin:10px 22px !important;\n font-size:16px !important;\n vertical-align:middle !important;\n}\n \n</style>" } [/block]