미디에이션 테스트 모음

Google 모바일 광고 미디에이션 테스트 모음을 사용하면 미디에이션을 통해 제3자 네트워크의 광고를 게재하기 위해 앱과 광고 단위가 제대로 구성되었는지 테스트할 수 있습니다. 본 가이드에는 Android 앱에서 도구를 앱에 통합하여 Google 모바일 광고 미디에이션 테스트 모음을 사용하는 방법이 설명되어 있습니다.

기본 요건

  • Android SDK 4.1 (API 수준 16) 이상
  • Google Play 서비스 9.8.0 이상
  • AndroidManifest.xml에 앱 ID를 올바르게 입력해야 합니다.

설치

Gradle 사용

다음과 같은 필수 종속 항목을 앱의 build.gradle 파일에 복사합니다.

dependencies {
    // You should already have the ads dependency in your app.
    implementation 'com.google.android.gms:play-services-ads:20.1.0'
    implementation 'com.google.android.ads:mediation-test-suite:2.0.0'
}

최상위 수준 build.gradle 파일에 google() 저장소를 포함합니다.

// Top-level build file where you can add configuration options common to all
// sub-projects/modules.

buildscript {

   repositories {
       google()
       jcenter()
   }
   dependencies {
       classpath 'com.android.tools.build:gradle:3.2.1'

       // NOTE: Do not place your application dependencies here; they belong
       // in the individual module build.gradle files
   }
}

allprojects {
   repositories {
       google()
       jcenter()
   }
}

미디에이션 테스트 모음 실행

다음 코드 행을 사용하여 미디에이션 테스트 모음을 실행합니다.


MediationTestSuite.launch(MainActivity.this);

도구가 열리고 다음과 같은 면책조항이 표시됩니다.

체크박스를 선택하고 동의를 누르면 다음 단계로 넘어갑니다.

계정의 광고 단위 목록이 오류가 있는 광고 단위 탭과 정상 작동하는 광고 단위 탭에 표시됩니다.

테스트 기기 등록

기기가 아직 AdMob UI에 테스트 기기로 등록되지 않은 경우 기기를 테스트 기기로 등록할 것인지 묻는 메시지가 표시됩니다.

기기를 테스트 기기로 등록하면 미디에이션 테스트 모음에서 다음과 같은 동작이 변경됩니다.

  • 테스트 모음 UI에서 광고 단위 ID 대신 광고 단위 이름을 볼 수 있습니다.
  • 광고 단위 세부정보 화면에서 광고 단위 ID 외에 광고 단위 이름으로 검색할 수 있습니다.
  • 기기에서 AdMob의 테스트 광고를 수신할 수 있습니다.

기기 등록을 클릭하면 AdMob UI의 테스트 기기 등록 페이지로 이동합니다. 이 페이지에는 미디에이션 테스트 모음에서 가져온 기기 플랫폼 및 기기 ID가 미리 입력되어 있습니다. 테스트 기기의 이름을 추가하고 저장을 클릭하면 기기가 등록됩니다. 자세한 내용은 테스트 기기 설정을 참고하세요.

기기 등록은 보통 15분 이내에 미디에이션 테스트 모음에서 활성화되지만 최대 24시간이 걸릴 수 있습니다. 변경사항을 확인하려면 미디에이션 테스트 모음을 닫았다가 다시 여세요.

테스트 기기 등록 페이지에 액세스하려면 AdMob 계정에 로그인해야 합니다. 계정에 액세스할 수 없지만 이 방법을 사용하여 기기를 추가하려면 링크를 클릭한 다음 페이지가 브라우저에서 열리면 해당 URL을 계정 소유자와 공유하세요. 이렇게 하면 계정 소유자가 링크를 클릭하여 대신 기기를 등록할 수 있습니다.

테스트 기기로 등록하지 않으려면 닫기를 누르세요.

오류가 있는 광고 단위

오류가 있는 광고 단위 목록은 누락된 구성요소구성 오류로 구분됩니다.

광고 단위 네트워크가 모두 정상적으로 테스트되면 광고 단위가 '작동하지 않는 광고 단위' 탭에서 '작동 중인 광고 단위' 탭으로 이동합니다. 광고 단위 목록이 표시되지 않으면 네트워크 호출에 실패했거나 광고 단위를 찾을 수 없기 때문입니다.

광고 단위 목록을 검색하려면 상단의 검색 아이콘을 누르고 광고 단위 ID 문자열을 입력합니다. 네트워크 이름 또는 광고 형식을 검색할 수도 있습니다.

각 광고 단위에 대해 다음에 해당하는 경우 이 화면에 경고가 표시됩니다.

  • 광고 소스 SDK가 설치되지 않은 경우
  • 광고 소스 어댑터가 설치되지 않은 경우

  • 광고 소스에 필요한 매니페스트 항목이 구성되지 않은 경우

테스트가 가능한 경우 화면에 모든 광고 소스의 전반적인 테스트 결과 상태도 표시됩니다.

광고 단위 세부정보 화면으로 이동하려면 광고 단위를 선택하세요.

광고 단위 세부정보

이 화면에는 ad unit ID, 광고 형식, ad unit에 구성된 미디에이션 폭포식 구조 등의 ad unit 관련 세부정보가 표시됩니다.

이 화면에서 표시되는 다음 정보를 확인합니다.

광고 소스 요약

광고 소스별로 SDK와 어댑터의 설치 여부를 나타내는 표시기가 나타나고, 발견된 모든 필수 매니페스트 항목이 표시되며, 이 세션에서 이 구성의 마지막 테스트 결과가 제공됩니다.

맞춤 이벤트의 경우 맞춤 이벤트: custom event 라벨이 사용됩니다. 맞춤 이벤트에 대해 지정된 클래스가 있으면 맞춤 이벤트에 대한 어댑터 상태가 양수로 표시됩니다. 다른 네트워크와 동일한 방법으로 맞춤 이벤트에 대한 광고를 로드 및 조회할 수 있습니다.

검색

검색 아이콘을 누르면 이름에 따라 광고 소스를 검색할 수 있는 검색 화면이 표시됩니다.

배치 테스트

광고 소스 이름의 왼쪽에 있는 체크박스를 선택하여 각 광고 소스를 일괄적으로 테스트하도록 선택할 수 있습니다. 이렇게 하면 새 옵션이 탐색 메뉴에 나타납니다.

선택한 광고 소스의 광고를 순차적으로 로드하려면 오른쪽 상단의 광고 로드 버튼을 누릅니다. 테스트가 진행되는 동안 진행률 표시기가 표시됩니다. 왼쪽 상단의 뒤로 아이콘을 누르면 선택 사항이 삭제됩니다.

광고 로드 및 게재

광고 소스 세부정보 화면을 보려면 광고 소스 항목을 탭합니다.

화면에는 다음과 같은 광고 소스 관련 정보가 표시됩니다.

  • SDK 설치 여부 및 SDK 버전(해당하는 경우)
  • 어댑터 설치 여부 및 어댑터 버전(해당하는 경우)
  • 필수 매니페스트 항목이 제대로 구성되었는지 여부
  • 어댑터 초기화 상태(해당하는 경우)
  • AdMob 콘솔에 입력된 구성의 매개변수

필요한 모든 구성요소를 설치하면 광고 로드 테스트 단계로 넘어갈 수 있습니다. 광고 로드를 탭하면 광고 소스 SDK로 광고 요청이 전송됩니다. 광고 요청이 완료되면 요청의 성공 여부를 나타내는 업데이트 정보가 제공됩니다.

요청에 실패하면 콘솔 로그에서 테스트 중인 SDK의 메시지를 확인합니다.

요청에 성공한 경우

  • 배너 광고의 경우 광고가 인라인으로 표시됩니다.
  • 전면 광고 또는 보상형 광고의 경우 광고 표시를 탭하여 광고를 표시할 수 있습니다.
  • 네이티브 광고의 경우 반환되는 애셋이 인라인으로 표시됩니다.

    다음 예와 같이 광고가 새 화면에서 열립니다.

'세부정보' 화면으로 돌아가면 마지막으로 ad unit 목록 화면의 광고를 테스트한 결과가 표시됩니다. 성공적으로 로드된 광고 소스는 추가 테스트가 필요한 광고 소스 목록의 맨 아래에 표시됩니다.

공개 입찰 파트너

공개 입찰 테스트에 관한 자세한 내용은 공개 입찰 설정 확인 가이드를 참고하세요.

프로덕션 단계에서 테스트 사용 설정

기본적으로 미디에이션 테스트 모음은 디버그 가능한 빌드에서만 실행됩니다. 이는 최종 사용자가 실수로 테스트 모음을 실행하지 못하도록 하기 위한 것입니다.

앱이 프로덕션 단계에 들어간 후 기기에서 미디에이션 테스트 모음을 실행해야 하는 경우 SDK를 사용하여 해당 기기를 테스트 기기로 등록하세요.

프로덕션 앱에 미디에이션 테스트 모음을 추가할 때는 미디에이션 테스트 모음(예: 숨겨진 동작 또는 숨겨진 디버그 메뉴)을 실행하는 숨겨진 방법이 필요합니다. 그러면 빌드의 허용 목록에 추가된 모든 기기에서 테스트 모음을 실행할 수 있습니다.

네트워크 추가 기능으로 광고 요청 구성(선택사항)

Vungle과 같은 일부 미디에이션 대상 네트워크에서는 네트워크에 대한 요청에 추가 정보를 제공하기 위해 맞춤 네트워크 추가 번들을 제공하는 옵션을 제공합니다.

미디에이션 요청에 네트워크 추가 기능을 제공해야 하는 경우 MediationTestSuite.setAdRequest() 정적 메서드를 통해 사용할 테스트 모음에 대한 광고 요청을 설정할 수 있습니다.

자바

AdRequest requestBuilder = new AdRequest.Builder();
...
// Set your network extras for your chosen networks here.
// I.e., for each network extras bundle, call
// 'requestBuilder.addNetworkExtrasBundle(\,
// \)'
...
MediationTestSuite.setAdRequest(requestBuilder.build());

Kotlin

val requestBuilder = AdRequest.Builder()
...
// Set your network extras for your chosen networks here.
// I.e., for each network extras bundle, call
// 'requestBuilder.addNetworkExtrasBundle(\,
// \)'
...
MediationTestSuite.setAdRequest(requestBuilder.build())

미디에이션 테스트 모음을 실행하기 전에 다음 작업을 처리해야 합니다.

이를 통해 테스트 모음이 미디에이션된 네트워크에 대한 요청에서 사용할 수 있는 모든 추가 기능으로 광고 요청을 인스턴스화하고 구성할 수 있습니다.

변경 로그

v2.0.0

출시일: 2021-06-04

  • play-services-ads v20과의 호환성이 추가되었습니다. SDK 버전 20.0.0 이상이 필요합니다.
  • play-services-ads 종속성이 20.1.0으로 업데이트되었습니다.
  • MediationTestSuite.addTestDevice() 및 MediationTestSuite.getTestDevices() API가 삭제되었습니다. MobileAds.setRequestConfiguration()을 사용하여 테스트 기기 식별자를 설정하세요.
  • AdColony, Vungle 및 IronSource 배너 구성에 대한 지원이 추가되었습니다.
  • i-mobile 및 Tapjoy가 구성 오류를 잘못 보고하는 버그가 수정되었습니다.

v1.5.0

출시일: 2020-11-23

  • 결합된 앱 ID를 사용하여 Ad Manager 지원을 사용 설정하는 MediationTestSuite.launchForAdManager(Context context) API가 추가되었습니다.
  • AdMob용 테스트 기기 등록을 위한 지원이 추가되었습니다.
  • Ad Manager에서 구성된 광고 단위 매핑이 작동하지 않는 문제가 해결되었습니다.
  • Vungle SDK의 사용되지 않는 매니페스트 검사가 삭제되었습니다.
  • play-services-ads 종속 항목이 19.5.0으로 업데이트되었습니다.

v1.4.0

출시일: 2020-07-30

  • play-services-ads 종속 항목이 19.3.0으로 업데이트되었습니다.
  • 장애를 일으키는 배너, 전면 광고 형식이 수정되었습니다.
  • Fyber Marketplace 지원이 추가되었습니다.
  • Chartboost 배너 지원이 추가되었습니다.
  • MoPub 매니페스트 항목 감지 문제가 해결되었습니다.

v1.3.0

출시일: 2020-02-27

  • 공개 입찰 광고 로드에 대한 지원이 추가되었습니다.
  • AppLovin 및 InMobi 매니페스트 요구사항이 수정되었습니다.

v1.2.2

출시일: 2019-12-10

  • Unity에서 빌드 오류를 일으키는 proguard 파일의 오류가 수정되었습니다.

v1.2.1

출시일: 2019-11-11

  • 광고 종속 항목이 18.3.0으로 업데이트되었습니다.

v1.2.0

출시일: 2019-09-11

  • 초기 공개 입찰 지원이 업데이트되었습니다(구성 확인 기능, 광고 로드 불가).
  • i-mobile, Verizon Media에 대한 네트워크 지원이 추가되었습니다.

v1.1.1

출시일: 2019-06-28

  • AndroidX 지원을 위한 FlexboxLayout 종속 항목이 업데이트되었습니다.

v1.1.0

출시일: 2019-06-27

  • AndroidX 지원이 업데이트되었습니다.
  • 어댑터와 네트워크, 관련 구성이 업데이트되었습니다(예: 필수 매니페스트 항목).
  • AndroidManifest.xml에 AdMob ID를 사용하는 MediationTestSuite.launch(Context) API가 추가되었습니다.

v1.0.0

출시일: 2019-04-22

  • 일반 출시용 버전 범프

v0.9.5

출시일: 2019-02-22

  • 광고 네트워크/맞춤 이벤트의 구성 매개변수에 JSON을 제공하는 것과 관련된 문제가 해결되었습니다.

v0.9.4

출시일: 2019-02-11

  • Google 모바일 광고 SDK의 버전 17.1.3 업데이트를 포함한 종속 항목이 업데이트되었습니다.
  • AdColony SDK의 잘못된 매니페스트 권한과 관련된 버그가 수정되었습니다.
  • 광고 로드 컨텍스트가 API 28에서 활동 컨텍스트로 작동하지 않는 문제가 수정되었습니다.

v0.9.3

출시일: 2019-02-07

  • 특정 네트워크를 테스트할 때 미디에이션 테스트 모음에서 다른 네트워크의 광고를 로드하는 문제가 해결되었습니다.
  • 네이티브 광고 로드를 볼 수 있는 네이티브 애셋 보기가 추가되었습니다.
  • 기존의 '배너, 전면 광고' 광고 단위에 대한 지원이 추가되었습니다.
  • 프로덕션 환경에서 테스트 모음을 시작하는 데 대한 보호 장치가 추가되었습니다. MediationTestSuite.addTestDevice(String deviceHash)를 사용하여 AdMob 기기 ID가 허용 목록에 추가된 기기에서 실행하지 않는 한, 테스트 모음은 더 이상 출시 빌드에서 시작되지 않습니다.
  • 테스트 모음의 한국어, 일본어, 베트남어, 중국어 현지화가 추가되었습니다.

v0.9.2

출시일: 2018-10-03

  • 추가 '계정 ID' 매개변수가 있는 Facebook 전면 광고 문제가 해결되었습니다.
  • Vungle SDK v5.x의 잘못된 권한 문제가 해결되었습니다.
  • v21보다 낮은 Android 버전에서 발생하는 버그가 수정되었습니다.
  • 미디에이션 어댑터에 활동 컨텍스트가 필요한 경우 광고의 로드 문제가 해결되었습니다.

v0.9.1

출시일: 2018-09-20

  • Vungle SDK 버전 6.x를 지원하도록 업데이트되었습니다.
  • proguard로 빌드할 때 장애가 발생하는 문제가 수정되었습니다.
  • 자바 7 지원이 추가되었습니다.

v0.9.0

출시일: 2018-08-07

  • 업데이트된 UI로 오픈 베타가 출시되었습니다.
  • 일괄 테스트 기능이 추가되었습니다.

v0.2

출시일: 2018-03-20

  • 게시자가 새 AdMob UI로 미디에이션 그룹을 사용할 수 있도록 업데이트되었습니다.
  • UI가 업데이트되었습니다.
  • Nend, myTarget, maio, IronSource 등의 광고 네트워크에 대한 지원이 추가되었습니다.

v0.1.1

출시일: 2017-12-11

  • 앱 구성을 로드할 때 간헐적으로 NPE를 유발하는 버그가 수정되었습니다.

v0.1

출시일: 2017-11-10

  • 첫 버전이 출시되었습니다. 미디에이션 구성을 실행 및 다운로드하고, 어댑터, SDK, 매니페스트 정확성을 확인하고, AdMob 미디에이션 어댑터를 통해 제3자 네트워크의 광고를 로드 및 표시합니다.