Vungle - Android SDK 입문

이 가이드는 SDK를 앱에 쉽게 통합하여 수익 창출을 시작하는 방법을 안내합니다! Vungle Android SDK 버전 4.1.0은 다중 창 모드 기능 및 향상된 비디오 광고 환경으로 Android Nougat(API 7.0)을 지원합니다. 이전 버전에서 최신 SDK로 업그레이드하려면 업그레이드 가이드를 참조하십시오.

목차

시작하기 전에...
1. SDK 다운로드
2. 프로젝트에 Vungle SDK 추가
3. AndroidManifest.xml 업데이트 
4. SDK 초기화 및 통합
5. 광고 재생!

시작하기 전에..

요구사항

  • Android 3.0 (Honeycomb - API 버전 11) 이상
  • 애플리케이션이 C/C++로 작성된 경우 Java로 작성된 Publisher SDK와 인터페이스로 연결하려면 JNI를 사용해야 합니다.
  • Java 1.7 - Android 5.+ 호환성을 위해서는 개발 시스템에 JDK 7가 필요합니다.
  • Java 1.8 - Android 7.+ 호환성을 위해서는 개발 시스템에 JDK 8이 필요합니다.

다음은 몇 가지 중요한 팁입니다.

  • 아직 앱을 추가하지 않으셨다면 단계별 가이드에 따라서 Vungle 대시보드에 귀사의 앱을 추가하십시오. 이와 같이 하였다면 애플리케이션 페이지에 나온 앱 ID를 꼭 메모해 두셔야 합니다. 이 앱 ID는 나중에 당사가 Vungle Android SDK를 초기화하는 데 필요합니다.

  • 한편, 샘플 앱으로 바로 시작하고자 하신다면 GitHub의 sample 폴더를 참조하십시오. 아니면 본문으로 넘어가겠습니다! 이후 밟아야 할 절차는 다섯 단계에 불과합니다.

1. SDK 다운로드

Vungle Android SDK는 Vungle 대시보드에서 다운로드할 수 있습니다.

2. 프로젝트에 Vungle SDK 추가

압축을 푼 /libs 디렉터리의 모든 라이브러리를 해당 프로젝트의 /libs 디렉터리에 복사합니다. 프로젝트에 이 디렉터리가 아직 없다면 디렉터리를 만드십시오. 이렇게 하면 프로젝트의 gradle 종속성이 해당 라이브러리에 자동으로 추가됩니다.

Vungle Android SDK에 필요한 라이브러리는 다음과 같습니다.

  • dagger-[version].jar
  • javax.inject-[version].jar
  • rxjava-[version].jar
  • eventbus-[version].jar
  • vungle-publisher-[version].jar

상기 라이브러리 중에서 버전이 같은 것이 이미 포함된 경우 컴파일 오류가 발생할 수도 있으니 해당 라이브러리는 다시 포함시키지 마십시오.  종속성 라이브러리의 사용 가능한 버전을 둘 다 테스트해서 귀사의 앱에서 최상의 성능을 보이는 버전을 정하십시오.

3. AndroidManifest.xml 업데이트

AndroidManifest.xml에 다음 줄을 추가하십시오.

<manifest>

...
<!-- 재생을 위해서 비디오 광고를 다운로드하고 캐싱하는 권한 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="18"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<application>

...
<!-- Vungle 비디오 광고의 재생에 필요한 작업 -->
 <activity android:name="com.vungle.publisher.VideoFullScreenAdActivity"
android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
android:theme="@android:style/Theme.NoTitleBar.Fullscreen"/>

<activity android:name="com.vungle.publisher.MraidFullScreenAdActivity"
android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"/>

</application>

</manifest>

 

4. SDK 초기화 및 통합

애플리케이션 시작

해당 애플리케이션의 첫 Activity에서 Publisher SDK를 초기화합니다. 이렇게 하면 비디오 사전 캐시가 시작되고 SDK가 광고 표시를 준비합니다.

