multi_ads_sdk 1.0.10 
multi_ads_sdk: ^1.0.10 copied to clipboard
A comprehensive Flutter SDK for multi-provider ads (AdMob, AdX, Facebook) with single-load and single-show pattern. Built with clean architecture principles and supports Android & iOS.
import 'dart:io' show Platform;
import 'package:flutter/material.dart';
import 'package:multi_ads_sdk/multi_ads_sdk.dart';
/// Test ad unit IDs (AdMob). Replace with your own for production.
/// https://developers.google.com/admob/android/test-ads
const _kTestAdUnitIds = (
interstitial: 'ca-app-pub-3940256099942544/1033173712',
rewarded: 'ca-app-pub-3940256099942544/5224354917',
rewardedInterstitial: 'ca-app-pub-3940256099942544/5354046379',
appOpen: 'ca-app-pub-3940256099942544/9257395921',
banner: 'ca-app-pub-3940256099942544/6300978111',
native: 'ca-app-pub-3940256099942544/2247696110',
);
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'Multi Ads SDK Example',
theme: ThemeData(
colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
useMaterial3: true,
),
home: const AdsExamplePage(),
);
}
}
class AdsExamplePage extends StatefulWidget {
const AdsExamplePage({super.key});
@override
State<AdsExamplePage> createState() => _AdsExamplePageState();
}
class _AdsExamplePageState extends State<AdsExamplePage> {
AdProviderType _selectedProvider = AdProviderType.admob;
bool _isInitialized = false;
String _statusMessage = 'Not initialized';
@override
void initState() {
super.initState();
_initializeSDK();
}
Future<void> _initializeSDK() async {
try {
await MultiAdsManager.init(_selectedProvider);
setState(() {
_isInitialized = true;
_statusMessage = 'Initialized with ${_selectedProvider.name}';
});
_log('SDK initialized with ${_selectedProvider.name}');
} catch (e) {
setState(() {
_statusMessage = 'Initialization failed: $e';
});
_log('Initialization error: $e');
}
}
void _log(String message) {
debugPrint('[Example] $message');
}
Future<void> _loadInterstitial() async {
try {
_log('Loading interstitial...');
// Use test ad unit ID - replace with your own
await MultiAdsManager.loadInterstitial(
adUnitId: _kTestAdUnitIds.interstitial,
);
setState(() {
_statusMessage = 'Interstitial loaded';
});
_log('Interstitial loaded successfully');
} catch (e) {
setState(() {
_statusMessage = 'Failed to load interstitial: $e';
});
_log('Error loading interstitial: $e');
}
}
Future<void> _showInterstitial() async {
try {
_log('Showing interstitial...');
await MultiAdsManager.showInterstitial();
_log('Interstitial shown');
} catch (e) {
setState(() {
_statusMessage = 'Failed to show interstitial: $e';
});
_log('Error showing interstitial: $e');
}
}
Future<void> _loadRewarded() async {
try {
_log('Loading rewarded ad...');
// Use test ad unit ID - replace with your own
await MultiAdsManager.loadRewarded(
adUnitId: _kTestAdUnitIds.rewarded,
);
setState(() {
_statusMessage = 'Rewarded ad loaded';
});
_log('Rewarded ad loaded successfully');
} catch (e) {
setState(() {
_statusMessage = 'Failed to load rewarded: $e';
});
_log('Error loading rewarded: $e');
}
}
Future<void> _showRewarded() async {
try {
_log('Showing rewarded ad...');
await MultiAdsManager.showRewarded(
onReward: () {
_log('User earned reward!');
setState(() {
_statusMessage = 'Reward earned!';
});
},
);
_log('Rewarded ad shown');
} catch (e) {
setState(() {
_statusMessage = 'Failed to show rewarded: $e';
});
_log('Error showing rewarded: $e');
}
}
Future<void> _loadAppOpen() async {
try {
_log('Loading app open ad...');
// Use test ad unit ID - replace with your own
await MultiAdsManager.loadAppOpen(
adUnitId: _kTestAdUnitIds.appOpen,
);
setState(() {
_statusMessage = 'App open ad loaded';
});
_log('App open ad loaded successfully');
} catch (e) {
setState(() {
_statusMessage = 'Failed to load app open: $e';
});
_log('Error loading app open: $e');
}
}
Future<void> _showAppOpen() async {
try {
_log('Showing app open ad...');
await MultiAdsManager.showAppOpen();
_log('App open ad shown');
} catch (e) {
setState(() {
_statusMessage = 'Failed to show app open: $e';
});
_log('Error showing app open: $e');
}
}
Future<void> _loadBanner() async {
try {
_log('Loading banner ad...');
// Use test ad unit ID - replace with your own
await MultiAdsManager.loadBanner(
adUnitId: _kTestAdUnitIds.banner,
);
setState(() {
_statusMessage = 'Banner ad loaded';
});
_log('Banner ad loaded successfully');
} catch (e) {
setState(() {
_statusMessage = 'Failed to load banner: $e';
});
_log('Error loading banner: $e');
}
}
Future<void> _showBanner() async {
try {
_log('Showing banner ad...');
await MultiAdsManager.showBanner();
_log('Banner ad shown');
} catch (e) {
setState(() {
_statusMessage = 'Failed to show banner: $e';
});
_log('Error showing banner: $e');
}
}
Future<void> _loadRewardedInterstitial() async {
try {
_log('Loading rewarded interstitial...');
// Use test ad unit ID - replace with your own
await MultiAdsManager.loadRewardedInterstitial(
adUnitId: _kTestAdUnitIds.rewardedInterstitial,
);
setState(() {
_statusMessage = 'Rewarded interstitial loaded';
});
_log('Rewarded interstitial loaded successfully');
} catch (e) {
setState(() {
_statusMessage = 'Failed to load rewarded interstitial: $e';
});
_log('Error loading rewarded interstitial: $e');
}
}
Future<void> _showRewardedInterstitial() async {
try {
_log('Showing rewarded interstitial...');
await MultiAdsManager.showRewardedInterstitial(
onReward: () {
_log('User earned reward from rewarded interstitial!');
setState(() {
_statusMessage = 'Reward earned!';
});
},
);
_log('Rewarded interstitial shown');
} catch (e) {
setState(() {
_statusMessage = 'Failed to show rewarded interstitial: $e';
});
_log('Error showing rewarded interstitial: $e');
}
}
Future<void> _loadNative() async {
try {
_log('Loading native ad...');
// Use test ad unit ID - replace with your own
await MultiAdsManager.loadNative(
adUnitId: _kTestAdUnitIds.native,
);
setState(() {
_statusMessage = 'Native ad loaded';
});
_log('Native ad loaded successfully');
} catch (e) {
setState(() {
_statusMessage = 'Failed to load native: $e';
});
_log('Error loading native: $e');
}
}
Future<void> _showNative() async {
try {
_log('Showing native ad...');
await MultiAdsManager.showNative();
setState(() => _statusMessage = 'Native ad shown');
_log('Native ad shown');
} catch (e) {
final msg = e.toString();
setState(() {
_statusMessage =
msg.contains('not loaded') || msg.contains('AD_NOT_LOADED')
? 'Load the native ad first, then tap Show.'
: 'Failed to show native: $e';
});
_log('Error showing native: $e');
}
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
backgroundColor: Theme.of(context).colorScheme.inversePrimary,
title: const Text('Multi Ads SDK Example'),
),
body: Column(
children: [
Expanded(
child: SingleChildScrollView(
padding: const EdgeInsets.all(16.0),
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
// Status Card
Card(
child: Padding(
padding: const EdgeInsets.all(16.0),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
'Status',
style: Theme.of(context).textTheme.titleLarge,
),
const SizedBox(height: 8),
Text(
_statusMessage,
style: Theme.of(context).textTheme.bodyMedium,
),
const SizedBox(height: 16),
// Provider Selection
Text(
'Provider',
style: Theme.of(context).textTheme.titleMedium,
),
const SizedBox(height: 8),
SegmentedButton<AdProviderType>(
segments: const [
ButtonSegment<AdProviderType>(
value: AdProviderType.admob,
label: Text('AdMob'),
),
ButtonSegment<AdProviderType>(
value: AdProviderType.adx,
label: Text('AdX'),
),
ButtonSegment<AdProviderType>(
value: AdProviderType.facebook,
label: Text('Facebook'),
),
],
selected: {_selectedProvider},
onSelectionChanged:
(Set<AdProviderType> newSelection) {
setState(() {
_selectedProvider = newSelection.first;
_isInitialized = false;
_statusMessage = 'Reinitializing...';
});
_initializeSDK();
},
),
],
),
),
),
const SizedBox(height: 16),
// Interstitial Ads
_buildSection(
context,
'Interstitial Ads',
[
_buildButton(
context,
'Load Interstitial',
_loadInterstitial,
enabled: _isInitialized,
),
_buildButton(
context,
'Show Interstitial',
_showInterstitial,
enabled: _isInitialized,
),
],
),
const SizedBox(height: 16),
// Rewarded Ads
_buildSection(
context,
'Rewarded Ads',
[
_buildButton(
context,
'Load Rewarded',
_loadRewarded,
enabled: _isInitialized,
),
_buildButton(
context,
'Show Rewarded',
_showRewarded,
enabled: _isInitialized,
),
],
),
const SizedBox(height: 16),
// Rewarded Interstitial Ads
_buildSection(
context,
'Rewarded Interstitial Ads',
[
_buildButton(
context,
'Load Rewarded Interstitial',
_loadRewardedInterstitial,
enabled: _isInitialized,
),
_buildButton(
context,
'Show Rewarded Interstitial',
_showRewardedInterstitial,
enabled: _isInitialized,
),
],
),
const SizedBox(height: 16),
// App Open Ads
_buildSection(
context,
'App Open Ads',
[
_buildButton(
context,
'Load App Open',
_loadAppOpen,
enabled: _isInitialized,
),
_buildButton(
context,
'Show App Open',
_showAppOpen,
enabled: _isInitialized,
),
],
),
const SizedBox(height: 16),
// Banner Ads – banner appears in the view at bottom of screen
_buildSection(
context,
'Banner Ads',
[
Text(
'Banner appears in the slot at the bottom of the screen.',
style: Theme.of(context).textTheme.bodySmall,
),
const SizedBox(height: 8),
_buildButton(
context,
'Load Banner',
_loadBanner,
enabled: _isInitialized,
),
_buildButton(
context,
'Show Banner',
_showBanner,
enabled: _isInitialized,
),
],
),
const SizedBox(height: 16),
// Native Ads – Small and Medium layouts
_buildSection(
context,
'Native Ads',
[
Text(
'Load then Show. Same ad appears in both slots: Small (compact row) and Medium (with media, body, full CTA).',
style: Theme.of(context).textTheme.bodySmall,
),
const SizedBox(height: 12),
Text(
'Small',
style: Theme.of(context).textTheme.titleSmall,
),
const SizedBox(height: 4),
_buildNativeAdSlot(
context, 'multi_ads_sdk/native_small', 128),
const SizedBox(height: 12),
Text(
'Medium',
style: Theme.of(context).textTheme.titleSmall,
),
const SizedBox(height: 4),
_buildNativeAdSlot(
context, 'multi_ads_sdk/native_medium', 350),
const SizedBox(height: 12),
_buildButton(
context,
'Load Native',
_loadNative,
enabled: _isInitialized,
),
_buildButton(
context,
'Show Native',
_showNative,
enabled: _isInitialized,
),
],
),
],
),
),
),
// Fixed banner slot at bottom (same view as above, keeps banner visible)
_buildBannerAdView(context),
],
),
);
}
/// Banner ad view: platform view on Android and iOS, placeholder on other platforms.
Widget _buildBannerAdView(BuildContext context) {
const height = 50.0;
if (Platform.isAndroid) {
return const SizedBox(
height: height,
child: AndroidView(
viewType: 'multi_ads_sdk/banner',
layoutDirection: TextDirection.ltr,
creationParams: null,
creationParamsCodec: null,
),
);
}
if (Platform.isIOS) {
return const SizedBox(
height: height,
child: UiKitView(
viewType: 'multi_ads_sdk/banner',
layoutDirection: TextDirection.ltr,
creationParams: null,
creationParamsCodec: null,
),
);
}
return Container(
height: height,
alignment: Alignment.center,
decoration: BoxDecoration(
color: Theme.of(context).colorScheme.surfaceContainerHighest,
borderRadius: BorderRadius.circular(8),
),
child: Text(
'Banner ad (Android / iOS only)',
style: Theme.of(context).textTheme.bodySmall,
),
);
}
/// Native ad slot: platform view for small or medium layout.
Widget _buildNativeAdSlot(
BuildContext context,
String viewType,
double height,
) {
if (Platform.isAndroid) {
return SizedBox(
height: height,
child: AndroidView(
viewType: viewType,
layoutDirection: TextDirection.ltr,
creationParams: null,
creationParamsCodec: null,
),
);
}
if (Platform.isIOS) {
return SizedBox(
height: height,
child: UiKitView(
viewType: viewType,
layoutDirection: TextDirection.ltr,
creationParams: null,
creationParamsCodec: null,
),
);
}
return Container(
height: height,
alignment: Alignment.center,
decoration: BoxDecoration(
color: Theme.of(context).colorScheme.surfaceContainerHighest,
borderRadius: BorderRadius.circular(8),
),
child: Text(
'Native ad (Android / iOS only)',
style: Theme.of(context).textTheme.bodySmall,
),
);
}
Widget _buildSection(
BuildContext context,
String title,
List<Widget> children,
) {
return Card(
child: Padding(
padding: const EdgeInsets.all(16.0),
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
Text(
title,
style: Theme.of(context).textTheme.titleLarge,
),
const SizedBox(height: 16),
...children,
],
),
),
);
}
Widget _buildButton(
BuildContext context,
String label,
VoidCallback onPressed, {
bool enabled = true,
}) {
return Padding(
padding: const EdgeInsets.only(bottom: 8.0),
child: FilledButton(
onPressed: enabled ? onPressed : null,
child: Text(label),
),
);
}
}Metadata
1
likes
150
points
318
downloads
Publisher
unverified uploader
Weekly Downloads
Metadata
A comprehensive Flutter SDK for multi-provider ads (AdMob, AdX, Facebook) with single-load and single-show pattern. Built with clean architecture principles and supports Android & iOS.
Repository (GitHub)
View/report issues
Documentation
License
MIT (license)
Dependencies
More
Packages that depend on multi_ads_sdk
Packages that implement multi_ads_sdk
