MoPub Setup Guide

Table of Contents: 1. 2. 3. 4. 5. 6. Account Setup App Setup Client Library Integration Ad Network and Campaign Setup Adding A Creative Testing the Campaign

Version Date: July 12, 2011

1. Account Setup
Go to http://app.mopub.com/account/login/ and create an account. You can use either a Google account or a MoPub account. To create a MoPub Account, click register for a MoPub account. To sign in with your Google account, click the Sign in with Google button.

Fill in all of the relevant information to create an account. You will need to agree to the terms and conditions. Click continue to create the account.

2. App Setup
You will now need to set up your apps in the dashboard (you also follow the same process for Mobile Web ads) i. ii. iii. Select either iOS, Android, or Mobile Web Enter your app name Search for your apps name on iTunes or the Android market. Our system will automatically pull in the app name and icon. that fails, name

You will now need to set up the locations where your want to show an ad. We call these ad units. i. ii. iii. iv. Name your ad unit Give it a description Select whether the format should be for phone or for tablet Select one of the ad sizes below 1. Phone a. 320x50 Banner b. 300x250 Medium c. 320x480 Fullscreen i. Identify if the ad should be in landscape or portrait mode. d. Custom Size 2. Tablet a. 728x90 Leaderboard b. 300x250 Medium c. 160x600 Skyscraper d. 1024x768 Full Screen e. 320x50 Banner f. Custom Size If you want the ad to refresh periodically, set the refresh interval. Otherwise, leave it as is.

v.

Your ad unit is now set up.

3. Client Library Integration

You will now land on the following screen.

Next, integrate the MoPub Client Library (aka MoPub SDK) into your application. The SDK contains all of the files that enable your app to show MoPub Ads. You can download the SDK from Github at https://github.com/mopub/mopubclient

3.1 iOS
In XCode, drag the MoPubSDK folder and the TouchJSON folder into the project directory as shown to the right. Add #import MPAdView.h to the top of your View Controller .h file In the view controller add the MPAdViewDelegate.

In the view controller add the MPAdViewDelegate.

Paste the MPAdView function into ViewDidLoad function in your View Controller

Paste the MPAdViewDelegate Methods into your View Controller .m file

You will now need to import the Storekit framework. i. ii. iii. iv. v. vi. vii. viii. Double click on the XCode project icon on the left. It should open a new window. Click on Build Phases Click on Link Binary With Libraries Click the + button to add a framework Search for StoreKit.framework and double click it It should show up in the files on the left Drag it into the Frameworks Folder

If you want to serve iAds, import the iAd framework. You can do this by following the same process as importing the Storekit framework.

3.2 Android

In Eclipse, copy the files in Android/mopub-androidsdk/src/com/mopub/mobileads into a /src/com/mopub/mobileads directory structure in your project. Your directory should look like the screenshot to the right

Copy the first code snippet from the dashboard into your layout file (e.g.

Add the second code snippet from the dashboard into your Activitys onCreate

Import the MoPubView method from the SDK by typing import com.mopub.mobileads.MoPubView; at the top of the same file as the last code snippet

Compile and test that a default ad shows.

4. Ad Network and Campaign Setup

If you have ad network accounts set up, you may enter your details on the next page. You may skip this step. If you ever want to return to ad more networks, you can click the Your Account button in the upper right hand corner next to the Help button. If the ad network doesnt require a publisher ID, the publisher Id simply acts as a default

You will now be on the campaigns page where you can see your campaigns performance.

Click the Add A Campaign button on the right side to create a new campaign.

You can create three types of campaigns.

Guaranteed These are campaigns that you directly show i. ii. iii. iv. v. vi. Select the Priority level of the campaign a. The priority levels are High, Normal, and Low b. a High priority campaign will always display ahead of other campaigns Give the campaign a name. Provide a description for the campaign. (optional) Select the start and end dates for the campaign (optional) Select the daily delivery amount. Choose to spread the imrpessions evenly throughout the day, or deliver all at once.

Promotional These are promotional / house campaigns that you can set up to promote your own apps i. ii. iii. iv. v. Choose the Priority Level a. Normal: Standard Promotional Campaigns b. Backfill: The ad that will show when no other ads can be displayed. Name the campaign. Give the campaign a description. (Optional) Select the start and end dates of the campaign. (Optional) Set the Rate of the campaign. a. This campaign will show ahead of other promotional campaigns that have a lower CPM.

Network These are campaigns that pull in ads using the network credentials you entered earlier i. ii. iii. iv. v. You must set up a campaign for a specific ad network to display ads from that network! Provide a campaign name Provide a description Select the Network Type (e.g. Admob, iAd, InMobi, etc.) Enter the Network Rate as either a CPC or an eCPM. a. If you set up ad network campaigns with CPCs the MoPub system will automatically optimize by CTR.

Target the campaign to your desired ad unit and click Continue.

5. Adding A Creative (Optional)

You will now be on the campaign page. If you created a Guaranteed or Promotional campaign, you will have the option to add a creative. i. ii. iii. Click Add a creative in on the middle right side of the page. Select the format (ad size) that you want the creative to be. Set the creative type as either Image, Text and Tile, or HTML a. For Image creative, you can upload an image file and input a click through URL to set up the ad. b. Text and Tile allows you to make text ads right in the MoPub interface without any external assets. You must also input a click through URL here. c. HTML allows you to drop in a Javascript or iFrame tag to serve ads from third party providers. If you set up another app to communicate conversions to MoPub, you can enter its App Store ID in the Conversion Tracking ID field to track conversions from this campaign. If you need to conduct third party tracking, the impression tracker can be placed in the Impression Tracking URL field. Click the Save button.

iv. v. vi.

6. Testing Your Campaign

If desired, you can click on the Test Campaigns button in the upper right hand corner of the campaign page to show you what will be displayed. i. ii. iii. iv. v. Select the Ad Unit that you want to test. Select the device that you would like to simulate the ad. Choose the country that youd be testing from. Click Run Again If everything is correct, the ad should show at the bottom of the test screen. You can click it to test the Click Through URL.