# AP미디에이션(iOS)

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

## 미디에이션이란?

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

{% hint style="warning" %}
**주의사항**

* 애드팝콘 SSP 미디에이션 연동하기 전에 반드시 APSSPSDK 기본 연동이 진행 되어야 합니다.
* 미디에이션 연동 시 APSSPSDK 최신 버전과 각 업체별 호환 버전을 반드시 확인 후 연동을 진행 부탁 드립니다.
  {% endhint %}

***

## 지원 중인 업체 목록

<table><thead><tr><th width="130.4913330078125">광고 업체</th><th width="78.2255859375" align="center">배너</th><th width="141.5850830078125" align="center">네이티브</th><th width="74.4713134765625" align="center">전면</th><th width="109.467041015625" align="center">전면 비디오</th><th width="121.7109375" align="center">리워드 비디오</th><th width="112.8436279296875" align="center">비디오 믹스</th></tr></thead><tbody><tr><td>NAM</td><td align="center">O</td><td align="center">O</td><td align="center">-</td><td align="center">-</td><td align="center">-</td><td align="center">-</td></tr><tr><td>AdFit</td><td align="center">O</td><td align="center">O</td><td align="center">-</td><td align="center">-</td><td align="center">-</td><td align="center">-</td></tr><tr><td>AppLovin</td><td align="center">O</td><td align="center">-</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td></tr><tr><td>AppLovinMax</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td></tr><tr><td>UnityAds</td><td align="center">-</td><td align="center">-</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td></tr><tr><td>Vungle</td><td align="center">O</td><td align="center">O</td><td align="center">-</td><td align="center">O</td><td align="center">O</td><td align="center">O</td></tr><tr><td>FaceBook</td><td align="center">O</td><td align="center">O <br>(Only Bidding)</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td></tr><tr><td>AdMob</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td></tr><tr><td>ADOP</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td></tr><tr><td>Fyber</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td></tr><tr><td>MezzoMedia</td><td align="center">O</td><td align="center">-</td><td align="center">-</td><td align="center">-</td><td align="center">-</td><td align="center">-</td></tr><tr><td>Cauly</td><td align="center">O</td><td align="center">-</td><td align="center">O</td><td align="center">-</td><td align="center">-</td><td align="center">O</td></tr><tr><td>Mintegral</td><td align="center">O</td><td align="center">O</td><td align="center">-</td><td align="center">O</td><td align="center">O</td><td align="center">-</td></tr><tr><td>Pangle</td><td align="center">-</td><td align="center">-</td><td align="center">-</td><td align="center">O</td><td align="center">O</td><td align="center">O</td></tr><tr><td>InMobi</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td></tr><tr><td>Maio</td><td align="center">-</td><td align="center">-</td><td align="center">-</td><td align="center">O</td><td align="center">O</td><td align="center">-</td></tr><tr><td>CSJ</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">O</td></tr><tr><td>Moloco</td><td align="center">O</td><td align="center">O</td><td align="center">O</td><td align="center">-</td><td align="center">O</td><td align="center">O</td></tr><tr><td>Fluct</td><td align="center">O</td><td align="center">-</td><td align="center">O</td><td align="center">-</td><td align="center">O</td><td align="center">-</td></tr></tbody></table>

***

## 설치 방법

### CocoaPods

각 업체별 Mediation Adapter를 CocoaPods로 설치합니다. 사용하고자 하는 업체만 추가하면 됩니다.

