> For the complete documentation index, see [llms.txt](https://one-admax-organization.gitbook.io/one-admax-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-admax-organization.gitbook.io/one-admax-sdk/sdk.md).

# 미디에이션 시작하기

{% hint style="info" %}
**광고지면에 타 광고네트워크의 광고를 활성화하는기능입니다.**\
**안정적인 Fill-rate과 eCPM을 위해 미디에이션 작업을 추천합니다.**
{% endhint %}

## 미디에이션 키 발급 요청하기 <a href="#id-03." id="id-03."></a>

1. ONE AdMax 콘솔에 로그인 하여 \[플레이스먼트 관리] 메뉴로 이동하여, 미디에이션을 적용할 플레이스먼트를 클릭합니다.<br>

   <figure><img src="/files/t7eBdjuAIT7eUWNuun5i" alt=""><figcaption></figcaption></figure>
2. \[국가/지역별  미디에이션 설정] 항목 중 \[key 발급 요청] 에서 미디에이션으로 추가할 플랫폼을 선택하고  \[발급 요청]을 클릭합니다. \
   (리워드 비디오의 경우 AppLovin, UnityAds, Vungle을 모두 추가 하시는 것을 추천합니다.)

   <figure><img src="/files/XfQL38l476qfx4QMcG68" alt=""><figcaption></figcaption></figure>
3. 키 발급까지는 최대 1일정도 소요되며, 완료되면 매칭정보가 '등록 완료'로 변경됩니다.<br>

   <figure><img src="/files/IpRKGJCK9p21kKlBs0zR" alt=""><figcaption></figcaption></figure>
4. Drag\&Drop을 통해 미디에이션 호출 순서를 변경할 수 있습니다.<br>

   <figure><img src="/files/LimNDZetiEOd1lDJmr89" alt=""><figcaption></figcaption></figure>

## Dependency Settings

앱 수준 build.gradle에 다음과 같이 사용하고자 하는 미디에이션 업체의 sdk dependency를 추가합니다.

```java
dependencies {
    ...
     
    // AppLovin
    implementation 'com.applovin:applovin-sdk:13.1.0'
 
    // Cauly
    implementation 'com.fsn.cauly:cauly-sdk:3.5.39'
 
    // MezzoMedia. adMan.jar v300
    implementation files( 'libs/manlibrary_v3.0.0_20250210.jar' ) 
 
    // Mobon
    implementation( 'io.github.mobon:mobonSDK:1.0.0.65'){
      transitive = true
    }
     
    // UnityAds
    implementation 'com.unity3d.ads:unity-ads:4.16.5'
     
    // Vungle
    implementation 'com.vungle:vungle-ads:7.4.3'
    
    ...
}
```

## ※ 미디에이션 적용 시 주의사항

1. 각 업체 별 proguard 설정이필요한 경우, 아래 가이드 링크에서 확인 후 설정해주세요.
2. 호환 버전 이외의 버전을 사용하고자 하는 경우,   <oneadmax@onestorecorp.com> 으로 문의해 주세요.&#x20;
3. 일부 업체의 광고 타입의 경우 앱의 activity life cycle에 따라 추가 연동이 필요할 수 있습니다. \
   각 업체의 가이드 링크를 확인해주세요.

* **미디에이션 파트너(총 6종)** : Vungle, Mobon, MezzoMedia, Cauly, UnityAds, AppLovin<br>

  <table data-header-hidden><thead><tr><th width="150">업체 이름</th><th width="164">호환 버전</th><th width="183">지원 광고 형식</th><th>가이드</th></tr></thead><tbody><tr><td>Company Name</td><td>Compatible Version</td><td>Supported Ad Format</td><td>GUIDE</td></tr><tr><td>Vungle</td><td>7.4.3</td><td>Rewarded Video, Interstitial Video</td><td><a href="https://support.vungle.com/hc/en-us/articles/360002922871">https://support.vungle.com/hc/en-us/articles/360002922871</a></td></tr><tr><td>Mobon</td><td>1.0.0.65</td><td>Banner, Interstitial</td><td><a href="https://github.com/mobon/MobonSDK_Sample2">https://github.com/mobon/MobonSDK_Sample2</a></td></tr><tr><td>MezzoMedia</td><td>v300(20250210)</td><td>Banner</td><td><a href="http://docs.meba.kr/s-plus/sdk/android_v2/">http://docs.meba.kr/s-plus/sdk/android_v2/</a></td></tr><tr><td>Cauly</td><td><mark style="color:$info;">3.5.39</mark></td><td>Banner, Interstitial</td><td><a href="https://github.com/cauly/Android-SDK/blob/master/Android%20SDK%20%EC%97%B0%EB%8F%99%20%EA%B0%80%EC%9D%B4%EB%93%9C.md#1-CAULY-%EC%8B%9C%EC%9E%91%ED%95%98%EA%B8%B0">https://github.com/cauly/Android-SDK/blob/master/Android SDK 연동 가이드.md#1-CAULY-시작하기<br>(For SDK integration guide, start with CAULY in the SDK Integration)</a></td></tr><tr><td>UnityAds</td><td><mark style="color:$info;">4.16.5</mark></td><td>Rewarded Video, Interstitial Video, Banner</td><td><a href="https://github.com/Unity-Technologies/unity-ads-android/releases/tag/4.12.2">https://github.com/Unity-Technologies/unity-ads-android</a></td></tr><tr><td>AppLovin</td><td>13.1.0</td><td>Banner, Native, Rewarded Video, Interstitial Video</td><td><a href="https://dash.applovin.com/documentation/mediation/android/getting-started/integration">https://dash.applovin.com/documentation/mediation/android/getting-started/integration</a></td></tr></tbody></table>

## 미디에이션 별 연동 특이사항

* Cauly\
  프로젝트 수준 build.gradle에 다음과 같이 maven을 추가합니다.<br>

  ```gradle
  repositories {
      google()
      mavenCentral()
   
      // Cauly
      maven { url 'https://cauly.github.io/cauly-sdk-android-maven/maven-repo' }
  }
  ```

* AppLovin

{% hint style="danger" %}
ONE AdMax SDK v1.2.0 하위 버전에서 v.1.2.0 이상  버전으로 업데이트하는 경우,  AppLovin SDK 키를 더 이상 입력할 필요가 없습니다.  \
따라서, 기 적용된 아래 코드를 삭제 후 업데이트 해주세요.
{% endhint %}

```csharp
<application>
    ...
    <meta-data android:name="applovin.sdk.key" android:value="nPNmWdnX7aDsJQd7yPG7w-rzdTAJJ3qcBNpgSoWzDrm4bUMSmHZJsv-2XRTSiOItVTm7FWZ7PrkUEKeVvlomd1" />
    ...
</application>
```