전면 광고

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

이 가이드에서는 Google 모바일 광고 C++ SDK를 사용하여 전면 광고를 Android 및 iOS 앱에 통합하는 방법을 설명합니다.

기본 요건

항상 테스트 광고로 테스트

앱을 빌드하고 테스트할 때는 실제 프로덕션 광고가 아닌 테스트 광고를 사용해야 합니다. 이렇게 하지 않으면 계정이 정지될 수 있습니다.

테스트 광고를 로드하는 가장 쉬운 방법은 전면 광고 테스트 전용 광고 단위 ID를 사용하는 것으로, 기기 플랫폼에 따라 다릅니다.

  • Android: ca-app-pub-3940256099942544/1033173712
  • iOS: ca-app-pub-3940256099942544/4411468910

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

모바일 광고 SDK의 테스트 광고가 작동하는 방식을 자세히 알아보려면 테스트 광고를 참고하세요.

구현

전면 광고를 통합하는 기본 단계는 다음과 같습니다.

  1. 광고를 로드합니다.
  2. 콜백을 등록합니다.
  3. 광고를 표시하고 수명 주기 이벤트를 처리합니다.

InterstitialAd 구성

전면 광고는 InterstitialAd 객체에 표시되므로 전면 광고를 앱에 통합하는 첫 번째 단계는 InterstitialAd 객체를 만들고 초기화하는 것입니다.

  1. 앱의 C++ 코드에 다음 헤더를 추가합니다.

     #include "firebase/gma/interstial_ad.h"
    

  2. InterstitialAd 객체를 선언하고 인스턴스화합니다.

     firebase::gma::InterstitialAd* interstitial_ad;
     interstitial_ad = new firebase::gma::InterstitialAd();
    

  3. AdParent 뷰로의 상위 뷰 캐스트를 사용하여 InterstitialAd 인스턴스를 초기화합니다. 상위 뷰는 Android Activity의 JNI jobject 참조 또는 iOS UIView의 포인터입니다.

    // my_ad_parent is a jobject reference to an Android Activity or
    // a pointer to an iOS UIView.
    firebase::gma::AdParent ad_parent =
      static_cast<firebase::gma::AdParent>(my_ad_parent);
    firebase::Future<void> result = interstitial_ad->Initialize(ad_parent);
    
  4. Future를 변수로 유지하는 대신 InterstitialAd 객체의 InitializeLastResult()를 호출하여 초기화 작업의 상태를 주기적으로 확인할 수 있습니다. 이는 전역 게임 루프에서 초기화 프로세스를 추적하는 데 도움이 될 수 있습니다.

    // Monitor the status of the future in your game loop:
    firebase::Future<void> result = interstitial_ad->InitializeLastResult();
    if (result.status() == firebase::kFutureStatusComplete) {
      // Initialization completed.
      if(future.error() == firebase::gma::kAdErrorCodeNone) {
        // Initialization successful.
      } else {
        // An error has occurred.
      }
    } else {
      // Initialization on-going.
    }
    

firebase::Future 작업에 관한 자세한 내용은 Future를 사용하여 메서드 호출의 완료 상태 모니터링을 참고하세요.

광고 로드

광고는 InterstitialAd 객체의 LoadAd() 메서드를 사용하여 로드됩니다. 로드 메서드를 사용하려면 InterstitialAd 객체를 초기화해야 하고 광고 단위 ID와 AdRequest 객체가 있어야 합니다. 로드 작업의 상태와 결과를 모니터링하는 데 사용할 수 있는 firebase::Future가 반환됩니다.

다음 코드는 InterstitialAd가 초기화된 후 광고를 로드하는 방법을 보여줍니다.

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = interstitial_ad->LoadAd(interstitial_ad_unit_id, ad_request);

콜백 등록

전면 광고 표시 및 수명 주기 이벤트에 대한 알림을 받으려면 FullScreenContentListener 클래스를 확장해야 합니다. 맞춤 FullScreenContentListener 서브클래스는 InterstitialAd::SetFullScreenContentListener() 메서드를 통해 등록할 수 있으며 광고가 표시되는 데 성공하거나 실패했을 때뿐만 아니라 광고가 닫힐 때도 콜백을 수신합니다.

