AMDevIT.Admob.Wrapper 0.1.0-preview.1

AMDev.IT AdMob Wrapper

A modern, lightweight AdMob wrapper for .NET 10 Android, .NET 10 iOS, and .NET MAUI, designed to solve the lack of working AdMob bindings in the current .NET ecosystem.

The library wraps the native Android and iOS SDKs in bindable Kotlin and Swift layers and exposes them to .NET with both callback and async/await APIs.

Packages

Package	Description	NuGet	Downloads
AMDevIT.Admob.Wrapper.Droid	.NET binding for the native Kotlin AAR
AMDevIT.Admob.Wrapper.iOSNative	.NET binding for the native Swift xcframework
AMDevIT.Admob.Wrapper	Multi-platform wrapper with async/await extensions
AMDevIT.Admob.Wrapper.MAUICross	MAUI controls, handlers, and full-screen services

Requirements

• .NET 10
• Android API 33+ (Android 13)
• iOS 15.0+
• Mac Catalyst 15.0+ or Windows 10 version 1809+ for the MAUI fallback UI

Xamarin.GooglePlayServices.Ads 125.2.0 is brought in transitively by the Android binding package.

Installation

Android project

<PackageReference Include="AMDevIT.Admob.Wrapper.Droid" Version="0.1.0-preview.1" />

iOS project

<PackageReference Include="AMDevIT.Admob.Wrapper.iOSNative" Version="0.1.0-preview.1" />

Android or iOS project with async/await support

<PackageReference Include="AMDevIT.Admob.Wrapper" Version="0.1.0-preview.1" />

MAUI project with async/await support and XAML controls

<PackageReference Include="AMDevIT.Admob.Wrapper.MAUICross" Version="0.1.0-preview.1" />

Add AMDevIT.Admob.Wrapper as well only when the application uses the lower-level native async/await extension methods.

AndroidManifest.xml

Add your AdMob App ID inside the <application> tag:

<application ...>
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY" />
</application>

Info.plist (iOS)

Add your AdMob App ID:

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY</string>

For testing, use the official Google test App ID: ca-app-pub-3940256099942544~3347511713

Ad formats supported

Usage — Android

Initialization

Callback style

AdMobManager.Instance.Initialize(this, new MyInitListener());

private class MyInitListener : Java.Lang.Object, IOnInitializedListener
{
    public void OnInitialized()
    {
        // SDK ready, load ads
    }

    public void OnInitializationFailed(string error)
    {
        Console.WriteLine($"AdMob init failed: {error}");
    }
}

Async style

await AdMobManager.Instance.InitializeAsync(this);

Banner Ad

Callback style

var bannerWrapper = new BannerAdWrapper(this);
var adView = bannerWrapper.Load(
    adUnitId: "ca-app-pub-3940256099942544/6300978111",
    loadListener: new MyBannerLoadListener()
);
bannerContainer.AddView(adView);

private class MyBannerLoadListener : Java.Lang.Object, IOnAdLoadedListener
{
    public void OnAdLoaded() => Console.WriteLine("Banner loaded");
    public void OnAdFailedToLoad(int errorCode, string errorMessage) =>
        Console.WriteLine($"Banner failed: [{errorCode}] {errorMessage}");
}

Async style

var bannerWrapper = new BannerAdWrapper(this);
var adView = await bannerWrapper.LoadAsync("ca-app-pub-3940256099942544/6300978111");
bannerContainer.AddView(adView);

Interstitial Ad

Callback style

var interstitialWrapper = new InterstitialAdWrapper(this);
interstitialWrapper.Load(
    adUnitId: "ca-app-pub-3940256099942544/1033173712",
    loadListener: new MyLoadListener(),
    eventListener: new MyEventListener()
);

if (interstitialWrapper.IsLoaded())
    interstitialWrapper.Show(this);

private class MyLoadListener : Java.Lang.Object, IOnAdLoadedListener
{
    public void OnAdLoaded() => Console.WriteLine("Interstitial loaded");
    public void OnAdFailedToLoad(int errorCode, string errorMessage) =>
        Console.WriteLine($"Interstitial failed: [{errorCode}] {errorMessage}");
}

