다음 가이드는 AppLovin MAX custom Network를 활용하여, AdPopcornSSP를 연동 하는 가이드입니다.
MAX Dashboard 에서, MAX > Mediation > Manage <Networks 를 선택합니다.
해당 메뉴 안에서 페이지 제일 하단의 ‘Click here to add a Custom Network’ 를 클릭 한 뒤 아래 스크린샷과 같이 설정해 줍니다.
MAX > Mediation > Manage > Networks를 선택 한 뒤, Manage Networks 리스트에 위에서 추가한 AdPopcornSSP가 활성화 되어 있는지 체크 합니다.
MAX Dashboard에서 MAX > Manage > Ad Units 페이지로 이동 합니다.
우측 상단의 Create Ad Unit 버튼을 클릭하여 신규 AdUnit을 생성합니다.
Name, Platform, AdType 선택 하시면, Custom Network에 1번 단계에서 생성한 AdPopcornSSP 네트워크가 노출됩니다.
AdPopcornSSP 네트워크의 Status를 활성화 한 뒤, 아래 스크린샷 같이 세팅합니다.
App ID : 애드팝콘 SSP 사업팀이 발급해 준 앱키를 입력합니다.
Placement ID : 애드팝콘 SSP 사업팀이 발급해 준 지면키를 입력합니다.
Custom Parameters : 애드팝콘 SSP 사업팀이 발급해 준 앱키, 지면키를 아래와 같은 Json 형태로 입력해 줍니다.
예시> 아래는 예시이며, 정확한 값은 사업팀을 통해 확인 받으시기 바랍니다.
{"appKey":"397261446","placementId":"iOS_NATIVE"}
단, 안드로이드 배너의 경우 아래 키 값이 추가로 필요 합니다.
{"appKey":"397261446","placementId":"BANNER_PID", "adSize":1}
#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
}];
}
아래 링크에서 ALAdPopcornSSPMediationAdapter.h, .m 어댑터 파일을 다운로드 한 뒤, 프로젝트에 추가하여 줍니다.
애드팝콘 SSP를 통해 추가로 미디에이션을 진행하는 경우, [미디에이션 가이드] 페이지에서 [애드팝콘 SSP iOS Mediation Adapter] 파일을 다운로드 한 뒤, 추가하고자 하는 업체의 Adapter 파일 및 framework를 설정합니다.
위 미디에이션 가이드 페이지에 연결된 각 업체의 가이드 페이지를 확인한 뒤, 초기화 혹은 info.plist 에 추가해야 될 사항(SkAdnetwork) 이 있는지 체크합니다.
Adapter와 framework를 프로젝트에 추가하셨으면, 네이티브를 제외한 모든 준비는 끝났습니다. 네이티브 연동시에만 아래 추가 사항을 확인해 주세요
***** 네이티브 연동 시 추가 사항 *****
애드팝콘 SSP를 통해 네이티브 미디에이션을 추가하고자 할 경우, 위 단계에서 다운로드 한 ALAdPopcornSSPMediationAdapter를 직접 수정해 주어야 합니다.
현재까지는 (AdPopcornSSP, Adfit, NaverAdManager만 지원하고 있으며, 추가 지원을 원할 경우 사업팀에 문의해 주시기 바랍니다)
1.1 ALAdPopcornSSPMediationAdapter.h 파일 내에 define 영역에서 사용하고자 하는 네이티브 업체만 남겨두고 사용하지 않은 업체는 주석처리합니다.
예시>
/* 애드팝콘 SSP 커스텀 어댑터는 아래의 네이티브 미디에이션을 지원합니다.
이 중 사용하고자 하는 미디에이션 업체만 아래 #define에 남겨두시고
사용하지 않는 업체는 주석처리해 두시기 바랍니다.
- AdPopcornSSP
- AdFit
- NAM
*/
#define UseAdPopcornSSPNativeView
#define UseAdFitNativeView
#define UseNAMNativeView
1.2 loadNativeAdForPArameters:andNotify Method 내 사용하고자 하는 업체의 네이티브 뷰를 설정합니다.
위 3개 함수에서 각각 레이아웃이 구성됩니다. 단, AdFit의 경우 BizBoardTemplate 고정이기에 따로 레이아웃을 구성할 필요는 없으며, AdPopcornSSPNativeView와 NaverAdManager 네이티브에 대해서만 매체가 원하는 형태로 레이아웃을 조정해 주시면 됩니다. 자세한 사항은 ALAdPopcornSSPMediationAdapter.m 파일과 애드팝콘 **[네이티브 미디에이션 레이아웃 가이드]**를 참고하시기 바랍니다.
AdFit의 경우 imp event를 제공해 주지 않기에, 애드핏을 통한 imp 수치는 SDK를 통해 전달 되지 않습니다.
***** 네이티브 연동 시 추가 사항 *****
아래 첨부된 layout 파일을 다운로드 후, 앱 프로젝트의 리소스 폴더 내 layout 폴더에 추가합니다.
1.1 apssp_applovin_custom_adapter_nativead.xml
apssp_applovin_custom_adapter_nativead.xml
1.2 apssp_applovin_custom_adapter_nativead_apssp_layout.xml
apssp_applovin_custom_adapter_nativead_apssp_layout.xml
위 2개의 layout에 설정되어 있는 UI Component의 ID는 그대로 유지한채로 수정을 진행하셔야 합니다. 그렇지 않을 경우, 네이티브 노출이 정상적으로 작동 하지 않을 수 있습니다.
AdFit의 경우 imp,click event를 제공해 주지 않기에, 애드핏을 통한 imp,click 이벤트는 SDK를 통해 전달 되지 않습니다.