{"_id":"58e35de97bd1620f002c8877","__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 SDK"},"user":"5770dd042659e20e00c90a98","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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-04-04T08:48:41.984Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":13,"body":"Welcome to PubNative's guite to accessing ads created by Yahoo Flurry on your application.  Below, we will guide you through setting up ad placements on the Flurry dashboard and connecting Flurry'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 Flurry SDK \n* [Flurry SDK Integration Guide for Android](https://developer.yahoo.com/flurry/docs/integrateflurry/android/)\n[block:api-header]\n{\n  \"title\": \"Building Ad Units with Flurry\"\n}\n[/block]\n##Step 1\nLog in to the Flurry portal at https://login.flurry.com/\n\n##Step 2\nNavigate to the App Publishing tab\n\n##Step 3\nSelect Applications & Ad Units from the left-hand navigation menu\n\n##Step 4\nClick the **+ Ad Unit** button\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/0c07479-1.png\",\n        \"1.png\",\n        620,\n        238,\n        \"#e1f0f8\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 5\nEnter an Ad Unit name, select the application in which the ad unit will appear and select the **Type** as standard\n\n##Step 6\nSelect the **Stream** Placement Type\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/50a2e9a-2.png\",\n        \"2.png\",\n        947,\n        631,\n        \"#21349d\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 7\nSelect the Native Ad Details that best match the format of the native ads that you want in your app:\n* Basic ads include headline, summary, and branding logo\n* Card ads include a headline, summary, and a branding logo overlaid on a high quality image\n* Detailed Card ads include a headline, summary, and a branding logo adjacent to a high quality image\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d7c1a57-3.png\",\n        \"3.png\",\n        646,\n        369,\n        \"#ebeded\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 8\nNow save your ad unit!  \n\nEnsure that you have a green success banner at the top of this page, indicating that your ad unit has been sucessfully saved.  \n[block:api-header]\n{\n  \"title\": \"Setting up Flurry's Reporting API\"\n}\n[/block]\nIn order to view Flurry data on PubNative's unified reporting solution, you first need to obtain your Flurry API access token.  This token grants the authorization to pull the data for that company.  \n\nPlease follow the steps below to obtain your token.  \n\n##Step 1\nLog into y.flurry.com.  \n[block:html]\n{\n  \"html\": \"<div class=\\\"isa_info\\\">\\n  <b>Note</b> You must be the administrator of your account in order to access the Reporting API.  If this is a new account or you are the only user, you can set yourself up as the administrator; if not, the administrator must perform the following steps.\\n</div> \"\n}\n[/block]\n##Step 2\nSelect **Admin** form the Top navigation bar\n\n##Step 3\nSelect  the **Users** option under the **Manage** column to the left\n\n##Step 4\nClick the **Programmatic User** option\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/acd359c-4.png\",\n        \"4.png\",\n        1358,\n        352,\n        \"#1f2995\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 5\nLogin with your Flurry account credentials (email address / password).  Again, you must be the account administrator to complete the following steps.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/0a39d24-5.png\",\n        \"5.png\",\n        2022,\n        1194,\n        \"#1b3ea4\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 6\nEnter the email address that will be tied with the programmatic token and the name of the account (for instance “Programmatic Token”). \n\nThis email address has to be unique i.e. not associated with the Flurry account that you or your company has. For instance, you can enter FlurryProgrammaticUser:::at:::yourCompany.com\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2a34d1b-6.png\",\n        \"6.png\",\n        2026,\n        1268,\n        \"#1e409f\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 7\nReceive the token code to access the API.  Save the token, as there is not existing interface available to recall the token.  \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7d02423-8.png\",\n        \"8.png\",\n        2014,\n        1450,\n        \"#224299\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<div class=\\\"isa_info\\\">\\n  <b>Note</b> Save your token! There is no existing interface to recall the token.\\n</div> \"\n}\n[/block]\n##Step 8\nClick on the **Next** button to declare the role for the programmatic user\n\n##Step 9\nPlease select the **Viewer** role to enable programmatic API access using this account. If you leave it as \"None\", then you will not be able to access metrics via API.  \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/893f21b-9.png\",\n        \"9.png\",\n        1702,\n        1122,\n        \"#333640\"\n      ]\n    }\n  ]\n}\n[/block]\n##Step 10\nNow press save!  \n[block:api-header]\n{\n  \"title\": \"Connecting Flurry Data to the PubNative Dashboard\"\n}\n[/block]\nThis section outlines the method for insterting Flurry's placement data into the PubNative Dashboard.\n\nThere are 4 key pieces of information that we need from your Flurry Dashboard: \n* The API Key \n* The Adspace Name - \"Ad Unit\" in Flurry Dashboard\n* Adspace ID - \"Ad Unit ID\" in Flurry Dashboard\n* API Access Code - \"Programmatic Access Code\" in Flurry Dashboard\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3379f61-flurry.png\",\n        \"flurry.png\",\n        1755,\n        769,\n        \"#dddedb\"\n      ]\n    }\n  ]\n}\n[/block]\nBelow we will instruct you on finding this information.  \n\n##Finding the API Key, Adspace Name, and Adspace ID in Flurry's Dashboard\n1. Once logged into Flurry's dashboard, click on the **App Publishing** icon in the main header at the top of the page\n2. Now, click on **Applications & Ad Units** in the left most column\n3. Click on the Application for which you wish to insert a placement\n4. Note the boxed items in the image below-- API Key, Adspace ID, and Adspace name.  Make a note of this information or take a screenshot.  It will be used to make your placement in the PubNative Dashboard.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/8b751ff-11.PNG\",\n        \"11.PNG\",\n        1406,\n        484,\n        \"#f0f1f1\"\n      ]\n    }\n  ]\n}\n[/block]\n##Reminder on the API Access Code\nYou should have made a note of your Programmatic Access Code in Step 9 of [Setting Up Flurry's Reporting API](http://developers.pubnative.net/v3.0/docs/flurry-setup-guide#setting-up-flurrys-reporting-api).  This is the **API Access Code** used to set up your placement in PubNative's Dashboard.\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":"flurry-setup-guide","type":"basic","title":"Flurry Setup Guide"}

