NativeAdManager

Native Ads - AdManageKit v4.4.4

Overview

AdManageKit provides comprehensive native ad support with caching, multiple formats, and the new NativeTemplateView (v2.6.0+). Native ads blend seamlessly with your app's content while maximizing engagement.

Library Version: v4.4.4

Features

Multiple Formats: Small, Medium, Large, and 38 template styles
Smart Caching: Per-unit caching with 1-hour expiration
Loading Strategies: ON_DEMAND, ONLY_CACHE, HYBRID, FRESH_WITH_CACHE_FALLBACK
Shimmer Loading: Beautiful loading placeholders
NativeTemplateView: Unified component with 38 templates (v2.6.0+)
Video Support: All templates support video ads

Installation

dependencies {
    implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit:v4.4.4'
    implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-core:v4.4.4'
}

Native Ad Formats

Traditional Views

Class	Best For
`NativeBannerSmall`	Compact spaces, lists
`NativeBannerMedium`	General content areas
`NativeLarge`	Featured placements

NativeTemplateView (v2.6.0+)

38 template styles in one unified component. A selection:

Template	Best For
`card_modern`	General use
`material3`	Material 3 apps
`minimal`	Content-focused
`compact_horizontal`	Lists
`list_item`	RecyclerView items
`magazine`	News/blog apps
`video_small/medium/large`	Video content
`video_square/vertical/fullscreen`	Social feeds
`featured`, `grid_card`, `overlay_dark`, `story_style`	Various layouts
`app_store`, `social_feed`, `gradient_card`, `spotlight`	Themed placements
`flat_*` family (10 styles)	Flat/minimal design systems

See attrs.xml for the full adTemplate enum.

Custom Templates (v4.3.0+)

If none of the 38 presets fit, supply your own layout. The root must be a Next-Gen SDK NativeAdView reusing the standard asset ids (ad_headline, ad_body, ad_call_to_action, ad_app_icon, ad_advertiser, ad_media).

nativeTemplateView.setCustomTemplate(
    layoutResId = R.layout.my_native_ad,
    shimmerResId = R.layout.my_shimmer,   // optional
    sizeHint = NativeAdSize.MEDIUM        // optional, default MEDIUM
)

Or in XML via app:customAdLayout / app:customAdShimmerLayout, or customLayoutResId on NativeTemplateCompose.

Media Aspect Ratio (v4.3.3+)

Every native request carries a media aspect-ratio hint matched to the template's MediaView slot. Override it globally with AdManageKitConfig.defaultNativeMediaAspect, or per view:

nativeTemplateView.setMediaAspect(NativeMediaAspect.LANDSCAPE)

Values: UNSPECIFIED, ANY (default), LANDSCAPE, PORTRAIT, SQUARE.

Usage

NativeTemplateView (Recommended)

XML:

<com.i2hammad.admanagekit.admob.NativeTemplateView
    android:id="@+id/nativeTemplateView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:adTemplate="material3" />

Kotlin:

// Load with default template
nativeTemplateView.loadNativeAd(activity, "ca-app-pub-xxx/yyy")

// Change template
nativeTemplateView.setTemplate(NativeAdTemplate.MAGAZINE)
nativeTemplateView.loadNativeAd(activity, "ca-app-pub-xxx/yyy")

// With callback
nativeTemplateView.loadNativeAd(activity, adUnitId, object : AdLoadCallback() {
    override fun onAdLoaded() { /* success */ }
    override fun onFailedToLoad(error: AdError?) { /* error */ }
})

// With strategy override
nativeTemplateView.loadNativeAd(activity, adUnitId, callback, AdLoadingStrategy.ONLY_CACHE)

Traditional Views

// NativeBannerSmall
val nativeBannerSmall = NativeBannerSmall(context)
nativeBannerSmall.loadNativeBannerAd(activity, "ca-app-pub-xxx/yyy")

// NativeBannerMedium
val nativeBannerMedium = NativeBannerMedium(context)
nativeBannerMedium.loadNativeBannerAd(activity, "ca-app-pub-xxx/yyy", useCachedAd = true)

// NativeLarge
val nativeLarge = NativeLarge(context)
nativeLarge.loadNativeAds(activity, "ca-app-pub-xxx/yyy")

Caching System

Configuration

AdManageKitConfig.apply {
    nativeLoadingStrategy = AdLoadingStrategy.HYBRID
    nativeCacheExpiry = 1.hours
    maxCachedAdsPerUnit = 3
    enableLRUEviction = true
    maxCacheMemoryMB = 200
}