applovin_admob_sdk 1.0.2

Dual-provider ad SDK for Flutter (AdMob + AppLovin MAX) with built-in safety throttle, VIP bypass, RouteAware banner lifecycle management, and animated TopToast feedback.

ad_sdk

Dual-provider Flutter Ad SDK — switch between AdMob and AppLovin MAX with a single line of config. Built-in anti-fraud safety layer, route-aware banner, and VIP device bypass.

---

Features

Feature	Description
Dual Provider	Switch AdMob ↔ AppLovin with AdProvider.admob / AdProvider.appLovin
Ad Types	App Open, Banner, Interstitial, Rewarded
Safety Layer	Throttle, session/hourly/daily caps, CTR fraud detection, progressive cooldown
RouteAware Banner	Banner automatically pauses/resumes on navigation
VIP Bypass	Specific devices (by GAID) never see ads — for owners/testers
Shimmer Placeholder	Beautiful loading state while banner fills

---

Installation

dependencies:
  ad_sdk: ^1.0.0

Android Setup (required)

android/app/src/main/AndroidManifest.xml:

<!-- AdMob -->
<meta-data
  android:name="com.google.android.gms.ads.APPLICATION_ID"
  android:value="ca-app-pub-xxxxxxxxxxxxxxxx~xxxxxxxxxx"/>

<!-- AppLovin -->
<meta-data
  android:name="applovin.sdk.key"
  android:value="YOUR_APPLOVIN_SDK_KEY"/>

<!-- GAID permission (required for VIP bypass + test device detection) -->
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

---

Quick Start

1. Initialize in main.dart

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await AdManager().initialize(
    config: AdConfig(
      provider: AdProvider.appLovin,          // or AdProvider.admob
      appLovin: AppLovinConfig(
        sdkKey: 'YOUR_SDK_KEY',
        bannerId: 'YOUR_BANNER_ID',
        interstitialId: 'YOUR_INTER_ID',
        appOpenId: 'YOUR_APP_OPEN_ID',
        rewardedId: 'YOUR_REWARDED_ID',
      ),
      // Optional: devices that never see ads (owners/testers)
      vipDeviceGaids: ['your-device-gaid'],
    ),
    onComplete: (success, gaid) {
      print('Ad SDK ready. GAID: $gaid');
    },
  );

  runApp(MyApp());
}

2. Add observers to your app

MaterialApp(
  navigatorObservers: [adRouteObserver, AdScreenRouteLogger()],
  // ...
)

3. Extend AdScreen on screens with ads

class HomeScreen extends AdScreen {
  const HomeScreen({super.key});

  @override
  State<HomeScreen> createState() => _HomeScreenState();
}

class _HomeScreenState extends AdScreenState<HomeScreen> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Column(
        children: [
          buildBanner(),          // ← banner at top or bottom
          Expanded(child: /* ... your content */),
        ],
      ),
    );
  }
}

4. Show Interstitial

showInterstitialAd(onDone: (wasShown) {
  // navigate or do action here
});

5. Show Rewarded

showRewardedAd(onEarnedReward: (earned) {
  if (earned) unlockPremiumFeature();
});

6. Show App Open (splash)

AdManager().showAppOpenAd(
  bypassSafety: true,     // true on splash, false on resume
  onAdDismiss: (shown) => navigateToHome(),
);

---

Advanced Configuration

Custom Safety Parameters

AdConfig(
  provider: AdProvider.appLovin,
  appLovin: AppLovinConfig(...),
)
// AdSafetyParams currently use defaults — customizable via AdSafetyConfig.init()

AdMob Provider

AdConfig(
  provider: AdProvider.admob,
  admob: AdMobConfig(
    bannerId: kDebugMode
      ? 'ca-app-pub-3940256099942544/6300978111'
      : 'ca-app-pub-xxxxxxxx/xxxxxxxx',
    interstitialId: '...',
    appOpenId: '...',
    rewardedId: '...',
    testDeviceIds: ['YOUR_TEST_DEVICE_HASH'],
  ),
)

---

License

MIT © 2026 — see LICENSE