private class MyEventListener : Java.Lang.Object, IOnAdEventListener
{
    public void OnAdShown()      => Console.WriteLine("Interstitial shown");
    public void OnAdDismissed()  => Console.WriteLine("Interstitial dismissed");
    public void OnAdClicked()    => Console.WriteLine("Interstitial clicked");
    public void OnAdImpression() => Console.WriteLine("Interstitial impression");
    public void OnAdFailedToShow(int errorCode, string errorMessage) =>
        Console.WriteLine($"Interstitial show failed: [{errorCode}] {errorMessage}");
}

Async style

var interstitialWrapper = new InterstitialAdWrapper(this);
await interstitialWrapper.LoadAsync("ca-app-pub-3940256099942544/1033173712");
interstitialWrapper.Show(this);

Note: Interstitial ads are one-shot. Once dismissed, you need to call Load again before showing. This is by design — it gives you full control over which Ad Unit ID to use on the next load.

Rewarded Ad

Callback style

var rewardedWrapper = new RewardedAdWrapper(this);
rewardedWrapper.Load(
    adUnitId: "ca-app-pub-3940256099942544/5224354917",
    loadListener: new MyLoadListener()
);

if (rewardedWrapper.IsLoaded())
    rewardedWrapper.Show(this, new MyRewardListener());

private class MyRewardListener : Java.Lang.Object, IOnRewardEarnedListener
{
    public void OnRewardEarned(string type, int amount) =>
        Console.WriteLine($"Reward earned: {amount} {type}");
}

Async style

var rewardedWrapper = new RewardedAdWrapper(this);
await rewardedWrapper.LoadAsync("ca-app-pub-3940256099942544/5224354917");
var (type, amount) = await rewardedWrapper.ShowAsync(this);
Console.WriteLine($"Reward earned: {amount} {type}");

App Open Ad

Callback style

var appOpenWrapper = new AppOpenAdWrapper(this);
appOpenWrapper.Load(
    adUnitId: "ca-app-pub-3940256099942544/9257395921",
    loadListener: new MyLoadListener(),
    eventListener: new MyEventListener()
);

if (appOpenWrapper.IsLoaded() && !appOpenWrapper.IsShowing())
    appOpenWrapper.Show(this);

Async style

var appOpenWrapper = new AppOpenAdWrapper(this);
await appOpenWrapper.LoadAsync("ca-app-pub-3940256099942544/9257395921");
if (!appOpenWrapper.IsShowing())
    appOpenWrapper.Show(this);

Usage — iOS

Initialization

Callback style

AdMobManager.Instance.InitializeWithViewController(this, new MyInitListener());

private class MyInitListener : NSObject, IOnInitializedListener
{
    public void OnInitialized()
    {
        // SDK ready, load ads
    }

    public void OnInitializationFailedWithError(string error)
    {
        Console.WriteLine($"AdMob init failed: {error}");
    }
}

Async style

await AdMobManager.Instance.InitializeAsync(this);

Banner Ad

Callback style

var bannerWrapper = new BannerAdWrapper();
var adView = bannerWrapper.LoadWithAdUnitId(
    adUnitId: "ca-app-pub-3940256099942544/6300978111",
    viewController: this,
    loadListener: new MyBannerLoadListener(),
    eventListener: null
);
bannerContainer.AddSubview(adView);

private class MyBannerLoadListener : NSObject, IOnAdLoadedListener
{
    public void OnAdLoaded() => Console.WriteLine("Banner loaded");
    public void OnAdFailedToLoadWithErrorCode(nint errorCode, string errorMessage) =>
        Console.WriteLine($"Banner failed: [{errorCode}] {errorMessage}");
}

Async style

var bannerWrapper = new BannerAdWrapper();
var adView = await bannerWrapper.LoadAsync("ca-app-pub-3940256099942544/6300978111", this);
bannerContainer.AddSubview(adView);

Interstitial Ad

Callback style

var interstitialWrapper = new InterstitialAdWrapper();
interstitialWrapper.LoadWithAdUnitId(
    adUnitId: "ca-app-pub-3940256099942544/1033173712",
    loadListener: new MyLoadListener(),
    eventListener: new MyEventListener()
);

if (interstitialWrapper.IsLoaded)
    interstitialWrapper.ShowWithViewController(this);

