> 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/admob-beta/admob-beta-unity-aos.md).

# Admob 미디에이션(Beta, Unity AOS)

## 1. 문서 목적

* 본 문서는 매체사가 **AdPopcornSSP SDK를 통해 Google AdMob 기반 광고 수익화 구조를 연동하는 방법**을 안내합니다.
* 실제 미디에이션 네트워크 구성과 운영은 내부 운영팀이 관리하며, 매체사는 **SDK 연동과 광고 호출 코드 적용만 진행하면 됩니다.**
* 실제 네트워크 구성은 내부 운영 기준에 따라 설정됩니다.

{% hint style="warning" %}
**연동 문의** : 애드팝콘 SSP 사업팀 (<monetize@adpopcorn.com>)
{% endhint %}

{% hint style="warning" %}
다만, 일부 미디에이션의 경우 AGP 버전이 구버전일 경우, 빌드에 실패하므로, UnityTool 최신 버전을 사용해 주셔야 합니다.
{% endhint %}

## 2. 적용 네트워크

별도 예외 협의가 없는 경우, 아래 **최대 범위 네트워크 기준**으로 운영됩니다.

| 네트워크                    | 리워드비디오 | 전면비디오 | 전면배너 | 네이티브 |  배너 |
| ----------------------- | :----: | :---: | :--: | :--: | :-: |
| AppLovin                |    O   |   O   |   O  |   O  |  O  |
| AppLovin Exchange       |    O   |   O   |   O  |   O  |  O  |
| BidMachine              |    O   |   O   |   O  |   O  |  O  |
| Google Bidding          |    O   |   O   |   O  |   O  |  O  |
| IronSource              |    O   |   O   |   O  |   -  |  O  |
| Meta                    |    O   |   O   |   O  |   O  |  O  |
| Mintegral               |    O   |   O   |   O  |   O  |  O  |
| Moloco                  |    O   |   O   |   O  |   O  |  O  |
| Unity                   |    O   |   O   |   O  |   -  |  O  |
| DT Exchange             |    O   |   O   |   O  |   -  |  O  |
| Liftoff Monetize        |    O   |   O   |   O  |   O  |  O  |
| Liftoff Monetize Native |    -   |   -   |   -  |   O  |  -  |
| Pangle                  |    O   |   O   |   O  |   O  |  O  |
| Pangle Native           |    -   |   -   |   -  |   O  |  -  |
| Meta Native             |    -   |   -   |   -  |   O  |  -  |
| InMobi                  |    O   |   O   |   O  |   O  |  O  |
| Google Ad Manager       |    O   |   O   |   O  |   O  |  O  |

## 3. Build.gradle(Project Level)

Pangle SDK를 사용하고자 하는 경우에는 아래 Pangle 부분을 추가해 주시면 됩니다.

#### 3.1  `Custom Gradle Settings Template` 활성화 확인

Unity에서 프로젝트 레벨의 설정을 변경하려면 이 템플릿이 활성화되어 있어야 합니다.

* Unity 에디터 > Edit > Project Settings > Player > Android 탭 > Publishing Settings에서 \*\*`Custom Gradle Settings Template`\*\*가 체크되어 있는지 확인합니다.

#### 3.2 `settingsTemplate.gradle` 파일 수정

프로젝트 레벨 설정 파일인 `Assets/Plugins/Android/settingsTemplate.gradle` 파일을 열고, `allprojects { repositories { ... } }` 블록 내에 IS/Mintegral/Pangle/Pubmatic 저장소 URL을 추가해야 합니다.

```java
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        **ARTIFACTORYREPOSITORY**
        google()
        mavenCentral()		
        // IronSource
        maven {
            url = uri("https://android-sdk.is.com/")
        }
        // Mintegral
        maven {
            url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
        }
        // Pangle
        maven {
            url = uri("https://artifact.bytedance.com/repository/pangle/")
        }
        // Pubmatic
        maven {
            url = uri("https://repo.pubmatic.com/artifactory/public-repos")
        }
    }
}
```

## 4. Build.gradle(App Level)

아래 설정 중, Common 라이브러리와 사용 예정인 업체의 SDK만 탑재하면 됩니다.

#### 4.1  `Custom Base Gradle Template` 활성화 확인

Unity에서 프로젝트 레벨의 설정을 변경하려면 이 템플릿이 활성화되어 있어야 합니다.

* Unity 에디터 > Edit > Project Settings > Player > Android 탭 > Publishing Settings에서 \*\*`Custom Main Gradle Template`\*\*가 체크되어 있는지 확인합니다.

#### 4.2 `mainTemplate.gradle` 파일 수정

위 설정을 활성화하면, Unity는 프로젝트 내의 특정 폴더에 기본 템플릿 파일을 생성합니다.

* 생성된 파일 경로: `Assets/Plugins/Android/mainTemplate.gradle`

```java
dependencies{
    // Common
    implementation 'com.igaworks.ssp:IgawAdPopcornSSP:3.11.1'
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    api 'com.google.android.gms:play-services-ads-identifier:18.2.0'
    
    // Admob mediation Adapter
    implementation("com.google.ads.mediation:applovin:13.6.2.0")
    implementation("com.google.ads.mediation:fyber:8.4.5.0")
    implementation("com.google.ads.mediation:inmobi:11.3.0.0")
    implementation("com.google.ads.mediation:ironsource:9.4.2.0")
    implementation("com.google.ads.mediation:vungle:7.7.4.0")
    implementation("com.google.ads.mediation:line:3.1.0.0")
    implementation("com.google.ads.mediation:facebook:6.21.0.3")
    implementation("com.google.ads.mediation:mintegral:17.1.61.0")
    implementation("com.google.ads.mediation:moloco:4.9.0.0")
    implementation("com.google.ads.mediation:pangle:8.0.0.5.0")
    implementation("com.google.ads.mediation:pubmatic:5.1.2.0")
    implementation("com.unity3d.ads:unity-ads:4.18.0")
    implementation("com.google.ads.mediation:unity:4.18.0.0")
}
```

## 5. AndroidManifest.xml

AdMob SDK를 사용하는 경우에는 아래의 설정을 추가해 줍니다.

입력해야 되는 키 값에 대해서는 사업팀(<monetize@adpopcorn.com>)에 문의해 주세요

```
<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
```