# Unity

ADPOPCORN SSP는 Unity 환경에서 ADPOPCORN만의 독보적인 인앱 비딩 기술을 통해 DSP파트너와 미디에이션 파트너간 실시간 입찰을 지원하여 eCPM 상승을 유도합니다. DSP 및 미디에이션 파트너 연동을 위해 하기 가이드 내용을 참고해주시기 바랍니다.

## 1. 연동을 위한 키 발급

연동을 위해서는 연동에 사용되는 <mark style="color:red;">**앱키**</mark>와 <mark style="color:red;">**지면키(Placementid)**</mark>에 대한 발급이 필요합니다. 연동하는 과정에서 필수로 사용되는 키값이며 [SSP Console](https://www.console.adpopcorn.com/) 회원가입 및 가입 승인 후 발급하거나, 사업부와의 논의를 통해 발급받을 수 있습니다.&#x20;

**\[사업부와 논의 진행 시]**

1. 사업부를 통해 사전질의서를 기반으로 지면 구성을 논의합니다.&#x20;

* 사전질의서 포함 내용 : 활용 지면 구성 및 희망 미디에이션

2. 논의를 기반으로 생성된 지면 정보를 확인합니다.&#x20;

<table><thead><tr><th>App Name</th><th width="98">OS</th><th>AppKey</th><th width="147">Placement id</th><th width="224">Placement name</th><th>Type</th></tr></thead><tbody><tr><td>ADPOPCORN</td><td>android</td><td>123456789</td><td>ABCDE123FGH</td><td>리워드_기본지면_Android</td><td>비디오믹스</td></tr><tr><td>ADPOPCORN</td><td>iOS</td><td>123456790</td><td>IJKLMNO456P</td><td>리워드_기본지면_iOS</td><td>비디오믹스</td></tr></tbody></table>

* 전달받은 Appkey Placement\_id를 활용, 이후 연동가이드를 따라 연동을 진행해주시면 됩니다.&#x20;

{% hint style="info" %}
해당 과정에서 [SSP Console](https://www.console.adpopcorn.com/) 회원가입이 필요하며, 이후 지면 정보 및 통계를 SSP Console을 통해 확인이 가능합니다.
{% endhint %}

## 2. UnityPackage 다운로드 및 지원 버전 정보

UnityPackage는 android/ios 통합하여 제공합니다.

아래 링크에서 애드팝콘에서  제공하는 최신 버전(v1.1.12) unitypackage를 다운로드 해주세요.

[\[AdPopcornSSPUnityPackage\]](https://github.com/IGAWorksDev/AdPopcornSDK/raw/refs/heads/master/AdPopcornSSP/03-unity-plugin/AdPopcornSSPUnityPlugin_v1.1.12.unitypackage)

v1.1.8 버전은 애드팝콘 SSP SDK 아래 버전과 호환됩니다.

* Unity2022.3.6f3 Editor
  * 다른 Editor를 사용중, 빌드에 문제가 생길 경우 문의해 주세요
* AdPopcornSSP Android 3.10.0
* AdPopcornSSP iOS 2.11.8

UnityPackage import 시, 선택해야될 내용은 아래에서 확인 가능합니다.

<details>

<summary>Import UnityPackage</summary>

* Android

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2F13QognlfVDS7QHWoUI7X%2Fimage.png?alt=media&#x26;token=eb28d077-e1d2-469a-b29c-5a995038b83a" alt="" width="563"><figcaption></figcaption></figure>

* iOS

<figure><img src="https://50533756-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqmkw7pJLtjFGD5fwChbN%2Fuploads%2Fv72tr3efZ5aCDvhBhPig%2Fimage.png?alt=media&#x26;token=4fc08dd5-12c2-478a-a94c-bbff12a2ee8a" alt="" width="375"><figcaption></figcaption></figure>

</details>

## 3. 미디에이션 연동

ADPOPCORN 외의 미디에이션 적용을 위해서는 하기 Unity 미디에이션 페이지에서 상세 내용 확인이 가능합니다.&#x20;

ADPOPCORN이  Unity 환경에서 지원하는 미디에이션은 아래와 같습니다.&#x20;

* AppLovin
* UnityAds
* Vungle(Liftoff)
* Meta(FAN)
* AdMob
* Fyber
* Pangle

{% hint style="info" %}
미디에이션은 사전에 협의된 항목을 기반으로 해당하는 항목에 대해서만 적용해주시면 됩니다.&#x20;

미디에이션 연동 가이드를 참고하시어 SDK별 호환 버전 확인 후 연동을 진행해주시기 바랍니다.&#x20;
{% endhint %}

<a href="../undefined-1/ap/ap-unity-aos" class="button primary" data-icon="link">안드로이드 Unity 미디에이션</a>&#x20;

<a href="../undefined-1/ap/ap-unity-ios" class="button primary" data-icon="link">iOS Unity 미디에이션</a>&#x20;

## 4. 연동 기본 설정

<a href="unity/unity-android/undefined" class="button primary" data-icon="link">안드로이드 연동 기본 설정</a>&#x20;

<a href="unity/unity-ios/undefined" class="button primary" data-icon="link">iOS 연동 기본 설정</a>&#x20;

## 5. 지원 광고 형식

Unity 환경에서는 비디오 믹스 광고 형식을 지원합니다.&#x20;

### 비디오 믹스 광고

비디오 믹스 광고는 ADPOPCORN만의 광고 형식으로 전면, 전면비디오, 리워드비디오를 혼합하여 광고 지면을 활용할 수 있는 상품입니다. 하나의 광고 형식 적용만으로 다양한 전면 형태의 광고를 송출할 수 있습니다.&#x20;

{% hint style="info" %}
ADPOPCORN에서 제공하는 광고의 기반은 리워드 비디오이며 미디에이션 활용 시 전면, 전면비디오, 리워드 비디오를 혼합하여 광고를 송출합니다.&#x20;
{% endhint %}

<a href="unity/unity-android/undefined-1" class="button primary" data-icon="link">안드로이드 비디오 믹스 광고</a>&#x20;

<a href="unity/unity-ios/undefined-1" class="button primary" data-icon="link">iOS 비디오 믹스 광고</a>&#x20;

## 6. 보상형 광고 플러스

보상형 광고 플러스는 페이먼트사와 협업하여 인앱 재화 지급 외에 페이먼트 포인트를 지급할 수 있는 ADPOPCORN만의 광고 상품입니다. 국내에서는 네이버페이 포인트를 지원하고 있으며 일본에서는 PAYPAY 포인트 쿠폰 발급을 지원합니다.&#x20;

보상형 광고 플러스는 매체에서 진행하는 1차 광고에서 포인트 박스 혹은 뽑기권을 지급하고, 보상형 광고 리워드 페이지에서 박스 열기 및 포인트 뽑기를 통해 2차 광고 시청 후 포인트를 지급하는 상품입니다.&#x20;

### 보상형 광고 지원 타입

* **포인트 박스형 (고정형)** : 매체에서 설정한 포인트 금액을 고정으로 사용자에게 지급하는 방식입니다. "포인트 박스"를 지급하며, 박스 열기를 통해 광고 시청 후 포인트를 지급합니다.&#x20;
* **포인트 뽑기형 (확률형)** : 매체에서 세팅한 뽑기 확률에 따라 사용자에게 포인트를 지급하는 방식입니다. "포인트 뽑기권"을 지급하여 뽑기를 통해 광고 시청 후 포인트를 지급합니다.&#x20;

{% hint style="info" %}
보상형 광고 지원타입은 적용 및 운영을 시작하면 변경이 불가합니다.&#x20;
{% endhint %}

### 지원 페이먼트

* **네이버페이** : 한국어 기반으로 운영되며, 사용자가 보상형 광고 리워드 페이지에서 1회 네이버 계정 연동 후 포인트 지급이 가능합니다.&#x20;
* **PAYPAY** : 일본어 기반으로 운영되며, 사용자는 별도 계정 연동 없이 포인트 쿠폰을 뽑을 수 있으며, PAYPAY 앱에서 쿠폰을 사용하여 포인트를 지급 받을 수 있습니다.&#x20;

보상형 광고 플러스에 대한 상세 연동 가이드는 아래에서 확인 가능합니다.&#x20;

<a href="unity/unity-android/undefined-2" class="button primary" data-icon="link">안드로이드 보상형 광고 플러스 연동</a>&#x20;

<a href="unity/unity-ios/undefined-2" class="button primary" data-icon="link">iOS 보상형 광고 플러스 연동</a>&#x20;