このページは Cloud Translation API によって翻訳されました。

概要

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

アドマネージャー広告を表示して収益を得るための第一歩は、Flutter アプリへの Google Mobile Ads SDK の統合です。このガイドでは、この追加方法について解説します。統合が完了したら、広告フォーマットを選択して、具体的な広告の実装手順を確認します。

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

前提条件

Flutter 1.22.0 以降
Android
- Android Studio 3.2 以上
- ターゲット: Android API レベル 20 以降
- compileSdkVersion を 28 以降に設定していること
iOS
- 最新バージョンの command-line を有効にするツールを使用した Xcode の最新バージョン

Mobile Ads SDK をインポートする

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

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

Android

AndroidManifest.xml を更新する

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

名前が com.google.android.gms.ads.APPLICATION_ID の <meta-data> タグを追加して、アドマネージャーアプリ ID（アドマネージャーの管理画面で確認）をアプリの android/app/src/main/AndroidManifest.xml ファイルに追加します。アプリ ID はアドマネージャーの UI で確認できます。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.
  }
}