Skip to main content
Version: v1.1

Google AdMob

Prerequisites​

  • Android: Google Mobile Ads SDK 20.0.0+, minSdkVersion of 19 or higher, compileSdkVersion of 28 or higher
  • iOS: GoogleMobileAds 9.13+, Xcode 14.1+, iOS 10.0+

1. Import PremiumAds adapters​

Android​

Add the following implementation dependency in the app-level build.gradle file:

// Repos
repositories {
    maven { url "https://repo.premiumads.net/artifactory/mobile-ads-sdk/" }
}


dependencies {
    implementation 'com.google.android.gms:play-services-ads:24.4.0' 
    implementation 'net.premiumads.sdk:admob-adapter:2.2.7'
}

iOS​

CocoaPods (preferred)​

The simplest way to import the PremiumAds Admob adapter into an iOS project is to use CocoaPods. Open your project's Podfile and add this line to your app's target:

pod 'PremiumAdmobAdapter','2.2.6'

Then from the command line run:

pod install --repo-update

Swift Package Manager (SPM)​

  1. Open your project in Xcode.

  2. Go to File → Add Packages…

  3. In the “Search or Enter Package URL” field, enter:

    https://github.com/premium-ads/adapter-ios-spm.git

  4. Set the Dependency Rule to:

    • Up to Next Major Version starting from 2.2.6
      (or select the latest version shown in the list).

  5. Click Add Package.

  6. In “Add to Target”, select the app target(s) where you want to use PremiumAdsAdapter.

  7. Click Add Package to finish.

Xcode will download the binary and link it to your project automatically.


Manual download​

  • Download and unzip the SDK framework directly, and import into your Xcode project
  • Add the -ObjC linker flag to Other Linker Flags in your project's build settings:

Unity​

If you are using Unity platorm for developing the app/game, you can use the unity package to import PremiumAd Admob adapters in your app/game, download here.

Flutter​

Run this command:

flutter pub add premium_ads

This will add a line like this to your package's pubspec.yaml (and run an implicit flutter pub get):

dependencies:
  premium_ads: ^0.2.6
warning

Repository Setup Required: Due to Android Gradle Plugin 7+ limitations with dependencyResolutionManagement, you MUST add the Premium Ads Maven repository to your Flutter app's repository configuration.

⚠️ Critical: The plugin includes the repository in its own build.gradle, but AGP 7+ ignores module-level repositories by default.

In your Flutter app's android/settings.gradle:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        google()
        mavenCentral()
        maven { url "https://repo.premiumads.net/artifactory/mobile-ads-sdk/" }
    }
}

Option 2: Root build.gradle (For older templates)​

In your Flutter app's android/build.gradle:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url "https://repo.premiumads.net/artifactory/mobile-ads-sdk/" }
    }
}

2. Set up PremiumAds Ad Unit in AdMob Mediation​

You need to add PremiumAds ad unit to the AdMob mediation as waterfall ad source

2.1 Add custom event​

2.2 Map ad units​

Class Name​

Use the following class name depending on the ad unit format of the mediation group.

Android

  • Banner: net.premiumads.sdk.admob.PremiumBannerAd
  • Native/Native advanced: net.premiumads.sdk.admob.PremiumNativeAd (Supported from version 2.2.7)
  • Interstitial: net.premiumads.sdk.admob.PremiumInterstitialAd
  • Rewarded/Rewarded Interstitial (Beta) net.premiumads.sdk.admob.PremiumRewardedAd
  • App open: net.premiumads.sdk.admob.PremiumAppOpenAd (Supported from version 2.2.5)

iOS

  • Banner/Interstitial/Rewarded/Native advanced : GADMediationAdapterPremiumAds

Parameter​

  • PremiumAds ad unit id.

2.3 Setup example​

3. GDPR Compliance​

If you are not using any Consent Management Platform to handle privacy issues and managing user consent with your own solution, you have to inform admob mediation and mediation partners about the consent.

AdRequest.Builder builder = new AdRequest.Builder();
Bundle extras = new Bundle();
extras.putString("npa", "1");
builder.addNetworkExtrasBundle(AdMobAdapter.class, extras);
//for banner
builder.addNetworkExtrasBundle(PremiumBannerAd.class,extras);
//for interstitial
builder.addNetworkExtrasBundle(PremiumInterstitialAd.class,extras);
//for rewarded
builder.addNetworkExtrasBundle(PremiumRewardedAd.class,extras);

4. For ProGuard Users Only​

-keepclassmembers class * implements android.os.Parcelable {
    public static final android.os.Parcelable$Creator *;
}
-dontwarn net.premiumads.**
-dontwarn net.premiumads.sdk.**
-keepclassmembers class net.premiumads.** { public *; }
-keep public class net.premiumads.**
-keep class net.premiumads.sdk.** { *;}
-keep class net.premiumads.sdk.admob.** { *;}

5. Tips for using the PremiumAds Admob adapter​

  • Use Ad Inspector (iOS | Android) to check the integration status and load ads from the Premium Ads Adapter.


  • Enable verbose logging if you need to view more information or debug issues with our SDK.
import net.premiumads.sdk.PremiumAdSDK;

...
PremiumAdSDK.setDebug(true);

  • Filter the Logcat with TAG PremiumAds Adapter

  • Enable test ads for your ads integration. It's recommended that you enable test ads during development so you can test clickthrough behavior without affecting your reservation campaigns' stats or charging advertisers on PremiumAds Exchange, see Test Ads.

6. Video tutorials​

Embedded HTML (interactive content rendered on the legacy site)

<iframe width="800" height="450" src="https://www.youtube.com/embed/JeiB3sSw6aw" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>