```ruby
# Podfile

platform :ios, '15.0'

target 'YourApp' do
  use_frameworks! :linkage => :static       #  3rd party SDK가 static xcframework 이므로 필수

  # APSSPSDK 코어 (필수)
  pod 'APSSPSDK', '3.1.0'

  # 미디에이션 Adapter (사용할 업체만 추가)
  pod 'APSSPMediationAdMob'
  pod 'APSSPMediationADOP'
  pod 'APSSPMediationGAM'
  pod 'APSSPMediationAdForus'
  pod 'APSSPMediationAppLovin'
  pod 'APSSPMediationAppLovinMax'
  pod 'APSSPMediationVungle'
  pod 'APSSPMediationUnityAds'
  pod 'APSSPMediationPangle'
  pod 'APSSPMediationFBAudienceNetwork'
  pod 'APSSPMediationMintegral'
  pod 'APSSPMediationFyber'
  pod 'APSSPMediationNAM'
  pod 'APSSPMediationAdFit'            # CocoaPods 최종 버전: 3.18.3 (이후 SPM만 지원)
  pod 'APSSPMediationMezzo'
  pod 'APSSPMediationInMobi'
  pod 'APSSPMediationMaio'
  pod 'APSSPMediationCSJ'
  pod 'APSSPMediationMoloco'
  pod 'APSSPMediationFluct'
end
```

{% hint style="warning" %}
위 목록에서 사용하지 않는 업체는 제거하세요. 전부 추가할 필요 없습니다.
{% endhint %}

### SPM (Swift Package Manager)

<table><thead><tr><th width="154.70220947265625">광고 업체</th><th width="144.1136474609375" align="center">CocoaPod 지원</th><th width="146.603271484375" align="center">SPM 지원</th><th>비고</th></tr></thead><tbody><tr><td>AdMob</td><td align="center">✅</td><td align="center">✅</td><td></td></tr><tr><td>ADOP</td><td align="center">✅</td><td align="center">✅</td><td></td></tr><tr><td>GAM</td><td align="center">✅</td><td align="center">✅</td><td></td></tr><tr><td>AdForus</td><td align="center">✅</td><td align="center">✅</td><td></td></tr><tr><td>AppLovin</td><td align="center">✅</td><td align="center">✅</td><td></td></tr><tr><td>AppLovinMax</td><td align="center">✅</td><td align="center">✅</td><td></td></tr><tr><td>Vungle</td><td align="center">✅</td><td align="center">✅</td><td></td></tr><tr><td>Pangle</td><td align="center">✅</td><td align="center">✅</td><td></td></tr><tr><td>Mintegral</td><td align="center">✅</td><td align="center">✅</td><td></td></tr><tr><td>NAM</td><td align="center">✅</td><td align="center">✅</td><td></td></tr><tr><td>AdFit</td><td align="center">✅</td><td align="center">✅</td><td><strong>3.18.6 이후 SPM만 지원</strong> <br>(CocoaPods 최종: 3.18.3)</td></tr><tr><td>Mezzo</td><td align="center">✅</td><td align="center">✅</td><td></td></tr><tr><td>Moloco</td><td align="center">✅</td><td align="center">✅</td><td></td></tr><tr><td>FAN</td><td align="center">✅</td><td align="center">❌</td><td></td></tr><tr><td>UnityAds</td><td align="center">✅</td><td align="center">❌</td><td></td></tr><tr><td>Fyber</td><td align="center">✅</td><td align="center">❌</td><td></td></tr><tr><td>InMobi</td><td align="center">✅</td><td align="center">❌</td><td></td></tr><tr><td>Maio</td><td align="center">✅</td><td align="center">❌</td><td></td></tr><tr><td>CSJ</td><td align="center">✅</td><td align="center">❌</td><td></td></tr><tr><td>Fluct</td><td align="center">✅</td><td align="center">❌</td><td></td></tr><tr><td>Cauly</td><td align="center">❌</td><td align="center">✅</td><td>cauly Pod Trunk 배포 x 이슈로 <br>SPM 만 지원</td></tr></tbody></table>

***

## 네트워크별 상세 설정

각 네트워크 별 상세 설정(Info.plist, SkAdNetworkId 등)은 해당 업체의 공식 가이드를 참고하세요.

