리워드 비디오 광고

SDK 초기화가 성공한 뒤 광고를 로드하세요. Swift 예제는 import Daro가 필요하며, Objective-C 예제는 DaroObjCBridge를 사용합니다. 기존 연동은 마이그레이션 가이드를 먼저 확인하세요.

리워드 비디오 형태 소개

광고 시청을 대가로 인앱 가치를 지닌 보상(재화, 기능, 컨텐츠 등)을 제공하는 형태의 광고입니다.
보상을 대가로 시청하므로 동영상 광고의 스킵이 불가능하며 일반적인 길이는 30초입니다.

How It Works

애드유닛 설정

대시보드에서 발급받은 Ad Unit Key를 사용하여 애드유닛을 설정하세요.

Swift
Objective-C

let rewardAdUnit = DaroAdUnit(unitId: "your_rewarded_unit_id")

// Objective-C에서는 초기화 시 unitId를 직접 전달합니다
NSString *rewardedUnitId = @"your_rewarded_unit_id";

광고 구현

Swift
Objective-C

class ExampleViewController: UIViewController {
    private var daroRewardedAd: DaroRewardedAd? = nil
    let daroRewardedLoader = DaroRewardedAdLoader(unit: rewardAdUnit)

    override func viewDidLoad() {
        super.viewDidLoad()
        setupRewardedAd()
    }

    private func setupRewardedAd() {
        // 광고 로드 성공 리스너
        daroRewardedLoader.listener.onAdLoadSuccess = { [weak self] ad, adInfo in
            print("[DARO] Listener Reward Ad loaded: \(ad) \(adInfo)")
            self?.showAd(ad: ad)
        }

        // 광고 클릭 리스너
        daroRewardedLoader.listener.onAdClicked = { adInfo in
            print("[DARO] Listener Reward Ad clicked: \(adInfo)")
        }

        // 광고 노출 리스너
        daroRewardedLoader.listener.onAdImpression = { adInfo in
            print("[DARO] Listener Reward Ad impression: \(adInfo)")
        }

        // 광고 로드 실패 리스너
        daroRewardedLoader.listener.onAdLoadFail = { error in
            print("[DARO] Listener Reward Ad failed: \(error)")
        }

        daroRewardedLoader.loadAd()
    }

    private func showAd(ad: DaroRewardedAd) {
        self.daroRewardedAd = ad

        // 보상 획득 리스너
        self.daroRewardedAd?.rewardedAdListener.onEarnedReward = { adInfo, rewardedItem in
            print("[DARO] Listener Reward Ad earned: \(adInfo) \(rewardedItem)")
        }

        // 광고 표시 성공 리스너
        self.daroRewardedAd?.rewardedAdListener.onShown = { adInfo in
            print("[DARO] Listener Reward Ad shown: \(adInfo)")
        }

        // 광고 닫힘 리스너
        self.daroRewardedAd?.rewardedAdListener.onDismiss = { adInfo in
            print("[DARO] Listener Reward Ad dismissed: \(adInfo)")
        }

        // 광고 표시 실패 리스너
        self.daroRewardedAd?.rewardedAdListener.onFailedToShow = { adInfo, error in
            print("[DARO] Listener Reward Ad failed to show: \(adInfo) \(error)")
        }

        showRewardedAd()
    }

    private func showRewardedAd() {
        daroRewardedAd?.show(viewController: self)
    }
}

1. 헤더 파일에서 delegate 프로토콜 채택:

@interface ExampleViewController () <DaroObjCRewardedAdDelegate>
@property (nonatomic, strong) DaroObjCRewardedAd *rewardedAd;
@end

2. 리워드 비디오 광고 설정 및 로드:

- (void)setupRewardedAd {
    self.rewardedAd = [[DaroObjCRewardedAd alloc]
        initWithAdUnitId:@"your_rewarded_unit_id"];
    self.rewardedAd.delegate = self;

    // 광고 로드
    [self.rewardedAd load];
}

