このページは 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 のみ）

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

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 を更新することで追加できます。GitHub には、Android 用と iOS 用のオープンソースアダプタがあります。

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

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

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

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