포스트 본문영역

좋아요, 댓글, 공유 상태바
AdMob 오류 코드 및 로그 🛠

AdMob 게시자 여러분 안녕하세요!
오늘은 AdMob 광고를 구현 혹은 게재하는 도중에 맞닥뜨릴 수 있는 오류 코드 및 로그에 대해 자세히 알아보겠습니다. 게시자가 광고 요청을 전송하면, Google 에서는 광고를 볼 사용자와 연관된 광고를 제공하기 위해 최선을 다합니다. 하지만, 간혹 조건에 일치하는 광고를 제공할 수 없는 경우가 발생하며 광고를 제공할 수 없는 상황은 매우 다양합니다. 게시자의 광고 요청이 잘못되었을 수도 있고, 네트워크 문제가 있을 수도 있으며, 혹은 광고 요청을 받은 시점에 적절한 광고가 없어서 광고가 제공되지 않았을 수도 있습니다. 광고 요청이 정상적으로 처리되지 않은 경우, 광고 대신 오류 코드가 반환됩니다. 이러한 오류 코드에는 광고 요청시 발생한 오류의 원인과 관련된 정보가 포함되어 있으므로 문제 해결시 유용하게 사용할 수 있습니다.

먼저 개발 툴 로그 출력 창에서 오류 코드 확인 방법은 아래와 같습니다.

1. Android Studio: 앱 실행 - Logcat 창 오픈 - 오류 정보가 표시된 로그를 확인
2. Xcode: 앱 실행 - Output 창에 표시되는 로그를 확인

다음은 자주 발생하는 오류 코드에 대한 예시입니다.

1. 광고 서버에서 잘못된 응답을 받는 등 내부적으로 오류가 발생한 경우
Android: ERROR_CODE_INTERNAL_ERROR (Error code: 0)
iOS: kGADErrorServerError (Error code: 3)
새로 만든 광고 단위는 활성화되기까지 최대 2시간이 걸릴 수 있습니다. 따라서 생성한 지 얼마 안 된 광고 단위를 사용하여 광고 요청을 하는 경우 이 오류가 발생할 수 있는데요. 광고 단위가 활성화 되기 전 테스트 광고를 활용해 보세요.

2. 광고 요청이 잘못된 경우 (예: 광고 단위 ID가 잘못된 경우)
Android: ERROR_CODE_INVALID_REQUEST (Error code: 1)
iOS: kGADErrorInvalidRequest (Error code: 0)
광고 요청이 SDK 요구사항에 맞게 구현되지 않았음을 의미합니다. 개발자 문서에 제공된 샘플 코드나 샘플 앱 등을 참고하여 구현 내용을 수정해보세요.

3. 네트워크 연결로 인해 광고 요청에 성공하지 못했을 경우
Android: ERROR_CODE_NETWORK_ERROR (Error code: 2)
iOS: kGADErrorNetworkError (Error code: 2)
사용자 단말기의 네트워크가 전환 상태이거나, 혹은 네트워크 장애로 앱과 광고 서버간 커뮤니케이션이 원활하게 수신되지 않고 있음을 의미합니다. 일부 통신 업체의 경우 정책에 따라 특정 트래픽을 제한하는 경우 위 오류가 발생할 수 있습니다.

4. 광고 요청에는 성공했지만, 광고 인벤토리의 부족으로 광고가 반환되지 않았을 경우
Android: ERROR_CODE_NO_FILL (Error code: 3)
iOS: kGADErrorNoFill (Error code: 1)
광고주는 비즈니스 관련성을 기반으로 특정 지역, 플랫폼, 사용자 프로필을 타겟팅할 수 있고, 이로 인해 특정 지역이나 사용자 프로필을 타겟팅하고 있는 광고의 수가 제한될 수 있습니다. 이 오류 코드는 광고 요청은 올바르게 구현 되었지만 앱에서 광고 요청이 전송된 시점에 게재가 가능한 적합한 광고가 부족하여 광고 요청이 충족되지 않았음을 의미합니다. 특정 앱이나 광고 단위와 관련된 정책 문제가 있는 경우에도 이 오류가 발생할 수 있습니다.
→ AdMob이 광고주 수요를 통제할 수는 없으므로 이 오류에 대한 수정방법은 없습니다. 다만 게시자는 광고 단위가 올바르게 구현되었는지 다시 한번 점검하고, 게시자 ID, 앱 단위에 대한 정책 상태를 검토하세요. 만약 테스트 광고 사용 시 광고가 구현 될 경우 구현에는 문제가 없음을 의미합니다.

전달 드린 내용을 통해 게시자 및 개발자 분들께서 문제 발생 시 유용하게 활용하실 수 있길 바랍니다. 감사합니다!

댓글영역
하두호2019년 5월 29일 오후 05:47

(이모티콘이 포함된 댓글은 카카오톡 모바일앱에서 확인할 수 있습니다.)

황창근2019년 9월 5일 오후 08:45

4번 에러코드3인 경우로 전면광고가 뜨고 있지 않은데...
얼마전 출시한 다른앱은 잘만 뜹니다.
제폰과 옆 개발자 폰에서요.
근데 또 옆에있는 디자이너분 폰에서는 모두 잘 뜹니다.
이건 대체 무슨 현상인걸까요?

황창근2019년 9월 5일 오후 08:54

3일이 지나도 에러코드가 3으로 전면광고가 뜨지 않고 있습니다.
처음 이틀정도만 떴고요.
이거 다른 문제가 있는거 아닌가요?