<table><thead><tr><th width="120.1197509765625">업체</th><th>공식 가이드</th></tr></thead><tbody><tr><td>NAM</td><td><a href="https://naver.github.io/nam-sdk-guide/">https://naver.github.io/nam-sdk-guide/</a></td></tr><tr><td>AdFit</td><td><a href="https://adfit.github.io/adfit-ios-sdk/documentation/adfitsdk/">https://adfit.github.io/adfit-ios-sdk/documentation/adfitsdk/</a></td></tr><tr><td>AppLovin</td><td><a href="https://developers.applovin.com/en/max/ios/overview/integration">https://developers.applovin.com/en/max/ios/overview/integration</a></td></tr><tr><td>UnityAds</td><td><a href="https://docs.unity.com/grow/en-us/ads/ios-sdk/install-sdk">https://docs.unity.com/grow/en-us/ads/ios-sdk/install-sdk</a></td></tr><tr><td>Vungle</td><td><a href="https://support.vungle.com/hc/en-us/articles/360002925791">https://support.vungle.com/hc/en-us/articles/360002925791</a></td></tr><tr><td>FAN</td><td><a href="https://developers.facebook.com/docs/audience-network/">https://developers.facebook.com/docs/audience-network/</a></td></tr><tr><td>AdMob</td><td><a href="https://developers.google.com/admob/ios/quick-start">https://developers.google.com/admob/ios/quick-start</a></td></tr><tr><td>Fyber</td><td><a href="https://developer.digitalturbine.com/hc/en-us/articles/360010915618https://docs.digitalturbine.com/dt-exchange/publishers/sdk-configuration/integrating-the-ios-sdk">https://docs.digitalturbine.com/dt-exchange/publishers/sdk-configuration/integrating-the-ios-sdk</a></td></tr><tr><td>Mintegral</td><td><a href="https://github.com/Mintegral-official/MintegralAdSDK-iOS-new">https://github.com/Mintegral-official/MintegralAdSDK-iOS-new</a></td></tr><tr><td>Pangle</td><td><a href="https://www.pangleglobal.com/integration/integrate-pangle-sdk-for-ios">https://www.pangleglobal.com/integration/integrate-pangle-sdk-for-ios</a></td></tr><tr><td>Cauly</td><td><a href="https://github.com/cauly/iOS-SDK">https://github.com/cauly/iOS-SDK</a></td></tr><tr><td>InMobi</td><td><a href="https://support.inmobi.com/monetize/sdk-documentation/ios-guidelines/">https://support.inmobi.com/monetize/sdk-documentation/ios-guidelines/</a></td></tr><tr><td>Maio</td><td><a href="https://github.com/imobile/MaioSDK-v2-iOS">https://github.com/imobile/MaioSDK-v2-iOS</a></td></tr></tbody></table>

***

## 네이티브 광고 미디에이션 Layout & Renderer 설정

네이티브 광고 미디에이션 사용 시 각 업체별 Renderer을 `APSSPNativeAd`에 설정해야 합니다.

자세한 내용은 [네이티브 가이드](/ssp-sdk/sdk/ios/ios-3.1.0+/undefined-2.md)의 "네이티브 레이아웃 가이드" 섹션을 참고하세요.

***

## SkAdNetworkId 등록

각 네트워크 별 SkAdNetworkId를 `Info.plist`에 등록해야 합니다. \
자세한 내용은 [미디에이션 초기셋팅](/ssp-sdk/undefined-1/ap/ap-ios/undefined.md#skadnetwork-ids)의 "SKAdNetwork IDs" 섹션을 참고하세요.

***

## 주의사항

1. 각 업체의 SDK 버전은 APSSPSDK와 호환되는 버전을 사용해야 합니다.
2. 위 리스트에 적힌 호환 버전 이외의 버전을 사용하고자 하는 경우 반드시 애드팝콘 SSP 사업팀 (<monetize@adpopcorn.com>) 문의 후 사용하시기 바랍니다.


---

# Agent Instructions: 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:

```
GET https://adpopcornssp.gitbook.io/ssp-sdk/undefined-1/ap/ap-ios.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
