name: admob-flutter description: FlutterアプリにAdMob広告を実装するスキル。ネイティブ広告、バナー広告、インタースティシャル広告の実装手順をカバー。子供向けアプリのCOPPA準拠設定も含む。

AdMob Flutter 実装スキル

FlutterアプリにGoogle AdMob広告を実装するための手順書。

公式ドキュメント

前提条件

AdMobアカウント作成済み
アプリ登録済み → アプリID取得
広告ユニット作成済み → 広告ユニットID取得

テスト用ID（開発中は必ずこれを使用）

種類	テスト用ID
アプリID	`ca-app-pub-3940256099942544~3347511713`
バナー	`ca-app-pub-3940256099942544/6300978111`
インタースティシャル	`ca-app-pub-3940256099942544/1033173712`
リワード	`ca-app-pub-3940256099942544/5224354917`
ネイティブ	`ca-app-pub-3940256099942544/2247696110`

⚠️ 本番IDでテストクリックするとアカウントBANの可能性あり

実装手順

Step 1: パッケージ追加

pubspec.yaml:

dependencies:
  google_mobile_ads: ^5.1.0

flutter pub get

Step 2: Android設定

android/app/src/main/AndroidManifest.xml の <application> 内に追加:

<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="YOUR_APP_ID"/>

開発中はテスト用アプリID、リリース時に本番IDに変更。

Step 3: 広告サービス作成

lib/core/services/ad_service.dart にシングルトンの広告サービスを作成する。本番/テストIDの自動切り替え、COPPA準拠設定を含む。

実装の詳細: references/ad-service.dart

Step 4: main.dartで初期化

import 'core/services/ad_service.dart';

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

  // 子供向けアプリの場合 childDirected: true
  await AdService().initialize(childDirected: true);

  runApp(const MyApp());
}

ネイティブ広告の実装

lib/core/widgets/native_ad_widget.dart にStatefulWidgetとして実装。NativeTemplateStyleでデザインをカスタマイズし、ロード完了後に表示する。

実装の詳細: references/native-ad-widget.dart

使用例

Column(
  children: [
    // コンテンツ
    Text('ここにコンテンツ'),

    // 広告
    const NativeAdWidget(templateType: TemplateType.medium),
  ],
)

バナー広告の実装

StatefulWidgetとしてバナー広告を実装。AdSize.bannerサイズで表示し、ロード失敗時は自動でdisposeする。

実装の詳細: references/banner-ad-widget.dart

インタースティシャル広告の実装

画面遷移時などに全画面広告を表示するサービス。表示後に次の広告を自動プリロードする。

実装の詳細: references/interstitial-ad-service.dart

子供向けアプリの設定（COPPA準拠）

13歳未満が使用する可能性があるアプリでは必須:

await MobileAds.instance.updateRequestConfiguration(
  RequestConfiguration(
    tagForChildDirectedTreatment: TagForChildDirectedTreatment.yes,
    maxAdContentRating: MaxAdContentRating.g, // 全年齢向け
  ),
);

リリース前チェックリスト

AndroidManifest.xml のアプリIDを本番用に変更
コード内の広告ユニットIDが本番用になっていることを確認
kReleaseMode で正しく切り替わることを確認
子供向けアプリの場合、COPPA設定が有効か確認
実機でテスト広告が表示されることを確認

⚠️ よくある落とし穴

本番IDでのテストクリックによるアカウントBAN: 開発中に本番の広告ユニットIDを使ってクリックテストをするとAdMobアカウントが停止される可能性がある。開発中は必ずテスト用IDを使い、kReleaseModeでの切り替えが正しく動作することをリリース前に確認する
広告が表示されない（新規ユニット）: 新しく作成した広告ユニットはAdMob側での反映に数時間かかることがある。まずテスト用IDで表示を確認し、本番IDへの切り替えは反映待ちを考慮してスケジュールする
初期化忘れによるクラッシュ: MobileAds.instance.initialize() の呼び出しを忘れると実行時クラッシュする。AndroidManifest.xmlへのアプリID設定も必須。main.dartでWidgetsFlutterBinding.ensureInitialized()の後に初期化すること
dispose忘れによるメモリリーク: 広告ウィジェットのdispose()でNativeAd/BannerAdを破棄しないとメモリリークが発生する。StatefulWidgetのdispose()メソッドで必ず_nativeAd?.dispose()等を呼ぶこと
リリースビルドでテスト広告しか出ない: AndroidManifest.xmlのアプリIDとコード内の広告ユニットIDの両方を本番用に変更する必要がある。片方だけ変更しても正しく動作しない

参考リンク

2026-01-29 作成