5-2. 전면 광고 for Flutter

화면 전체를 덮는 형태의 광고입니다.

사전 작업

05. Flutter-Plugin Guide

전면 광고 인스턴스 생성

 ...
 OAMInterstitial _oamInterstitial = OAMInterstitial()
 ...

전면 광고 요청

전면 광고의 load()를 요청합니다.

매개변수로는 placementId와 InterstitialCallBackListener을 받습니다.

전면광고의 placementId는 ONE AdMax 콘솔에서 생성이 가능합니다.

oamInterstitial.load(
 placementId: interstitialPlacementId,
);

과도한 광고 요청은 차단 사유가 되니 주의해주세요!

전면 광고 이벤트 리스너 설정

전면 광고를 불러올 때 발생하는 이벤트에 대한 리스너를 설정합니다. 제공되는 리스너와 구현 예시는 다음과 같습니다.

_oamInterstitial.load(
  callback: InterstitialCallBackListener(
    onLoaded: onLoaded,
    onLoadFailed: onLoadFailed,
    onOpened: onOpened,
    onOpenFailed: onOpenFailed,
    onClosed: onClosed,
    onClicked: onClicked,
  ),
);

ONE AdMax SDK Error Codes

전면 광고 노출

전면 광고를 보여줍니다.

_oamInterstitial.show();

전면 광고 커스텀 옵션

변수	설명
backgroundColor	배경색 및 투명도 변경. Color 값
isHideCloseButton	우측 상단 닫기 버튼 노출 여부 설정. default : false
closeBtnMargin.left	닫기 버튼 좌측 마진. default : -28dp
closeBtnMargin.top	닫기 버튼 상단 마진. default : 20dp
closeBtnMargin.right	닫기 버튼 우측 마진. default : 20dp
closeBtnMargin.bottom	닫기 버튼 하단 마진. default : 0dp
isDisableBackButton	백키 종료 사용 안 함. deault : false
EndingText.isShow	종료 메시지 노출 여부. default : false
EndingText.text	종료 메시지. default : "뒤로 가기를 한 번 더 누르시면 종료됩니다."
EndingText.size	종료 메시지 size. default : 11sp
EndingText.color	종료 메시지 test color. default : white
EndingText.align	종료 메시지 gravity. default : RIGHT

전면 광고 샘플 코드

OAMInterstitial _oamInterstitial = OAMInterstitial()

_oamInterstitial.load(
  placementId: interstitialPlacementId,
  callback: InterstitialCallBackListener(
    onLoaded: onLoaded,
    onLoadFailed: onLoadFailed,
    onOpened: onOpened,
    onOpenFailed: onOpenFailed,
    onClosed: onClosed,
    onClicked: onClicked,
  ),
);

_oamInterstitial.interstitialConfig.isHideCloseButton = false;
_oamInterstitial.interstitialConfig.backgroundColor = Colors.red;
_oamInterstitial.interstitialConfig.endingText = const EndingText(
  'Sample Text',
  12,
  Colors.white,
  TextAlign.center,
  true,
);

_oamInterstitial.interstitialConfig.closeBtnMargin = const CloseBtnMargin(
  top: 10,
  left: 10,
  right: 10,
  bottom: 10,
);

_oamInterstitial.show();