MoPub와 Vungle SDK v.6(Android) 통합하기

이 설명서를 참고해 MoPub을 기본 광고 미디에이션 레이어로 사용하여 Vungle Android SDK를 앱에 추가합니다.

목차

시작하기 전에

1단계. Vungle을 사용자 지정 네이티브 네트워크로 설정

MoPub 서버에서 통합 Vungle 어댑터를 인식하게 하려면, MoPub 대시보드에서 Vungle을 사용자 지정 네이티브 네트워크로 설정합니다.

  1. MoPub 대시보드에 로그인하고 기본 탐색 모음에서 네트워크를 선택합니다.

  2. 상단 오른쪽의 새 네트워크 버튼을 클릭합니다.

    Screen_Shot_2018-05-08_at_2.53.52_PM.png

    목록에서 Vungle을 선택합니다.

  1. Vungle을 네트워크로 생성한 후 네트워크 목록에서 이름을 클릭합니다. 인벤토리 설정 섹션에서 Vungle SDK를 사용하여 동영상 광고를 제공하는 각 광고 단위에 대해 MoPub SDK가 Vungle SDK와 상호 작용하는 데 사용되는 네트워크 어댑터를 찾을 수 있는지 확인합니다.

    Screen_Shot_2018-05-08_at_3.03.03_PM.png

    • 광고 단위에 대해 MoPub 보상형 동영상을 사용하는 경우 com.mopub.mobileads.VungleRewardedVideo사용자 정의 이벤트 클래스 섹션 아래 추가합니다.

    • 광고 단위에 대해 전면을 사용하는 경우 com.mopub.mobileads.VungleInterstitial사용자 정의 이벤트 클래스 섹션 아래 추가합니다.

    • Vungle 앱 ID, 광고 단위에서 호출될 플레이스먼트의 플레이스먼트 참조 ID 및 앱에서 사용될 모든 플레이스먼트 참조 ID를 JSON 형식으로 사용자 지정 이벤트 클래스 데이터 아래 추가합니다.

    • pid에 대해 MoPub 광고 단위에 연결할 플레이스먼트 참조 ID를 설정합니다.
      참고: 앱별로 기본 플레이스먼트가 자동으로 생성됩니다. 이 초기화 단계에서 플레이스먼트 기능을 사용하지 않더라도 반드시 플레이스먼트 참조 ID를 제공해야 합니다. 플레이스먼트를 여러 개 만드는 경우, 참조 ID를 모두 제공합니다.

    • Vungle 대시보드에서 보상형으로 설정된 플레이스먼트를 보상형 동영상으로 설정된 MoPub 광고 단위에 연결하고, Vungle 대시보드에서 전면 유형으로 설정된 플레이스먼트를 전체 화면(320 x 480)으로 설정된 MoPub 광고 단위에 연결합니다.
      { "appId":"5935efecc802d63d5100000f", "pid":"DEFAULT05223", "pids":"DEFAULT05223, PADUNIT49379, PADUNIT68848, PADUNIT04241, PADUNIT53279, PADUNIT08448" }

참고: Vungle SDK가 Vungle 대시보드에서 자동 캐시로 선택한 플레이스먼트에 자동으로 광고를 캐시합니다. 가장 먼저 표시되는 MoPub 광고 단위 또는 가장 자주 게재되는 광고 단위를 자동 캐시된 플레이스먼트로 선택하는 것이 좋습니다.

2단계. Vungle을 타사 광고 네트워크로 추가

MoPub 미디에이션을 사용해 Vungle Android SDK를 앱에 추가하려면 다음의 단계를 따릅니다.

  1. 모든 Vungle 관련 어댑터 파일(MoPub 어댑터 저장소/extras/src/com/mopub/mobileads/ 아래)을 앱 프로젝트의 /src/main/java/com/mopub/mobileads/ 디렉토리에 추가합니다. MoPub SDK가 이러한 파일을 디렉토리의 "사용자 지정 이벤트 클래스 속성"으로 참조하므로 이 단계가 필요합니다.

    • VungleInterstitial.java
    • VungleRewardedVideo.java
    • VungleRouter.java
    • VungleRouterListener.java

  2. Vungle - Android SDK 시작하기“의 1단계. 프로젝트에 Vungle SDK 포함“ 섹션의 지침을 따라 필요한 프레임워크를 추가합니다.

  3. Multidex, Proguard 및 Google Play Services를 설정해야 하는 경우에는 "Vungle - Android SDK 시작하기"의 "고급 설정" 섹션의 설명에 따라 프로젝트의 AndroidManifest.xml을 업데이트합니다.

  4. Vungle 동영상 광고를 게재하려고 할 때 MoPubInterstitial의 show 메서드를 호출(또는 보상형 광고의 경우 MoPubRewardedVideos의 showRewardedVideo 메서드 호출)합니다(Vungle Android SDK 메서드를 직접 호출할 필요 없음, MoPub SDK가 호출).

