このガイドは、Flutter アプリを収益化するパブリッシャーを対象としています。
Flutter アプリに Google Mobile Ads SDK を統合する作業は、AdMob 広告を表示して収益を得るための第一歩です。統合が完了したら、広告フォーマットを選択して、詳細な実装手順を確認できます。
Flutter 向け Google Mobile Ads SDK は現在、バナー広告、インタースティシャル広告(全画面)、ネイティブ広告、リワード広告の読み込みと表示をサポートしています。
前提条件
- Flutter 1.22.0 以降
- Android
- Android Studio 3.2 以上
- Android API レベル 20 以降をターゲットとする
compileSdkVersion
を 28 以上に設定する
- iOS
- 有効なコマンドライン ツールを備えた最新バージョンの Xcode
- 推奨: AdMob アカウントを作成し、Android または iOS アプリ(あるいはその両方)を登録します。
Mobile Ads SDK をインポートする
- Flutter プロジェクトに Google Mobile Ads SDK for Flutter プラグインを追加します。
プラットフォーム固有の設定
Android
AndroidManifest.xml を更新する
AndroidManifest.xml
には AdMob アプリ ID を含める必要があります。そうしないと、アプリの起動時にクラッシュします。
com.google.android.gms.ads.APPLICATION_ID
という名前の <meta-data>
タグを追加して、AdMob アプリ ID(AdMob 管理画面で確認できる)をアプリの android/app/src/main/AndroidManifest.xml
ファイルに追加します。android:value
の場合は、次のように、ご自身の AdMob アプリ ID を引用符で囲んで挿入します。
<manifest>
<application>
<!-- Sample AdMob 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
キーと AdMob アプリ ID の文字列値(AdMob ウェブ インターフェースで確認)を追加します。
<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.
}
}
広告フォーマットの選択
Mobile Ads SDK をインポートしたら、広告を実装できます。AdMob にはさまざまな広告フォーマットが用意されており、アプリのユーザー エクスペリエンスに最適なものを選択できます。
バナー
デバイス画面の上部か下部に表示される長方形の広告です。アプリの操作中は画面に表示され続けますが、一定時間が経過すると自動的に更新されるよう設定できます。モバイル広告を初めてお使いの場合は、この広告から始めることをおすすめします。
インタースティシャル
ユーザーが閉じるまでアプリのインターフェース上に全画面表示される広告です。ゲームのレベルが切り替わる合間やタスクが完了した直後など、アプリの実行の流れが自然に一時停止するタイミングでの使用に適しています。
ネイティブ
アプリのデザインに合わせてカスタマイズできる広告です。広告の配置場所やスタイルを指定できるため、アプリのデザインに溶け込んだレイアウトが可能になります。
特典
短い動画を視聴したり体験プレイ広告やアンケートを操作したユーザーに特典を提供する広告。無料ユーザーの収益化に適しています。