전면 광고

전면 광고는 호스트 앱의 인터페이스를 완전히 덮는 전체 화면 광고입니다. 일반적으로 활동이 바뀌는 시점 또는 게임에서 다음 레벨로 넘어갈 때처럼 앱 이용이 잠시 중단될 때 자연스럽게 광고가 게재됩니다. 앱에 전면 광고가 표시되면 사용자는 광고를 탭하여 도착 페이지로 이동하거나 광고를 닫고 앱으로 돌아갈 수 있습니다.

이 가이드에서는 전면 광고를 Flutter 앱에 통합하는 방법을 설명합니다.

항상 테스트 광고로 테스트

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

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

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

광고 로드

InterstitialAd를 로드하려면 adUnitId, AdRequestInterstitialAdLoadCallback이 필요합니다. 다음 예에서는 전면 광고를 인스턴스화합니다.

InterstitialAd.load(
  adUnitId: '<ad unit id>',
  request: AdRequest(),
  adLoadCallback: InterstitialAdLoadCallback(
    onAdLoaded: (InterstitialAd ad) {
      // Keep a reference to the ad so you can show it later.
      this._interstitialAd = ad;
    },
    onAdFailedToLoad: (LoadAdError error) {
      print('InterstitialAd failed to load: $error');
    },
  ));

전면 광고 이벤트

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

interstitialAd.fullScreenContentCallback = FullScreenContentCallback(
  onAdShowedFullScreenContent: (InterstitialAd ad) =>
     print('%ad onAdShowedFullScreenContent.'),
  onAdDismissedFullScreenContent: (InterstitialAd ad) {
    print('$ad onAdDismissedFullScreenContent.');
    ad.dispose();
  },
  onAdFailedToShowFullScreenContent: (InterstitialAd ad, AdError error) {
    print('$ad onAdFailedToShowFullScreenContent: $error');
    ad.dispose();
  },
  onAdImpression: (InterstitialAd ad) => print('$ad impression occurred.'),
);

전면 광고 게재

InterstitialAd는 모든 앱 콘텐츠 위에 오버레이로 표시되며 정적으로 배치되므로 Flutter 위젯 트리에 추가할 수 없습니다. show()를 호출하여 광고 게재 시점을 선택할 수 있습니다.

myInterstitial.show();

show()가 호출되면 이 방식으로 게재된 Ad는 프로그래매틱 방식으로 닫을 수 없으며 사용자가 입력해야 닫을 수 있습니다. InterstitialAd는 한 번만 게재할 수 있습니다. 이후 표시되는 호출에서 onAdFailedToShowFullScreenContent를 트리거합니다.

광고에서 load()를 호출한 후 액세스할 필요가 없어지면 dispose()를 호출해야 합니다. dispose()를 호출하기 가장 좋은 시점은 FullScreenContentCallback.onAdDismissedFullScreenContentFullScreenContentCallback.onAdFailedToShowFullScreenContent 콜백이 실행될 때입니다.

준비가 끝났습니다. 이제 앱에서 전면 광고를 표시할 수 있습니다.

다음 단계