Marketplace Demand Test App

Introduction

Fyber has created a self-serve test tool allowing DSP partners to test their integration and creatives on Fyber Marketplace. The goal of the test tool is to ensure partners can do the following:

  • Validate that their creatives render at a high quality on Fyber’s SDK; and
  • Gain transparency on Fyber’s SDK components and behaviors like the close button, video skip button, countdown timer, video skippability standards, close button delays.

Fyber’s self-serve test tool allows our partners to:

  • Download Fyber’s test Apps onto the DSP’s test devices
  • Test creatives before launching a new integration or creative format
  • Validate that an integration is working properly
  • Generate bid requests for specific test device(s)
  • Test ad rendering after going through the bid request/response lifecycle
  • Directly upload creatives and test how they render on Fyber’s SDK
  • Report issues directly to Fyber’s support team from the test app

The following ad formats are available for testing include:

  • Banners
  • Medium Rectangles (300x250)
  • Interstitial Display
  • Playables
  • Interstitial Video (VAST + VPAID)
  • Rewarded Video and Playables 

Criteria

To use Fyber’s self-serve test tool, a demand partner must either be currently integrating or have a live OpenRTB integration with Fyber Marketplace.

Note

DSPs who are actively integrating, but not yet live are only able to access the Creative Tester Tool. Once your OpenRTB integration is live, the ‘Ad Lifecycle’ tool becomes available.

Getting Started

  1. To obtain login credentials, contact your Account Manager
    A single login can be shared across all team members. Specify if multiple user logins are required
  2. Login to the web tool with your user credentials
  3. Download Fyber’s latest iOS and Android Test Apps to your own test devices
    You may download Fyber’s test SDKs on as many test devices as you would like
  4. Each time a new SDK goes live into production, by following our iOS and Android changelog pages, you receive an automatic notification, by email, of updates.

8625b94-Screen_Shot_2020-08-25_at_12.56.21.png

  1. The SDK version can be referenced within the demand test app description.

How to Test

  1. For live integrations, Fyber recommends that the DSP begins by testing their integration. Fyber recommends testing the following components:
  • Bid request parameters, including custom extensions. Fyber’s OpenRTB specification may be found here.
  • Win notification, billing notification and impression trackers
  • Click trackers
  • VAST quartile tracking
  • Attribution trackers

After the DSP confirms everything in their integration setup works as expected, it is recommended that the DSP validates that their live creatives render, as expected.

  1. For new creatives, Fyber recommends that the DSP test and pay special attention to components such as:
  • Clickability
  • Viewability
  • Event tracking
  • Resizing and centering
  • Load time performance
  • Webview margins
  • MRAID actions
  • VAST waterfall for mediafiles and companion ads

Ad Lifecycle

To test your integration end-to-end using Ad Lifecycle feature:

  1. Select Ad Lifecycle from the left menu
  2. Use your bidder to set up a test campaign that targets your test device ID(s) and append the creatives that you want to test. You may test all ad formats.
  3. Open the test app on your test device
  • Android - Tap the Scan QR Code button and scan the QR code on the web tools page under Ad Lifecycle
  • iOS - Tap Settings and then on QR code icon & scan the QR code on the web tools page under Ad Lifecycle
  1. To load an ad and view the ad rendering on Fyber’s SDK, within the test app on your device:
  • Android - Click load and wait for loading to finish (a message will appear and the show button will flash) and then click show.
  • iOS - Click load ad, then click show ad
  • The act of loading the ad within the test app initiates a bid request to your bidder’s production end point. There will be no other bidders in this auction in this instance. This setting only applies to the Ad Lifecycle component.
  1. To see full screen video and display ads (including playables), use the Interstitial setting
  2. To see banner ads, use the banner setting
  3. Fyber allows DSPs to live debug creatives on the test app using a webview tool,
  • Android - You may use chrome developer tools and open the “Remote devices” view
  • iOS - You may use the Safari debugger
  1. To Report Ads that do not work as expected,
  • Android - Tap the 'Report Ad' button, which opens your default email app. Click send email within the email app. A .txt file is attached containing all the necessary log data needed for debugging
  • iOS - Shake the device while an ad is showing to trigger an automated email to the support team

Creative Tester

The creative tester allows you to directly upload and test ad markups in a sandbox environment.

To test sandboxed creatives using the Creative Tester:

  1. Click +Create
  2. Add a description
  3. Upload your ad markup*
  • Accepted ad markup formats include:
    • HTML documents – the markup content is extracted from the body element and used as the adm upon saving
    • VAST XML
    • A complete OpenRTB bid response – the adm content is extracted automatically

Note

Copying the “adm” value from a bid json is not supported, instead simply paste the complete bid response json and the tool will parse the relevant “adm” field

  1. Click Save
  2. Open the test app on your test device
  • Android - Tap the Scan QR Code button
  • iOS - Tap Settings and then the QR code icon
  1. Find your relevant creative in the web tools page
  2. Click Expand to view the relevant QR code for your ad markup
  3. Scan the QR code
  4. To load an ad and view the ad rendering on Fyber’s SDK, within the test app on your device:
  • Android - Click load and wait for loading to finish (a message will appear and the load button will flash) and then click show.
  • iOS - Click load ad, then click show ad
  1. To see full screen video and display ads (including playables), use the Interstitial setting
  2. To see banner ads, use the banner setting
  3. Fyber allows DSPs to live debug creatives on the test app using a webview tool,
  • Android - You may use chrome developer tools and open the “Remote devices” view
  • iOS - You may use the Safari debugger
  1. You may Edit an existing ad markup once it is saved. Once saved, the new ad markup is immediately available for testing
  2. To Report Ads that do not work as expected,
  • Android - Tap the Report Ad button, which opens your default email app. Click send email within the email app. A .txt file is attached containing all the necessary log data needed for debugging.
  • iOS - Shake the device while an ad is showing to trigger an automated email to the support team

App Links

In this window, you can download our latest test applications, containing the relevant Fyber Marketplace SDK version.

iOS Test Application Walkthrough

  1. Download and install the IPA file from the download link page
  2. Make sure to mark Fyber GmbH as a trusted source in the device’s settings

  1. Open the test application and select Settings to set up a new ad

  1. To populate the ‘Settings’ fields, tap the QR Button in the upper left corner and scan a QR code from the web tool

  1. After scanning, click Done button in the upper right corner
  2. From the menu screen, choose the appropriate ad unit type you would like to test
  3. Tap load to load an ad
  • For banners, upon receiving a fill the banner is automatically shown
  • For Interstitials, click the show button upon receiving a fill
  1. When viewing the ad, shaking the device initiates an automatic report which is sent to our engineering team, should debugging be required.

Android Test Application Walkthrough

  1. Install the APK from the download link page (see above)
  2. Choose the desired ad unit type you want to test

  1. Tap the QR Button in the upper left and scan a QR code from the web tool
  2. Tap the relevant “load” button
  • Banners - the banner is automatically shown upon receiving a fill
  • Interstitial - After successfully receiving a fill, the “show interstitial” button flashes and you can show the ad
  1. At any given time after loading an ad, the possibility of reporting the ad appears.