보상형 광고를 사용하면 사용자에게 상호작용에 대한 대가로 인앱 리워드에 대해 자세히 알아보세요. 이 가이드에는 보상형 광고를 Google 모바일 광고 C++ SDK를 사용하는 Android 및 iOS 앱
고객 성공사례 읽어보기: 우수사례 1 우수사례 2를 참고하세요.
기본 요건
- 시작하기를 모두 읽어보세요.
- (Android만 해당) JNI
jobject
참조 작업에 관한 기본 지식 (참고: Android JNI 도움말)을 참조하세요.
항상 테스트 광고로 테스트
앱을 빌드하고 테스트할 때는 만들 수 있습니다. 이렇게 하지 않으면 계정이 정지될 수 있습니다.
테스트 광고를 로드하는 가장 쉬운 방법은 (기기 플랫폼에 따라 다름)
- Android:
ca-app-pub-3940256099942544/5224354917
- iOS:
ca-app-pub-3940256099942544/1712485313
모든 요청에 대해 테스트 광고를 반환하도록 특별히 구성되었으며, 코딩, 테스트 및 디버깅 중에 앱에서 자유롭게 사용할 수 있습니다. 단, 광고를 게시하기 전에 ID를 자체 광고 단위 ID로 바꿔야 합니다. 있습니다.
모바일 광고 SDK의 테스트 광고가 작동하는 방식을 자세히 알아보려면 다음을 참고하세요. 테스트 광고.
구현
보상형 광고를 통합하는 주요 단계는 다음과 같습니다.
- 광고를 로드합니다.
- 콜백을 등록합니다.
- 광고를 표시하고 보상 이벤트를 처리합니다.
RewardedAd
구성
보상형 광고는 RewardedAd
객체에 표시되므로
보상형 광고를 앱에 통합하는 방법은
인스턴스를 만들고 초기화하는 것입니다
(총 RewardedAd
개)
앱의 C++ 코드에 다음 헤더를 추가합니다.
#include "firebase/gma/rewarded_ad.h"
RewardedAd
객체를 선언하고 인스턴스화합니다.firebase::gma::RewardedAd* rewarded_ad; rewarded_ad = new firebase::gma::RewardedAd();
다음으로의 상위 뷰 캐스트를 사용하여
RewardedAd
인스턴스를 초기화합니다.AdParent
유형. 상위 뷰는 Android의 JNIjobject
참조입니다.Activity
또는 iOSUIView
를 가리키는 포인터입니다.// 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 = rewarded_ad->Initialize(ad_parent);
미래를 변수로 유지하기 위한 대안으로, 다음을 호출하여 초기화 작업의 상태를 확인합니다.
RewardedAd
객체의InitializeLastResult()
도움이 될 만한 정보 글로벌 게임 루프의 초기화 프로세스를 추적하는 데 유용합니다.// Monitor the status of the future in your game loop: firebase::Future<void> result = rewarded_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를 사용하여 메서드의 완료 상태 모니터링
호출
광고 로드
광고는 RewardedAd
의 LoadAd()
메서드를 사용하여 로드됩니다.
객체를 지정합니다. 로드 메서드를 사용하려면 RewardedAd
를 초기화해야 합니다.
객체에 광고 단위 ID와 AdRequest
객체가 있음을 확인합니다. 가
상태와 결과를 모니터링하는 데 사용할 수 있는 firebase::Future
가 반환됩니다.
일어날 수 있는 일입니다.
다음 코드는 RewardedAd
가 완료된 후 광고를 로드하는 방법을 보여줍니다.
성공적으로 초기화되었습니다.
firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = rewarded_ad->LoadAd(rewarded_ad_unit_id, ad_request);
콜백 등록
FullScreenContentListener
클래스를 확장해야
보상형 광고 표시 및 수명 주기 이벤트의 알림을 제공합니다. 커스텀
FullScreenContentListener
서브클래스는 다음을 통해 등록할 수 있습니다.
RewardedAd::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* example_full_screen_content_listener = new ExampleFullScreenContentListener(); rewarded_ad->SetFullScreenContentListener(example_full_screen_content_listener);
RewardedAd
는 일회용 객체입니다. 즉, 보상형 광고가
다시 표시할 수 없습니다. 다른 보상형 광고를 로드하는 것이 좋습니다.
OnAdDismissedFullScreenContent()
메서드에서
다음 보상형 광고가 즉시 로드되기 시작하도록 FullScreenContentListener
이전 광고가 닫히기 때문입니다.
광고 표시 및 보상 이벤트 처리
보상형 광고를 사용자에게 표시하기 전에 사용자에게 보상을 받는 대가로 보상형 광고 콘텐츠를 볼 것인지를 명확하게 선택할 수 있습니다. 보상형 광고 광고는 항상 선택 옵션을 제공해야 합니다.
광고를 표시할 때 처리할 UserEarnedReward
객체를 제공해야 합니다.
사용자에게 보상을 제공합니다
다음 코드는 RewardedAd
를 표시하는 방법을 보여줍니다.
// A simple listener track UserEarnedReward events.
class ExampleUserEarnedRewardListener :
public firebase::gma::UserEarnedRewardListener {
public:
ExampleUserEarnedRewardListener() { }
void OnUserEarnedReward(const firebase::gma::AdReward& reward) override {
// Reward the user!
}
};
ExampleUserEarnedRewardListener* user_earned_reward_listener =
new ExampleUserEarnedRewardListener();
firebase::Future<void> result = rewarded_ad->Show(user_earned_reward_listener);
FAQ
- 초기화 호출에 제한 시간이 있나요?
- Google 모바일 광고 C++ SDK가 10초 후에
미디에이션 네트워크가 여전히 있더라도
Initialize()
에서firebase::Future
를 반환함 초기화가 완료되지 않았습니다. - 초기화 콜백을 받을 때 일부 미디에이션 네트워크가 준비되지 않은 경우 어떻게 해야 하나요?
SDK 초기화가 완료된 후에 광고를 로드하는 것이 좋습니다. 미디에이션 네트워크가 준비되지 않은 경우에도 Google 모바일 광고 C++ SDK는 해당 네트워크에 광고를 요청할 수 있습니다 따라서 조정 네트워크에서 시간이 초과된 후에 초기화하더라도 해당 시간 동안 여전히 향후 광고 요청을 처리할 수 있습니다. 세션입니다.
이 과정에서 모든 어댑터의 초기화 상태를
GetInitializationStatus()
를 호출하여 앱 세션을 종료하세요.- 특정 미디에이션 네트워크가 준비되지 않은 이유를 확인하려면 어떻게 해야 하나요?
AdapterStatus.description()
에서는 어댑터를 서비스할 준비가 되지 않은 이유를 설명합니다. 광고 요청수에 따라 달라집니다. 자세한 내용은 빠른 시작 앱 예시 를 참고하세요.
추가 리소스
GitHub의 예제
- 예시의 소스 코드 보기 빠른 시작 앱 를 참조하세요.