メディエーションを設定する

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

前提条件

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

メディエーションを初めて使用する場合は、メディエーションの概要をご覧ください。 。

Google Mobile Ads Flutter Plugin を初期化する

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

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

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 flutterSdkPath = {
    def properties = new Properties()
    file("local.properties").withInputStream { properties.load(it) }
    def flutterSdkPath = properties.getProperty("flutter.sdk")
    assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
    return flutterSdkPath
}()

includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

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

メディエーション アダプタとその依存関係を 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(),
    );

メディエーションで使用するバナー広告ユニットについては、すべての第三者広告ソースの管理画面で更新を無効にしてください。これにより、更新の重複を防ぐことができます。アド マネージャーでもバナー広告ユニットの更新頻度に基づいて更新が行われるためです。

メディエーションでネイティブ広告を使用する

ネイティブ メディエーションを実装する際に考慮すべきベスト プラクティスをいくつかご紹介します。

ネイティブ広告の表示に関するポリシー
各広告ネットワークには独自のポリシーがあります。メディエーションを使用する場合でも、アプリは広告を提供したメディエーション ネットワークのポリシーを遵守する必要があります。

米国のプライバシー関連州法および GDPR

米国のプライバシー関連州法または一般データ保護規則(GDPR)を遵守する必要がある場合は、米国の州の規制の設定または GDPR の設定の手順に沿って、アド マネージャーの [プライバシーとメッセージ] の [米国の州] または [GDPR] の広告パートナー リストにメディエーション パートナーを追加します。これを行わないと、パートナーがアプリに広告を配信できなくなる可能性があります。

Google User Messaging Platform(UMP)SDK を使用して制限付きデータ処理 (RDP)を有効にし、GDPR の同意を取得する方法について詳しくは、こちらをご覧ください。