QuickStart Guide for AdMob Mediation + Vungle SDK v.1.0-v.4.1 (Android)

이 가이드에 따라 Vungle Android SDK를 AdMob 조정 레이어에 추가할 수 있습니다. Vungle 광고를 AdMob 조정에 포함하려면 Vungle 어댑터를 통합해야 합니다. 이를 통해 AdMob SDK와 Vungle SDK 간에 통신이 설정됩니다.

콘텐츠

1. 시작하기 전에...

2. 앱을 AdMob 대시보드에 추가

3. AdMob SDK를 Android 프로젝트에 통합

4. Vungle 어댑터와 SDK를 Android 프로젝트에 추가

5. Vungle이 이제 AdMob 조정에 등록됨

6. 고급 기능(선택 사항): 추가 매개 변수 전달

1. 시작하기 전에...

  • 이 가이드를 시작하기 전에 AdMob을 설정해야 합니다. 시작하려면 AdMob 계정에 가입하세요.
  • Vungle AdMob Android 어댑터는 삽입 광고 및 보상 동영상 게재위치를 지원합니다.

    • 동영상 삽입 광고가 선택한 게재위치에서 자동으로 재생됩니다. Vungle은 이러한 비보상 광고를 호출합니다.
    • 보상 동영상 광고는 사용자 선택 사항이며 광고를 조회한 대가로 사용자에게 보상을 제공합니다. Vungle은 이러한 보상 광고를 호출합니다.

  • 아직 이 작업을 수행하지 않은 경우 Vungle 대시보드에서 사용자 계정에 앱을 추가합니다. 이 단계는 Vungle 애플리케이션 ID가 필요합니다. Vungle 앱 ID를 사용하여 AdMob에서 Vungle을 초기화할 수 있습니다.

2. 앱을 AdMob 대시보드에 추가

  1. AdMob 대시보드에 로그인한 뒤 + Monetize New App(새 앱 수익 창출)을 클릭합니다.

  2. Step 1 - Select an app(1단계 - 앱 선택)에서 앱이 Google Play 스토어에 있는 경우 Search For Your App(앱 검색)을 클릭합니다. 수동으로 앱을 추가하는 경우 AndroidPlatform(플랫폼)으로 선택합니다.

  3. Step 2 - Select ad format and ad unit(2단계 - 광고 형식 및 광고 단위) 선택에서:

    • 삽입 광고인 경우. Video(동영상) 옵션이 선택되어 있는지 확인합니다. 이것은 모든 Vungle 광고의 특성입니다.



    • 보상 삽입 광고의 경우 Set a reward(보상 설정) 옵션을 선택하고 Reward amount(보상 금액)Reward item(보상 항목) 필드에 값을 입력합니다. Vungle은 Use third-party ad network settings(타사 광고 네트워크 설정 사용) 기능을 지원하지 않습니다.

  4. 앱을 추가한 후 이 가이드에 따라 Vungle을 네트워크로 추가할 수 있습니다.

    • + New Ad Network(새 광고 네트워크)를 클릭하고 왼쪽 패널에서 Vungle을 선택합니다. Vungle 대시보드에서 Vungle 애플리케이션 ID를 찾습니다(Vungle은 삽입 광고 및 보상 삽입 광고 모두에 한 개의 앱 ID 사용).

    • 광고 네트워크 최적화(선택 사항)의 경우 보고 API 키를 입력하면 Vungle 보고 API를 통해 eCPM에 대한 AdMob 액세스 권한을 확보할 수 있습니다. (키가 없는 경우, 보고 API 키 요청 방법을 참조하세요.)

3. AdMob SDK를 Android 프로젝트에 통합

AdMob의 Android Studiod에서 시작하기 가이드에 따라 AdMob SDK를 Android 프로젝트에 통합할 수 있습니다. 그런 다음 AdMob의 삽입 광고 가이드 및/또는 보상 광고: 게시자 시작하기 가이드에 따라 광고를 요청하고 표시할 수 있습니다.

4. Vungle 어댑터와 SDK를 Android 프로젝트에 추가

  1. Vungle AdMob 어댑터 다운로드
  2. Vungle Android SDK 다운로드
  3. Vungle AdMob 어댑터(.aar 파일 1개) 및 Vungle SDK(.jar 파일 3개)를 프로젝트 라이브러리에 추가합니다.



  4. build.gradle 파일 업데이트:
    dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar']) // Vungle SDK
    compile(name:'VungleAdapter', 'ext':'aar') // AdMob용 Vungle 어댑터
    }
    repositories {
    jcenter()
    flatDir {
    dirs 'libs'
    }
    }
  5. Vungle 권한 및 활동을 위해 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>

5. Vungle이 이제 AdMob 조정에 등록됨

이제 Vungle이 사용자가 선택한 다른 광고 네트워크와 함께 기본 AdMob 폭포식 구조에 등록되었습니다. 통합을 테스트하고 앱을 제출하면 테스트 모드에서 Vungle과 AdMob을 전환하여 시작할 수 있습니다.

Vungle Android SDK에 대한 자세한 내용은 다음 가이드를 참조하세요.

* 광고를 클릭하고 브라우저/앱이 실행되면 onAdLeftApplication() 콜백이 호출되지 않습니다.

6. 고급 기능(선택 사항): 추가 매개 변수 전달

Android SDK v4.0.3 및 AdMob 어댑터 v2.1.0은 추가 매개 변수를 지원합니다.

  

방법

 

설명

 

setUserId

 

고유 사용자 ID가 Vungle SDK에 전달되어 보상 광고용 서버 간 콜백에 사용되도록 설정합니다.

 

setSoundEnabled

 

광고 시작 사운드 상태를 설정합니다. 실패하는 경우 동영상이 음소거되지만 사용자가 수정할 수 있습니다.

 

샘플 통합 코드 :


// 네트워크 추가 번들 구축
Bundle extras = new VungleExtrasBuilder()
.setUserId("userId")
.setSoundEnabled(false)
.build();
// 보상 기반 광고 요청 구축
AdRequest rewardedAdRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(VungleAdapter.class, extras)
.build();
rewardedAd.loadAd(REWARDED_AD_UNIT_ID, rewardedAdRequest);
// 또는 삽입 광고 요청 구축
AdRequest interstitialAdRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras)
.build();
// 광고 로드
interstitialAd.loadAd(interstitialAdRequest);
또 다른 질문이 있으십니까? 문의 등록

댓글