3. Delegate 메서드 구현:

#pragma mark - DaroObjCRewardedAdDelegate

- (void)rewardedAdDidLoad:(DaroObjCRewardedAd *)ad
                   adInfo:(DaroObjCAdInfo *)adInfo {
    NSLog(@"[DARO] Rewarded ad loaded - Unit: %@", adInfo.adUnitId);
}

- (void)rewardedAdDidFailToLoad:(DaroObjCRewardedAd *)ad
                   error:(NSError *)error {
    NSLog(@"[DARO] Failed to load: %@", error.localizedDescription);
}

- (void)rewardedAdDidShow:(DaroObjCRewardedAd *)ad
                   adInfo:(DaroObjCAdInfo *)adInfo {
    NSLog(@"[DARO] Rewarded ad shown");
}

- (void)rewardedAdDidFailToShow:(DaroObjCRewardedAd *)ad
                   adInfo:(DaroObjCAdInfo *)adInfo
                    error:(NSError *)error {
    NSLog(@"[DARO] Failed to show: %@", error.localizedDescription);
}

- (void)rewardedAdDidClick:(DaroObjCRewardedAd *)ad
                    adInfo:(DaroObjCAdInfo *)adInfo {
    NSLog(@"[DARO] Rewarded ad clicked");
}

- (void)rewardedAdDidRecordImpression:(DaroObjCRewardedAd *)ad
                               adInfo:(DaroObjCAdInfo *)adInfo {
    NSLog(@"[DARO] Impression recorded");
}

- (void)rewardedAdDidEarnReward:(DaroObjCRewardedAd *)ad
                         adInfo:(DaroObjCAdInfo *)adInfo
                   rewardedItem:(DaroObjCRewardedItem *)rewardedItem {
    NSLog(@"[DARO] Reward earned! Type: %@, Amount: %d",
          rewardedItem.rewardType, rewardedItem.amount);
}

- (void)rewardedAdDidDismiss:(DaroObjCRewardedAd *)ad
                      adInfo:(DaroObjCAdInfo *)adInfo {
    NSLog(@"[DARO] Rewarded ad dismissed");
}

4. 광고 표시:

- (void)showRewardedAd {
    if (self.rewardedAd.isReady) {
        [self.rewardedAd showFrom:self];
    } else {
        NSLog(@"[DARO] Ad is not ready to show");
    }
}

리워드 아이템 구조

리워드 비디오 광고 시청 완료 시 전달되는 리워드 아이템은 다음과 같은 구조를 가집니다:

Swift
Objective-C

struct DaroRewardedItem {
    let amount: Int           // 보상 수량
    let rewardType: String    // 보상 타입 (예: "coin", "gem", "energy" 등)
}

@interface DaroObjCRewardedItem : NSObject

@property (nonatomic, assign, readonly) NSInteger amount;      // 보상 수량
@property (nonatomic, strong, readonly) NSString *rewardType;  // 보상 타입 (예: "coin", "gem", "energy" 등)

@end

추가 기능

사용자 식별자 설정

다음 코드는 사용자의 내부 User ID를 태그하는 방법을 보여줍니다. User ID 문자열의 최대 크기는 8192자입니다.

Swift
Objective-C

DaroAds.shared.userId = "user_id"

[DaroObjCAds shared].userId = @"user_id";

커스텀 데이터 설정

리워드 비디오 광고에 커스텀 데이터를 추가할 수 있습니다. 이 데이터는 서버 측 콜백에서 사용할 수 있습니다.

Swift
Objective-C

daroRewardedAd?.setCustomData("your_custom_data")
daroRewardedAd?.show(viewController: self)

[self.rewardedAd setCustomData:@"your_custom_data"];
[self.rewardedAd showFrom:self];

트러블슈팅: 광고 닫기 버튼 겹침 이슈

