보상형 전면 광고

플랫폼 선택: Android iOS Unity Flutter

보상형 전면 광고는 자연스러운 앱 전환 중에 자동으로 게재되는 광고에 대해 보상을 제공하는 인센티브형 광고 형식입니다. 보상형 광고와 달리 사용자는 수신 동의하지 않고도 보상형 전면 광고를 볼 수 있습니다. 이 가이드에서는 AdMob의 보상형 전면 광고를 Flutter 앱에 통합하는 방법을 설명합니다.

기본 요건

  • Flutter 플러그인 1.1.0 이상
  • 시작하기의 모든 단계를 완료합니다. Google 모바일 광고 Flutter 플러그인을 Flutter 앱에 이미 가져온 상태여야 합니다.

항상 테스트 광고로 테스트

앱을 제작하고 테스트할 때는 운영 중인 실제 광고 대신 테스트 광고를 사용하세요. 이렇게 하지 않으면 계정이 정지될 수 있습니다.

테스트 광고를 로드하는 가장 쉬운 방법은 보상형 전면 광고 테스트를 위한 전용 테스트 광고 단위 ID를 사용하는 것입니다.

Android

ca-app-pub-3940256099942544/5354046379

iOS

ca-app-pub-3940256099942544/6978759866

테스트 광고 단위는 모든 요청에 대해 테스트 광고를 반환하도록 구성되며 코딩, 테스트, 디버깅 중에 앱에서 자유롭게 사용할 수 있습니다. 앱을 게시하기 전에 이 ID를 자체 광고 단위 ID로 바꿔야 합니다.

광고 로드

다음 예에서는 보상형 전면 광고를 로드합니다.

RewardedInterstitialAd.load(
  adUnitId: "_adUnitId",
  request: const AdRequest(),
  rewardedInterstitialAdLoadCallback: RewardedInterstitialAdLoadCallback(
    onAdLoaded: (RewardedInterstitialAd ad) {
      // Called when an ad is successfully received.
      debugPrint('Ad was loaded.');
      // Keep a reference to the ad so you can show it later.
      _rewardedInterstitialAd = ad;
    },
    onAdFailedToLoad: (LoadAdError error) {
      // Called when an ad request failed.
      debugPrint('Ad failed to load with error: $error');
    },
  ),
);
rewarded_interstitial_ad_snippets.dart

_adUnitId를 실제로 사용할 광고 단위 ID로 바꿉니다.

보상형 전면 광고 이벤트

FullScreenContentCallback을 사용하면 광고 게재, 광고 닫기와 같은 수명 주기 이벤트를 수신 대기할 수 있습니다. 이러한 이벤트에 대한 알림을 받으려면 광고를 게재하기 전에 RewardedInterstitialAd.fullScreenContentCallback을 설정하세요. 이 예에서는 각 메서드를 구현하고 콘솔에 메시지를 기록합니다.

ad.fullScreenContentCallback = FullScreenContentCallback(
  onAdShowedFullScreenContent: (ad) {
    // Called when the ad showed the full screen content.
    debugPrint('Ad showed full screen content.');
  },
  onAdFailedToShowFullScreenContent: (ad, err) {
    // Called when the ad failed to show full screen content.
    debugPrint('Ad failed to show full screen content with error: $err');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdDismissedFullScreenContent: (ad) {
    // Called when the ad dismissed full screen content.
    debugPrint('Ad was dismissed.');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdImpression: (ad) {
    // Called when an impression occurs on the ad.
    debugPrint('Ad recorded an impression.');
  },
  onAdClicked: (ad) {
    // Called when a click is recorded for an ad.
    debugPrint('Ad was clicked.');
  },
);
rewarded_interstitial_ad_snippets.dart

광고 표시

RewardedInterstitialAd는 모든 앱 콘텐츠 위에 오버레이로 표시되며 정적으로 배치되므로 Flutter 위젯 트리에 추가할 수 없습니다. show()를 호출하여 광고 게재 시점을 선택할 수 있습니다. RewardedInterstitialAd.show()는 사용자가 보상을 획득할 때 호출되는 OnUserEarnedRewardCallback을 사용합니다. 이 이벤트를 구현하고 사용자에게 광고 시청에 대한 보상을 제공해야 합니다.

_rewardedInterstitialAd?.show(
  onUserEarnedReward: (AdWithoutView view, RewardItem rewardItem) {
    debugPrint('Reward amount: ${rewardItem.amount}');
  },
);
main.dart

show()가 호출되면 이 방식으로 게재된 Ad는 프로그래매틱 방식으로 삭제할 수 없으며 사용자가 직접 삭제해야 합니다. RewardedInterstitialAd는 한 번만 게재할 수 있습니다. 이후 게재를 위한 호출은 onAdFailedToShowFullScreenContent를 트리거합니다.

광고에 대한 액세스가 더 이상 필요하지 않으면 광고를 삭제해야 합니다. dispose()를 호출하기 가장 좋은 시점은 FullScreenContentCallback.onAdDismissedFullScreenContent 및 FullScreenContentCallback.onAdFailedToShowFullScreenContent 콜백이 실행될 때입니다.

[선택사항] 서버 측 확인(SSV) 콜백 검사

서버 측 확인 콜백에서 추가 데이터가 필요한 앱은 보상형 광고의 맞춤 데이터 기능을 사용해야 합니다. 보상형 광고 객체에 설정된 모든 문자열 값은 SSV 콜백의 custom_data 쿼리 매개변수에 전달됩니다. 맞춤 데이터 값이 설정되지 않은 경우 custom_data 쿼리 매개변수 값은 SSV 콜백에 표시되지 않습니다.

다음 코드 샘플은 보상형 전면 광고가 로드된 후 SSV 옵션을 설정하는 방법을 보여줍니다.

RewardedInterstitialAd.load(
  adUnitId: "_adUnitId",
  request: AdRequest(),
  rewardedInterstitialAdLoadCallback: RewardedInterstitialAdLoadCallback(
    onAdLoaded: (ad) {
      ServerSideVerificationOptions _options =
          ServerSideVerificationOptions(
              customData: 'SAMPLE_CUSTOM_DATA_STRING');
      ad.setServerSideOptions(_options);
      _rewardedInterstitialAd = ad;
    },
    onAdFailedToLoad: (error) {},
  ),
);
rewarded_interstitial_ad_snippets.dart

SAMPLE_CUSTOM_DATA_STRING을 맞춤 데이터로 바꿉니다.

GitHub의 전체 예

보상형 전면 광고