admanagekit-mcp-server 1.0.0

package/content/docs/release-notes/RELEASE_NOTES_v2.3.0.md

@@ -0,0 +1,280 @@
+# Release Notes - AdManageKit v2.3.0
+
+**Release Date:** December 16, 2024
+**Version:** 2.3.0
+**Compatibility:** Android API 21+ | Google Play Billing Library 8.x | Jetpack Compose 2024.12.01
+
+---
+
+## 🚀 What's New in v2.3.0
+
+### 🐛 **Critical Bug Fixes**
+- **Fixed Native Ad Display Issue** - Resolved critical bug where cached native ads were found but not visually displayed
+- **Enhanced AdChoices Handling** - Improved null AdChoices info handling for test ads
+- **Consistent Logging** - Replaced manual logging with AdDebugUtils for unified debugging experience
+
+### 🔧 **Core Improvements**
+
+#### **Fixed Cached Ad Display Pipeline**
+The major fix in this release addresses a critical issue where native ads reported successful loading but weren't displayed:
+
+**Before (v2.2.0):**
+```
+Cache hit for MainActivity_MEDIUM: serving cached ad
+✅ NativeBannerMedium loaded successfully
+// Ad callback fired but no visual ad appeared
+```
+
+**After (v2.3.0):**
+```
+Cache hit for MainActivity_MEDIUM: serving cached ad
+foundCachedAd: Found cached ad from integration manager - displaying it
+✅ NativeBannerMedium loaded successfully
+// Ad now displays visually on screen
+```
+
+#### **Enhanced NativeAdIntegrationManager**
+- **Fixed cache serving logic** - Now properly passes cached ads to display layer
+- **Added temporary ad storage** - Enables proper handoff between caching and display
+- **Improved error handling** - Better fallback when cached ad display fails
+
+#### **All Native Ad Components Fixed**
+- ✅ **NativeBannerSmall** - Fixed cached ad display
+- ✅ **NativeBannerMedium** - Fixed cached ad display
+- ✅ **NativeLarge** - Fixed cached ad display
+
+### 📊 **Enhanced Debugging**
+
+#### **Unified AdDebugUtils Integration**
+- **Consistent Event Logging** - All ad events now use `AdDebugUtils.logEvent()`
+- **Structured Debug Output** - Categorized logging with success/failure indicators
+- **Performance Tracking** - Enhanced timing and performance metrics
+- **Clean Error Messages** - Improved error reporting with context
+
+#### **Improved AdChoices Logging**
+- **Informative Null Handling** - "AdChoices info: null (normal for test ads)" instead of confusing null
+- **Visual State Tracking** - Detailed view state logging throughout display pipeline
+- **Cache Hit Verification** - Logs confirm when cached ads are found and displayed
+
+### 🔧 **Technical Improvements**
+
+#### **BillingConfig Enhancements**
+- **Java Interoperability** - Added `@JvmStatic` annotations for better Java integration
+- **Static Method Access** - Java code can now use `BillingConfig.setPurchaseProvider(provider)`
+- **Backward Compatible** - Instance access still works: `BillingConfig.INSTANCE.setPurchaseProvider(provider)`
+
+#### **Code Quality Improvements**
+- **Removed Unused Imports** - Cleaned up unused Log imports after AdDebugUtils migration
+- **Consistent TAG Usage** - Unified logging tags across all components
+- **Enhanced Code Documentation** - Better inline comments explaining fixes
+
+---
+
+## 📦 **Installation**
+
+### Gradle Dependencies (Kotlin DSL)
+```kotlin
+implementation("com.github.i2hammad.AdManageKit:ad-manage-kit:v2.3.0")
+implementation("com.github.i2hammad.AdManageKit:ad-manage-kit-billing:v2.3.0")
+implementation("com.github.i2hammad.AdManageKit:ad-manage-kit-core:v2.3.0")
+
+// For Jetpack Compose support
+implementation("com.github.i2hammad.AdManageKit:ad-manage-kit-compose:v2.3.0")
+```
+
+### Gradle Dependencies (Groovy)
+```groovy
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit:v2.3.0'
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-billing:v2.3.0'
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-core:v2.3.0'
+
+// For Jetpack Compose support
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-compose:v2.3.0'
+```
+
+---
+
+## 🔄 **Migration from v2.2.0**
+
+### **Automatic Migration**
+- **✅ Full Backward Compatibility** - All v2.2.0 code works without changes
+- **✅ No Breaking Changes** - All method signatures and behaviors preserved
+- **✅ Immediate Benefits** - Native ad display fixes apply automatically
+
+### **No Action Required**
+This is a **bug fix release** - simply update your dependency versions and rebuild. The fixes are automatically applied:
+
+```groovy
+// Update these version numbers
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit:v2.3.0'        // was v2.2.0
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-billing:v2.3.0' // was v2.2.0
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-core:v2.3.0'    // was v2.2.0
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-compose:v2.3.0' // was v2.2.0
+```
+
+### **Expected Improvements**
+After updating to v2.3.0, you should immediately see:
+
+1. **Native ads displaying visually** (not just success callbacks)
+2. **Cleaner debug logs** with structured event information
+3. **Better error messages** with proper context
+4. **Improved Java interop** if using Java code
+
+---
+
+## 🐛 **Bug Fixes**
+
+### **Critical Fixes**
+- **Native Ad Display** - Fixed critical issue where `NativeAdIntegrationManager` found cached ads but only called callbacks without displaying them
+- **AdChoices Null Handling** - Improved handling of null AdChoices info for test ad units
+- **Cache Display Pipeline** - Fixed disconnect between cache hits and actual visual display
+- **View Lifecycle Management** - Enhanced proper view attachment and visibility handling
+
+### **Stability Improvements**
+- **Thread Safety** - Better post-frame execution for view operations
+- **Memory Management** - Improved cleanup of temporary cached ad references
+- **Error Recovery** - Enhanced fallback when cached ad display fails
+- **State Synchronization** - Better coordination between caching and display layers
+
+---
+
+## 🔍 **Debugging Improvements**
+
+### **Enhanced Log Output**
+**Before v2.3.0:**
+```
+D AdManageKit: Cache hit for MainActivity_MEDIUM: serving cached ad
+D AdManageKit: ✅ [47696110] onAdLoaded: NativeBannerMedium loaded successfully
+// Ad not visible - confusing for developers
+```
+
+**After v2.3.0:**
+```
+D AdManageKit-Event: foundCachedAd: Found cached ad from integration manager - displaying it
+D AdManageKit-Event: displayCachedAd: Displaying cached/preloaded ad
+D AdManageKit-Event: ✅ [47696110] onAdLoaded: NativeBannerMedium loaded successfully
+// Ad now displays visually with clear debug trail
+```
+
+### **Structured Event Categories**
+- **AdDisplay** - View manipulation and visibility events
+- **CacheDisplay** - Cached ad retrieval and display events
+- **AdPopulate** - Native ad content population events
+- **ViewStates** - View hierarchy and layout state information
+- **DisplayVerify** - Final verification of successful ad display
+
+---
+
+## 📈 **Performance Impact**
+
+### **Improvements**
+- **Faster Ad Display** - Eliminated unnecessary callback cycles in cached ad serving
+- **Reduced Log Overhead** - More efficient structured logging vs. multiple Log.d() calls
+- **Better Memory Usage** - Proper cleanup of temporary cached ad references
+- **Fewer Wasted Cycles** - Direct display path for cached ads eliminates redundant processing
+
+### **No Performance Degradation**
+- **Same Load Times** - No impact on initial ad loading performance
+- **Same Memory Footprint** - Debug improvements don't affect production memory usage
+- **Same Network Usage** - No changes to ad fetching or caching behavior
+
+---
+
+## 🧪 **Testing Recommendations**
+
+### **Verify the Fixes**
+1. **Visual Verification** - Confirm native ads display on screen (not just success callbacks)
+2. **Cache Hit Testing** - Test rapid navigation to verify cached ads display properly
+3. **Debug Log Review** - Check for cleaner, more structured debug output
+4. **Error Scenarios** - Test ad loading failures for improved error messaging
+
+### **Test Scenarios**
+```kotlin
+// Test cached ad display
+nativeBannerMedium.loadNativeBannerAd(activity, adUnitId, useCachedAd = true, callback)
+
+// Test new debug output
+AdManageKitConfig.debugMode = true
+// Look for structured AdDebugUtils output in logs
+
+// Test Java interop (if using Java)
+BillingConfig.setPurchaseProvider(provider); // Now works in Java
+```
+
+---
+
+## 🔗 **Dependencies**
+
+### **Updated Components**
+All modules updated to v2.3.0:
+- **ad-manage-kit**: Core ad management with display fixes
+- **ad-manage-kit-billing**: Enhanced Java interoperability
+- **ad-manage-kit-core**: BillingConfig improvements
+- **ad-manage-kit-compose**: Consistent with core version
+
+### **No New Dependencies**
+This release doesn't add any new dependencies - it's purely a bug fix and enhancement release.
+
+---
+
+## ⚠️ **Known Issues Fixed**
+
+### **Resolved in v2.3.0**
+- ✅ **Native ads reporting success but not displaying** - Fixed
+- ✅ **"AdChoices info: null" appearing as error** - Now informational
+- ✅ **Inconsistent debug logging format** - Now unified with AdDebugUtils
+- ✅ **Java interop issues with BillingConfig** - Fixed with @JvmStatic
+- ✅ **LiveEdit crashes with abstract classes** - Mitigated with proper error handling
+
+### **Still Known**
+- **LiveEdit Compatibility** - Android Studio LiveEdit may have issues with abstract classes - restart app to resolve
+
+---
+
+## 🛠️ **Developer Notes**
+
+### **For Existing Users**
+- **Update is Recommended** - This fixes critical display issues that may affect user experience
+- **Zero Code Changes** - Update dependency versions and rebuild
+- **Immediate Benefits** - Native ads will display properly without any code changes
+
+### **For New Users**
+- **Start with v2.3.0** - This version includes all Compose support plus critical bug fixes
+- **Stable Foundation** - Built on the solid v2.2.0 base with important display fixes
+- **Full Feature Set** - Complete Jetpack Compose integration with reliable native ad display
+
+---
+
+## 🔮 **What's Next**
+
+### **Upcoming Features (v2.5.0 Preview)**
+- **Enhanced Subscription Management** - Advanced offer handling and discount management
+- **App Open Ad Compose** - Complete Compose support for app open ads
+- **Rewarded Ad Compose** - Declarative rewarded ad integration
+- **Advanced Analytics Dashboard** - Real-time ad performance monitoring
+- **A/B Testing Framework** - Built-in ad performance optimization
+
+### **Community Feedback**
+This release addresses critical user feedback about native ad display issues. Please continue reporting issues:
+- **GitHub Issues**: [AdManageKit Issues](https://github.com/i2hammad/AdManageKit/issues)
+- **Discussions**: [AdManageKit Discussions](https://github.com/i2hammad/AdManageKit/discussions)
+
+---
+
+## 💝 **Acknowledgments**
+
+Special thanks to the developers who reported the native ad display issues that led to this critical fix. Your detailed bug reports and testing feedback made this release possible.
+
+---
+
+## 📄 **Full Documentation**
+
+- **[README.md](README.md)** - Updated integration guide with v2.3.0 information
+- **[API Documentation](https://jitpack.io/com/github/i2hammad/AdManageKit/v2.3.0/javadoc/)** - Complete API reference
+- **[Migration Guide](README.md#migrating-to-23)** - Simple version update instructions
+- **[Compose Examples](app/)** - Working examples in the demo app
+
+**Download AdManageKit v2.3.0**: [![JitPack](https://jitpack.io/v/i2hammad/AdManageKit.svg)](https://jitpack.io/#i2hammad/AdManageKit)
+
+---
+*AdManageKit v2.3.0 - Now your cached native ads actually display! 🎯*

package/content/docs/release-notes/RELEASE_NOTES_v2.5.0.md

@@ -0,0 +1,73 @@
+# Release Notes - AdManageKit v2.5.0
+
+**Release Date:** October 31, 2025  
+**Version:** 2.5.0  
+**Compatibility:** Android API 21+ | Google Play Billing Library 8.x | Jetpack Compose 2024.12.01
+
+---
+
+## 🚀 What's New in v2.5.0
+
+### 🛡️ App Open Stability Overhaul
+- **Thread-Safe Lifecycle:** `AppOpenManager` now relies on `AtomicBoolean`, `AtomicInteger`, and `WeakReference` state to prevent race conditions and memory leaks when activities rotate or background.
+- **Smarter Activity Exclusion:** Adds a fast-path cache for excluded activities and uses `cleanup()` to unregister lifecycle callbacks when the manager is no longer needed.
+- **Force & Conditional Showing:** `forceShowAdIfAvailable()` and the new `canShowAd()` helper guard against duplicate displays and return actionable reasons when an ad cannot be shown.
+- **Lifecycle-Ready Cleanup:** `cleanup()` resets cached state, cancels pending timeouts, clears load metrics, and unregisters callbacks to avoid leaks on process shutdown.
+
+### 📡 Intelligent Retry & Circuit Breaking
+- **Exponential Backoff:** `fetchAdWithRetry()` automatically retries network and no-fill failures using configurable exponential backoff (`updateRetryConfiguration`).
+- **Circuit Breaker Integration:** Tracks consecutive failures, opens a circuit breaker based on `AdManageKitConfig.circuitBreakerThreshold`, and auto-resets after the configured cooldown.
+- **Load Analytics:** `getPerformanceMetrics()` surfaces average load time, failure counts, and current breaker state for dashboards or support tooling.
+- **Robust Timeout Handling:** All pending timeouts are tracked and cancelled safely, ensuring callbacks never fire after a manager is cleaned up.
+
+### 🧠 Smarter Native Ad Fallback
+- **Same-Unit Cache Fallback:** `NativeAdManager.getCachedNativeAd()` now reuses cached ads that were fetched with the same ad unit ID (including screen-specific suffixes) when the primary cache bucket is empty.
+- **Automatic Adoption:** `NativeBannerSmall`, `NativeBannerMedium`, and `NativeLarge` opt into the safe fallback path, improving cache hit rates after connectivity hiccups without crossing placements.
+- **Analytics Visibility:** Fallback serves are logged with detailed analytics, making it easy to observe cache performance in Firebase.
+
+### 💳 Billing & Sample Improvements
+- **Billing Control Surface:** `AppPurchase` exposes `isBillingAvailable` and `connectToGooglePlayBilling()` so apps can manually reconnect or surface billing state.
+- **Sample App Hardening:** `SplashActivity` now checks `AppOpenManager.isShowingAd()` before navigating to prevent duplicate navigation while app open ads display.
+- **Documentation Fixes:** Updated README examples align `onProductPurchased` with the real callback signature.
+
+---
+
+## 📦 Installation
+
+### Gradle Dependencies (Kotlin DSL)
+```kotlin
+implementation("com.github.i2hammad.AdManageKit:ad-manage-kit:v2.5.0")
+implementation("com.github.i2hammad.AdManageKit:ad-manage-kit-billing:v2.5.0")
+implementation("com.github.i2hammad.AdManageKit:ad-manage-kit-core:v2.5.0")
+implementation("com.github.i2hammad.AdManageKit:ad-manage-kit-compose:v2.5.0")
+```
+
+### Gradle Dependencies (Groovy)
+```groovy
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit:v2.5.0'
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-billing:v2.5.0'
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-core:v2.5.0'
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-compose:v2.5.0'
+```
+
+---
+
+## 🔄 Migration from v2.3.0
+
+- **Drop-In Upgrade:** No breaking API changes. Existing integrations continue to work after bumping the dependency version.
+- **Optional Tuning:** Call `AppOpenManager.updateRetryConfiguration()` if you want to customize retry counts, base delay, or multipliers.
+- **Manual Cleanup:** If you create multiple `AppOpenManager` instances, invoke `cleanup()` when an instance is no longer needed to free lifecycle callbacks promptly.
+- **Native Cache Fallback:** The new same-unit fallback behaviour is on by default for bundled widgets; you can opt out by passing `useCachedAd = false` or disabling caching via `AdManageKitConfig`.
+
+---
+
+## 🧪 Testing Recommendations
+
+1. **Cold Start Flow:** Launch from a cold start repeatedly to verify app open ads respect the circuit breaker and never double-display.
+2. **Network Failure Drills:** Simulate offline/no-fill scenarios to confirm exponential backoff scheduling and circuit breaker logging.
+3. **Native Cache Coverage:** Toggle airplane mode after initial load to ensure fallback cached ads render across banners, medium, and large placements.
+4. **Billing Reconnections:** Force-stop Google Play services or revoke billing to validate manual `connectToGooglePlayBilling()` recovery paths.
+
+---
+
+AdManageKit v2.5.0 focuses on resiliency: tougher app open delivery, smarter native caching, and clearer billing controls so monetization keeps flowing even under adverse conditions.

package/content/docs/release-notes/RELEASE_NOTES_v2.6.0.md

@@ -0,0 +1,265 @@
+# AdManageKit v2.6.0 Release Notes
+
+**Release Date:** November 27, 2024
+
+## Highlights
+
+This release introduces **NativeTemplateView** - a unified native ad component supporting 17 different template styles, **Ad Loading Strategies** for fine-grained control over ad loading behavior, and comprehensive **Material 3 theme support** for automatic dark/light mode.
+
+---
+
+## New Features
+
+### NativeTemplateView
+
+A single, flexible component that replaces the need for multiple native ad views.
+
+**17 Template Styles:**
+
+| Standard Templates | Video Templates |
+|-------------------|-----------------|
+| card_modern | video_small |
+| material3 | video_medium |
+| minimal | video_large |
+| compact_horizontal | video_square |
+| full_width_banner | video_vertical |
+| list_item | video_fullscreen |
+| grid_card | |
+| featured | |
+| overlay_dark | |
+| story_style | |
+| magazine | |
+
+**Usage:**
+
+```xml
+<com.i2hammad.admanagekit.admob.NativeTemplateView
+    android:id="@+id/nativeTemplateView"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    app:adTemplate="material3" />
+```
+
+```kotlin
+// Programmatic usage
+nativeTemplateView.setTemplate(NativeAdTemplate.MAGAZINE)
+nativeTemplateView.loadNativeAd(activity, adUnitId)
+
+// With loading strategy override
+nativeTemplateView.loadNativeAd(activity, adUnitId, callback, AdLoadingStrategy.ONLY_CACHE)
+```
+
+**Features:**
+- XML attribute support (`app:adTemplate`)
+- Programmatic template switching
+- XML Preview in Android Studio designer
+- Shimmer loading animation
+- Integration with NativeAdManager caching
+
+---
+
+### Ad Loading Strategies
+
+Three strategies to control how ads are loaded and displayed:
+
+| Strategy | Behavior | Interstitial | App Open | Native |
+|----------|----------|:------------:|:--------:|:------:|
+| `ON_DEMAND` | Always fetch fresh ad with loading dialog | ✅ | ✅ | ✅ |
+| `ONLY_CACHE` | Instant display from cache, skip if unavailable | ✅ | ✅ | ❌ |
+| `HYBRID` | Check cache first, fetch if needed (recommended) | ✅ | ✅ | ✅ |
+
+> **Note:** `ONLY_CACHE` is only available for Interstitial and App Open ads. Native ads display inline with shimmer loading, so they always load content.
+
+**Configuration:**
+
+```kotlin
+AdManageKitConfig.apply {
+    interstitialLoadingStrategy = AdLoadingStrategy.HYBRID
+    appOpenLoadingStrategy = AdLoadingStrategy.HYBRID
+    nativeLoadingStrategy = AdLoadingStrategy.HYBRID // ON_DEMAND or HYBRID only
+}
+```
+
+See [Ad Loading Strategies Guide](docs/AD_LOADING_STRATEGIES.md) for detailed documentation.
+
+---
+
+### Material 3 Theme Support
+
+All templates now use Material 3 theme attributes for automatic dark/light mode support:
+
+- `?attr/colorSurface` - Background
+- `?attr/colorOnSurface` - Primary text
+- `?attr/colorOnSurfaceVariant` - Secondary text
+- `?attr/colorPrimary` - CTA button
+- `?attr/colorOutlineVariant` - Borders, dividers
+
+No configuration needed - templates automatically adapt to your app's theme.
+
+---
+
+### Enhanced Video Ad Support
+
+- **Minimum 120dp MediaView**: All templates support video ads with proper sizing
+- **6 Video-Optimized Templates**: Designed specifically for video ad content
+- **Proper Aspect Ratios**: Square, vertical, and fullscreen options
+
+---
+
+## Improvements
+
+### Smart View Handling
+
+- **GONE vs INVISIBLE**: Views now use `GONE` instead of `INVISIBLE` when content is missing, ensuring proper layout reflow
+- **Container Auto-Hide**: Advertiser container automatically hides when both advertiser name and star rating are null
+- **Proper Alignment**: RelativeLayout ensures correct alignment when optional items are missing
+
+### AdChoices Support
+
+- Automatic visibility handling for AdChoices view
+- Hidden by default, shown when ad has AdChoices content
+
+### Jetpack Compose Support
+
+New Compose components for NativeTemplateView and loading strategies:
+
+**NativeTemplateCompose:**
+```kotlin
+// Use any of 17 templates in Compose
+NativeTemplateCompose(
+    adUnitId = "ca-app-pub-xxx/yyy",
+    template = NativeAdTemplate.MATERIAL3,
+    loadingStrategy = AdLoadingStrategy.HYBRID,
+    onAdLoaded = { /* success */ }
+)
+
+// Convenience functions for common templates
+NativeCardModernCompose(adUnitId = adUnitId)
+NativeMaterial3Compose(adUnitId = adUnitId)
+NativeMinimalCompose(adUnitId = adUnitId)
+NativeListItemCompose(adUnitId = adUnitId)
+NativeMagazineCompose(adUnitId = adUnitId)
+NativeFeaturedCompose(adUnitId = adUnitId)
+NativeVideoMediumCompose(adUnitId = adUnitId)
+NativeVideoLargeCompose(adUnitId = adUnitId)
+```
+
+**Loading Strategy Support in Existing Compose Components:**
+```kotlin
+// All native ad Compose functions now support loadingStrategy parameter
+NativeBannerSmallCompose(
+    adUnitId = adUnitId,
+    loadingStrategy = AdLoadingStrategy.ONLY_CACHE
+)
+
+NativeBannerMediumCompose(
+    adUnitId = adUnitId,
+    loadingStrategy = AdLoadingStrategy.HYBRID
+)
+
+NativeLargeCompose(
+    adUnitId = adUnitId,
+    loadingStrategy = AdLoadingStrategy.ON_DEMAND
+)
+```
+
+### XML Preview
+
+- `NativeTemplateView` shows actual template layout in Android Studio designer
+- Preview displays placeholder data instead of shimmer
+- Helps visualize ad placement during development
+
+---
+
+## Bug Fixes
+
+### Splash Screen Offline Mode Fix
+
+**Issue:** App would get stuck on splash screen when device is offline
+- UMP consent request failed with "Error making request"
+- `canRequestAds()` returned `false`
+- No fallback path existed, causing the app to freeze
+
+**Fix:** Added fallback navigation when ads cannot be requested, allowing the app to proceed to the next screen in offline mode.
+
+### Native Ad View Fixes
+
+- Fixed duplicate `starRatingView` assignment
+- Removed unused `priceView` and `storeView` references
+- Fixed hardcoded "4.5" rating text in material3 template
+- Improved star rating check (now checks `starRating > 0`)
+
+---
+
+## Breaking Changes
+
+None. This release is fully backward compatible. Existing `NativeBannerSmall`, `NativeBannerMedium`, and `NativeLarge` views continue to work as expected.
+
+---
+
+## Migration Guide
+
+### Optional: Adopt NativeTemplateView
+
+```kotlin
+// Old way (still works)
+val nativeBannerMedium = NativeBannerMedium(context)
+nativeBannerMedium.loadNativeBannerAd(activity, adUnitId)
+
+// New unified approach
+val nativeTemplateView = NativeTemplateView(context)
+nativeTemplateView.setTemplate(NativeAdTemplate.CARD_MODERN)
+nativeTemplateView.loadNativeAd(activity, adUnitId)
+```
+
+### Optional: Configure Loading Strategies
+
+```kotlin
+// In Application.onCreate()
+AdManageKitConfig.apply {
+    interstitialLoadingStrategy = AdLoadingStrategy.HYBRID
+    appOpenLoadingStrategy = AdLoadingStrategy.HYBRID
+    nativeLoadingStrategy = AdLoadingStrategy.HYBRID
+}
+```
+
+---
+
+## Dependencies
+
+No dependency changes in this release.
+
+---
+
+## Documentation
+
+- [NativeTemplateView Guide](docs/NATIVE_TEMPLATE_VIEW.md)
+- [Ad Loading Strategies Guide](docs/AD_LOADING_STRATEGIES.md)
+- [README](README.md)
+
+---
+
+## Installation
+
+```groovy
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit:v2.6.0'
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-billing:v2.6.0'
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-core:v2.6.0'
+
+// For Jetpack Compose support
+implementation 'com.github.i2hammad.AdManageKit:ad-manage-kit-compose:v2.6.0'
+```
+
+---
+
+## What's Next
+
+- Additional template styles based on user feedback
+- Compose support for NativeTemplateView
+- Enhanced analytics for loading strategies
+
+---
+
+## Feedback
+
+For issues or feature requests, please open an issue on [GitHub](https://github.com/i2hammad/AdManageKit/issues).