기본 설정

1. SDK 정보

SDK 릴리즈 정보는 아래 github 에서 확인 가능합니다.

2. SDK 다운로드 및 설치

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

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

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

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

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

3. 코드 연동

1) IDFA 설정

Adsupport Framework를 Dependencies에 추가합니다.

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

2) iOS 14 IDFA 사용 동의 설정

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가지 사항을 적용한 예시는 아래 스크린샷의 하이라이트 처리 된 부분을 참고 부탁 드립니다.

Last updated