# 기본 설정

## 1. Sample Project

Object-C Sample Project

{% embed url="<https://bitbucket.org/mezzomediaadtech/ios-v300-objectivec/src/master/>" %}

```
git clone https://mezzomedia_adtech@bitbucket.org/mezzomediaadtech/ios-v300-objectivec.git
```

Swift Sample Project

{% embed url="<https://bitbucket.org/mezzomediaadtech/ios-v300-swift/src/master/>" %}

```
git clone https://mezzomedia_adtech@bitbucket.org/mezzomediaadtech/ios-v300-swift.git
```

## 2. SDK 광고의 구성

<table><thead><tr><th width="197">구분</th><th>샘플</th><th>설명</th></tr></thead><tbody><tr><td>띠 배너</td><td><img src="https://docs.meba.kr/s-plus/sdk/ios_v300/images/banner.png" alt=""></td><td>일반적인 바(Bar) 형태의 배너입니다.<br>대부분 하단에 위치하지만, 퍼블리셔의 조정에 따라 상단 또는 중간에도 게재할 수 있습니다.</td></tr><tr><td>전면 배너</td><td><img src="https://docs.meba.kr/s-plus/sdk/ios_v300/images/interstitial.png" alt=""></td><td>전면에 광고가 게시되며, 퍼블리셔의 조정에 따라 노출 영역을 조정할 수 있습니다.</td></tr><tr><td>동영상</td><td><img src="https://docs.meba.kr/s-plus/sdk/ios_v300/images/video.png" alt=""></td><td>동영상 콘텐츠 재생 전 Instream 형태 또는 지면에 포함되어 Outstream 형태로 재생되는 동영상 광고입니다.</td></tr><tr><td>전면확장</td><td><img src="https://docs.meba.kr/s-plus/sdk/ios_v300/images/interstitial_expand.png" alt=""></td><td>전면에 광고가 게시되며, 남은 영역에는 좌측상단 1pixel 기준의 색상이 채워집니다.</td></tr><tr><td>전면동영상</td><td><img src="https://docs.meba.kr/s-plus/sdk/ios_v300/images/interstitial_video.png" alt=""></td><td>전면에 광고가 게시되며, 배너의 하단에는 동영상광고가 함께 재생됩니다.</td></tr><tr><td>네이티브 피드</td><td><img src="https://docs.meba.kr/s-plus/sdk/ios_v300/images/native_feed.png" alt=""></td><td>다양한 요소(애셋)들로 이루어진 광고입니다.<br>전면에 광고가 게시되며, 동영상과 이미지가 포함되어 있습니다.<br>퍼블리셔가 각 요소(애셋)들로 광고 형태를 조합해서 게시할 수 있습니다.(별도 문의)</td></tr><tr><td>네이티브 피드 배너</td><td><img src="https://docs.meba.kr/s-plus/sdk/ios_v300/images/native_feed_banner.png" alt=""></td><td>다양한 요소(애셋)들로 이루어진 광고입니다.<br>바(Bar) 형태로 광고가 게시되며, 동영상과 이미지가 포함되어 있습니다.<br>퍼블리셔가 각 요소(애셋)들로 광고 형태를 조합해서 게시할 수 있습니다.(별도 문의)</td></tr><tr><td>카운트다운 배너</td><td><img src="https://docs.meba.kr/s-plus/sdk/android_v3/images/countdown.png" alt=""></td><td>라이브커머스 / 주요 경기 등 카운트다운을 통해 시각적으로 방송 시작을 강조하는 배너입니다.<br>카운트다운 영역은 퍼블리셔의 조정이 불필요합니다.</td></tr><tr><td>디데이 카운트다운 배너</td><td><img src="https://docs.meba.kr/s-plus/sdk/android_v3/images/dday.png" alt=""></td><td>카운트다운 배너와 동일하지만 ‘D-DAY’ 표현이 추가된 배너입니다.</td></tr></tbody></table>

## 3. 지원 상품(사이즈)

