---
description: >-
  디스플레이 광고지면에 타 광고네트워크의 광고를 라이브 할 수 있는 기능을 의미하며, 내부/자체 광고의 운영 및 여러 국내/해외의 외부 광고를
  노출시킬 수 있어 수익극대화에 효과적입니다.
---

# 미디에이션

### 미디에이션이란?

* 다양한 타 광고(NAM, AdFit, AdMob 등) 업체를 미리 연동해 둔 Mediation SDK를 활용하여 별다른 설정 없이 손쉽게 이용하실 수 있어 수익 극대화에 효과적인 기능입니다.
* 저희 AdPopcornSSP에 각 업체별 Mediation을 설치하시면 각 업체별로 광고 load를 진행하지 않고 AdPopcornSSP load 만으로도 다양한 업체의 광고를 제공받으실 수 있습니다.

{% hint style="warning" %}
<mark style="color:red;">**주의사항**</mark>

* 애드팝콘 SSP 미디에이션 연동하기 전에 반드시 애드팝콘 SSP 연동이 진행 되어야 합니다. [\[애드팝콘 SSP : iOS\]](undefined)
* 애드팝콘 SSP 미디에이션 연동 시 애드팝콘 최신 SSP 버전과 각 업체별 호환 버전을 반드시 확인 후 연동을 진행 부탁 드립니다.
* 각 업체별 호환 버전은 아래 가이드 바로가기 링크에 기재가 되어 있으니 확인 부탁 드립니다.
{% endhint %}



## 1. 지원 중인 업체 목록

<table><thead><tr><th width="143.4296875">광고 업체</th><th width="88.87109375" align="center">Banner</th><th width="89.90234375" align="center">Native</th><th width="124.33203125" align="center">Interstitial</th><th width="143.05859375" align="center">InterstitialVideo</th><th align="center" valign="middle">RewardVideo</th></tr></thead><tbody><tr><td>NAM</td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><mark style="color:red;">X</mark></td><td align="center" valign="middle"><mark style="color:red;">X</mark></td></tr><tr><td>AdFit</td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><mark style="color:red;">X</mark></td><td align="center" valign="middle"><mark style="color:red;">X</mark></td></tr><tr><td>AppLovin</td><td align="center"><strong>O</strong></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center" valign="middle"><strong>O</strong></td></tr><tr><td>AppLovinMax</td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center" valign="middle"><strong>O</strong></td></tr><tr><td>UnityAds</td><td align="center"><strong>O</strong></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center" valign="middle"><strong>O</strong></td></tr><tr><td>Vungle</td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><strong>O</strong></td><td align="center" valign="middle"><strong>O</strong></td></tr><tr><td>FaceBook</td><td align="center"><strong>O</strong></td><td align="center">?</td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center" valign="middle"><strong>O</strong></td></tr><tr><td>AdMob</td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center" valign="middle"><strong>O</strong></td></tr><tr><td>ADOP</td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center" valign="middle"><strong>O</strong></td></tr><tr><td>Fyber</td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><strong>O</strong></td><td align="center" valign="middle"><strong>O</strong></td></tr><tr><td>MezzoMedia</td><td align="center"><strong>O</strong></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><mark style="color:red;">X</mark></td><td align="center" valign="middle"><mark style="color:red;">X</mark></td></tr><tr><td>Cauly</td><td align="center"><strong>O</strong></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><strong>O</strong></td><td align="center"><mark style="color:red;">X</mark></td><td align="center" valign="middle"><mark style="color:red;">X</mark></td></tr><tr><td>Mintegral</td><td align="center"><strong>O</strong></td><td align="center"><strong>O</strong></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><strong>O</strong></td><td align="center" valign="middle"><strong>O</strong></td></tr><tr><td>Pangle</td><td align="center"><strong>O</strong></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><mark style="color:red;">X</mark></td><td align="center"><strong>O</strong></td><td align="center" valign="middle"><strong>O</strong></td></tr></tbody></table>





## 2. 설치 방법

### CocoaPod

아래에 포함되지 않은 업체를 미디에이션으로 사용하고자 할 경우에는 MediationAdapter 내에 포함되어 있는 framework를 사용하시기 바랍니다.

