Testing Creatives with a Bidder

Use these instructions for end-to-end testing of your integration with MoPub Marketplace. By testing end-to-end, you can validate that:

  • your bidder is receiving bid requests from MoPub
  • your bidder is responding to MoPub’s bid requests with a bid response
  • your creative is rendering as expected in the MoPub Sample App
  • your trackers are firing as expected

If you don’t need integration testing and are only looking to validate that your creatives render correctly inside the MoPub SDK, refer to Testing Without a Bidder.

Overview of Testing with a Bidder

For end-to-end testing, you’ll create a MoPub publisher test account with inventory that is only directed to your bidder. Your bidder will receive the bid requests generated from your instance of the MoPub Sample App.

Testing with a bidder involves the following steps:

  1. Create a MoPub publisher test account and set up Marketplace.
  2. Create an app and ad units.
  3. Create an order and line items.
  4. Request to whitelist your bidder.
  5. Download our sample app.
  6. Validate.

The MoPub Sample App

MoPub provides a sample app you can use to discover how a creative behaves across various ad formats. Use our sample app with the understanding that it will be used only for non-revenue-generating, internal testing purposes.

We provide a MoPub Sample App for iOS and a MoPub Sample App for Android, which you can access globally from a browser.

Supported Ad Sizes

The following ad sizes are supported on the MoPub platform:

  • Phone: Banner (320×50), MRect (300×250), Interstitial and Rewarded Video (320×480), and Native (custom defined dimensions)
  • Tablet: Leaderboard (728×90), MRect (300×250), Interstitial and Rewarded Video (1024×768), and Native (custom defined dimensions)

Step 1. Create a MoPub Publisher Test Account and Set Up Marketplace

  1. Create an account at https://app.mopub.com/account/register.

    For compliance reasons, you must complete all payment and tax information on the MoPub account payments page. This is required even for a test account.

    Payment Information

  2. After you’ve entered in all payment and tax information, email your account representative (or mopubDSPsuccess@twitter.com if you don’t have a dedicated representative) with the following subject and information:

    • Subject: Marketplace Approval Request
    • Include: MoPub Publisher UI account email address

    Your account team or a member of our Support Team will respond when your account has been granted Marketplace approval.

Step 2. Create an App and Ad Units

Every app must have a minimum of one ad unit; we provide instructions for you to optionally add more ad units to test different creative formats.

  1. Navigate to the Apps tab and click New App.

  2. Select Add your app manually.

  3. Choose Android or iOS.

  4. Complete the form with the app details.

    • Enter a dummy value for the iTunes URL/package name; for example: https://itunes.apple.com/us/app/fake_app_1234/id433359 or com.fake.MyOwnTestApp.

    • You can set the primary and secondary categories to any value.

    • Make sure to check the COPPA compliance option; leaving it blank generates an error.

  5. Click Save and Create ad unit.

  6. Fill out the information to create an ad unit to use for testing.

  7. Click Save and View Code Integration.

  8. Note the provided ad unit ID; you will need this later.

Step 3. Create an Order and Line Items

Now that you have created an ad unit, create an order with one or more line items to serve a creative to your ad unit. Each ad unit you created in Step 2 should only have a single line item serving to it. This line item should only contain a single creative of a single dimension (such as 320×50) that targets the corresponding ad unit with the same dimensions.

  1. Create a new order by navigating to the Orders tab and clicking Create Order.

  2. Select the settings for your order. Here are some sample settings:

    • Order name: Name it something that describes the type of line-items you are creating (ie: MRAID_certification_iOS only)
    • Advertiser: ‘None’
    • Description: Optional

    Click Save & create line item.

  3. Create a Marketplace line item. Enter the line item settings, using these as examples:

    • Line item name: Name your line item with as much detail as possible as it relates to the platform/tag size you will be serving (for example, MRAID-cert-Android-Phone-320×50).
    • Type: ‘Marketplace Line Item’
    • Priority: ‘1’
    • Budgeting & schedule: Select the Start immediately option and ignore the other options.
  4. Click Next.

  5. Select the ad units you will use to test the line item and click Next.

  6. Ignore Audience targeting settings and click Save.