구성 옵션(선택 사항)

전면 광고

속성

기본 값

설명

SOUND_ENABLED_KEY

true

음소거 또는 음소거 해제된 상태로 광고를 재생합니다. 음소거된 상태로 재생하려면 'false'로, 음소거 해제된 상태로 재생하려면 'true'로 설정합니다.

ORDINAL_VIEW_COUNT_KEY

null

Vungle에서 서수 데이터 보고를 받는 경우 이 필드를 이용하여 미디에이션 서수를 내보내십시오. 게임 세션에서 해당 광고의 표시 순서를 나타내는 정수 값입니다(예를 들어, 이번 세션에서 이미 두 개의 광고가 표시되고 Vungle의 광고가 세 번째로 보여지는 경우, '3'을 내보냅니다). 서수 데이터에 대한 자세한 내용은 여기를 참조하십시오.

FLEX_VIEW_CLOSE_TIME_KEY

null

이는 Flex View 동영상이 자동으로 닫히기 전에 재생될 시간(초)입니다.

 ashMap<String, Object> extras = new HashMap<>(); extras.put(VungleInterstitial.SOUND_ENABLED_KEY, false); extras.put(VungleInterstitial.ORDINAL_VIEW_COUNT_KEY, 1); extras.put(VungleInterstitial.FLEX_VIEW_CLOSE_TIME_KEY, 5); mMoPubInterstitial.setLocalExtras(extras); mMoPubInterstitial.load(); 

보상형 광고

속성

기본 값

설명

withUserId

null

해당 사용자에게 보상형 광고 시청에 대한 보상을 제공해야 하는지 확인하기 위해 어플리케이션에 고유한 사용자 ID가 전달되도록 설정합니다.

withCancelDialogBody

"이 동영상을 일찍 닫으면 보상을 받을 수 없습니다. 정말 닫을까요?"

보상형 광고를 건너뛸 경우 표시되는 확인 대화 상자의 본문을 설정합니다.

withCancelDialogCloseButton

"동영상 닫기"

보상형 광고를 건너뛰려고 할 때 표시되는 확인 대화 상자의 '취소 버튼' 텍스트를 설정합니다.

withCancelDialogKeepWatchingButton

"계속 시청"

보상형 광고를 건너뛰려고 할 때 표시되는 확인 대화 상자의 '계속 시청 버튼' 텍스트를 설정합니다.

withCancelDialogTitle

"동영상을 닫을까요?"

보상형 광고를 건너뛸 경우 표시되는 확인 대화 상자의 제목을 설정합니다.

withSoundEnabled

true

광고의 시작음 상태를 설정합니다. true로 설정되면 오디오가 장치의 볼륨 및 소리 설정을 따릅니다. false인 경우 동영상이 무음으로 시작되지만 사용자가 변경할 수 있습니다.

withOrdinalViewCount

null

Vungle에서 서수 데이터 보고를 받는 경우 이 필드를 이용하여 미디에이션 서수를 내보내십시오. 게임 세션에서 해당 광고의 표시 순서를 나타내는 정수 값입니다(예를 들어, 이번 세션에서 이미 두 개의 광고가 표시되고 Vungle의 광고가 세 번째로 보여지는 경우, '3'을 내보냅니다). 서수 데이터에 대한 자세한 내용은 여기를 참조하십시오.

 public class MainActivity extends Activity { @Override MoPubRewardedVideos.initializeRewardedVideo(this, new VungleRewardedVideo.VungleMediationSettings.Builder() .withUserId("VUNGLE_TEST_USER") .withCancelDialogTitle("TITLE") .withCancelDialogBody("BODY") .withCancelDialogCloseButton("CLOSE") .withCancelDialogKeepWatchingButton("CONTINUE") .withSoundEnabled(false) .withOrdinalViewCount(10) .build() ); MoPub.onCreate(this); // ... } 

추가 정보

Android SDK - 하드웨어 가속

대상 API 수준이 14 이상으로 설정되어 있으면 하드웨어 가속이 기본적으로 활성화되어 있습니다. 다이나믹 템플릿 및 Native Flex 광고를 적절하게 표시하려면 SDK에 대해 이 옵션을 사용하도록 설정해야 합니다. 프로젝트에서 이 옵션이 'false'로 설정되어 있지 않은지 확인하십시오.

 < application android:hardwareAccelerated="true" ... > 

 

또 다른 질문이 있으십니까? 문의 등록

댓글