Using the Partner Portal test app

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

  1. Open the Google Play Store.
  2. 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

  1. Open the Apple App Store.
  2. 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:

  1. On the Partner Portal, select Create QR Code in the bid response validator.
  2. 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.
  3. On the PSP Test app, select Scan QR.
  4. 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:

ErrorDescription
AD_BLOCKER_DETECTEDAn error occurred due to an ad blocker.
DEVICE_ID_ERRORAn error occurred due to a bad device identifier.
FILE_IO_ERRORAn error occurred due to inability to read or write a file.
INIT_SANITY_CHECK_FAILInitialization of the Unity Ads service failed due to an invalid environment.
INITIALIZE_FAILEDAn error occurred in the initialization process.
INTERNAL_ERRORAn internal Unity Ads service error occurred.
INVALID_ARGUMENTUnity Ads initialization failed due to invalid parameters.
NOT_INITIALIZEDThe Unity Ads service is not initialized.
SHOW_ERRORAn error occurred when attempting to show an ad.
VIDEO_PLAYER_ERRORAn error occurred due to the video player failing.

Help

For more information, questions, or concerns with this tool, email customer support.

Unity logo Documentation
Copyright © 2024 Unity Technologies
"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.