애드팝콘 SSP 콘솔 바로가기

기본 설정

1. SDK 다운로드 및 설치

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

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

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

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

1) 지원 버전 정보

  • AdPopcornSSPUnityPlugin_v1.1.2

    • AdPopcornSSP Android 3.8.3

    • AdPopcornSSP iOS 2.10.4

  • 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()에서 등록된 델리게이트의 해제 작업을 진행해야 합니다.

3) GDPR 설정

EU의 GDPR (General Data protection Regulation) 법안에 대응하기 위해 아래 API를 추가 합니다.

GDPR 동의 여부 세팅을 위해 아래의 API가 추가 되었습니다. 기본 값은 True이고 GDPR 동의가 필요한 유저에 한해 아래 API를 호출하시기 바랍니다.

AdPopcornSSPPlugin.gdprConsentAvailable(false);

4) COPPA 설정

COPPA 대응을위해 아래의 API가 추가 되었습니다. 기본 값은 false 이고 COPPA에 따라 콘텐츠를 아동 대상으로 지정하려면 아래 API를 이용하여 true로 설정해 주세요

AdPopcornSSPPlugin.tagForChildDirectedTreatment(true);

PreviousUnity (Android)Next배너 광고

Last updated

Was this helpful?