Async style

var interstitialWrapper = new InterstitialAdWrapper();
await interstitialWrapper.LoadAsync("ca-app-pub-3940256099942544/1033173712");
interstitialWrapper.ShowWithViewController(this);

Rewarded Ad

Callback style

var rewardedWrapper = new RewardedAdWrapper();
rewardedWrapper.LoadWithAdUnitId(
    adUnitId: "ca-app-pub-3940256099942544/5224354917",
    loadListener: new MyLoadListener(),
    eventListener: null
);

if (rewardedWrapper.IsLoaded)
    rewardedWrapper.ShowWithViewController(this, new MyRewardListener());

Async style

var rewardedWrapper = new RewardedAdWrapper();
await rewardedWrapper.LoadAsync("ca-app-pub-3940256099942544/5224354917");
var (type, amount) = await rewardedWrapper.ShowAsync(this);
Console.WriteLine($"Reward earned: {amount} {type}");

App Open Ad

Callback style

var appOpenWrapper = new AppOpenAdWrapper();
appOpenWrapper.LoadWithAdUnitId(
    adUnitId: "ca-app-pub-3940256099942544/9257395921",
    loadListener: new MyLoadListener(),
    eventListener: null
);

if (appOpenWrapper.IsLoaded && !appOpenWrapper.IsShowing)
    appOpenWrapper.ShowWithViewController(this);

Async style

var appOpenWrapper = new AppOpenAdWrapper();
await appOpenWrapper.LoadAsync("ca-app-pub-3940256099942544/9257395921");
if (!appOpenWrapper.IsShowing)
    appOpenWrapper.ShowWithViewController(this);

Usage — MAUI (AMDevIT.Admob.Wrapper.MAUICross)

Setup

Register the handler in MauiProgram.cs:

builder.UseAMDevITAdMobWrapper();

Banner Ad in XAML

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:admob="clr-namespace:AMDevIT.Admob.Wrapper.MAUICross;assembly=AMDevIT.Admob.Wrapper.MAUICross"
             x:Class="YourApp.MainPage">

    <Grid RowDefinitions="*, Auto">

        <Label Grid.Row="0" Text="Hello MAUI!" />

        <admob:BannerAd Grid.Row="1"
                        AdUnitId="ca-app-pub-3940256099942544/6300978111"
                        AdSize="Adaptive"
                        AdLoaded="OnBannerLoaded"
                        AdFailed="OnBannerFailed">
            <admob:BannerAd.FallbackTemplate>
                <DataTemplate>
                    <Border Padding="12">
                        <Label Text="AdMob banner ads aren't supported on this platform." />
                    </Border>
                </DataTemplate>
            </admob:BannerAd.FallbackTemplate>
        </admob:BannerAd>

    </Grid>
</ContentPage>

private void OnBannerLoaded(object sender, EventArgs e)
{
    Console.WriteLine("Banner loaded");
}

private void OnBannerFailed(object sender, AdFailedEventArgs e)
{
    Console.WriteLine($"Banner failed: [{e.ErrorCode}] {e.ErrorMessage}");
}

FallbackTemplate is rendered on Windows and Mac Catalyst, where AdMob isn't supported. Its content is created lazily by the platform handler. If the property isn't set, the default template creates an empty ContentView. Android and iOS continue to render the native AdMob banner view and don't instantiate the fallback template.

Full-screen ad services are available for dependency injection on every supported MAUI target. Calling them on Windows or Mac Catalyst throws PlatformNotSupportedException.

Full-screen ads

Inject IInterstitialAdService, IAppOpenAdService, or IShowableRewardedAdService, then await loading before showing the ad:

public sealed class AdCoordinator(
    IInterstitialAdService interstitialAdService,
    IShowableRewardedAdService rewardedAdService)
{
    public Task ShowInterstitialAsync(CancellationToken cancellationToken = default)
    {
        return interstitialAdService.LoadAndShowAsync(
            "ca-app-pub-3940256099942544/1033173712",
            cancellationToken);
    }

    public async Task ShowRewardedAsync(CancellationToken cancellationToken = default)
    {
        rewardedAdService.AdRewardEarned += OnAdRewardEarned;

        await rewardedAdService.LoadAndShowAsync(
            "ca-app-pub-3940256099942544/5224354917",
            cancellationToken);
    }

    private static void OnAdRewardEarned(object? sender, AdReward reward)
    {
        Console.WriteLine($"Reward: {reward.Amount} {reward.Type}");
    }
}