DARO iOS SDK를 사용해 리워드 비디오 광고를 표시할 때, 일부 광고 크리에이티브에서 상단 Safe Area 또는 Status Bar 영역과 UI가 겹쳐 보이는 현상이 발생할 수 있습니다. 아래는 광고가 표시되는 동안만 Status Bar를 숨기고, 광고 종료 시 원복하는 방법을 안내합니다.

Swift
Objective-C

1. ViewController에 Status Bar 제어 프로퍼티 추가:

class ExampleViewController: UIViewController {
    private var isAdShowing = false

    override var prefersStatusBarHidden: Bool {
        return isAdShowing
    }

    override var childForStatusBarHidden: UIViewController? {
        return presentedViewController
    }
}

2. 광고 표시 전 Status Bar 숨기기 및 콜백에서 복구:

private func showAd(ad: DaroRewardedAd) {
    self.daroRewardedAd = ad

    self.daroRewardedAd?.rewardedAdListener.onEarnedReward = { adInfo, rewardedItem in
        print("[DARO] Reward Ad earned: \(adInfo) \(rewardedItem)")
    }

    self.daroRewardedAd?.rewardedAdListener.onShown = { [weak self] adInfo in
        print("[DARO] Reward Ad shown")
    }

    self.daroRewardedAd?.rewardedAdListener.onDismiss = { [weak self] adInfo in
        self?.isAdShowing = false
        self?.setNeedsStatusBarAppearanceUpdate()
    }

    self.daroRewardedAd?.rewardedAdListener.onFailedToShow = { [weak self] adInfo, error in
        self?.isAdShowing = false
        self?.setNeedsStatusBarAppearanceUpdate()
    }

    // show() 직전에 Status Bar 숨기기
    isAdShowing = true
    setNeedsStatusBarAppearanceUpdate()
    daroRewardedAd?.show(viewController: self)
}

1. 헤더 파일에 프로퍼티 추가:

@interface ExampleViewController ()
@property (nonatomic, assign) BOOL adShowing;
@end

2. Status Bar 제어 메서드 오버라이드:

- (BOOL)prefersStatusBarHidden {
    return self.adShowing;
}

- (UIViewController *)childViewControllerForStatusBarHidden {
    return self.presentedViewController;
}

3. 광고 표시 전 숨기기 및 콜백에서 복구:

- (void)showRewardedAd {
    // show() 직전에 Status Bar 숨기기
    self.adShowing = YES;
    [self setNeedsStatusBarAppearanceUpdate];

    [self.rewardedAd showFrom:self];
}

// 광고 닫힘 시 복구
- (void)rewardedAdDidDismiss:(DaroObjCRewardedAd *)ad
                      adInfo:(DaroObjCAdInfo *)adInfo {
    self.adShowing = NO;
    [self setNeedsStatusBarAppearanceUpdate];
}

// 광고 표시 실패 시 복구
- (void)rewardedAdDidFailToShow:(DaroObjCRewardedAd *)ad
                   adInfo:(DaroObjCAdInfo *)adInfo
                    error:(NSError *)error {
    self.adShowing = NO;
    [self setNeedsStatusBarAppearanceUpdate];
}

DARO 2.0 SDK 마이그레이션

다로 시작하기

SDK 통합하기

DARO 사용하기

FAQ

레거시 SDK

리워드 비디오 광고

리워드 비디오 형태 소개

How It Works

애드유닛 설정

광고 구현

리워드 아이템 구조

추가 기능

사용자 식별자 설정

커스텀 데이터 설정

트러블슈팅: 광고 닫기 버튼 겹침 이슈

​리워드 비디오 형태 소개

​How It Works

​애드유닛 설정

​광고 구현

​리워드 아이템 구조

​추가 기능

​사용자 식별자 설정

​커스텀 데이터 설정

​트러블슈팅: 광고 닫기 버튼 겹침 이슈

리워드 비디오 형태 소개

How It Works

애드유닛 설정

광고 구현

리워드 아이템 구조

추가 기능

사용자 식별자 설정

커스텀 데이터 설정

트러블슈팅: 광고 닫기 버튼 겹침 이슈