Android

Android 환경에서 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를 다운로드 합니다. AdPopcornSSP SDK는 [애드팝콘 SSP 안드로이드 가이드] 에서 다운로드 및 필수 코드 연동 부분까지만 진행하시면 됩니다.

  2. 추가로 미디에이션 진행하고자 하는 업체가 있는 경우 [미디에이션 가이드] 에서 확인 하신 뒤, 각 업체 SDK를 다운로드 하시기 바랍니다.

  3. 각 업체의 SDK 다운로드 후, 초기화 및 AndroidManifest.xml 설정이 필요한 부분이 있으면 추가해 줍니다.

  4. 이제, AppLovin Max를 통해 AdPopcornSSP를 사용하기 위한 필수 부분은 끝났습니다. 네이티브 연동 시 아래의 추가 사항을 확인해 주세요.

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

  • AdPopcornSSP 에서 AppLovin Custom Adapter를 통해 제공하는 네이티브 미디에이션은 아래 3개 업체입니다.

    • AdPopcornSSP

    • Adfit

    • NAM(NaverAdManager)

  1. 아래 첨부된 layout 파일을 다운로드 후, 앱 프로젝트의 리소스 폴더 내 layout 폴더에 추가합니다.

  • apssp_applovin_custom_adapter_nativead.xml

위 xml에는 3개의 업체 미디에이션 View가 포함되어 있습니다. 사용하는 업체의 View만 남겨두시고, 나머진 제거 후 사용하시기 바랍니다.

  • apssp_applovin_custom_adapter_nativead_apssp_layout.xml

AdFit, Nam의 경우는 지정된 템플릿 형태로만 광고가 제공되기에, 상세 레이아웃 가이드가 필요 없으나, AdPopcornSSP의 네이티브 광고의 경우에는 상세 레이아웃을 설정해 주어야 합니다.

apssp_applovin_custom_adapter_nativead_apssp_layout.xml에는 title, desc, cta, icon, main image가 포함된 형태로 레이아웃이 구성되어 있으며, 각자 앱 특성에 맞게 사용하고자 하는 UI Component만 남겨두시고 위치, 크기 등을 조정 하시면 됩니다.

  1. 위 2개의 layout에 설정되어 있는 UI Component의 ID는 그대로 유지한채로 수정을 진행하셔야 합니다. 그렇지 않을 경우, 네이티브 노출이 정상적으로 작동 하지 않을 수 있습니다.

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

Last updated