Each registered service supports one native load operation at a time. A second overlapping call throws InvalidOperationException. Cancelling the token cancels the caller's wait, but it cannot cancel the native SDK operation; wait for its load callback before starting another load on the same service.

Banner Ad sizes

Error handling

The lower-level async extensions throw AdException on failure. MAUI full-screen loading throws AdLoadException; both exceptions expose the native error code:

try
{
    await AdMobManager.Instance.InitializeAsync(this);
    var adView = await bannerWrapper.LoadAsync(adUnitId);
    bannerContainer.AddView(adView);
}
catch (AdException ex)
{
    Console.WriteLine($"AdMob error [{ex.ErrorCode}]: {ex.Message}");
}

Test Ad Unit IDs

Use these IDs during development. Never use real Ad Unit IDs on a device you own.

Project structure

AMDevITAdMobWrapper/
├── sources/
│   ├── droid/                                      # Kotlin source (Android Studio)
│   │   └── admob-wrapper/
│   │       ├── AdMobManager.kt
│   │       └── ads/
│   │           ├── BannerAdWrapper.kt
│   │           ├── InterstitialAdWrapper.kt
│   │           ├── RewardedAdWrapper.kt
│   │           └── AppOpenAdWrapper.kt
│   ├── apple/ios/                                  # Swift source (Xcode)
│   │   ├── build_xcframework.sh
│   │   └── AdMobWrapper/
│   │       ├── AdMobManager.swift
│   │       └── Ads/
│   │           ├── BannerAdWrapper.swift
│   │           ├── InterstitialAdWrapper.swift
│   │           ├── RewardedAdWrapper.swift
│   │           └── AppOpenAdWrapper.swift
│   └── dotnet/AMDevIT.Admob.Wrapper/
│       ├── AMDevIT.Admob.Wrapper.Droid/            # .NET binding project (Android)
│       ├── AMDevIT.Admob.Wrapper.iOSNative/        # .NET binding project (iOS)
│       ├── AMDevIT.Admob.Wrapper/                  # Multi-platform wrapper + async extensions
│       ├── AMDevIT.Admob.Wrapper.MAUICross/        # MAUI controls and services
│       ├── AMDevIT.Admob.Wrapper.DroidTestApp/     # Android test app
│       ├── AMDevIT.Admob.Wrapper.AppleTestApp/     # iOS test app
│       └── AMDevIT.Admob.Wrapper.MAUICross.Tests/  # async lifecycle tests

Notes about building

Android

The native Android SDK is built as an AAR using Gradle. When making changes to the native code, rebuild the release AAR and replace AMDevIT.Admob.Wrapper.Droid/Jars/admob-wrapper-release.aar.

iOS

The native iOS SDK is built as an xcframework using Xcode. A build script is provided at sources/apple/ios/build_xcframework.sh. Run it from that directory:

./build_xcframework.sh

Then replace sources/dotnet/AMDevIT.Admob.Wrapper/AMDevIT.Admob.Wrapper.iOSNative/libs/AdMobWrapper.xcframework.

Contributing

Contributions are welcome. Please open an issue before submitting a pull request for significant changes.

When updating the native Android SDK version:

1. Update playServicesAdsVersion in libs.versions.toml
2. Recompile the AAR from Android Studio
3. Replace the release AAR in AMDevIT.Admob.Wrapper.Droid/Jars/
4. Update the Xamarin.GooglePlayServices.Ads NuGet version accordingly
5. Bump the package version and publish

When updating the native iOS SDK version:

1. Update the SPM dependency version in Xcode
2. Run ./build_xcframework.sh from sources/apple/ios/
3. Replace the xcframework in AMDevIT.Admob.Wrapper.iOSNative/libs/
4. Bump the package version and publish

License

Apache 2.0 License — see LICENSE for details.

This library is not affiliated with or endorsed by Google. AdMob is a trademark of Google LLC.