<table><thead><tr><th width="127.86328125">광고 업체</th><th width="381.984375" align="center">CocoaPod</th><th width="59.796875" align="center">링크</th><th width="134.046875" align="center">비고</th></tr></thead><tbody><tr><td>NAM</td><td align="center"><pre><code>pod 'NAMSDK', '8.8.0'
pod 'NAMSDK/MediationNDA', '8.8.0'
</code></pre></td><td align="center"><a href="https://naver.github.io/nam-sdk-guide/ios/common/get_started/">Link</a></td><td align="center"></td></tr><tr><td>AdFit</td><td align="center"><pre><code>pod 'AdFitSDK', '3.18.3'
</code></pre></td><td align="center"><a href="https://adfit.github.io/adfit-ios-sdk/documentation/adfitsdk/">Link</a></td><td align="center">3.18.6 이후 부터 <br><strong>SPM</strong>만 지원</td></tr><tr><td>AppLovin</td><td align="center"><pre><code>pod 'AppLovinSDK', '13.3.1'
</code></pre></td><td align="center"><a href="https://developers.applovin.com/en/max/ios/overview/integration">Link</a></td><td align="center"></td></tr><tr><td>AppLovinMax</td><td align="center"><pre><code>pod 'AppLovinSDK', '13.3.1'
</code></pre></td><td align="center"><a href="https://developers.applovin.com/en/max/ios/overview/integration">Link</a></td><td align="center"></td></tr><tr><td>UnityAds</td><td align="center"><pre><code>pod 'UnityAds', '4.16.0'
</code></pre></td><td align="center"><a href="https://docs.unity.com/grow/en-us/ads/ios-sdk/install-sdk">Link</a></td><td align="center"></td></tr><tr><td>Vungle</td><td align="center"><pre><code>pod "VungleAds", '7.5.2'
</code></pre></td><td align="center"><a href="https://support.vungle.com/hc/en-us/articles/360002925791-Integrate-Vungle-SDK-for-iOS#h_01GWQTCFD182A6NRBT9PZ96FXY">Link</a></td><td align="center"></td></tr><tr><td>FaceBook</td><td align="center"><pre><code>pod 'FBAudienceNetwork', '6.20.1'
</code></pre></td><td align="center"><a href="https://developers.facebook.com/docs/audience-network/setting-up/platform-setup/ios/get-started?locale=ko_KR">Link</a></td><td align="center"></td></tr><tr><td>AdMob</td><td align="center"><pre><code>pod 'Google-Mobile-Ads-SDK', '12.8.0'
</code></pre></td><td align="center"><a href="https://developers.google.com/admob/ios/quick-start?hl=ko">Link</a></td><td align="center"></td></tr><tr><td>ADOP</td><td align="center"><pre><code>pod 'Google-Mobile-Ads-SDK', '12.8.0'
</code></pre></td><td align="center"><a href="https://developers.google.com/admob/ios/quick-start?hl=ko">Link</a></td><td align="center"></td></tr><tr><td>Fyber</td><td align="center"><pre><code>pod 'Fyber_Marketplace_SDK', '8.3.8'
</code></pre></td><td align="center"><a href="https://developer.digitalturbine.com/hc/en-us/articles/360010915618-Integrating-the-iOS-SDK">Link</a></td><td align="center"></td></tr><tr><td>MezzoMedia</td><td align="center">수동 설치 <br>- Mediation Mezzo Adapter 내부 framework </td><td align="center"><a href="https://docs.meba.kr/s-plus/sdk/ios_v300/">Link</a></td><td align="center"></td></tr><tr><td>Cauly</td><td align="center"><pre><code>pod 'CaulySDK', :git => 'https://github.com/cauly/CaulySDK_iOS.git', :tag => '3.1.22'
</code></pre></td><td align="center"><a href="https://github.com/cauly/iOS-SDK?tab=readme-ov-file">Link</a></td><td align="center"></td></tr><tr><td>Mintegral</td><td align="center"><pre><code>pod 'MintegralAdSDK', '7.7.7'
</code></pre></td><td align="center"><a href="https://github.com/Mintegral-official/MintegralAdSDK-iOS-new?tab=readme-ov-file">Link</a></td><td align="center"></td></tr><tr><td>Pangle</td><td align="center"><pre><code>pod 'Ads-Global', '7.4.1.0'
</code></pre></td><td align="center"><a href="https://www.pangleglobal.com/integration/integrate-pangle-sdk-for-ios">Link</a></td><td align="center"></td></tr><tr><td>AdColony</td><td align="center"><pre><code>pod 'AdColony', '4.9.0'
</code></pre></td><td align="center"></td><td align="center"></td></tr></tbody></table>



### SPM (Swift Package Manager)

<table><thead><tr><th width="170">광고 업체</th><th width="343.77734375">SPM 링크</th><th width="120.9921875">Version</th><th>비고</th></tr></thead><tbody><tr><td>AdFit</td><td><a href="https://github.com/adfit/adfit-spm">https://github.com/adfit/adfit-spm</a></td><td>3.19.9</td><td>iOS 15+</td></tr><tr><td></td><td></td><td></td><td></td></tr></tbody></table>



***

{% hint style="warning" %}
**미디에이션을 이용하려면 Adapter를 다운로드 해주셔야 합니다.**
{% endhint %}

## 3. 미디에이션 Adapter 다운로드 & 초기 Setting

