기본 설정

1. SDK 다운로드 및 설치

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

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

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

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

1) 지원 버전 정보

• 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에 필요한 iOS만 빌드할 경우 아래 항목만 선택하여 import 합니다.

2. 코드 연동

1) IDFA 설정

Adsupport Framework를 Dependencies에 추가합니다.

AdSupport Framework가 추가되지 않으면 애드팝콘 SSP 서비스가 정상 동작 하지 않습니다.

iOS 14 버전의 사용자에게는 AdSupport Framework 추가 이외에 아래의 연동을 통해 수집 동의를 받아야 합니다.

1. App Tracking Transparency framework를 Dependencies에 추가합니다.

2. 앱 추적 투명성 승인 요청

IDFA에 액세스하기 위한 앱 추적 투명성 승인 요청을 표시하려면 Info.plist을 업데이트하여 사용을 설명하는 맞춤 메시지와 함께 NSUserTrackingUsageDescription 키를 추가합니다. 다음은 설명 텍스트의 예입니다.

This identifier will be used to deliver personalized ads to you.

위 설정 후, 다음과 같이 코드에서 requestTrackingAuthorizationWithCompletionHandler:를 호출하여 승인 요청을 합니다. 승인 요청할 경우 아래와 같은 동의 팝업이 노출되게 됩니다.

승인 여부에 대한 결과 값을 받은 후, 광고 로드를 시작하여야 애드팝콘 SDK에서 IDFA를 사용할 수 있습니다. 이에 해당 API는 광고 요청 전에 반드시 마무리 되어야 합니다. 아래 코드를 Xcode 내에서 설정하여 사용하시기 바랍니다.

Objective-C

#import <AppTrackingTransparency/AppTrackingTransparency.h>
#import <AdSupport/AdSupport.h>
...
- (void)requestIDFA {
  [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
    // Tracking authorization completed. Start loading ads here.    
  }];
}

2) 로그 수준 설정

SDK에서 노출하는 로그의 수준을 설정할 수 있습니다.

setLogLevel API를 이용하여 설정하며 수준을 결정하는 값은 AdPopcornSSPPluginIOS 에 정의된 enum을 사용하며 각 수준은 다음과 같습니다.

enum	설명
AdPopcornSSPLogInfo	info 수준의 가장 기본적인 로그 만을 노출합니다.
AdPopcornSSPLogDebug	info를 포함한 Debug 수준의 로그를 노출합니다.
AdPopcornSSPLogTrace	모든 로그를 노출합니다.

C#

AdPopcornSSPPluginIOS.SetLogLevel(AdPopcornSSPPluginIOS.AdPopcornSSPLogDebug);

3) 델리게이트 설정

각 광고 타입별 델리게이트가 정상적으로 동작하기 위해서는 아래의 내용이 필수로 설정되어 있어야 합니다.

• GameObject의 이름을 제대로 넘겨주는지 확인

  • AdPopcornSSPPluginIOS.AdPopcornSSPSetCallbackHandler("AdPopcornSSPSample");

• GameObject에 이용하려는 서비스 plugin파일을 추가 했는지 확인

  • SSP 관련 delegate를 이용하려면 Plugins/IOS 폴더 밑에 있는 AdPopcornSSPPluginIOS.cs 파일을 GameObject에 추가했는지 확인 필요

위 2가지 사항을 적용한 예시는 아래 스크린샷의 하이라이트 처리 된 부분을 참고 부탁 드립니다.

4) SDK 초기화

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

C#

void Start (){	
    AdPopcornSSPPluginIOS.Initialize("your_app_key");
}

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

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

C#

public class AdPopcornSSPSampleScene : MonoBehaviour
{
	void Start (){
	
	    // 델리게이트 등록	
	    AdPopcornSSPPluginIOS.AdPopcornSSPSetCallbackHandler("AdPopcornSSPSampleScene ");	    
	    AdPopcornSSPPluginIOS.sspSdkInitialized += HandleSSPSDKInitialized;
            AdPopcornSSPPluginIOS.Initialize("your_app_key");
	}
	
	public void HandleSSPSDKInitialized()
	{
	}
}