<table><thead><tr><th width="205">상품 구분</th><th>사이즈</th></tr></thead><tbody><tr><td>띠배너</td><td>300x50 ㅣ 320x50 ㅣ 320x100 ㅣ 640x240 ㅣ 640x100 ㅣ 728x90</td></tr><tr><td>전면배너</td><td>640x960 ㅣ 320X480 ㅣ 480x320 ㅣ 1024x768 ㅣ 750x1200 ㅣ 768x1024</td></tr><tr><td>종료배너</td><td>640x960 ㅣ 750x1200</td></tr><tr><td>정사각형 및 직사각형</td><td>200x200 ㅣ 240x400 ㅣ 240x240 ㅣ 250x250 ㅣ 250x360 ㅣ 300x250 ㅣ 336x280 ㅣ 150x150 ㅣ 580x400</td></tr><tr><td>스카이스크래퍼</td><td>120x600 ㅣ 160x600 ㅣ 300x600 ㅣ 300x1050</td></tr><tr><td>리더보드</td><td>468x60 ㅣ 728x90 ㅣ 930x180 ㅣ 970x90 ㅣ 970x250 ㅣ 980x120</td></tr><tr><td>네이티브 피드</td><td>640x960</td></tr><tr><td>네이티브 피드 배너</td><td>320x100 ㅣ 320x50</td></tr><tr><td>카운트다운 배너   </td><td>640x960 ㅣ 320x100 ㅣ 320x50</td></tr><tr><td>디데이 카운트다운 배너</td><td>3640x960 ㅣ 300x200 ㅣ 320x100 ㅣ 320x50</td></tr><tr><td>동영상 엔드카드   </td><td>-</td></tr><tr><td>플레이어블(MRAID)   </td><td>320x100 ㅣ 320x50 ㅣ 640x960</td></tr></tbody></table>

## 4. SDK Library 구성

* **헤더 파일**

<table><thead><tr><th width="304">헤더 파일명</th><th>설명</th></tr></thead><tbody><tr><td>LibADPlus-Swift.h</td><td>Objective-C용 앱을 위한 BridgeHeader파일입니다.</td></tr><tr><td>LibADPlus.h</td><td>Library버전이 정의된 Header파일입니다.</td></tr></tbody></table>

* **라이브러리 파일**

<table><thead><tr><th width="305">라이브러리 파일명</th><th>설명</th></tr></thead><tbody><tr><td>LibADPlus.xcframework</td><td>TARGETPICK 광고 라이브러리</td></tr><tr><td>OMSDK_Cjnet.xcframework</td><td>LibADPlus내의 일부 기능을 위한 라이브러리입니다.</td></tr></tbody></table>

* **샘플 구성(Object-c)**

```
SDK 샘플 프로젝트가 포함 되어 있습니다.
라이브러리 경로 : ADPlusSampleObjc/ADPlusSampleObjc/Lib/…
```

* **샘플 구성(Swift)**

```
SDK 샘플 프로젝트가 포함 되어 있습니다.
라이브러리 경로 : ADPlusSampleSwift/ADPlusSampleSwift/Lib/…
```

## 5. SDK 연동시 주의사항 <a href="#caution" id="caution"></a>

{% hint style="info" %}
IOS 9 ATS(App Transport Security) 기능 사용 관련\
IOS9 이상에서는 ATS(App Transport Security) 기능이 제공됩니다.\
ATS기능 활성화 시, HTTP 방식이 제한되므로, 정상적인 TARGETPICK 광고가 노출되지 않습니다.
{% endhint %}

> info.plist 파일에 아래의 항목을 추가 적용하여 사용 바랍니다.\
> 앱의 info.plist파일에 마우스 오른쪽 버튼을 눌러 ‘Open As > Source Code’로 해당파일 편집모드로 들어간 후, 아래 코드를 삽입합니다.

{% code lineNumbers="true" %}

```java
<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitararyLoads</key>
  <true/>
</dict>
```

{% endcode %}

{% hint style="info" %}
백그라운드에서 사용 승인을 위한 코드입니다.\
추가하지않을경우 TestFlight업로드시 App Store Connect Operation ERROR ITMS-90771에러가 나타납니다.
{% endhint %}

{% code lineNumbers="true" %}

```java
<key>BGTaskSchedulerPermittedIdentifiers</key>
 <array>
  <string>com.mezzo.LibADPlus</string>
  <string>com.iabtechlab.OMSDK-Cjnet</string>
 </array>
```

{% endcode %}

## 6. SKAdNetwork ID(iOS Only)

**SKAdNetwork 란**

