Flutter용 배너 통합

필수 조건

• 레벨플레이 플러그인을 앱에 올바르게 통합했는지 확인합니다.
• 레벨플레이 초기화 API 사용하여 SDK를 초기화해야 합니다.
• 레벨플레이 대시보드에서 AdUnitID를 찾습니다.

배너 광고 오브젝트 생성 및 크기 설정

onInitSuccess

final GlobalKey<LevelPlayBannerAdViewState> _bannerKey = GlobalKey<LevelPlayBannerAdViewState>();@override위젯 빌드(BuildContext 컨텍스트) {     return SizedBox(          width: _adSize.width.toDouble(),          height: _adSize.height.toDouble(),          child: LevelPlayBannerAdView(            key: _bannerKey,            adUnitId: [YOUR_AD_UNIT_ID],            adSize: [YOUR_AD_SIZE],            listener: [YOUR_LISTENER],            placementName: [YOUR_PLACEMENT], // 선택 사항            onPlatformViewCreated:[YOUR_LOAD_BANER_METHOD] // 선택 사항          ),        );}

배너 크기

• 화면 너비에 맞게 조정되는 적응적 광고 크기(권장): 이 옵션은 기기 유형에 따라 배너 또는 LEADERBOARD를 반환하므로 "SMART" 통합을 대체합니다. 적응적 기능을 지원하는 네트워크(Google, Yandex)는 최적화 로직에 따라 높이를 반환합니다.

  LevelPlayAdSize adSize = await LevelPlayAdSize.createAdaptiveAdSize();

• 고정 너비 광고 크기를 사용한 적응적 광고 크기: 이 옵션을 사용하면 특정 너비를 설정할 수 있습니다. 적응적 배너 기능을 지원하는 네트워크(Google, Yandex)는 제공된 너비를 기반으로 최적화 로직을 기반으로 높이를 반환합니다. 다른 모든 네트워크는 제공된 너비에 따라 폴백 크기(배너 또는 리더보드)를 반환합니다.

  LevelPlayAdSize adSize = await LevelPlayAdSize.createAdaptiveAdSize(width: 400);

• 특정 배너 크기: 이 옵션을 사용하면 배너 크기를 구체적으로 설정할 수 있습니다. 배너, 대형, 중형.

  LevelPlayAdSize adSize = LevelPlayAdSize.MEDIUM_RECTANGLE;

Placements

loadAd

배너 리스너 설정

• 권장되는 베스트 프랙티스는 배너 광고를 로드하기 전에 리스너를 설정하는 것입니다.
• 각 배너 광고에는 자체 리스너 구현이 있어야 합니다.
• 콜백은 메인 스레드 실행됩니다.

/** 배너 로드된 후 호출됩니다. @param adInfo 광고 정보입니다. */ @overridevoid onAdLoaded(LevelPlayAdInfo adInfo) {}/** 배너 로드에 실패한 후 호출됩니다. @param error 오류에 대한 정보입니다. */ @overridevoid onAdLoadFailed(LevelPlayAdError error) {}/** 화면이 표시되었음을 알립니다. @param adInfo 광고 정보입니다. */ @overridevoid onAdDisplayed(LevelPlayAdInfo adInfo) {}/** 화면 표시 실패를 알립니다. @param adInfo 광고 정보입니다. @param error 오류에 대한 정보입니다.  */ @overridevoid onAdDisplayFailed(LevelPlayAdInfo adInfo, LevelPlayAdError error) {}/** 사용자 배너 광고를 클릭할 때 호출합니다. @param adInfo 광고 정보입니다. */ @overridevoid onAdClicked(LevelPlayAdInfo adInfo) {}/** 광고가 전체 화면으로 열립니다. @param adInfo 광고 정보입니다. */ @overridevoid onAdExpanded(LevelPlayAdInfo adInfo) {}/** 광고가 원본의, 원래의 크기로 복원됩니다. @param adInfo 광고 정보입니다. */ @overridevoid onAdCollapsed(LevelPlayAdInfo adInfo) {}/** 사용자 광고를 누르고 앱을 벗어났습니다. @param adInfo 광고 정보입니다. */ @overridevoid onAdLeftApplication(LevelPlayAdInfo adInfo) {}

배너 광고 로드

// Load the banner ad _bannerKey.currentState?.loadAd();

onPlatformViewCreated is called

배너 새로고침 일시 정지 및 재개

• pauseAutoRefresh

  : 배너 광고의 자동 새로고침을 일시 중지합니다.

• resumeAutoRefresh

  : 배너 광고가 일시 중지된 후 배너 광고의 자동 새로고침을 재개합니다.

// Pause refresh _bannerKey.currentState?.pauseAutoRefresh(); // Resume refresh _bannerKey.currentState?.resumeAutoRefresh();

배너 광고 삭제

destroy

LevelPlayBannerAdView

_bannerKey.currentState?.destroy();

배너 광고의 전체 구현 예시

  // Start of the widget...  final _bannerKey = GlobalKey<LevelPlayBannerAdViewState>();  final adSize = LevelPlayAdSize. 배너;  @override  위젯 빌드(BuildContext 컨텍스트) {    return SizedBox(      너비: adSize.width.toDouble(), // 실제 배너 레이아웃 너비 크기를 가져옵니다      height: adSize.height.toDouble(), // 실제 배너 레이아웃 높이 크기를 가져옵니다      child: LevelPlayBannerAdView(        key: _bannerKey,        adUnitId: 'YOUR_AD_UNIT_ID',        adSize: adSize,        listener: 이,        placementName: 'YOUR_PLACEMENT',        onPlatformViewCreated: () {	// In this implementation we call loadAd on the key,            // it is also possible to store the LevelPlayBannerAdView widget            // in a variable and call loadAd on it as described above in the docs.          _bannerKey.currentState?.loadAd();         },      ),    );  }  @override  void onAdClicked(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdCollapsed(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdDisplayFailed(LevelPlayAdInfo adInfo, LevelPlayAdError error) {    // Implement your logic here...  }  @override  void onAdDisplayed(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdExpanded(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdLeftApplication(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdLoadFailed(LevelPlayAdError error) {    // Implement your logic here...  }  @override  void onAdLoaded(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  // End of widget...

레벨플레이 Mediation 데모 앱

다음 단계

• Mediation Networks 추가
• 보상형 광고
• 인터스티셜 광고
• 네이티브 광고