mopub start guide 2011.07.18.v1

Table of Contents:

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

MoPub Setup Guide

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. Select either iOS, Android, or Mobile Web ii. Enter your app name iii. Search for your appʼs 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. Name your ad unit ii. Give it a description iii. Select whether the format should be for phone or for tablet iv. 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

v. If you want the ad to refresh periodically, set the refresh interval. Otherwise, leave it as is.

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/mopub-client

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. Double click on the XCode project icon on the left.

ii. It should open a new window. iii. Click on Build Phases iv. Click on Link Binary With

Libraries v. Click the + button to add a

framework vi. Search for StoreKit.framework

and double click it vii. It should show up in the files on

the left viii. 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-android-sdk/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 Activity’s 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 doesn’t require a publisher ID, the publisher Id simply acts as a default

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

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

You can create three types of campaigns.

Guaranteed

These are campaigns that you directly show

i. 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

ii. Give the campaign a name. iii. Provide a description for the campaign. (optional) iv. Select the start and end dates for the campaign (optional) v. Select the daily delivery amount. vi. 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. Choose the Priority Level a. Normal: Standard Promotional Campaigns b. Backfill: The ad that will show when no other ads can be displayed.

ii. Name the campaign. iii. Give the campaign a description. (Optional) iv. Select the start and end dates of the campaign. (Optional) v. 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. You must set up a campaign for a specific ad network to display ads from that network!

ii. Provide a campaign name iii. Provide a description iv. Select the Network Type (e.g. Admob, iAd, InMobi, etc.) v. 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. Click “Add a creative” in on the middle right side of the page. ii. Select the format (ad size) that you want the creative to be. iii. 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.

iv. 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.

v. If you need to conduct third party tracking, the impression tracker can be placed in the “Impression Tracking URL” field.

vi. Click the “Save” button.

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. Select the Ad Unit that you want to test. ii. Select the device that you would like to simulate the ad. iii. Choose the country that you’d be testing from. iv. Click “Run Again” v. 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.