시작하기

iOS SDK 적용 가이드

SDK 적용

Download Link

https://ads-static.v2.dexops.co.kr/sdk/iOS_DeXOpsAdsAgent_2.1.0.zip

다운로드 받은 SDK를 프로젝트 라이브러리 폴더에 복사

Xcode > Frameworks, Libraries, and Embedded Content 설정

Embed & Sign 으로 설정

SDK 초기화

AppDelegate 에서 수행

광고서버 URL은 담당 메니저를 통해 별도 안내 드립니다.

Code Sample

class AppDelegate: UIResponder, UIApplicationDelegate {
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // Override point for customization after application launch.
        
        // 광고 서버 URL 셋팅
        DeXOps.shared.configure(campaignHost: "광고 서버 URL")
        return true
    }
}

#import "DeXOpsAgent/DeXOpsAgent.h"
@interface AppDelegate ()
@end
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    
    // 광고 서버 URL 셋팅
    [[DeXOps shared] configureWithCampaignHost:@"광고 서버 URL"];
    return YES;
}
@end

광고 요청

UIViewController 의 라이프 사이클 viewDidLoad(), viewWillAppear(), viewDidAppear() 에서 목적에 맞게 광고 요청 수행

아래 예시는 viewWillApear() 에서 수행

Code Sample

class ViewController: UIViewController {
    override func viewWillAppear(_ animated: Bool) {
        super.viewWillAppear(animated)
        
        let channel = 0 //채널
        let section = 0 //섹션
        let slot = 0    //슬롯
        // 배너 옵션
        let bannerOptions = DeXOps.shared.makeBannerOptionsBuilder()
                                        .topMargin(0)
                                        .bottomMargin(0)
                                        .leftMargin(0)
                                        .rightMargin(0)
                                        .build()
        // 광고 요청                                
        DeXOps.shared.bannerView(parentView: self.view, 
                                   channel: channel, 
                                   section: section, 
                                   slot: slot, 
                                   bannerOptions: bannerOptions) { isSuccess, message in
            print("성공 여부: \(isSuccess)")
            print("성공 여부: \(message)")
        }
    }
}

@implementation ViewController
- (void)viewWillAppear:(BOOL)animated {
    [super viewWillAppear:animated];
    
    NSInteger channel = 0;    //채널
    NSInteger section = 0;    //섹션
    NSInteger slot = 0;    //슬롯
    
    // 배너 옵션
    NSDictionary *bannerOptions = [[[[[DeXOps.shared.makeBannerOptionsBuilder topMargin:0] bottomMargin:0] leftMargin: 0] rightMargin:0] build];
    
    // 광고 요청
    [[DeXOps shared] bannerViewWithParentView:self.view
                                          channel:channel
                                          section:section
                                             slot:slot
                                    bannerOptions:bannerOptions completion:^(BOOL isSuccess, NSString * _Nonnull message) {
            NSLog(@"isSuccess %b : message %@", isSuccess, message);
    }];
}
@end

Hybrid App 광고 요청

Javascript Interface 설정

Code Sample

class ViewController: UIViewController {
  override func viewDidLoad() {
        super.viewDidLoad()
        
        //Javascript Interface 적용
        let userCtrl = DeXOpsUserContentController(wkWebView: wkWebView)
        wkWebView.configuration.userContentController.add(userCtrl, name: userCtrl.name)
    }
}

@implementation ViewController
- (void)viewDidLoad {
    [super viewDidLoad];
    
    //Javascript Interface 적용
    DeXOpsUserContentController *userCtrl = [[DeXOpsUserContentController alloc] initWithWkWebView:self.wkWebView];    
    [[[self.wkWebView configuration] userContentController] addScriptMessageHandler:userCtrl name:userCtrl.name];
}
@end

Web 광고 요청

등록된 Javascript Interface 를 통해 광고를 요청 하고 Web 화면에 광고를 보여주게 됨
HTML 또는 Javascript 함수 호출 선택

Custom Element 가이드

<html>
<head>
  <!-- DeXOps Web Javascript SDK-->
  <script defer src="https://ads-static.v2.dexops.co.kr/js/dexops_agent_ads.js" data-campaign="광고 서버 URL"></script>
</head>
<body>
  <!-- 모바일 웹과 Hybrid웹을 동일한 페이지에서 사용 하는 경우 분기 처리 필요 -->
  <!-- 하이브리드 웹뷰 페이지인 경우 -->
  <div>
    <dexops-ads-app-view data-channel="0" data-section="0" data-slot="0" data-top-margin="0" data-bottom-margin="0" data-left-margin="0" data-right-margin="0"></dexops-ads-app-view>  
  </div>
  <!-- 광고 응답 콜백 이벤트 필요한 경우 -->
  <script>
      for (let element of document.getElementsByTagName('dexops-ads-app-view') ){
          element.addEventListener('dexopsAdsViewCompletion', function (ev) {
              const status = this.dataset.status; //성공 true, 실패 false
              const message = this.dataset.message; //결과 메세지
              const channel = this.dataset.channel; //채널
              const section = this.dataset.section; //섹션
              const slot = this.dataset.slot; //슬롯
          });
      }
  </script>
</body>
</html>

Javascript 가이드

<html>
<head>
  <!-- DeXOps Web Javascript SDK-->
  <script defer src="https://ads-static.v2.dexops.co.kr/js/dexops_agent_ads.js" data-campaign="광고 서버 URL"></script>
</head>
<body>
  <!-- 모바일 웹과 Hybrid웹을 동일한 페이지에서 사용 하는 경우 분기 처리 필요 -->
  <!-- 하이브리드 웹뷰 페이지인 경우 -->
  <div id="ads">
  </div>
  <script>
    document.addEventListener('DOMContentLoaded', function () {
      if (DeXOpsSDKInterface.availableSDKInterface()) {
        const marginInfo = { top: 0, bottom: 0, left: 0, right: 0 };
        
        DeXOpsSDKInterface.bannerView(document.getElementById('ads'), channel, section, slot, marginInfo)
        .then( function (result) {
            console.log(result);
        }).catch( function (err) {
            console.log(err);
        });
      }
    });
  </script>
</body>
</html>

PreviousIOS Next주요 함수

Last updated 1 year ago

Was this helpful?