> For the complete documentation index, see [llms.txt](https://adpopcornssp.gitbook.io/ssp-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adpopcornssp.gitbook.io/ssp-sdk/undefined-1/ap-mediation/ap-ios/ios-2.x.x.md). # iOS 2.x.x (구버전) 디스플레이 광고지면에 타 광고네트워크의 광고를 라이브 할 수 있는 기능을 의미하며, 내부/자체 광고의 운영 및 여러 국내/해외의 외부 광고를 노출시킬 수 있어 수익극대화에 효과적입니다. ### 미디에이션이란? * 다양한 타 광고(NAM, AdFit, AdMob 등) 업체를 미리 연동해 둔 Mediation SDK를 활용하여 별다른 설정 없이 손쉽게 이용하실 수 있어 수익 극대화에 효과적인 기능입니다. * 저희 AdPopcornSSP에 각 업체별 Mediation을 설치하시면 각 업체별로 광고 load를 진행하지 않고 AdPopcornSSP load 만으로도 다양한 업체의 광고를 제공받으실 수 있습니다. {% hint style="warning" %} **주의사항** * 애드팝콘 SSP 미디에이션 연동하기 전에 반드시 애드팝콘 SSP 연동이 진행 되어야 합니다. [\[애드팝콘 SSP : iOS\]](/ssp-sdk/sdk/ios/ios-2.x.x/undefined.md) * 애드팝콘 SSP 미디에이션 연동 시 애드팝콘 최신 SSP 버전과 각 업체별 호환 버전을 반드시 확인 후 연동을 진행 부탁 드립니다. * 각 업체별 호환 버전은 아래 가이드 바로가기 링크에 기재가 되어 있으니 확인 부탁 드립니다. {% endhint %} ## 1. 지원 중인 업체 목록

광고 업체	배너	네이티브	전면	전면 비디오	리워드 비디오	비디오 믹스
NAM	O	O	X	X	X	X
AdFit	O	O	X	X	X	X
AppLovin	O	X	O	O	O	O
AppLovinMax	O	O	O	O	O	O
UnityAds	X	X	O	O	O	O
Vungle	O	O	X	O	O	O
FaceBook	O	O	O	O	O	X
AdMob	O	O	O	O	O	O
ADOP	O	O	O	O	O	O
Fyber	O	O	O	O	O	O
MezzoMedia	O	X	X	X	X	X
Cauly	O	X	O	X	X	O
Mintegral	O	O	X	O	O	X
Pangle	X	X	X	O	O	O
InMobi	O	예정	O	O	O	O
Maio	X	X	X	O	O	X

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

광고 업체	CocoaPod	링크	비고
NAM	`pod 'NAMSDK', '8.15.0' pod 'NAMSDK/MediationNDA', '8.15.0'`	Link
AdFit	`pod 'AdFitSDK', '3.18.3'`	Link	3.18.6 이후 부터 SPM만 지원
AppLovin	`pod 'AppLovinSDK', '13.6.2'`	Link
AppLovinMax	`pod 'AppLovinSDK', '13.6.2'`	Link
UnityAds	`pod 'UnityAds', '4.17.0'`	Link
Vungle	`pod "VungleAds", '7.7.1'`	Link
FaceBook	`pod 'FBAudienceNetwork', '6.21.0'`	Link
AdMob	`pod 'Google-Mobile-Ads-SDK', '12.14.0'`	Link
ADOP	`pod 'Google-Mobile-Ads-SDK', '12.14.0'`	Link
Fyber	`pod 'Fyber_Marketplace_SDK', '8.4.2'`	Link
MezzoMedia	수동 설치 - Mediation Mezzo Adapter 내부 framework	Link
Cauly	`pod 'CaulySDK', :git => 'https://github.com/cauly/CaulySDK_iOS.git', :tag => '3.1.22'`	Link
Mintegral	`pod 'MintegralAdSDK', '8.0.3'`	Link
Pangle	`pod 'Ads-Global', '7.9.1.1'`	Link
InMobi	`pod 'InMobiSDK', '11.1.1'`	Link
Maio	`pod 'MaioSDK-v2', '2.2.1'`	Link

### SPM (Swift Package Manager)

광고 업체	SPM 링크	Version	비고
AdFit	https://github.com/adfit/adfit-spm	3.21.6	iOS 15+
NAM	https://github.com/naver/nam-sdk-ios.git	8.15.0	iOS 13+ Xcode 16+

*** {% hint style="warning" %} **미디에이션을 이용하려면 Adapter를 다운로드 해주셔야 합니다.** {% endhint %} ## 3. 미디에이션 Adapter 다운로드 & 초기 Setting 아래 링크로 미디에이션 Adapter 최신 버전을 다운로드 해주세요.\ 이전 어댑터 파일이 필요한 경우, [SDK 호환성 체크](/ssp-sdk/undefined-1/ap-mediation/ap-ios/ios-2.x.x/sdk-mediation-ver.md) 정보에서 다운로드 가능합니다. [\[애드팝콘 SSP iOS Mediation Adapter 다운로드\]](https://github.com/IGAWorksDev/AdPopcornSDK/raw/refs/heads/master/AdPopcornSSP/02-ios-sdk/MediationAdapter/AdPopcornSSPMediationAdapter_260423.zip) ### 1) Adapter 추가

다운받은 Adapter 파일에서 미디에이션시 필요한 파일을 Project에 추가해 주시면 됩니다 (CocoaPod, SPM 별도) ### 2) .h .m 파일 설정 **2-1) @@@.h**

저희 'AdPopcornSSP' SDK를 **CocoaPod**, **SPM** 으로 설치했을 경우 빨간박스, \ 수동 설치했을 경우 파란박스 코드를 사용해 주셔야 합니다. **2-2) @@@.m**

