광고 검사기

광고 검사기 는 승인된 기기가 모바일 앱 내에서 바로 테스트 광고 요청을 실시간으로 분석할 수 있도록 지원하는 인앱 오버레이입니다. Google 모바일 광고 SDK 버전 7.68.0 이상에 포함되어 있으며 코딩 없이 사용할 수 있습니다.

버전 7.68.0~8.5.0의 모바일 광고 SDK에서 광고 검사기를 이용해 다음을 할 수 있습니다.

  • 광고 단위 검사
  • 광고가 예상대로 게재되고 있는지 확인
  • 오류 파악 및 해결 방법에 관한 세부정보 확인
  • 요청별로 각 광고 네트워크의 미디에이션 세부정보 확인
  • 개별 제3자 미디에이션 광고 소스 테스트
  • 각 광고 단위를 폭포식 구조 미디에이션을 위해 제대로 구성했는지 확인

모바일 광고 SDK 버전 8.5.0 이상을 이용하면 다음도 할 수 있습니다.

  • 요청별로 각 광고 네트워크의 입찰 세부정보 확인
  • 요청별로 각 광고 네트워크의 입찰 및 폭포식 구조 미디에이션 세부정보를 동시에 확인
  • 개별 제3자 입찰 또는 폭포식 구조 미디에이션 광고 소스 테스트
  • 각 광고 단위를 입찰 및 폭포식 구조 미디에이션을 위해 제대로 구성했다는 점을 확인

이 가이드에서는 광고 검사기의 다양한 기능을 실행하고 사용하는 방법을 보여줍니다.

기본 요건

광고 검사기를 사용하려면 다음을 준비해야 합니다.

  • 시작 가이드를 모두 읽어보세요.

  • Google 모바일 광고 SDK 버전 7.68.0 이상을 사용합니다.

광고 검사기 실행하기

광고 검사기는 앱 내의 어느 위치에서든 실행할 수 있으며 실행 방법은 세 가지입니다.

  1. 테스트 기기를 등록할 때 AdMob UI에서 선택한 동작 사용

  2. 제공된 API를 이용하는 프로그래매틱 방식 사용

  3. 디버그 메뉴의 실행 버튼 사용

동작으로 실행하기

동작으로 광고 검사기를 실행하기 위해 앱에 적용해야 하는 변경사항은 없습니다. 테스트 기기의 AdMob에서 구성한 동작(2번 휙 돌리기 또는 흔들기)을 실행하기만 하면 됩니다. 자세히 알아보기

AdMob UI에서 동작을 설정하고 적용될 때까지 15분 동안 기다린 후 앱이 Google 모바일 광고 SDK에 광고 요청을 전송해야만 앱에서 동작 설정을 인식하게 됩니다. 지정된 동작이 작동하지 않으면 광고를 로드하고 앱을 다시 시작한 다음 동작을 다시 테스트해 보세요.

프로그래매틱 방식으로 실행하기

프로그래매틱 방식으로 광고 검사기를 실행할 수도 있습니다.

