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

メディエーション

このガイドでは、メディエーションアダプタを Flutter アプリに統合する方法について説明します。

前提条件

広告フォーマットにメディエーションを統合するには、その広告フォーマットをあらかじめアプリに組み込んでおく必要があります。

メディエーションを初めてご利用の場合は、メディエーションの概要を読む。

Mobile Ads SDK を初期化する

クイックスタートガイドでは、Mobile Ads SDK を初期化する方法を説明します。この初期化の呼び出し中に、メディエーションアダプタも初期化されます。最初の広告リクエストにすべての広告ネットワークが参加できるようにするため、広告を読み込むのは初期化が完了するまで待ってからにしてください。

次のサンプルコードは、広告リクエストを行う前に各アダプタの初期化状況を確認する方法を示しています。

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

Gradle の設定を更新する（Android のみ）

プラグインの Android API を使用できるように、settings.gradle ファイルに次の行を追加します。

def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

パートナーネットワークの依存関係を追加する

メディエーションアダプターとその依存関係を Android プロジェクトと iOS プロジェクトに追加する必要があります。これらは、Android ではアプリレベルの build.gradle ファイルを更新し、iOS では Podfile を更新することで追加できます。Google は、Android と iOS の両方に対応したオープンソースのアダプタを GitHub で公開しています。

各パートナーネットワークの Android と iOS のドキュメントで、アプリにアダプターを追加する方法について詳細なガイダンスをご覧ください。

広告を読み込んだ広告ネットワークアダプタのクラスを確認する

次のサンプルコードは、バナー広告の広告ネットワーククラス名をログに記録する方法を示しています。

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );