Migrate to ad inspector

Mediation Test Suite is deprecated in favor of ad inspector and is to be sunsetted on September 30, 2023. Documentation will be removed then also.

You should update your app to use ad inspector to perform real-time ad testing. This guide outlines the steps to migrate to ad inspector and the feature comparisons between these tools.

How to migrate

Remove Mediation Test Suite

​​With the Mediation Test Suite being sunset, we strongly recommend removing its artifacts from your project.

Remove the mediation-test-suite artifact from your app-level build.gradle file:

repositories {
    google()
    mavenCentral()
}

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:22.4.0'
    # Remove this line.
    implementation 'com.google.android.ads:mediation-test-suite:3.0.0'
}
...

Update programmatic code for ad inspector

Replace the code that launches Mediation Test Suite with the equivalent for ad inspector:

Ad inspector

Java

// Launch ad inspector programmatically.
MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

// Launch ad inspector programmatically.
        MobileAds.openAdInspector(context) {
            // Error will be non-null if ad inspector closed due to an error.
        }

Mediation Test Suite

Java

// Remove this line.
MediationTestSuite.launch(MainActivity.this);

Kotlin

// Remove this line.
MediationTestSuite.launch(this)

Start using ad inspector

That’s it! Your app is now integrated with ad inspector. Follow the steps in ad inspector documentation to perform real-time analysis of test ad requests in your app.

Why migrate to ad inspector

The table below compares the features between ad inspector and Mediation Test Suite.

Feature Ad inspector Mediation Test Suite
Supported Google Mobile Ads SDK versions 20.0.0 or higher 9.8.0 - 21.5.0
Third-party and custom event adapters troubleshooting
List all adapters associated with the ad sources in mediation configurations
Verify if adapters and 3p SDKs can be found
View adapter initialization statuses
View adapter initialization latencies
Show adapter versions
Show third-party SDK versions 1
Ad units troubleshooting
List all ad units with their IDs and formats
Show the names configured in AdMob UI for the ad units 1
Search ad unit by ID
Ad testing
Load app open ads
Load banner ads
Load interstitial ads
Load rewarded video ads
Load rewarded interstitial ads
Load native ads
show test ads within the tool
Perform single bidding or waterfall mediation ad source testing
Support newly added waterfall or bidding mediation partner without requiring a new Google Mobile Ads SDK version
Restrict ad requests to only serve ads from Google ad source
Ad requests troubleshooting
View ad request log
Export full ad request
Visualize waterfall mediation chain
Visualize bidding auction
Inspect third-party bidding parameters
Batch test multiple ad sources
Miscellaneous
Launch programmatically using provided APIs
Launch using gestures
No additional code required

1 Will be supported in future versions.