GMA Next-Gen SDK をインストールする

Android の改善されたレイテンシと安定性を反映するには、 GMA Next-Gen SDK を使用します。このガイドでは、Google Mobile Ads Flutter Plugin を構成して、Android 向けに GMA Next-Gen SDK を使用する方法について説明します。

前提条件

先に進む前に、次のことを実施してください。

Android Gradle の設定を構成する

Android で GMA Next-Gen SDK を使用するには、Gradle 構成を更新する必要があります。

環境宣言を使用して実行する

Android アプリのビルドと実行時に GMA Next-Gen SDK を使用するには、 USE_NEXT_GEN_SDK 環境宣言を true 値に設定する必要があります。

アプリをビルドまたは実行するたびに、次の操作を行います。

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 SDKGMA Next-Gen SDK の両方をサポートする必要がある場合は、android/app/build.gradle ファイルで環境宣言に基づいて依存関係を条件付きで定義するように構成できます。

Google Mobile Ads Flutter Plugin には、 サンプルアプリの build.gradle ファイルにサンプル構成が用意されています。