{% hint style="info" %}
SKAdNetwork 란\
SKAdNetwork(SKAN)는 Apple에서 제공하는 개인 정보 보호 방식의 어트리뷰션 프레임워크입니다.\
이는 사용자의 개인정보를 침해하지 않고도 앱 인스톨(전환), 캠페인의 전환율을 측정할 수 있게합니다.\
SKAdNetwork와 관련해서 보다 자세한 내용은 Apple의 공식 문서를 참고해주세요.\
\
\[참고] <https://developer.apple.com/documentation/storekit/skadnetwork>
{% endhint %}

#### **퍼블리셔의 SKAdNetwork ID 적용방법**

> CJ MezzoMedia와 제휴된 매체는 CJ Mezzomedia를 포함, 연동된 Adnetwork 업체의 SKAdNetwork ID를 아래와 같이 Info.plist에 추가해야 합니다.

{% hint style="info" %}

1. Xcode project에서 Info.plist 파일을 불러옵니다.
2. Root directory에서 property 키를 선택하고, 오른쪽 +를 클릭하여 새로운 property 키를 만듭니다.
3. SKAdNetworkItems로 키를 입력합니다.
4. Array 타입을 선택합니다.
5. Array에 Dictionary를 추가합니다.
6. Dictionary에 각 SKAdNetwork 항목을 추가합니다.
7. 각 항목의 키는 SKAdNetworkIdentifier이며, 값은 개별 광고네트워크의 SKAdNetwork ID입니다.&#x20;
   {% endhint %}

해당 필드에 대한 자세한 항목은 Apple의 공식문서를 참고해주세요.

{% embed url="<https://developer.apple.com/documentation/storekit/skadnetwork/configuring_the_participating_apps>" %}

**SKAdNetwork ID 목록(마지막 업데이트: 2021/04/12)**

{% hint style="info" %}
현재 CJ Mezzomedia와 연동된 AdNetwork의 ID 목록입니다.
{% endhint %}

{% code lineNumbers="true" %}

```java
<key>SKAdNetworkItems</key>
<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>feyaarzu9v.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>xxxxxxxxxx.skadnetwork</string>
    </dict>
</array>
```

{% endcode %}

## 7. Library 추가(Swift 샘플 기준) <a href="#importlibrary" id="importlibrary"></a>

![](https://docs.meba.kr/s-plus/sdk/ios_v300/images/v3/dragtodrop.png)

프로젝트내에 라이브러리가 위치할 폴더를 생성하고\
해당 폴더에 라이브러리를 Drag and Drop합니다.\
(예시 이미지에서는 Sample Project와 동일하게 Lib폴더에 추가하였습니다.)

![](https://docs.meba.kr/s-plus/sdk/ios_v300/images/v3/addpreview.png)

Added folders는 “Create groups”를 선택\
적용할 Target앱을 선택후 “Finish”를 선택하면 프로젝트에 라이브러리 추가됩니다.

<div align="left"><img src="https://docs.meba.kr/s-plus/sdk/ios_v300/images/v3/addfinish.png" alt="" width="375"></div>

프로젝트에 파일이 추가되었습니다.<br>

![](https://docs.meba.kr/s-plus/sdk/ios_v300/images/v3/embedoption.png)

Project 선택 -> Target 선택 -> General탭 선택-> “Frameworks,Libraries, and Embedded Content” 항목으로 이동합니다. 추가한 두개의 Library의 Embed option을 “Do Not Embed”에서 “Embed & Sign”으로 변경합니다.

![](https://docs.meba.kr/s-plus/sdk/ios_v300/images/v3/selectfolderpath.png)

Project 선택 -> Target 선택 -> Build Settings탭 선택 -> Search Paths 항목으로 이동합니다.\
“Framework Search Paths”,”Header Search Paths”,”Library Search Paths”에 각각 추가한 라이브러리의 경로를 입력합니다.\
Sample Project의 경우 ADPlusSampleSwift/ADPlusSampleSwift/Lib 로 되어있어 “$(PROJECT\_DIR)/$(PROJECT\_NAME)/Lib”로 추가함으로써 라이브러리 사용환경을 완료합니다.

## 8. Import 예시 <a href="#importexample" id="importexample"></a>

* Swift

{% code lineNumbers="true" %}

```java
import LibADPlus
```

{% endcode %}

* Objective-C

{% code lineNumbers="true" %}

```java
#import <LibADPlus/LibADPlus-Swift.h>
```

{% endcode %}

<br>

\
\ <br>