본문으로 건너뛰기

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 단에서 수행하는 것을 권장드립니다.