광고 검사기는 최신 Google 모바일 광고 SDK(Android의 경우 버전 20.0.0 이상, iOS의 경우 7.68.0 이상)에 포함된 새로운 기능입니다. 광고 검사기를 사용하면 광고 게재와 관련된 유용한 정보를 확인하고 제3자 광고 소스를 실시간으로 테스트할 수 있습니다. 코딩이 필요하지 않습니다.
테스트 기기를 흔들기 또는 휙 돌리기 등 간단한 동작을 통해 광고 검사기가 앱 상단에 오버레이로 표시됩니다. 광고 검사기를 사용하여 다음과 같은 작업을 처리할 수 있습니다.
- 광고 단위 검사하기
- 광고가 예상대로 게재되고 있는지 확인합니다.
- 오류를 파악하고 해결 방법에 관한 세부정보를 확인합니다.
- 요청마다 미디에이션의 폭포식 구조 세부정보를 확인합니다.
- 제3자 광고 소스 SDK 어댑터의 상태를 확인합니다.
- 개별 제3자 폭포식 구조 광고 소스 테스트하기
- 미디에이션에 광고 소스를 제대로 구성했는지 확인합니다.
- 광고 단위마다 광고 소스별 실적을 확인합니다.
시작하기
광고 검사기를 사용하려면 다음과 같이 해야 합니다.
- 최신 Google 모바일 광고 SDK(Android의 경우 버전 20.0.0 이상, iOS의 경우 7.68.0 이상)를 설치하고 초기화합니다.
- 테스트 기기를 설정하고, 내 기기에서 광고 검사기를 호출하는 데 사용할 동작을 선택합니다. 테스트 기기를 추가하는 방법을 알아보세요.
- 테스트 기기에서 앱을 열고 앱과 상호작용합니다. 이렇게 하면 분석할 광고 요청이 충분히 많아집니다. 앱에 광고 캐싱을 구현한 경우에는 앱 시작 시에도 일련의 광고 요청이 표시될 수 있습니다.
- 테스트 기기에서 내 앱과 상호작용한 후 2단계에서 선택한 동작을 사용하여 광고 검사기를 호출합니다.
Android 또는 iOS용 API 호출을 통해 테스트 기기에서 광고 검사기를 활성화할 수도 있습니다.
작동 방식
등록된 테스트 기기에서 앱을 열면 광고 검사기에서 자동으로 앱의 광고 게재를 검사합니다.
분석할 광고 요청이 충분하도록 하려면 앱과 상호작용해야 합니다. 앱에서 광고를 미리 가져오는 경우 앱 시작 시에도 일련의 광고 요청이 표시될 수도 있습니다.
동작 또는 맞춤 API 호출을 통해 테스트 기기에서 광고 검사기를 호출한 후에는 앱의 광고 단위가 최신 활동 순으로 나열됩니다(이러한 광고 단위에서 광고를 게재했는지 여부와 관계없음). 타사 SDK 어댑터를 확인할 수 있는 탭도 표시됩니다. 일반적인 SDK 어댑터 문제에 대해 자세히 알아보세요.
SDK 요청 로그를 확인하려면 광고 단위를 탭합니다. 그러면 최신 광고 요청에 대한 광고가 게재되기까지(또는 폭포식 구조가 처리되지 않고 종료되기까지)의 미디에이션 폭포식 구조가 자세히 표시됩니다. 여기에서 광고가 게재되지 않은 각 광고 소스를 펼쳐 '처리되지 않음' 오류에 대한 세부정보를 확인할 수 있습니다.
제3자 광고 소스의 경우 오류 메시지가 광고 소스에서 직접 전송됩니다. 자세한 정보가 필요한 경우 제3자 광고 소스를 참고하세요.
단일 광고 소스 테스트하기
광고 검사기를 사용하면 제3자 단일 폭포식 구조 광고 소스의 설정을 테스트할 수 있습니다. 이렇게 하면 제3자 미디에이션 어댑터가 제대로 구현되었는지와 광고 소스에서 광고를 예상대로 게재하고 있는지를 확인할 수 있습니다.
단일 광고 소스 테스트를 시작하려면 앱 하단에서 단일 광고 소스 테스트를 전환합니다. 그런 다음 테스트할 광고 소스를 선택합니다. 단일 광고 소스 테스트에 대해 광고 검사기를 사용 설정하면 이후의 모든 광고 요청에서 선택된 광고 소스로부터 광고를 반환하려고 시도합니다.
단일 광고 소스 테스트에서 광고 단위를 탭하여 SDK 요청 로그를 확인할 수 있습니다. 이렇게 하면 단일 광고 소스 테스트가 사용 설정된 후에 광고 소스에서 광고 요청을 처리했는지 여부를 확인할 수 있습니다. 광고 소스에서 광고 요청을 처리하지 않은 경우에는 '처리되지 않음' 오류가 발생한 원인을 설명하는 오류 메시지가 표시됩니다.
선택한 광고 소스의 여러 인스턴스를 미디에이션 폭포식 구조에 추가한 경우 광고가 게재되었거나 폭포식 구조가 처리되지 않고 종료되었을 때까지의 폭포식 구조 광고 소스에 대한 호출의 각 인스턴스가 표시됩니다.
단일 광고 소스 테스트는 60분 후에 자동으로 만료됩니다.
강제로 다시 시작하는 방법
단일 광고 소스 테스트를 사용 설정하면 앱을 강제로 다시 시작해야 합니다. 일부 앱에서는 시작 시 광고를 캐시하기 때문에 앱을 다시 시작하면 테스트되는 세션의 모든 광고 요청에 단일 소스 테스트가 적용되도록 할 수 있습니다.
Android 기기의 경우 일반적으로 휴대전화의 설정 앱을 통해 앱을 강제로 다시 시작할 수 있으며, 설정은 휴대전화마다 다를 수 있습니다. 자세한 내용은 기기 제조업체를 참고하세요.
iOS 기기용 앱을 강제로 다시 시작하는 방법을 알아보세요.
SDK 어댑터 문제 파악하기
SDK 어댑터의 상태를 확인하려면 어댑터 탭을 클릭합니다.
제3자 광고 소스의 SDK 어댑터를 확인할 때 두 가지 문제가 발생할 수 있습니다. 다음을 검토하여 문제 및 해결 방법을 파악하세요.
어댑터를 찾을 수 없음
일부 제3자 광고 소스는 해당 소스에서 광고를 로드하고 표시하려면 SDK 및 GMA SDK별 어댑터가 필요합니다. 이 오류는 GMA SDK에서 제3자 어댑터 또는 SDK를 찾을 수 없음을 의미합니다. SDK 어댑터를 올바르게 설치했는지 확인합니다. 자세히 알아보기(Android, iOS)
초기화되지 않음
각 제3자 광고 소스 SDK 어댑터는 필요한 매개변수를 사용하여 코드베이스에서 명시적으로 초기화해야 합니다. 통합 가이드를 올바르게 따랐는지 확인하세요. 특정 초기화 오류는 제3자 광고 소스 설명서를 참고하세요. 자세히 알아보기(Android, iOS)