AdMob Mediation과 Vungle SDK v.5(Android) 통합하기

목차

시작하기 전에

  • AdMob 대시보드에는 아직 Vungle 플레이스먼트가 포함되지 않지만 퍼블리셔에 대한 리포팅 API를 사용하여 플레이스먼트 수준 실적을 확인할 수 있습니다.

  • 이 지침서를 시작하기 전에 AdMob을 설정해야 합니다. 시작하려면, Android용 AdMob 시작 설명서를 참조하십시오.

  • Vungle AdMob Android 어댑터는 전면 및 보상형 동영상 광고 형식을 모두 지원합니다.

  • AdMob을 앱에 통합하는 방법에 대해서는 AdMob 통합 문서를 참조하십시오.

1단계. Vungle을 광고 네트워크로 설정

  1. AdMob 대시보드에 로그인하여 수익화 탭으로 이동합니다.

  2. Vungle을 광고 네트워크로 추가하려는 앱을 선택합니다.

  3. 광고 형식을 선택하고 앱에 광고 단위를 추가합니다.

    • 전면 광고 형식의 경우, 모든 Vungle 광고는 동영상 형식이므로 동영상 옵션을 선택합니다.

      image2.png

    • 보상형 동영상 광고 형식의 경우, 보상 설정 옵션을 선택하고 보상 금액보상 항목 필드에 값을 입력합니다. Vungle은 타사 광고 네트워크 설정 기능을 지원하지 않습니다.

      image6.png

  4. 광고 단위를 선택하고 미디에이션 열의 광고 소스를 클릭합니다.

    image1.png

  5. + 새 광고 네트워크를 클릭합니다.

    image5.png

  6. 왼쪽 패널에서 Vungle을 선택하고 Vungle 대시보드에서 확인 가능한 Vungle 어플리케이션 ID 및 일치하는 플레이스먼트 ID를 입력합니다.

    image1.png

2단계. Vungle Adapter 및 SDK 통합

  1. Vungle AdMob 어댑터를 다운로드하여 프로젝트 라이브러리에 추가합니다.

    image3.png

  2. 앱 수준 build.gradle 파일을 업데이트합니다.
    dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) // Vungle SDK compile(name:'VungleAdapter', 'ext':'aar') // Vungle Adapter for AdMob } repositories { jcenter() flatDir { dirs 'libs' } } 


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

  4. Multidex, Proguard 및 Google Play Services를 설정해야 하는 경우에는 "Vungle - Android SDK 시작하기" 섹션의 "고급 설정"의 설명에 따릅니다.

3단계. 플레이스먼트 참조 ID를 Adapter에 전달

Vungle SDK 버전 5.1 이상에서는 플레이스먼트 참조 ID 및 모든 플레이스먼트 참조 ID를 Vungle 어댑터에 제공하려면 VungleExtrasBuilder를 가져와 번들 개체를 생성해야 합니다.

참고: 앱별로 기본 플레이스먼트가 자동으로 생성됩니다. 플레이스먼트를 여러 개 만드는 경우, 참조 ID를 모두 제공합니다. AdMob 대시보드에서 Vungle 플레이스먼트 참조 ID를 설정하지 않은 경우 플레이스먼트 참조 ID를 playPlacement로 제공해야 합니다.

전면:

import com.vungle.mediation.VungleInterstitialAdapter; 
import com.vungle.mediation.VungleExtrasBuilder;

String[] placements = new String[] { “PLACEMENT_ID_1”, “PLACEMENT_ID_2”, “PLACEMENT_ID_3” };

Bundle extras = new VungleExtrasBuilder(placements).build();
// Required if there is no placement reference ID set up in AdMob dashboard
// Bundle extras = new VungleExtrasBuilder(allPlacements).setPlayingPlacement(“PLACEMENT_ID_FOR_THE_AD_UNIT”).build();

AdRequest adRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras)
.build();

mInterstitialAd01.loadAd(adRequest);

보상형 동영상:

import com.vungle.mediation.VungleAdapter; 
import com.vungle.mediation.VungleExtrasBuilder;

String[] placements = new String[] { “PLACEMENT_ID_1”, “PLACEMENT_ID_2”, “PLACEMENT_ID_3” };

Bundle extras = new VungleExtrasBuilder(placements).build();
// Required if there is no placement reference ID set up in AdMob dashboard
// Bundle extras = new VungleExtrasBuilder(allPlacements).setPlayingPlacement(“PLACEMENT_ID_FOR_THE_AD_UNIT”).build();

AdRequest adRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(VungleAdapter.class, extras)
.build();

mRewardedAd01.loadAd(RewardedAdUnitID01, adRequest);

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

여러 보상형 광고 재생 관련 참고 사항: RewardedVideoAd.showAd()을(를) 호출하면 RewardedVideoAd.loadAd(admob_ad_unit, adRequest)에 의해 마지막으로 호출된 AdMob 광고 단위가 재생됩니다. 여러 광고를 사전 캐시하고 사전 캐시된 광고 재생을 지정하려는 경우, RewardedVideoAd.showAd()을(를) 호출하기 전에 여러 광고 단위에 대해 RewardedVideoAd.loadAd(admob_ad_unit, adRequest)을(를) 호출한 다음 이미 사전 캐시된 광고에 대해 RewardedVideoAd.loadAd(admob_ad_unit, adRequest)을(를) 다시 호출하여 수행할 수 있습니다. "com.google.android.gms:play-services-ads:11.4.0"부터 AdMob에서는 RewardedVideoAd.showAd()을(를) 통해 재생할 사전 캐시된 보상형 광고를 매개변수로 지정할 수 없습니다.

추가 매개변수 전달(선택사항)

전면 광고

추가 속성을 사용해 광고를 사용자 정의할 수 있습니다.

속성

설명

userId

Vungle SDK에 전달하여 보상형 광고에 대한 서버 간 콜백에 사용할 사용자 고유 ID를 설정합니다.

setSoundEnabled

광고의 시작음 상태를 설정합니다. false로 설정된 경우 동영상이 무음으로 시작되지만 사용자가 이를 변경할 수 있습니다.

setOrdinalViewCount

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

setFlexViewCloseTimeInSec

지정된 시간(초)이 지난 후 Flex View 광고가 자동적으로 해제되게 하려면 이 옵션을 사용하십시오.
이 함수는 Flex View 광고에서만 작동하지만 대부분의 경우 권장되지 않습니다.

// sending user id ("USER_ID") and setting ad playback muted String[] placements = {"PLACEMENT_ID_1", "PLACEMENT_ID_", "PLACEMENT_ID_3"}; Bundle extras = new VungleExtrasBuilder(placements).setUserId("USER_ID").setSoundEnabled(false) .setOrdinalViewCount(3).setPlayingPlacement("PLACEMENT_ID_1").build(); AdRequest adRequest = new AdRequest.Builder() .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) .build(); mInterstitialAd01.loadAd(adRequest);

보상형 광고

추가 매개변수를 사용하여 보상형 광고를 사용자 정의할 수 있습니다.

속성

설명

setUserId

Vungle SDK에 전달하여 보상형 광고에 대한 서버 간 콜백에 사용할 사용자 고유 ID를 설정합니다.

withSoundEnabled

광고의 시작음 상태를 설정합니다. false로 설정된 경우 동영상이 무음으로 시작되지만 사용자가 이를 변경할 수 있습니다.

setOrdinalViewCount

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

setViewCloseTimeInSec

Flex View 동영상이 자동으로 닫히기 전에 재생할 시간(초)을 설정합니다.

 

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

댓글