Step 4. Request to Whitelist Your Bidder

Once you have set up a Marketplace line item, we must configure that line item on our backend to send requests only to your bidder. Email your account representative (or, if you don’t have a dedicated representative, email mopubDSPsuccess@twitter.com) with the following subject and information:

  • Subject: “Whitelist DSP for Publisher Test Account”
  • Include:
    • MoPub Publisher UI account email address
    • MoPub Demand UI bidder or endpoint name
    • Name of the Marketplace line item you will use to perform end-to-end testing

Your account team or a member of our Support Team will respond when your line item has been configured for end-to-end testing in the Marketplace with your bidder endpoint only.

Step 5. Download Our Sample App

Install the MoPub Sample App on your iOS and Android test devices.

iOS Sample App

The iOS sample app hosted on this page will always be integrated with the latest MoPub iOS SDK. When a new SDK is released; you must re-install the latest version from this page. The app will not auto-update on your test device.

  1. Open the MoPub Sample App for iOS on your iOS test device (iPhone or iPad).

  2. Click Install. Once installed, the app appears on your device’s home screen. Open the app.

  3. In the app, click the ! icon in the top left corner of the main screen to display the SDK version with which your sample app is integrated. Confirm that this SDK version matches our most recent version by checking our iOS MoPub SDK release notes.

Android Sample App

The Android app hosted on this page will always be integrated with the latest MoPub Android SDK. When a new SDK is released; the sample app should auto-update via the Google Play store service.

  1. Search the Google Play Store for “mopub” on your Android test device (phone or tablet) and download/install the MoPub Sample App.

  2. Click Install and then open the app once installed.

  3. In the app, check the bottom of the main screen for “SDK Version major.minor.build”. Confirm that this SDK version matches our most recent version by checking our Android MoPub SDK release notes..

Step 6. Validate

Validate that your creatives load and display in the MoPub Sample App.

  1. Retrieve the ad unit ID you wrote down from Step 2. You can also find the ad unit ID in the URL of your ad unit of the MoPub UI, as shown.

    Ad Unit ID URL Location

  2. Open the MoPub Sample App on your test device.

  3. Carefully enter your ad unit into the Ad Unit Id field. To avoid typos, email the ad unit ID to your test device and then copy/paste it into this field.

    iOS Android
    iOS Sample App Screenshot Android Sample App Screenshot
  4. Select the Ad Type (banner, interstitial, etc.) that corresponds to your ad unit. This must match your ad unit’s size configuration in the UI.

  5. Enter a descriptive name under Name (for example, ‘Testing MRAID banner for Nike campaign’). The name does not have to match what is configured in the UI.

  6. Click Save.

  7. Select your new ad unit from the main page, and if it’s an Interstitial or Native ad unit, click Load Ad. This sends a bid request to your endpoint. For all other types of ad units, the bid request will be sent immediately.

  8. Your creative should render. If your bidder is responding to the bid request, a successful test will display your ad in the sample app.


If Your Bidder Fails to Receive Bid Requests

If your bidder is not seeing bid requests from your MoPub Sample App in the open Marketplace:

  • Confirm that your Marketplace line item is enabled and assigned to the ad unit on which you are testing. Editing the Marketplace line item will show you which ad units are assigned.

  • If you see this message in the sample app: Failed to load. Ad Unit is warming up, it means you’re not using a valid Ad Unit ID. Double-check the ad unit ID you created in Step 2.

If You Have Additional Issues

Please email dspsupport@mopub.com or your account representative with the following information:

  • Email subject: DSP/MoPub Sample App End-to-End Test Setup Request
  • MoPub UI account email
  • Link to the specific ad unit you are targeting
  • Link to the specific line item that is serving the ad unit you are testing
  • Full JSON bid response that your bidder is sending, with to your test app bid requests (if applicable)

Last updated May 18, 2020

TWITTER, MOPUB, and the Bird logo are trademarks of Twitter, Inc. or its affiliates. All third party logos and trademarks included are the property of their respective owners.

© 2020 MoPub (a division of Twitter, Inc.)