始める

このガイドは、Flutter アプリの収益化を希望するパブリッシャー様を対象としています。

アドマネージャー広告を表示して収益を得るための第一歩は、Google Mobile Ads SDK を Flutter アプリに統合することです。統合が完了したら、広告フォーマットを選択して詳細な実装手順を確認できます。

Flutter 向け Google Mobile Ads SDK は現在、バナー、インタースティシャル（全画面）、ネイティブ、リワード広告の読み込みと表示をサポートしています。

Prerequisites

Flutter 1.22.0 以降
Android
- Android Studio 3.2 以上
- ターゲット: Android API レベル 20 以降
- compileSdkVersion を 28 以上に設定します
iOS
- 有効なコマンドラインツールを備えた最新バージョンの Xcode

Mobile Ads SDK をインポートする

Flutter プロジェクトに Google Mobile Ads SDK for Flutter プラグインを追加します。

プラットフォーム固有の設定

Android

AndroidManifest.xml を更新する

アドマネージャーアプリ ID を AndroidManifest.xml に含める必要があります。そうしないと、アプリの起動時にクラッシュが発生します。

アドマネージャーのアプリ ID（アドマネージャー UI で識別）をアプリの android/app/src/main/AndroidManifest.xml ファイルに追加します。その際、com.google.android.gms.ads.APPLICATION_ID という名前の <meta-data> タグを追加します。アプリ ID はアドマネージャーの管理画面で確認できます。android:value の場合、次に示すようにご自身のアドマネージャーアプリ ID を引用符で囲んで挿入します。

<manifest>
    <application>
        <!-- Sample app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    <application>
<manifest>

Dart コードでプラグインを初期化するときに、同じ value を使用します。

AndroidManifest.xml の構成とアプリ ID の設定について詳しくは、Android のガイドをご覧ください。

iOS

Info.plist を更新する

アプリの ios/Runner/Info.plist ファイルで、GADApplicationIdentifier キーとアドマネージャーアプリ ID（アドマネージャー UI で確認）の文字列値を追加します。

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>

Dart コードでプラグインを初期化するときに、同じ値を渡す必要があります。

Info.plist の構成とアプリ ID の設定について詳しくは、iOS のガイドをご覧ください。

Mobile Ads SDK を初期化する

広告を読み込む前に、アプリで MobileAds.instance.initialize() を呼び出して Mobile Ads SDK を初期化します。これにより、SDK が初期化され、初期化が完了すると（または 30 秒のタイムアウト後に）終了する Future が返されます。この処理は 1 回だけ行います（アプリを実行する直前に行うことが理想的です）。

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:flutter/material.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  MobileAds.instance.initialize();

  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  MyAppState createState() => MyAppState();
}

class MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    // Load ads.
  }
}