미디에이션

이 가이드에서는 미디에이션 어댑터를 Flutter 앱과 통합하는 방법을 설명합니다.

기본 요건

광고 형식에 적합한 미디에이션 기능을 통합하기 전에 해당 광고 형식을 앱에 통합해야 합니다.

미디에이션을 처음 사용하는 경우 미디에이션 소개를 읽어보세요.

Google 모바일 광고 SDK 초기화

빠른 시작 가이드에서는 Google 모바일 광고 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 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(),
    );