Using the Partner Portal test app

Use the Test App feature in the Unity Exchange Partner Portal to preview and validate ad creatives in a controlled environment.

Read time 2 minutes

Last updated 3 days ago

The Unity Ads Partner Portal test app lets you to render the creative markup from your validated OpenRTB response through Unity's auction in order to test creative rendering and your tracking URLs.

Installing the app

Follow these instructions to install the Partner Portal Test app depending on your targeted platform.

Android

Open the Google Play Store.
Search "Ad Testing for Unity Ads", and install the app.

Alternatively, open the Ad Testing for Unity Ads Play Store app link from your mobile device to access and install the app directly.

iOS

Open the Apple App Store.
Search "Ad Testing for Unity Ads", and install the app.

Alternatively, open the Ad Testing for Unity Ads App Store app link from your mobile device to access it directly.

Viewing creatives from a bid response

To render creatives from a bid response, you will first need to visit the Partner Portal on your computer and successfully validate a response. When the response is validated:

On the Partner Portal, select Create QR Code in the bid response validator.
Select the appropriate creative format, and whether you want it to be rendered as a rewarded ad, then select Next to generate the QR code. Note that each QR code you generate is unique and cannot be scanned multiple times.
On the PSP Test app, select Scan QR.
If needed, grant the app permission to use the device camera, then scan the QR code you generated in the Partner Portal.

The app's response might take a moment while the SDK initializes, simulates the auction, receives the response, and caches the creative. Unity generates a robust debug log of these transactions, and activates the Show Ad button if the test succeeded. Select this button to view the creative as it would appear in the ad space.

Note

If you consistently get "No Fill" results for MRAID creatives, try generating a QR code with the HTML Interstitial or JS Interstitial type instead.

Also note that banner creatives will appear on the screen without prompting you to select Show Ad. This is because Unity Ads SDK does not cache banner ads. Selecting Show Ad loads banner ads as opposed to other creative types, which are cached instead.

Error logging

When you scan a QR code with the PSP Test app, the Unity Ads SDK initializes, simulates the auction, and returns a robust debug log. The following errors might occur from the SDK side:

Error	Description
`AD_BLOCKER_DETECTED`	An error occurred due to an ad blocker.
`DEVICE_ID_ERROR`	An error occurred due to a bad device identifier.
`FILE_IO_ERROR`	An error occurred due to inability to read or write a file.
`INIT_SANITY_CHECK_FAIL`	Initialization of the Unity Ads service failed due to an invalid environment.
`INITIALIZE_FAILED`	An error occurred in the initialization process.
`INTERNAL_ERROR`	An internal Unity Ads service error occurred.
`INVALID_ARGUMENT`	Unity Ads initialization failed due to invalid parameters.
`NOT_INITIALIZED`	The Unity Ads service is not initialized.
`SHOW_ERROR`	An error occurred when attempting to show an ad.
`VIDEO_PLAYER_ERROR`	An error occurred due to the video player failing.

Documentation

Development

User Acquisition

Monetization

Industry

Documentation

Development

User Acquisition

Monetization

Industry

Grow

Unity Ads Android SDK

Unity Ads iOS SDK

LevelPlay SDK