monetization_kit 0.0.3

A complete Flutter monetization toolkit with AdMob ads, Firebase integration, native ads, custom ad widgets, analytics, remote config, and reusable utilities for building production-ready apps.

Monetization Kit

A powerful Flutter monetization toolkit that combines AdMob ads, Firebase services, force updates, feedback reporting, analytics, remote config, and reusable monetization utilities into a single package.

Development Status

monetization_kit is currently under active development. While the core features are stable, some APIs, implementations, and integrations may evolve in future releases.

Please thoroughly test ad flows, Firebase setup, native ad factories, force update behavior, and feedback systems before using this package in production environments.

---

Features

Ads

• Banner Ads

• Collapsible Banner Ads

• Native Ads

  • Small
  • Medium
  • Fullscreen
  • Custom Factory Support

• Native Popup Ads

• Fullscreen Native Timer Ads

• Interstitial Ads

• Rewarded Ads

• App Open Ads

• App Resume Ads

---

Smart Ad Systems

• Global Ad Controller
• Premium User Ad Disable
• Remote Ad Enable / Disable
• Ad Frequency Manager
• Placement Based Ad Logic
• Cooldown Management
• Retry System
• Auto Reload After Dismiss
• Ad Preload Manager
• Native Ad Cache System
• Default Shimmer Loading UI
• Smart Ad Fallback Logic

---

Firebase

• Firebase Core
• Firebase Analytics
• Firebase Crashlytics
• Firebase Remote Config

---

Updates

• Android In-App Update
• iOS App Store Update
• Force Update System
• Dynamic Update Dialog

---

Feedback System

• Discord Webhook Integration
• Modern Feedback Screen
• Screenshot Attachment Support
• Automatic Device Information Collection
• Automatic App Information Collection
• Custom Metadata Support

Collected automatically:

• App Name
• App Version
• Build Number
• Platform
• Device Model
• Device ID
• User Agent
• Timestamp

Users only need to provide:

• Feedback Description
• Optional Screenshot

---

Installation

dependencies:
  monetization_kit: ^0.0.3

---

Initialize

await MonetizationKit.initialize(
  config: MonetizationConfig(
    iosStoreId: 'YOUR_IOS_APP_STORE_ID',

    adUnitIds: AdUnitIds(
      androidBanner: 'ANDROID_BANNER_ID',
      iosBanner: 'IOS_BANNER_ID',

      androidInterstitial: 'ANDROID_INTERSTITIAL_ID',
      iosInterstitial: 'IOS_INTERSTITIAL_ID',

      androidRewarded: 'ANDROID_REWARDED_ID',
      iosRewarded: 'IOS_REWARDED_ID',

      androidAppOpen: 'ANDROID_APP_OPEN_ID',
      iosAppOpen: 'IOS_APP_OPEN_ID',

      androidNativeSmall: 'ANDROID_NATIVE_ID',
      iosNativeSmall: 'IOS_NATIVE_ID',

      androidNativeMedium: 'ANDROID_NATIVE_ID',
      iosNativeMedium: 'IOS_NATIVE_ID',

      androidNativeFull: 'ANDROID_NATIVE_ID',
      iosNativeFull: 'IOS_NATIVE_ID',
    ),
  ),
);

---

Banner Ads

const BannerAdWidget()

---

Native Ads

Small Native

const NativeAdWidget(
  type: NativeAdType.small,
)

Medium Native

const NativeAdWidget(
  type: NativeAdType.medium,
)

Full Native

const NativeAdWidget(
  type: NativeAdType.full,
)

---

Fullscreen Native Timer Ad

await FullscreenNativeTimerAd.show(
  context,
  duration: const Duration(
    seconds: 10,
  ),
);

---

Native Popup Ad

await NativePopupAd.show(
  context,
  type: NativeAdType.full,
);

---

Interstitial Ad

await InterstitialAdService.show(
  context: context,
);

---

Rewarded Ad

await RewardedAdService.show(
  onRewardEarned: (reward) {
    print(reward.amount);
  },
);

---

Premium User

Disable ads for premium users:

AdController.setPremiumUser(true);

---

Disable Ads

AdController.disableAds();

Enable again:

AdController.enableAds();

---

Force Update

await ForceUpdateService.checkForUpdate(
  context: context,
);

---

Analytics

Screen Tracking

await AnalyticsService.logScreenView(
  screenName: 'HomeScreen',
);

Custom Event

await AnalyticsService.logEvent(
  name: 'generate_image_clicked',
);

Ad Impression

await AnalyticsService.logAdImpression(
  adType: 'interstitial',
);

---

Feedback Screen

Navigator.push(
  context,
  MaterialPageRoute(
    builder: (_) => const FeedbackScreen(
      webhookUrl:
          'YOUR_DISCORD_WEBHOOK_URL',
    ),
  ),
);

---

Discord Feedback Service

final feedback =
    DiscordFeedbackService(
  webhookUrl:
      'YOUR_DISCORD_WEBHOOK_URL',
);

await feedback.sendFeedback(
  description:
      'App crashes on scanner screen',
);

---

Remote Config Keys

Key	Type
ads_enabled	bool
banner_enabled	bool
interstitial_enabled	bool
rewarded_enabled	bool
native_enabled	bool
app_open_enabled	bool
interstitial_click_count	int
force_update	bool
force_update_android_version	int
force_update_ios_version	int
maintenance_mode	bool

---

Native Ad Factory IDs

Default factory IDs:

customNativeAd
customNativeAdSmall
fullscreenNativeAd

---

Android Native Setup

Add native factories inside:

android/app/src/main/kotlin/

Add layouts inside:

android/app/src/main/res/layout/

Reference implementation:

example/native_reference/android/

---

iOS Native Setup

Add native factories inside:

ios/Runner/

Reference implementation:

example/native_reference/ios/

---

Included Systems

• Retry Config
• Auto Preload
• Auto Reload
• App Resume Ads
• Native Cache
• Frequency Logic
• Cooldown Logic
• Dynamic Update Dialog
• Smart Ad Fallbacks
• Feedback Reporting

---

Example

A complete example application is included inside:

example/

---

License

MIT License