리워드 비디오 광고

리워드 비디오 형태 소개

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

How It Works

광고 단위 설정

대시보드에서 발급받은 ad unit ID를 사용하여 광고 단위를 설정하세요.

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)rewardedAdDidFail:(DaroObjCRewardedAd *)ad
                   toLoad:(NSError *)error {
    NSLog(@"[DARO] Failed to load: %@", error.localizedDescription);
}

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

- (void)rewardedAdDidFail:(DaroObjCRewardedAd *)ad
                   toShow:(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";

플레이스먼트 설정

광고 표시 전에 placement를 설정할 수 있습니다.

Swift
Objective-C

daroRewardedAd?.setPlacement("your_rewarded_placement")
daroRewardedAd?.show(viewController: self)

[self.rewardedAd setPlacement:@"your_rewarded_placement"];
[self.rewardedAd showFrom:self];

커스텀 데이터 설정

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

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)rewardedAdDidFail:(DaroObjCRewardedAd *)ad
                   toShow:(DaroObjCAdInfo *)adInfo
                    error:(NSError *)error {
    self.adShowing = NO;
    [self setNeedsStatusBarAppearanceUpdate];
}

다로 시작하기

SDK 통합하기

DARO 사용하기

FAQ

리워드 비디오 광고

리워드 비디오 형태 소개

How It Works

광고 단위 설정

광고 구현

리워드 아이템 구조

추가 기능

사용자 식별자 설정

플레이스먼트 설정

커스텀 데이터 설정

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

다로 시작하기

SDK 통합하기

DARO 사용하기

FAQ

​리워드 비디오 형태 소개

​How It Works

​광고 단위 설정

​광고 구현

​리워드 아이템 구조

​추가 기능

​사용자 식별자 설정

​플레이스먼트 설정

​커스텀 데이터 설정

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

리워드 비디오 형태 소개

How It Works

광고 단위 설정

광고 구현

리워드 아이템 구조

추가 기능

사용자 식별자 설정

플레이스먼트 설정

커스텀 데이터 설정

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