다음 코드는 클래스를 확장하고 이를 광고에 할당하는 방법을 보여줍니다.

  class ExampleFullScreenContentListener
      : public firebase::gma::FullScreenContentListener {

   public:
    ExampleFullScreenContentListener() {}

    void OnAdClicked() override {
      // This method is invoked when the user clicks the ad.
    }

    void OnAdDismissedFullScreenContent() override {
     // This method is invoked when the ad dismisses full screen content.
    }

    void OnAdFailedToShowFullScreenContent(const AdError& error) override {
      // This method is invoked when the ad failed to show full screen content.
      // Details about the error are contained within the AdError parameter.
    }

    void OnAdImpression() override {
      // This method is invoked when an impression is recorded for an ad.
    }

    void OnAdShowedFullScreenContent() override {
      // This method is invoked when the ad showed its full screen content.
    }
  };

  ExampleFullScreenContentListener* full_screen_content_listener =
    new ExampleFullScreenContentListener();
  interstitial_ad->SetFullScreenContentListener(full_screen_content_listener);

InterstitialAd는 일회용 객체입니다. 즉, 전면 광고가 표시된 후에는 다시 표시되지 않습니다. 이전 광고가 닫힌 직후에 다음 전면 광고가 로드되기 시작하도록 FullScreenContentListenerOnAdDismissedFullScreenContent() 메서드에서 다른 전면 광고를 로드하는 것이 좋습니다.

광고 표시

전면 광고는 앱 이용이 잠시 중단될 때 자연스럽게 표시되어야 합니다. 예를 들어 게임에서 다음 레벨로 넘어갈 때 또는 작업을 완료한 직후에 광고가 게재됩니다. FullScreenContentListener를 사용하여 광고가 전체 화면 콘텐츠를 표시한 시점을 확인할 수 있지만, Show()에서 반환하는 미래에는 광고가 성공적으로 표시된 시점도 알립니다.

  firebase::Future<void> result = interstitial_ad->Show();

권장사항

전면 광고가 앱에 적합한 광고 유형인지 고려하세요.
전면 광고는 자연스러운 전환 지점이 있는 앱에서 가장 효과적입니다. 앱 내에서 작업을 종료(예: 이미지 공유 또는 게임 레벨 완료)하면 이러한 지점이 생성됩니다. 이러한 경우는 사용자도 쉬어가는 지점으로 인식하므로 사용자 경험에 지장을 주지 않고 전면 광고를 부담 없이 표시할 수 있습니다. 앱 워크플로에서 전면 광고를 표시할 지점과 사용자의 반응 방식을 고려해야 합니다.
전면 광고를 게재할 때는 작업을 일시중지해야 합니다.
텍스트, 이미지, 동영상 등 전면 광고에는 다양한 유형이 있습니다. 앱에서 전면 광고를 표시할 때는 광고에서 리소스를 활용할 수 있도록 일부 리소스의 이용을 중지해야 합니다. 예를 들어 전면 광고를 표시하도록 호출할 때 앱에서 재생되는 오디오 출력을 일시중지해야 합니다. 사용자가 광고와의 상호작용을 마칠 때 호출되는 FullScreenContentListenerOnAdDismissedFullScreenContent 메서드에서 사운드 재생을 재개할 수 있습니다. 또한 광고가 표시되는 동안에는 강도 높은 계산 작업 (예: 게임 루프)을 잠시 중단하는 것이 좋습니다. 이렇게 하면 그래픽이 느려지거나 응답이 없는 현상 또는 동영상 끊김 등의 문제가 사라집니다.
적절한 로드 시간을 허용합니다.
전면 광고를 적절한 시점에 표시하는 것뿐 아니라 광고 로드가 너무 지연되지 않게 하는 것도 중요합니다. 광고를 표시하기 전에 미리 로드하면 앱에서 전면 광고를 완전히 로드된 상태로 표시할 수 있습니다.
광고를 과도하게 게재하면 안 됩니다.
앱에 전면 광고를 더 많이 게재할수록 수익이 늘어난다고 생각할 수 있겠지만, 이렇게 하면 사용자 경험이 악화되고 클릭률이 떨어지기도 합니다. 사용자의 원활한 앱 사용에 지장을 주지 않는 범위에서 게재 빈도를 조절하시기 바랍니다.
전면 광고를 게재할 때는 로드 완료 시점을 사용하지 마세요.
사용자 환경이 저하될 수 있습니다. 대신 광고를 미리 로드하세요.

추가 리소스

GitHub의 예제

Mobile Ads Garage 동영상 튜토리얼

성공사례

다음 단계