본문으로 건너뛰기

NAM Error Codes

담당자를 통한 문의 전에...

문의 사항이 있는 경우, device log와 재현 스텝 (가능하다면 재현 영상이나 디버그 가능한 앱)을 첨부하여 문의 주시면 빠른 원인 파악에 도움이 됩니다.

NAM Error Codes

Error CodeSub type codeDesc초기 대응
1000GFP_INTERNAL_ERROR배너 광고에서 웹뷰가 없거나 렌더링 과정에서 오류 발생가용한 웹뷰가 있는지 확인
GFP_NOT_REGISTERED_PROVIDER처리 할 광고 어뎁터가 없을 때라이브러리 추가 상태 확인 필요
GFP_RECEIVED_INVALID_PROPERTYvalid한 광고 응답이 아닐 때유닛 설정 확인 필요
GFP_NOT_FOUND_***_ADAPTER처리 할 광고 어뎁터가 없을 때라이브러리 추가 상태 확인 필요
2000GFP_RECEIVED_INVALID_PROPERTY광고 서버로 부터 응답 받은 광고가 없을 때
3000GFP_THIRD_PARTY_INIT_ERRORDSP 초기화 과정 중 에러 발생
3000그 외광고 요청 중 에러 발생
3100GFP_RECEIVED_INVALID_PROPERTY광고 서버에서 받은 응답에 광고 처리에 필요한 파라미터가 없음
3210NETWORK/SERVER/INTERNAL ERROR네트워크 등의 문제로 광고 요청에 실패 함네트워크 상태 확인 필요
3220GFP_INTERNAL_ERROR광고 서버 응답 데이터에 문제가 있음
3310GFP_NO_FILL 혹은 기타 메시지DSP 에서 NO_FILL(광고 없음)에러를 보내주는 경우, 광고 로드시 오류 발생
3320GFP_INMOBI_NOT_SUPPORTED_NATIVE_AD_TYPEInMobi 네이티브 광고 렌더링 에러
3400GFP_REQUEST_TIMEOUT광고 처리 시간 만료 - timeout네트워크 상태 확인 및 timeout 설정 값 확인 필요
4000GFP_INTERNAL_ERRORIMA 동영상 controller 생성 오류
4100기타 메시지동영상 광고 재생 중 에러
5100GFP_FAILED_TO_RENDER_NATIVE_AD네이버 네이티브 광고 렌더링시 에러 발생
GFP_FAILED_TO_UNTRACK네이버 네이티브 광고 해제 중 에러 발생
6100GFP_FAILED_TO_RENDER_REWARDED_AD 혹은 기타 메시지리워드 형 광고 렌더링 중 에러 발생
7100GFP_FAILED_TO_RENDER_INTERSTITIAL_AD 혹은 기타 메시지전면형 광고 렌더링 중 에러 발생
9110GFP_MISSING_PARAM광고 스케줄 ID가 설정되지 않은 경우광고 스케줄 ID 확인이 필요
9210GFP_AD_SCHEDULE_EMPTY 외 기타 메시지광고 스케줄 처리 중 에러 발생콘텐츠 길이 등 VideoAdScheduleParam 확인 필요

FAQ

  • 에러 메시지: Empty render type

    • AD 서버에서 광고가 선출되지 않은 경우.

      Admin 혹은 AD 담당자를 통해 해당 광고 유닛에 광고가 설정되어 있는지 확인해 주세요.

    • 선출된 광고에서 에러 발생 이후, 데이터 측정을 위한 empty 광고가 처리된 경우.

      이 경우 이전에 발생된 에러 메시지를 참고해 주세요.

  • 에러 메시지: There is no adapter available 또는 Not found adapter: UNITY, BANNER, INTERSTITIAL (대문자의 이름은 가변적임)

    NAM SDK는 내부적으로 adapter 패턴을 사용합니다. 해당 메시지는 아래 2가지 경우가 있습니다.

    • AdLoader 에서 셋팅하지 않은 광고 형태가 응답으로 온 경우

      ex) GfpAdLoader로 네이티브 광고를 설정 했는데, 요청한 광고 유닛의 응답으로 배너가 내려 오는 경우

      NAM Admin 담당자를 통해서 Unit ID를 확인해 주시고, 설정해야 하는 광고 타입을 확인해 주세요.

    • Dependency가 누락된 경우

      NAM 담당자와 협의하신 DSP의 의존성이 누락 됐는지 확인해 주세요.

      또한 해당 DSP의 configration을 셋팅 했는지도 함께 확인해 주세요.

  • META(FAN) 의 경우, 에러 메시지: Bid 421...586 for template 200 being used on template NATIVE_BANNER

    META의 Native나 Native Banner 광고를 사용할 때 위 메시지가 발생 되었다면

    META Admin에 설정한 유닛의 타입이 Native Banner 인지 확인해 주시고

    GfpNativeAdOptions 에서 Native Banner 를 사용하도록 설정 (setHasMediaView(false)) 했는지 확인해 주세요.

  • DFP (구글)의 경우, 에러 메시지: No ad config

    주로 테스트 광고 설정에 문제가 있는 경우 발생 됩니다.

    Admin 혹은 AD 담당자 통해 광고 설정을 확인해 주세요.

  • 두번 광고 요청을 하는 경우 어떻게 되나요? (하나의 GfpAdLoader 로 여러번 요청)

    이전에 요청된 광고는 무시되고, 마지막에 요청된 광고에 대한 응답을 처리하게 됩니다. (마지막 광고가 노출 됨)

  • 초기화가 필요한가요?

    필수는 아니지만 초기화가 필요합니다. 초기화 과정으로 타겟팅 등에 사용 될 adid 등을 가져오고, 각 DSP 초기화 과정을 거치게 됩니다.

    또한 특정 DSP는 application context를 필요로 하기 때문에, application 단에서 수행하는 것을 권장드립니다.