미디에이션

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

미디에이션이란?

• 다양한 타 광고(NAM, AdFit, AdMob 등) 업체를 미리 연동해 둔 Mediation SDK를 활용하여 별다른 설정 없이 손쉽게 이용하실 수 있어 수익 극대화에 효과적인 기능입니다.

• 저희 AdPopcornSSP에 각 업체별 Mediation을 설치하시면 각 업체별로 광고 load를 진행하지 않고 AdPopcornSSP load 만으로도 다양한 업체의 광고를 제공받으실 수 있습니다.

주의사항

• 애드팝콘 SSP 미디에이션 연동하기 전에 반드시 애드팝콘 SSP 연동이 진행 되어야 합니다. [애드팝콘 SSP : iOS]

• 애드팝콘 SSP 미디에이션 연동 시 애드팝콘 최신 SSP 버전과 각 업체별 호환 버전을 반드시 확인 후 연동을 진행 부탁 드립니다.

• 각 업체별 호환 버전은 아래 가이드 바로가기 링크에 기재가 되어 있으니 확인 부탁 드립니다.

1. 지원 중인 업체 목록

광고 업체	Banner	Native	Interstitial	InterstitialVideo	RewardVideo
NAM	O	O	X	X	X
AdFit	O	O	X	X	X
AppLovin	O	X	O	O	O
AppLovinMax	O	O	O	O	O
UnityAds	O	X	O	O	O
Vungle	O	O	X	O	O
FaceBook	X	X	O	O	O
AdMob	O	O	O	O	O
ADOP	O	O	O	O	O
Fyber	X	X	X	O	O
MezzoMedia	O	X	X	X	X
Cauly	O	X	O	X	X
Mintegral	O	O	X	O	O
Pangle	O	X	X	O	O

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.5.1'	Link
AppLovinMax	pod 'AppLovinSDK', '13.5.1'	Link
UnityAds	pod 'UnityAds', '4.16.4'	Link
Vungle	pod "VungleAds", '7.6.2'	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.8.0.3'	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+

---

미디에이션을 이용하려면 Adapter를 다운로드 해주셔야 합니다.

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

아래 링크로 미디에이션 Adapter 최신 버전을 다운로드 해주세요. 이전 어댑터 파일이 필요한 경우, SDK 호환성 체크 정보에서 다운로드 가능합니다.

[애드팝콘 SSP iOS Mediation Adapter 다운로드]

1) Adapter 추가

Drag & Drop

다운받은 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 파일을 추가해 주어야 합니다. [기본 설정] 링크 내의 bridge-header 파일에 아래의 내용을 추가로 설정해 주시기 바랍니다.

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

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

'Bridge-Header' 내부에 사용하고자 하는 Adapter 추가

4) Framework 추가

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

5) 네트워크별 상세 설정

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

6) SkAdNetworkId 등록 및 SDK 초기화

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

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

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

5. 미디에이션 SDK 초기화

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

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