# 미디에이션 시작하기

{% 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>
```


---

# 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://one-admax-organization.gitbook.io/one-admax-sdk/sdk.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.