Adapter 코드를 사용하기 위해서 '@@@.m '의 Target을 해당 project 로 설정 해주세요. ### 3) Swift Bridge-Header 추가설정 미디에이션의 네이티브 광고를 사용하고자 할 경우에는 Bridge-Header 파일 내에 각 업체의 어댑터 header 파일을 추가해 주어야 합니다. [\[기본 설정\]](/ssp-sdk/sdk/ios/ios-2.x.x/undefined.md#id-3) 링크 내의 bridge-header 파일에 아래의 내용을 추가로 설정해 주시기 바랍니다. 아래 내용은 예시이며, adapter header 파일이 위치하는 경로는 매체의 프로젝트 내 경로에 따라 다르게 지정해야 합니다.

#import "NAMAdapter.h"
#import "AdMobAdapter.h"

### 4) Framework 추가 각 네트워크 별로 필요한 iOS Framework를 추가합니다.기본적으로 cocoapod를 통한 설치를 추천하고 있습니다. 단, Mezzo, Cauly의 경우에는 MediationAdapter 파일 내에 framework가 포함되어 있습니다. ### 5) 네트워크별 상세 설정 각 네트워크 별 상세 설정은 아래의 가이드 페이지를 참고하시어 설정 부탁 드립니다. ### 6) SkAdNetworkId 등록 및 SDK 초기화 각 네트워크 별 SkAdNetworkId 등록, SDK 초기화 등은 직접 앱에 작업해 주셔야 하며, 그 밖의 배너, 전면, 리워드 비디오, 네이티브의 연동은 애드팝콘 SSP SDK의 API를 통해서 연동 진행해 주시면 됩니다. SDK 초기화를 AppDelegate.m 시점에 호출하도록 가이드한 업체의 초기화를 누락할 경우, 실제 광고 요청 시 초기화가 이루어져야 하기에, 광고 로딩에 시간이 더 소요되니 참고 하시기 바랍니다. {% hint style="warning" %} Unity 개발 환경에서도 각 업체의 UnityPlugin을 설치할 필요는 없고 각 업체의 framework만 추가해 주시면 정상 동작 합니다. {% endhint %} ## 5. 미디에이션 SDK 초기화 일부 업체의 경우 앱 시작 시, 초기화 코드를 삽입하라고 안내 하고 있습니다. 이에 AppDelegate.m 파일 내에 각 업체 별 초기화 코드를 삽입하시기 바랍니다. 자세한 사항은 각 업체 별 가이드 문서를 참고해 주시기 바랍니다.