앱 오프닝 광고

Dart

AdWhaleAppOpenAd({
    required this.placementUid,
    required this.adLoadCallback
  });

파라미터 타입	파라미터 값
String placementUid	발급받은 placementUid
AdWhaleAppOpenAdLoadCallback adLoadCallback	앱 오프닝 미디에이션 광고 호출 콜백 리스너

AdWhaleAppOpenAdLoadCallback

리스너 구성	설명
onAppOpenAdLoaded	광고 로드시
onAppOpenAdLoadFailed	광고 로드 실패
onAppOpenAdShowed	광고 화면 랜딩
onAppOpenAdShowFailed	광고 화면 랜딩 실패
onAppOpenAdDismissed	광고 화면 종료
onAppOpenAdClicked	광고 화면 클릭

onAppOpenAdLoadFailed: (code, message) // 미디에이션 앱 오프닝 광고요청 실패 시

파라미터 타입	파라미터 값
code	광고로드 결과 코드 (200 또는 300)
message	초기화 결과 메시지 ("Internal error occurred..." 또는 "Mediation network error occurred...")

AdWhaleAppOpenAd.load() // 미디에이션 앱 오프닝 광고로드

AdWhaleAppOpenAd.show() // 미디에이션 앱 오프닝 광고로드 후 표시할 때 호출

앱 오프닝 구현 예제

void _loadAppOpen() {
    _appOpenAd?.dispose();
    _appOpenAd = null;
    _isAppOpenLoaded = false;

    _appOpenAd =
        AdWhaleAppOpenAd(
            placementUid: '발급받은 placementUid',
            adLoadCallback: AdWhaleAppOpenAdLoadCallback(
              onAppOpenAdLoaded: () {
                debugPrint('GuideSamplePage AppOpen onAdLoaded');
                _isAppOpenLoaded = true;
                if (mounted) {
                  ScaffoldMessenger.of(context).showSnackBar(
                    const SnackBar(content: Text('앱오프닝 광고 로드 완료')),
                  );
                }
              },
              onAppOpenAdLoadFailed: (code, message) {
                debugPrint(
                  'GuideSamplePage AppOpen onAdLoadFailed: $code, $message',
                );
                _appOpenAd = null;
                _isAppOpenLoaded = false;
              },
              onAppOpenAdShowed: () {
                debugPrint('GuideSamplePage AppOpen onAdShowed');
              },
              onAppOpenAdShowFailed: (code, message) {
                debugPrint(
                  'GuideSamplePage AppOpen onAdShowFailed: $code, $message',
                );
                _appOpenAd = null;
                _isAppOpenLoaded = false;
              },
              onAppOpenAdDismissed: () {
                debugPrint('GuideSamplePage AppOpen onAdDismissed');
              },
              onAppOpenAdClicked: () {
                debugPrint('GuideSamplePage AppOpen onAdClicked');
              },
            ),
          )
    _appOpenAd!.load();
  }
  void _showAppOpen() {
    if (_appOpenAd == null || !_isAppOpenLoaded) {
      if (mounted) {
        ScaffoldMessenger.of(
          context,
        ).showSnackBar(const SnackBar(content: Text('앱오프닝 광고를 먼저 로드해 주세요.')));
      }
      return;
    }
    _appOpenAd!.show();
    _isAppOpenLoaded = false;
    _appOpenAd = null;
  }