> 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/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/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 파일 내에 각 업체 별 초기화 코드를 삽입하시기 바랍니다. 자세한 사항은 각 업체 별 가이드 문서를 참고해 주시기 바랍니다. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://adpopcornssp.gitbook.io/ssp-sdk/undefined-1/ap/ap-ios/ios-2.x.x.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.