{"id":29316,"date":"2017-01-16T10:55:20","date_gmt":"2017-01-16T18:55:20","guid":{"rendered":"https:\/\/blog.xamarin.com\/?p=29316"},"modified":"2020-01-17T10:41:28","modified_gmt":"2020-01-17T18:41:28","slug":"lightweight-ads-for-android-apps","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/xamarin\/lightweight-ads-for-android-apps\/","title":{"rendered":"Lightweight Ads for Android Apps"},"content":{"rendered":"

\t\t\t\t\"play-services-ads-lite_128x128\"The easiest way to start monetizing your mobile apps is to connect with advertisers and show relevant ads within them. It’s as simple as displaying an ad, your users click on it, and you make money. The main staple in the industry is AdMob from Google, which offers SDKs for both iOS<\/a> and Android<\/a> applications and can be integrated in minutes. However, one drawback to the Android library is that its part of Google Play services, which can increase the size of your app. Today we’re going to look at a new SDK for Android, Ads Lite, that gives us a lightweight new version to help reduce app size and decrease the number of dependencies required. This can be extremely useful if you’re running into the 64K reference limit<\/a> and have to multidex your application.<\/p>\n

Monetize App in AdMob<\/h2>\n

Before we can integrate the SDK, we’ll need to set up our app in AdMob. If you haven’t signed up for an AdMob account<\/a>, you’ll want to do so at this time to start the monetization process. Once you’ve created an account, we can simply click on the Monetize App button to find our app in the app store or add it manually. Select the Manual process if you haven’t launched your app in Google Play.<\/p>\n

\"addappadmob\"<\/p>\n

The next step is to select the ad format that we want to integrate into the app. The easiest format to integrate is a Banner, which is placed throughout the apps. We have control over different refresh rates along with the type of ads we want to display. We can then link to Firebase for advanced analytics, or skip over this process.<\/p>\n

We can add additional ad units or get setup instructions at this point. If we wanted to add ad banners to multiple Activities, it’s best practice to create an ad unit for each. Back on the main app screen, we’ll want to write down our App ID and Ad unit ID to integrate into our code:<\/p>\n

\"appid\"<\/p>\n

\"adunitid\"<\/p>\n

Getting Started with Ads Lite SDK<\/h2>\n

Ads Lite is a brand new SDK that was introduced with Google Play services 9.6.1. It has far fewer dependencies than the standard Ads SDK, but still requires a minimum version of 24.2.1 of the Android Support Libraries. This means that, as of this blog, Ads Lite is currently not compatible with Xamarin.Forms applications (see my blog on adding Ads to Xamarin.Forms apps<\/a>), but can be added to traditional Xamarin.Android applications easily through the NuGet package<\/a>.<\/p>\n

\"adnuget\"<\/p>\n

Add Permissions and Ads Activity<\/h2>\n

Once the SDK has been added, we must update our Android Manifest with a few permissions and a default Ads activity that can be launched. <\/p>\n

The Google Mobile Ads Lite SDK requires the Internet and Access Network State permissions to work correctly. We can add these with the following assembly level attributes:<\/p>\n

\r\n[assembly: UsesPermission (Android.Manifest.Permission.Internet)]\r\n[assembly: UsesPermission (Android.Manifest.Permission.AccessNetworkState)]\r\n<\/pre>\n
Or, we can add them directly inside the Android Manifest manually. We can find our Android Manifest source under the Properties folder in Visual Studio or Visual Studio for Mac.<\/p>\n
\r\n\t\r\n\t\r\n<\/pre>\n
Inside of the application tag we will add this very specific activity node:<\/p>\n
\r\n    \r\n\r\n    \r\n<\/pre>\n
Integrate AdView<\/h2>\n
We can now start to add the AdViews throughout our application. Simply open the layout file where the ad will live, and in the root node we’ll add a custom xmlns for our ad under the xmlns:android<\/code> attribute:<\/p>\n
\r\nxmlns:ads=\"http:\/\/schemas.android.com\/apk\/res-auto\"\r\n<\/pre>\n
Next, we can add the AdView control:<\/p>\n
\r\n  \r\n  <\/com.google.android.gms.ads.AdView>\r\n<\/pre>\n
Note that we’re using the SMART_BANNER<\/code> keyword for the adSize<\/a> to dynamically fill the width and height and by referencing @string\/banner_ad_unit_id<\/code> for the adUnitId<\/code>, which we get from AdMob. The ID should be placed in the strings.xml resources folder. This ID starts with ca-app-pub<\/code> and has a \/<\/code> in it.<\/p>\n
\r\nYOUR_AD_UNIT_ID\r\n<\/pre>\n
Initialize the Ads SDK<\/h2>\n
Our AdView is ready to start displaying ads, but we must ensure that the SDK has been initialized with our publisher app ID. It’s recommended to initialize at app launch, such as inside the OnCreate of our MainActivity. This ID starts with ca-app-pub<\/code> and has a ~<\/code> in it.<\/p>\n
\r\nvar id = \"YOUR_ADMOB_APP_ID\";\r\nAndroid.Gms.Ads.MobileAds.Initialize(ApplicationContext, id);\r\n<\/pre>\n
Finally, we must send a request for the ad in the code behind where the layout is loaded:<\/p>\n
\r\nvar adView = FindViewById(Resource.Id.adView);\r\nvar adRequest = new AdRequest.Builder().Build();\r\nadView.LoadAd(adRequest);\r\n<\/pre>\n
See it in Action<\/h2>\n
At this point, we’re ready to launch and run our application. We must use a Google Android emulator with Google Play services or a physical device.<\/p>\n
\"screenshot_1484006501\"<\/p>\n
This should look very similar to standard AdMob test ads if you have used the standard Ads SDK in your app. In fact, you could simply replace the standard Ads SDK with Ads Lite SDK with absolutely no code changes!<\/p>\n
Limitations<\/h2>\n
Ads Lite has a reduced footprint because it is unlike the standard Ads SDK, which includes the Google Play services client libraries. Ads Lite strips away the implementation and leaves only an interface for us to develop against. This means that Google Play services must be installed and updated on the device that your app is running on. It’s only recommended to use the Lite SDK if distributing through the Google Play store. If a device doesn’t have Google Play services, it will log an error and an ad will not be displayed.<\/p>\n
Learn More<\/h2>\n
To learn more about the Ads Lite SDK, be sure to read through the Firebase documentation<\/a> and the full Ads SDK documentation<\/a> on integrating ads. You can find a full sample of integrating Ads Lite SDK in my Monkeys App on GitHub<\/a>. If you’re looking to integrate AdMob ads in your Xamarin.Forms applications, read through my posts on integrating AdMob for both iOS<\/a> and Android<\/a> Xamarin.Forms apps.<\/p>\n","protected":false},"excerpt":{"rendered":"
The easiest way to start monetizing your mobile apps is to connect with advertisers and show relevant ads within them. It’s as simple as displaying an ad, your users click on it, and you make money.  Today we’re going to look at a new SDK for Android, Ads Lite.<\/p>\n","protected":false},"author":544,"featured_media":41053,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[313,2,556],"tags":[5,429,1176,1448,4],"class_list":["post-29316","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-android","category-developers","category-integrations","tag-android","tag-components","tag-google-play","tag-monetization","tag-xamarin-platform"],"acf":[],"blog_post_summary":"
The easiest way to start monetizing your mobile apps is to connect with advertisers and show relevant ads within them. It’s as simple as displaying an ad, your users click on it, and you make money.  Today we’re going to look at a new SDK for Android, Ads Lite.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts\/29316","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/users\/544"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/comments?post=29316"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts\/29316\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/media\/41053"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/media?parent=29316"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/categories?post=29316"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/tags?post=29316"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}