Skip to content

Latest commit

 

History

History
98 lines (76 loc) · 3.71 KB

Readme.md

File metadata and controls

98 lines (76 loc) · 3.71 KB

AdContainerView

Codacy Badge

AdContainerView is a simple, lifecycle aware wrapper over Google AdMob's AdView (Banner Ad) for a plug & play use-case.

For the simplest use:
You just need to add AdContainerView in your layout, define adUnitId, adSize & that's it!
AdContainerView hooks to your Activity's lifecycle process & handles AdView's lifecycle (Resume, Pause, Destroy Ad).
This is most helpful when you just want to add a simple Banner Ad without any boilerplate.

Adding in your project

AdContainerView is now on mavenCentral(),
Make sure to add that to your repositories block.

Gradle

implementation 'com.lazygeniouz:acv:$latest_version'

Maven

<dependency>
    <groupId>com.lazygeniouz</groupId>
    <artifactId>acv</artifactId>
    <version>$latest_version</version>
    <type>aar</type>
</dependency>

Using AdContainerView

The same old XML Way

<com.lazygeniouz.acv.AdContainerView 
    android:id="@+id/adContainerView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:acv_autoLoad="true"
    app:acv_adSize="ADAPTIVE"
    app:acv_adUnitId="@string/test_ad"/>

The attributes are as follows:

  • acv_autoLoad: Default Value is false
    If true, the AdView will be loaded as soon as the Activity is created.

  • acv_adSize: Default Value is ADAPTIVE which equals to AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize().
    Define an AdSize for the the AdView, check AdSize.

  • acv_adUnitId: Define an adUnitId for the Banner AdView from your AdMob dashboard.

Programmatically

val adContainerView = AdContainerView(this@MainActivity)
adContainerView.loadAdView(adUnitId, adSize, adRequest)
parentLayout.addView(adContainerView)

Loading the Ad:

fun loadAdView(
    adUnitId: String,
    adSize: AdSize,
    adRequest: AdRequest,
    parentHasListView: Boolean,
    showOnCondition: (() -> Boolean)? = null
)
  1. The arguments adSize & adRequest are optional\
  2. The default value of parameter adSize is ADAPTIVE.\
  3. Pass your AdRequest if you have a customized request.\
  4. Pass true if AdContainerView is added inside a list (RecyclerView, List / GridView).
    If you don't do this & the parent view group is a List, it will be destroyed.
  5. Pass you condition to evaluate whether to show the Ad or not (Default is Null).

All other methods:

  • @Nullable getAdView(): Returns the underlying AdView, can be @null if called before loadAdView().

  • isLoading(): Boolean: Returns true if the Ad is currently loading, false otherwise.

  • isAdLoaded(): Boolean: Returns true if the Ad is loaded, false otherwise.

  • isVisible(): Boolean: Returns true if the Ad is loaded, not null & visible, false otherwise.

  • getAdSize(): Returns current adSize.

  • getAdUnitId(): Returns current adUnitId.

  • setAdListener(listener: AdListener): Use the AdView's AdListener.

  • @Nullable getAdListener(): Returns the Listener if set, null otherwise.

  • removeAd(): Removes the AdView. Make sure to call loadAdView() to re-add AdView.

  • resumeAd(): Resumes AdView (Handled automatically)

  • pauseAd(): Pauses AdView (Handled automatically)

  • destroyAd(): Destroys AdView (Handled automatically)