기본 설정

1. SDK 다운로드 및 설치

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

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

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

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

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. SDK 초기화

API를 어플리케이션 실행 후 최초로 로드되는 activity에서 호출하여 SDK를 초기화합니다.

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

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

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

해당 API는 AdPopcornSSPUnityPlugin_aos_v3.0.16_rev1 버전부터 지원합니다.

C#
public class AdPopcornSSPSampleScene : MonoBehaviour, IInitEventCallbackListener
{
		void Start (){
			Debug.Log ("Start");	
			AdPopcornSSPPlugin.initWithListener (this);
		}

		// init Event Callback
		void IInitEventCallbackListener.OnInitializationFinished()
		{
	         // init 작업이 완료 된 뒤, 광고 로드 작업을 진행해 주시기 바랍니다.
		}
}

4. 리소스 해제

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

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

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

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

Last updated