전면 광고

<ph type="x-smartling-placeholder">


전면 광고는 광고가 표시될 때까지 앱의 인터페이스를 가리는 전체 화면 광고입니다. 볼 수 있습니다. 일반적으로 자연스러운 전환 지점에 게재됩니다. 활동 사이 또는 다음 활동으로 바뀌는 일시중지와 같은 앱의 흐름에 따라 있습니다. 앱에서 전면 광고를 표시할 때 사용자는 광고를 탭하여 도착 페이지로 이동하거나 광고를 닫았다가 하세요. 우수사례

이 가이드에는 전면 광고를 Android 및 iOS 앱에 통합하는 방법이 나와 있습니다. Google 모바일 광고 C++ SDK를 사용하는 것이 좋습니다

기본 요건

항상 테스트 광고로 테스트

앱을 빌드하고 테스트할 때는 만들 수 있습니다. 이렇게 하지 않으면 계정이 정지될 수 있습니다.

테스트 광고를 로드하는 가장 쉬운 방법은 전면 광고는 기기 플랫폼에 따라 다릅니다.

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

모든 요청에 대해 테스트 광고를 반환하도록 특별히 구성되었으며, 코딩, 테스트 및 디버깅 중에 앱에서 자유롭게 사용할 수 있습니다. 단, 광고를 게시하기 전에 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. 다음으로의 상위 뷰 캐스트를 사용하여 InterstitialAd 인스턴스를 초기화합니다. AdParent 유형. 상위 뷰는 Android의 JNI jobject 참조입니다. Activity 또는 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. 미래를 변수로 유지하기 위한 대안으로, 다음을 호출하여 초기화 작업의 상태를 확인합니다. 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를 사용하여 메서드의 완료 상태 모니터링 호출을 참조하세요.

광고 로드

광고는LoadAd() InterstitialAd 객체. 로드 메서드를 사용하려면 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는 일회용 객체입니다. 즉, 전면 광고가 게재되면 다시 표시할 수 없습니다. 가장 좋은 방법은 OnAdDismissedFullScreenContent() 메서드에서 전면 광고를 FullScreenContentListener를 호출하여 다음 전면 광고가 바로 이전 요청이 닫히는 것입니다.

광고 표시

전면 광고는 앱 이용이 잠시 중단될 때 자연스럽게 표시되어야 합니다. 예를 들어 게임에서 다음 레벨로 넘어갈 때 또는 작업을 완료한 직후가 좋은 예입니다. FullScreenContentListener는 광고가 전체 화면 콘텐츠를 표시하는 경우 Show()에서 반환된 향후에도 광고가 성공적으로 게재되었을 때

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

권장사항

전면 광고가 앱에 적합한 광고 유형인지 생각해 보세요.
전면 광고는 자연스러운 전환 지점이 있는 앱에서 가장 효과적입니다. 이 이미지 공유, 게임 완료 등 앱 내에서 작업이 완료될 때 그러한 점을 만듭니다. 사용자가 사용자의 참여를 방해하지 않고 간편하게 전면 광고를 표시할 수 있습니다. 경험해 볼 수 있습니다 앱 워크플로의 어떤 지점에서 사용자가 어떻게 반응할지를 정확히 파악할 수 있습니다.
전면 광고를 표시할 때는 작업을 일시중지해야 합니다.
전면 광고에는 텍스트, 이미지, 확인할 수 있습니다. 앱에서 삽입 광고의 경우 광고가 다시 게재될 수 있도록 일부 리소스의 사용도 활용할 수 있습니다 예를 들어 앱에서 재생되는 오디오 출력을 일시중지해야 합니다. 다음 앱의 OnAdDismissedFullScreenContent 메서드에서 사운드 재생을 다시 시작할 수 있습니다. 설치된 FullScreenContentListener는 사용자가 광고와의 상호작용이 끝나야 합니다. 또한 모바일 애플리케이션에 대한 광고가 재생되는 동안 집중적인 계산 작업 (예: 게임 루프)이 표시됩니다. 이렇게 하면 사용자가 느리거나 응답이 없는 그래픽 또는 동영상 끊김
로드 시간을 충분히 확보하세요.
적절한 위치에 전면 광고를 표시하는 것도 중요하듯이 적절한 시간에 사용자가 기다리지 않도록 하는 것도 중요합니다. 할 수 있습니다. 게재하기 전에 미리 광고를 로드하면 앱에서 전면 광고가 완전히 로드된 후 그중 하나가 표시됩니다
사용자에게 광고를 지나치게 많이 게재하지 않습니다.
앱에 게재되는 전면 광고의 게재빈도가 늘어나는 것처럼 보일 수 있지만 이용 만족도가 떨어질 수 있으므로 클릭률 감소 사용자가 너무 자주 더 이상 앱 사용을 즐길 수 없다고 알립니다.
전면 광고를 표시할 때 로드 완료를 사용하지 마세요.
이로 인해 사용자 경험이 저하될 수 있습니다. 대신 광고를 미리 로드한 다음에 보여줘야 합니다.

추가 리소스

GitHub의 예제

모바일 광고 관련 동영상 가이드

성공사례

다음 단계