📦 ToponAdPlugin (Flutter)

A lightweight Flutter plugin to integrate TopOn Ads using method channels.
This plugin provides simple methods to initialize the SDK and display Interstitial, Rewarded, Native, Banner, and Splash ads in your Flutter apps.

🔗 GitHub: https://github.com/jaiswal4sudeep/ToponAdPlugin

---

🚀 Features

• ✅ Initialize TopOn SDK
• ✅ Load & Show Interstitial Ads
• ✅ Load & Show Rewarded Ads
• ✅ Load Native Ads and render custom Flutter widgets
• ✅ Load Banner Ads
• ✅ Load Splash Ads
• ✅ Listen to Ad Events from Native Side

---

📦 Installation

Add this plugin to your pubspec.yaml:

dependencies:
  topon_ad_plugin:
    git:
      url: https://github.com/jaiswal4sudeep/ToponAdPlugin.git

---

🛠️ Android Setup

1. Add TopOn SDK dependencies:
   Follow the official TopOn Android integration guide.

2. Update your AndroidManifest.xml:

   • Add necessary permissions
   • Include required meta-data tags from TopOn

3. Add Proguard Rules (if using Proguard)

---

🧑‍💻 Usage

0️⃣ Set Up Ad Event Listeners (Optional)

Call this once during app startup to listen to ad lifecycle events from native code.

ToponAdPlugin.setUpListeners((event, args) {
  print('Ad Event: \$event, Data: \$args');
});

---

1️⃣ Initialize SDK

final success = await ToponAdPlugin.initializeSdk(
  appId: 'your_app_id',
  appKey: 'your_app_key',
);

---

2️⃣ Interstitial Ads

await ToponAdPlugin.loadInterstitialAd(placementId: 'your_interstitial_id');
final shown = await ToponAdPlugin.showInterstitialAd();

---

3️⃣ Rewarded Ads

await ToponAdPlugin.loadRewardedAd(placementId: 'your_rewarded_id');
final shown = await ToponAdPlugin.showRewardedAd();

---

4️⃣ Native Ads (Self-Rendering)

await ToponAdPlugin.loadNativeAd(placementId: 'your_native_id');
final nativeAdInfo = await ToponAdPlugin.getNativeAdInfo();
if (nativeAdInfo != null) {
  print(nativeAdInfo.title);
  // Render your custom native ad widget
}

---

5️⃣ Banner Ads

await ToponAdPlugin.loadBannerAd(
  placementId: 'your_banner_id',
  position: BannerPosition.bottom,
);

⚡ Note: Banner ads auto-render at top or bottom based on the provided position.

---

6️⃣ Splash Ads

await ToponAdPlugin.loadSplashAd(placementId: 'your_splash_id');

---

🧪 Testing Tips

• Use real appId, appKey, and placementId from the TopOn dashboard.
• Always test ad behavior on a real device (not emulator).

---

📃 License

MIT License. Free to use, modify, and distribute.