import com.vungle.publisher.VunglePub;

public class FirstActivity extends android.app.Activity {

  // VunglePub 인스턴스 보기
  final VunglePub vunglePub = VunglePub.getInstance();

  @Override
  public void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);

      // 앱을 설치한 후 Vungle 대시보드에서 앱의 기본 페이지에 있는 해당 앱 ID를 봅니다.
      final String app_id = "your Vungle App ID";

      // Publisher SDK 초기화
      vunglePub.init(this, app_id);
  }
}

Each Activity

또한, onPauseonResume 메서드(Activity에 있음, 첫 번째 포함)를 다시 정의해서, 애플리케이션이 포커스를 얻거나 잃었을 때 Vungle Android SDK가 올바르게 업데이트되는지 다음과 같이 확인해야 합니다.

import com.vungle.publisher.VunglePub;

public class EachActivity extends android.app.Activity {

  // VunglePub 인스턴스 보기
  final VunglePub vunglePub = VunglePub.getInstance();

  ...

  @Override
  protected void onPause() {
      super.onPause();
      vunglePub.onPause();
  }

  @Override
  protected void onResume() {
      super.onResume();
      vunglePub.onResume();
  }
}

5. 광고 재생

기본 구성

거의 다 되었습니다! 애플리케이션에서 광고를 재생할 준비가 되었을 때 Vungle Android SDK의 playAd 메서드를 호출하기만 하면 됩니다.

import com.vungle.publisher.VunglePub;

public class GameActivity extends android.app.Activity {

  // VunglePub 인스턴스 보기
  final VunglePub vunglePub = VunglePub.getInstance();

  ...

  private void onLevelComplete() {
      vunglePub.playAd();
  }
}

팁 1 - 플레이 이벤트를 구독하려면 고급 설정 가이드를 참조하십시오. 오디오 중지 상태를 해제하고 게임 등을 재개하기 위해 사용할 수 있습니다.

팁 2 - 재생 전에 광고가 있는지 확인하려면 다음과 같이 하십시오.

// 광고 재생 준비 여부 표시
vunglePub.isAdPlayable()

참고: 앱이 테스트 모드에 있는 동안에는 광고 중인 앱을 다운로드할 수 없습니다. 또한, 대시보드가 광고 노출 수를 보고하지 않습니다. 이는 사용자가 올바르게 SDK를 통합했는지 확인하는 데에만 테스트 광고가 사용되기 때문입니다. 이 기능은 해당 앱이 활성 모드에서 작동할 준비가 되었을 때 비로소 제공됩니다.

Google Play Services(선택사항)

프로젝트에 Google Play Services를 포함하면 Vungle에서 최종 사용자가 누리는 사용자 지정형 광고 경험을 한층 강화할 수 있게 되지만, 의무 사항은 아닙니다. 버전 4.0.30 이상을 사용하시길 권장합니다.

Google Play Services를 포함하려면 Google의 설치 설명서를 읽어 보시기 바랍니다. 앱에서 해당 장치에 충분히 최신 버전의 Google Play Services가 갖춰졌는지 확인하십시오.

그 밖에 Google Play Services에 관하여 궁금한 사항은 Google Play Services 질문과 대답 중 일부를 참조하십시오.

Android SDK 버전 3.3.5 이상의 경우:

play-services 7.8.0을 사용하는 경우:

  • play-services-ads 포함
  • play-services-location 포함
  • 지원 라이브러리 유지

play-services 8.4.0을 사용하는 경우:

  • play-services-ads 포함
  • play-services-location 포함
  • 지원 라이브러리는 필요하지 '않음'

이상입니다. 이제 '수익화'의 장도에 오르셨습니다!

고급 설정

Vungle Android SDK의 기타 고급 정보(사용자 지정, 이벤트 리스너 등)에 관심이 있으시면 언제든지 고급 설정 가이드를 참조하시기 바랍니다.

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

댓글