기본 설정

1. SDK 다운로드 및 설치

아래 다운로드 링크를 통하여 최신 유니티 플러그인 패키지(v1.1.0)를 다운로드 합니다.

[애드팝콘 SSP 유니티 SDK 다운로드]

2024년 2월 5일부터 애드팝콘 SSP 유니티 플러그인 버전이 Android/iOS 통합되었습니다. 이에 기존 프로젝트에서 애드팝콘 관련 파일 제거 후, 위 링크의 최신 버전(v1.1.0)을 다운로드 하시기 바랍니다.

다운로드받은 .zip 파일의 압축을 풀어 AdPopcornSSPUnityPlugin_v1.1.1.unitypackage 파일을 유니티 프로젝트로 드래그하여 설치합니다.

1) 지원 버전 정보

• AdPopcornSSPUnityPlugin_v1.1.1

  • AdPopcornSSP Android 3.8.2

  • AdPopcornSSP iOS 2.10.3

• AdPopcornSSPUnityPlugin_v1.1.0

  • AdPopcornSSP Android 3.8.2

  • AdPopcornSSP iOS 2.10.2

• AdPopcornSSPUnityPlugin_v1.0.9

  • AdPopcornSSP Android 3.8.1

  • AdPopcornSSP iOS 2.10.0

• AdPopcornSSPUnityPlugin_v1.0.8

  • AdPopcornSSP Android 3.7.4

  • AdPopcornSSP iOS 2.9.7

• AdPopcornSSPUnityPlugin_v1.0.7

  • AdPopcornSSP Android 3.7.4

  • AdPopcornSSP iOS 2.9.4

• AdPopcornSSPUnityPlugin_v1.0.6

  • AdPopcornSSP Android 3.7.0

  • AdPopcornSSP iOS 2.9.0

Importing package 팝업창에서 애드팝콘 SSP에 필요한 Android만 빌드할 경우 아래 항목만을 선택하여 import 합니다.

2. 매니페스트 설정

애드팝콘 SSP를 이용하기 위한 내용을 AndroidManifest.xml 파일에 추가합니다.

1) 앱 키 추가

AdPopcornSSP 홈페이지에서 애드팝콘 앱 등록 후 발급받은 앱 키를 <application></application> 태그 안에 추가합니다.

XML

<application>
... 
<meta-data android:name="adpopcorn_ssp_app_key" android:value="이곳에_앱키를_입력하세요" />
...
</application>

2) 퍼미션 추가

<manifest></manifest>태그 안에 필수 퍼미션을 추가합니다.

XML

<manifest>
... <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
...
</manifest>

3. 코드 연동

1) SDK 초기화

API를 어플리케이션 실행 후 최대한 빠르게 호출하여 SDK를 초기화합니다.

C#

void Start (){	
	Debug.Log ("Start");	
	AdPopcornSSPPlugin.init();
}

인 앱 비딩을 사용하는 매체의 경우 아래 init API를 사용해, 초기화를 진행해 주어야 합니다.

그렇지 않을 경우, 인 앱 비딩을 사용하는 placement 지면에 대한 업데이트가 이루어지지 않아, 인 앱 비딩이 동작하지 않습니다.

C#

public class AdPopcornSSPSampleScene : MonoBehaviour, IInitEventCallbackListener
{
	void Start (){
		Debug.Log ("Start");	
		AdPopcornSSPPlugin.initWithListener (this);
	}
	
	// init Event Callback
	void IInitEventCallbackListener.OnInitializationFinished()
	{
	     // init 작업이 완료 된 뒤, 광고 로드 작업을 진행해 주시기 바랍니다.
	}
}

2) 리소스 해제

destroy API를 이용하여 어플리케이션이 종료될 때 메모리에 할당된 SSP 관련 리소스(View,Memory)를 해제합니다.

앱이 종료될 때 onDestroy()에서 호출합니다.

C#

void OnDestroy(){	
    Debug.Log ("OnDestroy");	
    AdPopcornSSPPlugin.destroy();
}

델리게이트를 사용하기 위해 등록을 했을 경우 OnDestory()에서 등록된 델리게이트의 해제 작업을 진행해야 합니다.