flutter_native_admob_ads #

A specialized Flutter plugin for AdMob Native Ads that gives you 100% control over the UI. Build your ads using standard Flutter widgets while maintaining native tracking and click handling.

Why this plugin? #

Standard AdMob plugins often force you to use rigid "Native Templates." This plugin gives you full control:

1. Total UI Freedom: You build the entire ad layout using standard Flutter widgets (Text, Image, etc.).
2. Native Tracking: The plugin manages a hidden native view to ensure AdMob correctly registers impressions.
3. Manual Trigger: You decide exactly which interaction triggers the ad click by calling a simple method.

Use Cases #

• High-Fidelity Branding: Match your ad's style perfectly with your app's design system.
• Complex Layouts: Build ad layouts that are difficult or impossible to achieve with standard native templates.
• Performance: Avoid the overhead of multiple heavy PlatformViews for small list-item ads.

Installation #

Add this to your pubspec.yaml:

dependencies:
  flutter_native_admob_ads: ^1.1.0

Platform Setup #

Android #

Add your AdMob App ID to android/app/src/main/AndroidManifest.xml:

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

iOS #

Add your AdMob App ID to ios/Runner/Info.plist:

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy</string>

Usage #

1. Load an Ad #

import 'package:flutter_native_admob_ads/flutter_native_admob_ads.dart';
import 'package:flutter_native_admob_ads/native_ad_models.dart';

final _plugin = FlutterNativeAdmobAds();

final ads = await _plugin.loadNativeAd(FlutterNativeAdOptions(
  adId: 'ca-app-pub-3940256099942544/2247696110', // Test ID
  isTesting: true,
  adsCount: 1,
));

if (ads.isNotEmpty) {
  final ad = ads.first;
  // Use ad.headline, ad.body, ad.icon, ad.cover, etc.
}

2. Trigger a Click #

When the user taps your custom CTA button in Flutter:

onTap: () async {
  await _plugin.triggerNativeAd(ad.id);
}

3. Handle AdChoices #

To comply with AdMob policies, you should always include an AdChoices icon that links to the adChoicesUrl:

if (ad.adChoicesUrl != null)
  GestureDetector(
    onTap: () => launchUrl(Uri.parse(ad.adChoicesUrl!)),
    child: const Icon(Icons.info_outline, size: 14),
  );

4. Cleanup #

To prevent memory leaks, always dispose of the ad when the widget is destroyed:

@override
void dispose() {
  _plugin.disposeNativeAd(ad.id);
  super.dispose();
}

Limitations #

• Only Static Native Ads: This plugin currently only supports static assets (images and text). Native Video ads are not supported yet.
• Only Native Ads: This plugin does not support Banners, Interstitials, or Rewarded ads.
• Manual Compliance: Since you are building the UI, you are responsible for including the "Ad" attribution and "AdChoices" icon to comply with AdMob policies.

License #

MIT