Integrate Zucks with mediation
Stay organized with collections
Save and categorize content based on your preferences.
This guide is intended for publishers who are interested in using Google
Mobile Ads mediation with Zucks. It walks
through the setup of a mediation adapter to work with your current Android app
and the configuration of additional settings.
Prerequisites
Helpful primers
The following Help Center articles provide background information on mediation:
Add Zucks to your project
Include network adapter and SDK
Download the Zucks SDK and adapter from the
previous links.
In Android Studio, include the adapter and SDK files in your project's libs
folder. Make sure that your app-level Gradle file includes the following:
Kotlin
dependencies {
implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.aar", "*.jar"))))
// ...
}
Groovy
dependencies {
implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'])
// ...
}
Modify your AndroidManifest.xml
file as instructed in the
Zucks documentation.
Your app doesn't need to call Zucks
directly—Google Mobile Ads SDK calls the
Zucks adapter to fetch ads on your behalf. If necessary, you can
specify any additional request parameters.
The rest of this page details how to provide more information to
Zucks.
Initialize your ad object with an Activity instance
In the constructor for a new ad object (for example,
AdView
),
you must pass in an object of type
Context
.
This Context
is passed on to other ad networks when using mediation. Some
ad networks require a more restrictive Context
that is of type
Activity
and may not be able to serve ads without an Activity
instance. Therefore,
we recommend passing in an Activity
instance when initializing ad objects
to ensure a consistent experience with your mediated ad networks.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-29 UTC.
[null,null,["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThe Mediation Test Suite allows you to test whether your mediation setup is configured correctly before going live to ensure ad requests and revenue are flowing as expected.\u003c/p\u003e\n"],["\u003cp\u003eBy integrating the Mediation Test Suite into your app, you gain access to detailed, real-time insights into the ad mediation waterfall to troubleshoot setup problems quickly.\u003c/p\u003e\n"],["\u003cp\u003eThe suite offers comprehensive functionalities such as manual ad requests for testing specific scenarios, a visual ad request waterfall, and adapter status reports to monitor adapter configuration.\u003c/p\u003e\n"],["\u003cp\u003eIt enables you to manage and organize multiple ad units and ad sources within the test suite, including line item details and other properties for each ad source.\u003c/p\u003e\n"],["\u003cp\u003eThis ensures a seamless and optimized ad mediation experience, leading to higher fill rates, increased ad revenue, and improved app performance.\u003c/p\u003e\n"]]],["Publishers using Google Mobile Ads mediation with Zucks should integrate the Zucks SDK and adapter into their Android app via Android Studio's `libs` folder and update their app-level Gradle file. They must also configure the `AndroidManifest.xml` according to Zucks' documentation. An `Activity` instance should be passed when initializing ad objects for mediated ad networks. The Google Mobile Ads SDK handles fetching ads via the Zucks adapter, without direct calls from the app.\n"],null,["# Integrate Zucks with mediation\n\nThis guide is intended for publishers who are interested in using Google\nMobile Ads mediation with **Zucks**. It walks\nthrough the setup of a mediation adapter to work with your current Android app\nand the configuration of additional settings.\n\n| Zucks Resources |\n|---------------------------------------------------------------------------------|\n| [Documentation](http://ms.zucksadnetwork.com/media/sdk/manual/admob-mediation/) |\n| [SDK](http://ms.zucksadnetwork.com/media/sdk/manual/android/) |\n| [Adapter](http://ms.zucksadnetwork.com/media/sdk/manual/admob-mediation/) |\n| [Customer support](mailto:support@zucksadnetwork.com) |\n\nPrerequisites\n-------------\n\n- An Android app with\n\n Google Mobile Ads SDK\n\n integrated. (If you don't\n have one, see [Get Started](/admob/android/quick-start).)\n\n- An AdMob account and [an ad unit configured with mediation line\n items](//support.google.com/admob/answer/3124703).\n\nHelpful primers\n---------------\n\nThe following Help Center articles provide background information on mediation:\n\n- [About AdMob Mediation](//support.google.com/admob/answer/3063564)\n- [Set up AdMob Mediation](//support.google.com/admob/answer/3124703)\n- [Optimize AdMob Network](//support.google.com/admob/answer/3534471)\n\nAdd Zucks to your project\n-------------------------\n\n### Include network adapter and SDK\n\nDownload the Zucks SDK and adapter from the\n[previous links](#resources).\n\nIn Android Studio, include the adapter and SDK files in your project's `libs`\nfolder. Make sure that your app-level Gradle file includes the following: \n\n### Kotlin\n\n dependencies {\n implementation(fileTree(mapOf(\"dir\" to \"libs\", \"include\" to listOf(\"\\*.aar\", \"\\*.jar\"))))\n // ...\n }\n\n### Groovy\n\n dependencies {\n implementation fileTree(dir: 'libs', include: \\['\\*.aar', '\\*.jar'\\])\n // ...\n }\n\n### Configure the AndroidManifest.xml file\n\nModify your `AndroidManifest.xml` file as instructed in the\nZucks documentation.\n\nYour app doesn't need to call Zucks\ndirectly---\n\nGoogle Mobile Ads SDK\n\ncalls the\nZucks adapter to fetch ads on your behalf. If necessary, you can\nspecify any additional request parameters.\nThe rest of this page details how to provide more information to\nZucks.\n\n### Initialize your ad object with an Activity instance\n\nIn the constructor for a new ad object (for example,\n\n[`AdView`](/admob/android/reference/com/google/android/gms/ads/AdView)),\n\nyou must pass in an object of type\n[`Context`](//developer.android.com/reference/android/content/Context).\nThis `Context` is passed on to other ad networks when using mediation. Some\nad networks require a more restrictive `Context` that is of type\n[`Activity`](//developer.android.com/reference/android/app/Activity)\nand may not be able to serve ads without an `Activity` instance. Therefore,\nwe recommend passing in an `Activity` instance when initializing ad objects\nto ensure a consistent experience with your mediated ad networks."]]