🚀 cas_ad_manager

A simple and reusable ad manager built around the Clever Ads Solutions (CAS) Flutter SDK. This manager handles initialization, loading, and displaying of interstitial and rewarded ads with automatic reloads and error handling.

---

✨ Features

• ✅ Initializes CAS SDK with one method
• 🚀 Supports Interstitial and Rewarded ads
• 🔁 Automatically reloads ads after each show
• ⚙️ Custom callbacks for ad closed, rewarded, or failed events
• 🧠 Prevents duplicate ad shows (uses internal flags)

---

📦 Installation

1️⃣ Add Dependency

In your pubspec.yaml file:

dependencies:
  flutter:
    sdk: flutter
  clever_ads_solutions: ^3.5.0 # check for latest version

Then run:

flutter pub get

---

⚙️ Setup

Step 1: Android Configuration

Ensure you follow the CAS Android integration guide to update your AndroidManifest.xml and other project files.

Step 2: iOS Configuration

Ensure platform-specific setup for iOS is also complete (App Tracking Transparency, Ad Network IDs, etc.)

---

🚀 Usage

Step 1: Create Config

final casConfig = CasConfig(
  casId: 'YOUR_CAS_ID',
  testMode: true, // Enable for testing
  debugMode: true, // Logs info in console
);

Step 2: Initialize in main.dart

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await CasAdManager().initialize(casConfig);
  runApp(MyApp());
}

---

Step 3: Show Interstitial Ad

CasAdManager().showInterstitial(onFinished: () {
  print('Interstitial closed.');
});

---

Step 4: Show Rewarded Ad

CasAdManager().showRewardedAd(
  onCompleted: () {
    print('User earned reward.');
  },
  onFailed: () {
    print('Rewarded ad failed or not ready.');
  },
);

---

🧠 Internals

CasAdManager Singleton

Handles:

• Initialization (only once)
• Loading interstitial and rewarded ads
• Showing ads with state checks
• Resetting and reloading ads after interaction

CasConfig

class CasConfig {
  final String casId;
  final bool testMode;
  final bool debugMode;

  const CasConfig({
    required this.casId,
    this.testMode = false,
    this.debugMode = false,
  });
}

Custom Callbacks

Located in cas_callbacks.dart:

• CasInterstitialCallback
• CasRewardedCallback

These manage ad events and reset flags or reload ads accordingly.

---

❓ FAQ

Q: Does it handle ad loading automatically?
A: Yes, ads are loaded on initialization and reloaded after each display.

Q: What happens if the ad isn’t ready?
A: The fallback logic triggers your onFinished or onFailed callbacks, and it tries to reload the ad.

Q: Can I use it for banner/native ads?
A: No, this package is focused on interstitial and rewarded ads only.

---

🧪 Optional: Manual Reload

CasAdManager().loadAll(); // Reload both ad types manually

---

📱 Platform Support

Platform	Supported
Android	✅
iOS	✅
Web	❌
Desktop	❌

---