기본 설정

iOS 프로젝트에서 애드팝콘 SSP를 연동하기 위한 문서입니다. 서비스 이용 중 도움이 필요한 경우에는 애드팝콘 SSP 사업팀 (monetize@adpopcorn.com)으로 연락 부탁드립니다

1. SDK 설치 방법

1) CocoaPods

CocoaPod 설치

2) SPM(Swift Package Manager)

SPM 설치

3) 수동

수동 설치

2. 코드 연동

  1. Bridge Header 추가

//
// AdPopcorn-Bridging-Header.h
// AdPopcornSSPSwiftSample
//
// Created by mick on 2018. 9. 13..
// Copyright (c) 2021년 AdPopcorn. All rights reserved.
//
#ifndef SwiftAdPopcornSSP_ObjectiveC_Header_h
#define SwiftAdPopcornSSP_ObjectiveC_Header_h

#import <AdPopcornSSP/AdPopcornSSP.h>
#import <AdPopcornSSP/AdPopcornSSPAdSize.h>
#import <AdPopcornSSP/AdPopcornSSPBannerView.h>
#import <AdPopcornSSP/AdPopcornSSPError.h>
#import <AdPopcornSSP/AdPopcornSSPInterstitialAd.h>
#import <AdPopcornSSP/AdPopcornSSPInterstitialVideoAd.h>
#import <AdPopcornSSP/AdPopcornSSPNativeAd.h>
#import <AdPopcornSSP/AdPopcornSSPRewardVideoAd.h>
#import <AdPopcornSSP/AdPopcornSSPSplashAd.h>
#import <AdPopcornSSP/AdPopcornSSPWKScriptMessageHandler.h>
#import <AdPopcornSSP/AdPopcornSSPModalAd.h>
#import <AdPopcornSSP/AdPopcornSSPContentsAd.h>
#import <AdPopcornSSP/AdPopcornSSPPopContentsAd.h>
#import <AdPopcornSSP/AdPopcornSSPVideoMixAd.h>
#import <AdPopcornSSP/AdPopcornSSPRewardAdPlus.h>
#import <AdPopcornSSP/APSSPRewardAdPlusStatusModel.h>
#endif

Objective-C로 구성된 header 파일을 swift에서 사용할 수 있게 bridge header 파일 생성 후 사용하고자 하는 header 파일 import 해줍니다.

  1. Build Setting 내 Header 파일 추가

위에서 생성한 bridge Header 파일을 build setting 에 선언해 줍니다.

1) IDFA 설정

AdSupport Framework를 Dependencies에 추가합니다.

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

2) iOS 14 IDFA 사용 동의 설정

  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는 광고 요청 전에 반드시 마무리 되어야 합니다.

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

3) 로그 수준 설정

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

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

설명

AdPopcornSSPLogInfo

info 수준의 가장 기본적인 로그를 노출 합니다.

AdPopcornSSPLogDebug

info 를 포함한 Debug 수준의 로그를 노출 합니다.

AdPopcornSSPLogTrace

모든 로그를 노출합니다.

[AdPopcornSSP setLogLevel:AdPopcornSSPLogTrace];

4) SSP SDK 초기화

#import <AdPopcornSSP/AdPopcornSSP.h>

@interface AppDelegate() <APSSPSDKInitializeDelegate>
@end

@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
	[AdPopcornSSP sharedInstance].initializeDelegate = self;
	[AdPopcornSSP initializeSDK:@"YOUR_APP_KEY"];
}

#pragma mark - APSSPSDKInitializeDelegate
- (void)AdPopcornSSPSDKDidInitialize
{
	// 초기화가 완료 된 이후, 광고 요청 작업을 수행해 주시기 바랍니다.
}
@end

5) UID 2.0 설정

쿠팡 DSP로 부터 높은 단가의 광고를 제공 받기 위해서는 UID 2.0 설정을 진행하여야 합니다.

애드팝콘 SSP 콘솔 페이지 내 개인정보보호약정서에 동의한 매체의 경우 아래 API를 통해 UID 설정을 진행해 주어야 합니다.

UIDIdentifier Type은 아래 2가지를 지원합니다.

  • 0: Email

  • 1: PhoneNumber

[AdPopcornSSP setUIDIdentifier:0 identifier:@"test_uid@adpopcorn.com"];

6) GDPR 설정

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

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

[AdPopcornSSP gdprConsentAvailable:NO];

7) COPPA 설정

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

[AdPopcornSSP tagForChildDirectedTreatment:NO];

Last updated

Was this helpful?