아래 링크로 미디에이션 Adapter 최신 버전을 다운로드 해주세요.\
이전 어댑터 파일이 필요한 경우, [SDK 호환성 체크](undefined-12/sdk-mediation-ver) 정보에서 다운로드 가능합니다.

[\[애드팝콘 SSP iOS Mediation Adapter 다운로드\]](https://github.com/IGAWorksDev/AdPopcornSDK/raw/refs/heads/master/AdPopcornSSP/02-ios-sdk/MediationAdapter/AdPopcornSSPMediationAdapter_250623.zip)



### 1) Adapter 추가

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2FiYrcgQoLD1zCyCb8qnRi%2Fimage.png?alt=media&#x26;token=ffe7c72d-60bf-4386-acc3-7f50d7da69aa" alt=""><figcaption><p>Drag &#x26; Drop</p></figcaption></figure>

다운받은 Adapter 파일에서 미디에이션시 필요한 파일을  Project에 추가해 주시면 됩니다 (CocoaPod, SPM 별도)

### 2) .h .m 파일 설정

&#x20;**2-1) @@@.h**

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2FZBf7D6io6n8ikzUUqIP1%2Fimage.png?alt=media&#x26;token=cb1cb740-21e6-497d-b155-80e85804eb0a" alt=""><figcaption></figcaption></figure>

저희 'AdPopcornSSP' SDK를 **CocoaPod**, **SPM** 으로 설치했을 경우 <mark style="color:red;">빨간박스</mark>, \
수동 설치했을 경우 <mark style="color:blue;">파란박스</mark> 코드를 사용해 주셔야 합니다.



**2-2) @@@.m**

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2FsMDsyfa01CDEzg1Xi0Gm%2Fimage.png?alt=media&#x26;token=fd1220e9-f822-4720-a67c-618f7e09c842" alt=""><figcaption></figcaption></figure>

Adapter 코드를 사용하기 위해서 '@@@.m '의 Target을 해당 project 로 설정 해주세요.



### 3) Swift Bridge-Header 추가설정

미디에이션의 네이티브  광고를 사용하고자 할 경우에는 Bridge-Header 파일 내에 각 업체의  어댑터 header 파일을 추가해 주어야 합니다. [\[기본 설정\]](../undefined#id-3) 링크 내의 bridge-header 파일에 아래의 내용을 추가로 설정해 주시기 바랍니다.

아래 내용은 예시이며,  adapter header 파일이 위치하는 경로는 매체의 프로젝트 내 경로에 따라 다르게 지정해야 합니다.

<pre class="language-objectivec"><code class="lang-objectivec"><strong>#import "NAMAdapter.h"
</strong><strong>#import "AdMobAdapter.h"
</strong></code></pre>

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2FFcRQFwJduL31PXv8ItyN%2Fimage.png?alt=media&#x26;token=55e5d305-855d-4cc1-8e6c-84cd09371b61" alt=""><figcaption><p>'Bridge-Header' 내부에 사용하고자 하는 Adapter 추가</p></figcaption></figure>



### 4) Framework 추가

각 네트워크 별로 필요한 iOS Framework를 추가합니다.기본적으로 cocoapod를 통한 설치를 추천하고 있습니다. 단, Mezzo, Cauly의 경우에는 MediationAdapter 파일 내에 framework가 포함되어 있습니다.



### 5) 네트워크별 상세 설정

각 네트워크 별 상세 설정은 아래의 가이드 페이지를 참고하시어 설정 부탁 드립니다.



### 6) SkAdNetworkId 등록 및 SDK 초기화

각 네트워크 별 SkAdNetworkId 등록, SDK 초기화 등은 직접 앱에 작업해 주셔야 하며, 그 밖의 배너, 전면, 리워드 비디오, 네이티브의 연동은 애드팝콘 SSP SDK의 API를 통해서 연동 진행해 주시면 됩니다.&#x20;

SDK 초기화를 AppDelegate.m 시점에 호출하도록 가이드한 업체의 초기화를 누락할 경우, 실제 광고 요청 시 초기화가 이루어져야 하기에, 광고 로딩에 시간이 더 소요되니 참고 하시기 바랍니다.

{% hint style="warning" %}
Unity 개발 환경에서도 각 업체의 UnityPlugin을 설치할 필요는 없고 각 업체의 framework만 추가해 주시면 정상 동작 합니다.
{% endhint %}



## 5. 미디에이션 SDK 초기화

일부 업체의 경우 앱 시작 시, 초기화 코드를 삽입하라고 안내 하고 있습니다. 이에 AppDelegate.m 파일 내에 각 업체 별 초기화 코드를 삽입하시기 바랍니다.&#x20;

자세한 사항은 각 업체 별 가이드 문서를 참고해 주시기 바랍니다.

