iOS

iOS 환경에서 AppLovin MAX custom Network를 활용하여, AdPopcornSSP를 연동 하는 가이드입니다.

1. AppLovin Console 정보 세팅

1) Add Custom SDK Network Settings

1. MAX Dashboard 에서, MAX > Mediation > Manage > Networks 를 선택합니다.

2. 해당 메뉴 안에서 페이지 제일 하단의 ‘Click here to add a Custom Network’ 를 클릭 한 뒤 아래 스크린샷과 같이 설정해 줍니다.

• Network Type : SDK

• Custom Network Name : AdPopcornSSP

• iOS Adapter Class Name : ALAdPopcornSSPMediationAdapter

• Android / Fire OS Adapter Class Name : com.igaworks.ssp.part.custom.APSSPAppLovinCustomAdapter

1. MAX > Mediation > Manage > Networks를 선택 한 뒤, Manage Networks 리스트에 위에서 추가한 AdPopcornSSP가 활성화 되어 있는지 체크 합니다.

2) AdUnit 설정

1. MAX Dashboard에서 MAX > Manage > Ad Units 페이지로 이동 합니다.

2. 우측 상단의 Create Ad Unit 버튼을 클릭하여 신규 AdUnit을 생성합니다.

3. Name, Platform, AdType 선택 하시면, Custom Network에 1번 단계에서 생성한 AdPopcornSSP 네트워크가 노출됩니다.

4. AdPopcornSSP 네트워크의 Status를 활성화 한 뒤, 아래 스크린샷 같이 세팅합니다.

• App ID : 애드팝콘 SSP 사업팀이 발급해 준 앱키를 입력합니다.

• Placement ID : 애드팝콘 SSP 사업팀이 발급해 준 지면키를 입력합니다.

• Custom Parameters : 애드팝콘 SSP 사업팀이 발급해 준 앱키, 지면키를 아래와 같은 Json 형태로 입력해 줍니다.

예시> 아래는 예시이며, 정확한 값은 사업팀을 통해 확인 받으시기 바랍니다.

{"appKey":"397261446","placementId":"iOS_NATIVE"}

단, 안드로이드 배너의 경우 아래 키 값이 추가로 필요 합니다.

{"appKey":"397261446","placementId":"BANNER_PID", "adSize":1}

2. 코드 연동

1. AdPopcornSSP, AppLovin SDK를 다운로드 합니다.

2. AppDelegate 파일 내에서 AppLovin 초기화를 진행합니다.

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // Please make sure to set the mediation provider value to @"max" to ensure proper functionality
    [ALSdk shared].mediationProvider = @"max";
    
    [ALSdk shared].userIdentifier = @"USER_ID";
    
    [[ALSdk shared] initializeSdkWithCompletionHandler:^(ALSdkConfiguration *configuration) {
        // Start loading ads
    }];
}

1. 아래 링크에서 ALAdPopcornSSPMediationAdapter.h, .m 어댑터 파일을 다운로드 한 뒤, 프로젝트에 추가하여 줍니다.

[AppLovin MAX Custom Network Adapter]

1. 애드팝콘 SSP를 통해 추가로 미디에이션을 진행하는 경우, [미디에이션 가이드] 페이지에서 [애드팝콘 SSP iOS Mediation Adapter] 파일을 다운로드 한 뒤, 추가하고자 하는 업체의 Adapter 파일 및 framework를 설정합니다.
2. 위 미디에이션 가이드 페이지에 연결된 각 업체의 가이드 페이지를 확인한 뒤, 초기화 혹은 info.plist에 추가해야 될 사항(SkAdnetwork) 이 있는지 체크합니다.

3. Adapter와 framework를 프로젝트에 추가하셨으면, 네이티브를 제외한 모든 준비는 끝났습니다. 네이티브 연동 시 아래 추가 사항을 확인해 주세요

3. 네이티브 연동 시 추가 사항

• 애드팝콘 SSP를 통해 네이티브 미디에이션을 추가하고자 할 경우, 위 단계에서 다운로드 한 ALAdPopcornSSPMediationAdapter를 직접 수정해 주어야 합니다.

• 현재까지 지원하는 업체는 아래와 같으며, 추가 지원을 원할 경우 애드팝콘 사업팀으로 문의 바랍니다.

  • AdPopcornSSP

  • Adfit

  • NAM(NaverAdManager)

1. ALAdPopcornSSPMediationAdapter.h 파일 내에 define 영역에서 사용하고자 하는 네이티브 업체만 남겨두고 사용하지 않은 업체는 주석 처리 합니다. 아래 예시로 확인 바랍니다.

Objective-C

/* 애드팝콘 SSP 커스텀 어댑터는 아래의 네이티브 미디에이션을 지원합니다.
  이 중 사용하고자 하는 미디에이션 업체만 아래 #define에 남겨두시고
  사용하지 않는 업체는 주석처리해 두시기 바랍니다.
  - AdPopcornSSP
  - AdFit
  - NAM
 */
#define UseAdPopcornSSPNativeView
#define UseAdFitNativeView
#define UseNAMNativeView

1. loadNativeAdForPArameters:andNotify Method 내 사용하고자 하는 업체의 네이티브 뷰를 설정합니다.

• createAdPopcornSSPNativeAdView : 애드팝콘 SSP 네이티브 광고 레이아웃 구성 함수

• createNAMNativeAdView : Naver AdManager 네이티브 광고 레이아웃 구성 함수

• createAdFitNativeAdView : AdFit 네이티브 광고 레이아웃 구성 함수

위 3개 함수에서 각각 레이아웃이 구성됩니다.

단, AdFit의 경우 BizBoardTemplate 고정이기에 따로 레이아웃을 구성할 필요는 없으며, AdPopcornSSPNativeView와 NaverAdManager 네이티브에 대해서만 매체가 원하는 형태로 레이아웃을 조정해 주시면 됩니다.

자세한 사항은 ALAdPopcornSSPMediationAdapter.m 파일과 애드팝콘 [네이티브 미디에이션 레이아웃 가이드]를 참고하시기 바랍니다.

AdFit의 경우 imp event를 제공해 주지 않기에, 애드핏을 통한 imp 수치는 SDK를 통해 전달 되지 않습니다.