ads_kit_max 0.1.1

AppLovin MAX implementation of the ads_kit AdProvider contract. Wraps applovin_max — no ads_kit-facing API here ever leaks a MAX SDK type.

example/example.dart

// AppLovin MAX behind ads_kit: register the provider once, supply its keys,
// then show ads through AdManager.I — app code never touches the MAX SDK
// directly.
import 'package:ads_kit/ads_kit.dart';
import 'package:ads_kit_max/ads_kit_max.dart';
import 'package:flutter/material.dart';

/// Serves a fixed config so this example runs without a Firebase project.
/// A real app passes no `configSource` and lets [AdManager.boot] read the
/// `ads_config` Firebase Remote Config parameter instead.
final class InlineAdConfigSource implements AdConfigSource {
  const InlineAdConfigSource(this.config);

  final Map<String, dynamic> config;

  @override
  Future<Map<String, dynamic>?> fetchRawConfig() async => config;
}

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  AdManager.register('max', () => MaxAdProvider());

  await AdManager.boot(
    configSource: const InlineAdConfigSource({
      'active_provider': 'max',
      'fallback_provider': 'noop',
      'formats_enabled': ['rewarded', 'banner'],
    }),
    // MAX refuses child-directed users; AdManager then falls back to
    // `fallback_provider`.
    consent: const AdConsent(gdprConsent: true),
    // Placeholders: use your own SDK key and ad unit ids. `_android`/`_ios`
    // suffixes resolve to the running platform, and the remote config's
    // `providers.max` block can override any of them.
    providerExtras: {
      'max': {
        'sdk_key': 'YOUR_SDK_KEY',
        'rewarded_ad_unit_id_android': 'YOUR_ANDROID_REWARDED_AD_UNIT_ID',
        'rewarded_ad_unit_id_ios': 'YOUR_IOS_REWARDED_AD_UNIT_ID',
        'banner_ad_unit_id_android': 'YOUR_ANDROID_BANNER_AD_UNIT_ID',
        'banner_ad_unit_id_ios': 'YOUR_IOS_BANNER_AD_UNIT_ID',
      },
    },
  );

  runApp(const ExampleApp());
}

class ExampleApp extends StatelessWidget {
  const ExampleApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('ads_kit_max')),
        body: Center(
          child: FilledButton(
            onPressed: () async {
              // Resolves once the ad is dismissed, so the reward can be
              // granted right here.
              final result = await AdManager.I.showRewarded(
                placement: 'extra_life',
              );
              if (result.rewardEarned) debugPrint('grant the extra life');
            },
            child: const Text('Watch an ad for an extra life'),
          ),
        ),
        bottomNavigationBar: SafeArea(
          child: AdManager.I.banner(
            size: AdBannerSize.banner,
            placement: 'home',
          ),
        ),
      ),
    );
  }
}