Flurry Setup Guide


Welcome to PubNative's guite to accessing ads created by Yahoo Flurry on your application. Below, we will guide you through setting up ad placements on the Flurry dashboard and connecting Flurry'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 Flurry SDK * [Flurry SDK Integration Guide for Android](https://developer.yahoo.com/flurry/docs/integrateflurry/android/) [block:api-header] { "title": "Building Ad Units with Flurry" } [/block] ##Step 1 Log in to the Flurry portal at https://login.flurry.com/ ##Step 2 Navigate to the App Publishing tab ##Step 3 Select Applications & Ad Units from the left-hand navigation menu ##Step 4 Click the **+ Ad Unit** button [block:image] { "images": [ { "image": [ "https://files.readme.io/0c07479-1.png", "1.png", 620, 238, "#e1f0f8" ] } ] } [/block] ##Step 5 Enter an Ad Unit name, select the application in which the ad unit will appear and select the **Type** as standard ##Step 6 Select the **Stream** Placement Type [block:image] { "images": [ { "image": [ "https://files.readme.io/50a2e9a-2.png", "2.png", 947, 631, "#21349d" ] } ] } [/block] ##Step 7 Select the Native Ad Details that best match the format of the native ads that you want in your app: * Basic ads include headline, summary, and branding logo * Card ads include a headline, summary, and a branding logo overlaid on a high quality image * Detailed Card ads include a headline, summary, and a branding logo adjacent to a high quality image [block:image] { "images": [ { "image": [ "https://files.readme.io/d7c1a57-3.png", "3.png", 646, 369, "#ebeded" ] } ] } [/block] ##Step 8 Now save your ad unit! Ensure that you have a green success banner at the top of this page, indicating that your ad unit has been sucessfully saved. [block:api-header] { "title": "Setting up Flurry's Reporting API" } [/block] In order to view Flurry data on PubNative's unified reporting solution, you first need to obtain your Flurry API access token. This token grants the authorization to pull the data for that company. Please follow the steps below to obtain your token. ##Step 1 Log into y.flurry.com. [block:html] { "html": "<div class=\"isa_info\">\n <b>Note</b> You must be the administrator of your account in order to access the Reporting API. If this is a new account or you are the only user, you can set yourself up as the administrator; if not, the administrator must perform the following steps.\n</div> " } [/block] ##Step 2 Select **Admin** form the Top navigation bar ##Step 3 Select the **Users** option under the **Manage** column to the left ##Step 4 Click the **Programmatic User** option [block:image] { "images": [ { "image": [ "https://files.readme.io/acd359c-4.png", "4.png", 1358, 352, "#1f2995" ] } ] } [/block] ##Step 5 Login with your Flurry account credentials (email address / password). Again, you must be the account administrator to complete the following steps. [block:image] { "images": [ { "image": [ "https://files.readme.io/0a39d24-5.png", "5.png", 2022, 1194, "#1b3ea4" ] } ] } [/block] ##Step 6 Enter the email address that will be tied with the programmatic token and the name of the account (for instance “Programmatic Token”). This email address has to be unique i.e. not associated with the Flurry account that you or your company has. For instance, you can enter FlurryProgrammaticUser@yourCompany.com [block:image] { "images": [ { "image": [ "https://files.readme.io/2a34d1b-6.png", "6.png", 2026, 1268, "#1e409f" ] } ] } [/block] ##Step 7 Receive the token code to access the API. Save the token, as there is not existing interface available to recall the token. [block:image] { "images": [ { "image": [ "https://files.readme.io/7d02423-8.png", "8.png", 2014, 1450, "#224299" ] } ] } [/block] [block:html] { "html": "<div class=\"isa_info\">\n <b>Note</b> Save your token! There is no existing interface to recall the token.\n</div> " } [/block] ##Step 8 Click on the **Next** button to declare the role for the programmatic user ##Step 9 Please select the **Viewer** role to enable programmatic API access using this account. If you leave it as "None", then you will not be able to access metrics via API. [block:image] { "images": [ { "image": [ "https://files.readme.io/893f21b-9.png", "9.png", 1702, 1122, "#333640" ] } ] } [/block] ##Step 10 Now press save! [block:api-header] { "title": "Connecting Flurry Data to the PubNative Dashboard" } [/block] This section outlines the method for insterting Flurry's placement data into the PubNative Dashboard. There are 4 key pieces of information that we need from your Flurry Dashboard: * The API Key * The Adspace Name - "Ad Unit" in Flurry Dashboard * Adspace ID - "Ad Unit ID" in Flurry Dashboard * API Access Code - "Programmatic Access Code" in Flurry Dashboard [block:image] { "images": [ { "image": [ "https://files.readme.io/3379f61-flurry.png", "flurry.png", 1755, 769, "#dddedb" ] } ] } [/block] Below we will instruct you on finding this information. ##Finding the API Key, Adspace Name, and Adspace ID in Flurry's Dashboard 1. Once logged into Flurry's dashboard, click on the **App Publishing** icon in the main header at the top of the page 2. Now, click on **Applications & Ad Units** in the left most column 3. Click on the Application for which you wish to insert a placement 4. Note the boxed items in the image below-- API Key, Adspace ID, and Adspace name. Make a note of this information or take a screenshot. It will be used to make your placement in the PubNative Dashboard. [block:image] { "images": [ { "image": [ "https://files.readme.io/8b751ff-11.PNG", "11.PNG", 1406, 484, "#f0f1f1" ] } ] } [/block] ##Reminder on the API Access Code You should have made a note of your Programmatic Access Code in Step 9 of [Setting Up Flurry's Reporting API](http://developers.pubnative.net/v3.0/docs/flurry-setup-guide#setting-up-flurrys-reporting-api). This is the **API Access Code** used to set up your placement in PubNative's Dashboard. [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]