[GADMobileAds.sharedInstance presentInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

이 API는 프로그래매틱 방식으로 등록되거나 AdMob UI를 통해 등록된 테스트 기기에서 작동합니다.

이 API로 전달된 뷰 컨트롤러가 화면에 완전하게 표시된 후에 실행하세요(viewDidAppear:가 호출됨). 전달된 뷰 컨트롤러가 표시되는 중이면(예: 위의 API가 뷰 컨트롤러의 viewDidLoad 함수에서 호출된 경우) 광고 검사기가 실행되지 않습니다.

광고 단위별로 최근 광고 요청 결과 보기

광고 검사기를 실행하면 기본 광고 검사기 화면이 표시되고 여기에는 내 AdMob 앱 ID와 연결된 AdMob UI에서 볼 수 있고 입찰 또는 미디에이션 구성이 적용된 광고 단위가 모두 표시됩니다.

광고 단위는 가장 최근에 요청이 완료된 것부터 시간순으로 정렬됩니다. 위와 같이 완료된 요청이 없는 것으로 파악된 광고 단위는 흐리게 표시됩니다.

광고 검사기를 사용하기 전에 Google 모바일 광고 SDK를 초기화하는 것이 좋습니다.

광고 단위에 대한 bidding 세부정보 보기

기본 요건: Google 모바일 광고 SDK 8.5.0 이상

입찰을 처음 사용하는 경우 입찰 개요를 읽어보세요.

SDK 요청 로그를 보면 광고 요청에서 호출된 bidding 광고 소스를 확인할 수 있습니다. SDK 요청 로그에서 광고 단위를 탭하여 bidding 입찰의 각 광고 소스에 대한 세부정보를 확인하세요.

모든 입찰자 보기 링크를 탭하여 광고 단위에 대해 구성된 모든 bidding 광고 네트워크를 확인하세요. bidding 결과는 위에서부터 실행 가능한 항목 순으로 정렬됩니다.

  • 맨 위에는 낙찰을 받은 광고 네트워크가 표시됩니다.

  • 그 다음은 문제가 있는 광고 네트워크가 표시됩니다. 문제 해결 단계를 따르세요.

  • 그 다음에는 반환된 광고가 없거나 입찰에 참여하지 않은 광고 네트워크가 표시됩니다. 이는 해당 광고 소스가 설정이나 결정으로 인해 입찰에 참여하지 않은 것일 수 있으므로 광고 소스에 여러 가지 많은 문제가 있다는 뜻일 수 있습니다. 광고 소스의 설정 가이드를 참고하거나 광고 소스에 직접 문의하여 지원을 받으세요.

  • 마지막으로, 목록 하단에는 bidding 입찰에서 탈락한 광고 네트워크가 표시됩니다.

미디에이션 폭포식 구조를 사용하면 bidding 낙찰을 받은 광고 소스를 eCPM 값에 따라 배치할 수 있습니다.

미디에이션 폭포식 구조에서 호출되는 광고 소스가 광고를 게재합니다. 입찰이 미디에이션 폭포식 구조에서 작동하는 방식에 관한 자세한 내용은 미디에이션 그룹의 입찰 및 폭포식 구조 광고 소스를 보여주는 예 2와 예 3을 참고하세요.

광고 단위별 미디에이션 폭포식 구조 세부정보 보기

SDK 요청 로그를 확인하려면 광고 단위를 탭합니다. 그러면 최신 광고 요청에 대해 광고가 채워진 시점(또는 광고가 게재되지 않고 종료된 폭포식 구조)을 비롯한 미디에이션 폭포식 구조에 대한 세부정보가 표시됩니다.

정보 공개 표시기를 통해 각 요청을 확장하여 해당 요청에 대한 미디에이션의 폭포식 구조 결과를 해당 요청과 관련된 오류 및 지연 시간과 더불어 표시할 수 있습니다.

제3자 광고 소스의 경우 오류 메시지가 광고 소스에서 직접 전송됩니다. 자세한 내용은 제3자 광고 소스를 찾아보세요.

단일 광고 소스 테스트 실행하기

광고 검사기에는 단일 bidding 또는 폭포식 구조 미디에이션 광고 소스의 광고만 게재되도록 내 앱의 광고 요청을 제한하는 기능이 있습니다. 이를 통해 제3자 어댑터를 올바르게 구현했는지, 광고 소스가 예상대로 게재되고 있는지 확인할 수 있습니다.

이 기능을 사용 설정하려면 화면 하단에서 단일 광고 소스 테스트 스위치를 전환하여 사용 설정하세요. 그러면 다음과 같이 광고 소스를 선택할 수 있는 대화상자가 표시됩니다.

Google 모바일 광고 SDK를 초기화해야 단일 광고 소스를 테스트할 수 있습니다.

이제 테스트할 단일 광고 소스를 선택합니다. 광고 소스를 선택하면 다음과 같은 화면이 표시됩니다.

단일 광고 소스 테스트 설정은 동일한 세션에서 나중에 하는 광고 요청에 적용됩니다. 하지만 해당 세션에서 아직 게재되지 않은 이전에 캐시된 광고에는 적용되지 않습니다. 요청 수신을 선택한 광고 소스 대신 게재될 수 있는 캐시된 광고를 무효화하려면 단일 소스 테스트를 적용할 때 앱을 강제로 다시 시작하는 것이 좋습니다.

앱을 다시 시작한 후에는 모든 광고 단위 게재위치에서 선택된 네트워크의 광고만 게재하려고 시도합니다. 단일 광고 소스 테스트가 진행 중일 때 광고 검사기를 실행하면 테스트가 진행되고 있는 광고 소스가 다음과 같이 표시됩니다.

단일 광고 소스 테스트 모드에서는 선택한 광고 소스가 요청된 광고 단위의 입찰이나 미디에이션에 대해 구성되었는지에 관계없이 모든 광고 요청에서 이러한 광고 소스를 게재하려고 시도합니다. 즉, 테스트 중인 광고 소스가 광고 단위의 미디에이션 폭포식 구조에 속해 있지 않으면 '게재 불가' 오류 메시지가 표시됩니다.

단일 광고 소스 테스트에서 광고 단위를 탭하여 SDK 요청 로그를 확인할 수 있습니다. 이렇게 하면 단일 광고 소스 테스트가 사용 설정된 후에 이루어진 광고 요청에 대해 광고 소스에서 광고를 게재했는지를 확인할 수 있습니다. 광고 소스에서 광고를 로드하지 못하면 해당 오류를 설명하는 오류 메시지가 표시됩니다.

선택한 광고 소스의 여러 인스턴스를 미디에이션의 폭포식 구조에 추가한 경우 광고가 게재되거나 광고 게재 없이 폭포식 구조가 종료되기까지 폭포식 구조에 각 광고 소스 호출 인스턴스가 표시됩니다.

단일 광고 소스 테스트에서는 맞춤 이벤트가 지원되지 않습니다.

단일 광고 소스 테스트 중지하기

테스트를 중지하려면 스위치를 전환하여 중지합니다.

다음과 같이 다시 시작 화면에 확인 메시지가 표시됩니다.

테스트한 광고 소스에 대해 캐시된 광고를 무효화하려면 테스트를 중지한 후 앱을 강제로 다시 시작하는 것이 좋습니다.