Android の改善されたレイテンシと安定性を反映するには、GMA Next-Gen SDK を使用します。このガイドでは、Google Mobile Ads Flutter Plugin を設定して、Android 向け GMA Next-Gen SDK を使用する方法について説明します。
前提条件
続行する前に、次のことを実施してください。
- Google Mobile Ads Flutter Plugin バージョン 9.0.0 以降をインストールします。
- Google Mobile Ads Flutter Plugin を設定します。
- Flutter プロジェクトがあること。
Android Gradle の設定を構成する
Android で GMA Next-Gen SDK を使用するには、Gradle 構成を更新する必要があります。
- 最小 Android API レベルとコンパイル Android API レベルを設定します。
- メディエーションを使用する場合は、移行手順に沿って
com.google.android.gmsモジュールを除外し、クラスの重複エラーが発生しないようにしてください。
環境宣言を使用して実行
Android アプリのビルドと実行時に GMA Next-Gen SDK を使用するには、true 値に設定された USE_NEXT_GEN_SDK 環境宣言セットを指定する必要があります。
アプリをビルドまたは実行するたびに、次のコマンドを実行します。
flutter run --dart-define USE_NEXT_GEN_SDK=true
IDE 構成で実行する
統合開発環境(IDE)を使用してアプリを実行する場合は、コマンドラインを使用してフラグを渡す代わりに、起動構成で環境宣言を構成できます。
たとえば、これらの変数を JSON ファイルで定義して、IDE の設定に追加できます。詳細については、環境宣言の指定をご覧ください。
ネイティブ広告テンプレートを更新する
ネイティブ広告テンプレートを使用している場合は、GMA Next-Gen SDK をサポートするために次の更新を行います。
NativeAdFactory パッケージのインポートを更新
Android の場合は、NativeAdFactory クラスのインポート ステートメントを更新します。
Java
// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory;
// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory;
Kotlin
// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory
// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory
ネイティブ広告ビューのレイアウト XML ビューを更新する
ネイティブ広告のレイアウト XML ファイルで、ネイティブ広告ビュー クラスを更新します。
<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />
<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />
両方の設定の依存関係を構成する
プロジェクトで Google Mobile Ads SDK と GMA Next-Gen SDK の両方をサポートする必要がある場合は、環境宣言に基づいて依存関係を条件付きで定義するように android/app/build.gradle ファイルを構成できます。
Google Mobile Ads Flutter Plugin は、サンプルアプリの build.gradle ファイルでサンプル構成を提供します。