Banners

To add a Banner on a page you have two options:

XAML

<controls:MTAdView x:Name="myAds"></controls:MTAdView>

remember to add this line in your XAML:

xmlns:controls="clr-namespace:MarcTron.Plugin.Controls;assembly=Plugin.MtAdmob"

CODE

MTAdView ads = new MTAdView();

Now you can add the control to your layout.

PLEASE NOTE

From version 1.1.0, for Consent compliancy, to load your banner, you need to manually call:

YourBanner.LoadAd();

IMPORTANT

To test the banner during the development google uses two Banner Id, one for Android and the other for iOS. Use them then remember to replace them with your own IDs:

Android: ca-app-pub-3940256099942544/6300978111
iOS: ca-app-pub-3940256099942544/2934735716

If the Banners don't appear in your app, probably it's a size problem. To solve it, add this style to your app.xaml:

<Style TargetType="controls:MTAdView">
<Setter Property="HeightRequest">
<Setter.Value>
<x:OnIdiom Phone="50" Tablet="90"></x:OnIdiom>
</Setter.Value>
</Setter>
</Style>

PROPERTIES

For each AdView if you want, you can set this property: AdsId: To add the id of your ads AdSize: To chose the size of your banners (from version 1.9) AutoSize: If true, the plugin will update the heightbanner height according to the ads loaded (from version 1.9)

For GDPR it's better to rely on a custom consent instead or using the non personalized ads as I cannot guarantee it works. So it's better if you create a custom consent

GLOBAL PROPERTIES

AdsId: To add the id of your ads

PersonalizedAds: You can set it to False if you want to use generic ads (for GDPR...) (It works only for Android Banners, for the others, you must ask for consent) For GDPR it's better to rely on a custom consent instead or using the non personalized ads as I cannot guarantee it works. So it's better if you create a custom consent

TestDevices: You can add here the ID of your test devices

UseRestrictedDataProcessing: For compliance with the CCPA

You can use Global Properties in this way: CrossMTAdmob.Current.UserPersonalizedAds = true;

Interstitials

You can show an interstitial with a single line of code:

CrossMTAdmob.Current.ShowInterstitial();

To Load an interstitial you can use this line:

CrossMTAdmob.Current.LoadInterstitial("xx-xxx-xxx-xxxxxxxxxxxxxxxxx/xxxxxxxxxx");

Rewarded ads

You can show a Rewarded video with a single line of code:

CrossMTAdmob.Current.ShowRewarded();

To Load a Rewarded Video you can use this line:

CrossMTAdmob.Current.LoadRewarded("xx-xxx-xxx-xxxxxxxxxxxxxxxxx/xxxxxxxxxx");

Rewarded Interstitials

You can show a Rewarded video with a single line of code:

CrossMTAdmob.Current.ShowRewardInterstitial();

To Load a Rewarded Video you can use this line:

CrossMTAdmob.Current.LoadRewardInterstitial("xx-xxx-xxx-xxxxxxxxxxxxxxxxx/xxxxxxxxxx");

App Open Ads

The plugin provides functionality to load and display App Open ads in an Android and iOS application, while handling ad loading callbacks and error handling.

To initialize the Open Ads in your app, you need to set the corresponding variable enableOpenAds in

CrossMTAdmob.Current.Init(...)

In the same Init, you also need to pass your Open App Id in openAdsId.

To load and show your Open Ads when the app starts or goes into foreground, you need the following code:

Android

protected override void OnResume()
{
base.OnResume();
CrossMauiMTAdmob.Current.OnResume();
}

iOS

public override void OnActivated(UIApplication application)
{
base.OnActivated(application);
CrossMTAdmob.Current.OnResume();
}

Methods

None

Events

• OnAppOpenAdLoaded: Event raised when an app open ad is loaded.
• OnAppOpenOpened: Event raised when an app open ad is opened.
• OnAppOpenClosed: Event raised when an app open ad is closed.
• OnAppOpenFailedToLoad: Event raised when an app open ad fails to load.
• OnAppOpenFailedToShow: Event raised when an app open ad fails to show.
• OnAppOpenImpression: Event raised when an app open ad impression occurs.
• OnAppOpenClicked: Event raised when an app open ad is clicked.

Native Ads

Native ads are ad assets that are presented to users through UI components that are native to the platform. They're shown using the same types of views with which you're already building your layouts, and can be formatted to match your app's visual design.

Methods

• LoadNativeAd: To load a native ad. (Eg. CrossMauiMTAdmob.Current.LoadNativeAd();)
• LoadNativeAds: To load up to 5 native ads (*only on Android) (Eg. CrossMauiMTAdmob.Current.LoadNativeAds(5);)
• ShowNativeAd: Event raised when a native ad is opened. (Eg. myNativeAds.ShowNativeAd();)

Events

• OnNativeAdLoaded: Event raised when a native ad is loaded.
• OnNativeAdOpened: Event raised when a native ad is opened.
• OnNativeAdClosed: Event raised when a native ad is closed.
• OnNativeAdFailedToLoad: Event raised when a native ad fails to load.
• OnNativeAdFailedToShow: Event raised when a native ad fails to show.
• OnNativeAdImpression: Event raised when a native ad impression occurs.
• OnNativeAdClicked: Event raised when a native ad is clicked.

Ump

Under the Google EU User Consent Policy, you must make certain disclosures to your users in the European Economic Area (EEA) along with the UK and obtain their consent to use cookies or other local storage, where legally required, and to use personal data (such as AdID) to serve ads. The licensed version of the plugin allows you to automatically ask consent to your users that need to provide it (EEA & UK). To enable this feature and automatically request the consent on your apps, you can buy the license here.

Known issues and fix

Links

VIDEO

Get Filthy Rich by Monetizing Your Xamarin.Forms App with AdMob - Gerald Versluis (Youtube)

LINKS

Available on Nuget: https://www.nuget.org/packages/MarcTron.Admob

Tutorial: https://www.xamarinexpert.it/admob-made-easy/

To report any issue: https://github.com/marcojak/MTAdmob/issues

DISCLAIMER OF LIABILITY

By using the MTAdmob plugin you agree that:

1. The Plugin is provided "as is" without any warranties or guarantees of any kind, either expressed or implied.
2. I shall not be responsible or liable for any direct, indirect, incidental, special, or consequential damages arising out of the use or inability to use the Plugin.
3. I do not warrant that the Plugin will meet your specific requirements or operate without interruption.

You acknowledge that the use of the Plugin is at your own risk. The author of the plugin disclaims all liability for any damage to your computer system or loss of data that results from the use of the Plugin.

This disclaimer of liability is a fundamental part of the agreement between you and the author of the plugin. You agree that the limitations and exclusions of liability set forth in this disclaimer are reasonable and fair.

If you do not agree to these terms, do not use the Plugin.