Integrate Ad Quality SDK

Ad Quality helps you monitor and control the ad content your users see, so you can ensure it aligns with your app’s goals and enhances user experience. Maximize your revenue potential while serving relevant ads that engage your audience.

Before you start Follow our step-by-step guide and configure your application in the LevelPlay platform

Note: Starting with version 8.9.0, Ad Quality is integrated into the LevelPlay SDK and automatically initialized when LevelPlay is implemented. The steps outlined below apply if LevelPlay is not implemented in the build or if you are using a LevelPlay SDK version earlier than 8.9.0.

Step 1: Import the Ad Quality SDK to your app

Step 2: Initialize the SDK

  1. Initialize the Ad Quality SDK using your ironSource app key, which can be found in the Unity LevelPlay Platform.
  2. Add the following code to your app’s main thread, or on the same thread as your other ad network SDKs to initialize the Ad Quality SDK:

Step 3 (optional): Advanced SDK Initialization

Note: To use the configuration below – initialize Ad Quality SDK before initializing LevelPlay SDK.

Customize your integration settings to get even more functionality with these special configurations:

  1. User ID – Use your own user IDs, instead of the default IDs from Ad Quality
  2. Test mode – Test your Ad Quality SDK integration (default is false)
  3. Log level – Choose a log level to debug code issues (default is INFO)

Use the code below to create your config object with a builder.

User ID

The Ad Quality SDK provides two options for configuring your user IDs:

1.Use your own user IDs, and add them before or during initialization:

2.Change the default user IDs after initializing the Ad Quality SDK, for cases for your ID’s are set later.

Test Mode

Log level

Step 4 (optional): Configure SDK callback events

Note: If you’re using LevelPlay make sure you’ve init Ad Quality first to use the following functionalities 

Note:   The time it takes s to initialize the Ad Quality SDK depends on the number of ad network SDKs integrated into your app. Network connectivity issues may also cause delays. On average, initializations take between 3 – 4 seconds.

Step 5 (optional): Report impression-level ad revenue to Ad Quality SDK

Note: If you’re using LevelPlay make sure you’ve init Ad Quality first to use the following functionalities 

Note:  The feature is support for fullscreen ads only. For LevelPlay, MAX and DT FairBid this data is being collected automatically

Ad Quality SDK 7.2.0+ supports impression-level ad revenue report:

To report Impression-level ad revenue in the Ad Quality SDK, add the code snippet below to your SDK integration.

Important! sendCustomMediationRevenue method should be called when the ad displayed, calling it out of ad lifecycle have no affect 

If you’re using AdMob mediation, follow these steps:

  1. Ask your AdMob account manager to enable AdMob impression-level LTV (iLTV)
  2. Verify that you use GMA SDK 8.12.0 or higher for Android or iOS and that the version supports iLTV
  3. Add the following code snippet to your Ad Quality SDK integration: