미디에이션 테스트 모음

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:19.7.0'
    implementation 'com.google.android.ads:mediation-test-suite:1.5.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())

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

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