본문으로 건너뛰기

문제 해결하기

오류 코드가 나타납니다

BuzzAd iOS용 SDK 메소드 호출 시 오류가 발생하면 onFailure 콜백으로 NSError가 전달됩니다. 아래의 오류 코드 표를 참고하여 문제의 원인을 파악하고 오류를 해결할 수 있습니다.

✏️  참고
BuzzAd iOS용 SDK에서 발생하는 오류의 도메인은 BZVErrorDomain입니다.

오류 코드원인해결 방법
BZVServerError버즈빌 서버에서 오류가 발생했습니다.버즈빌 담당자에게 오류 코드를 전달하세요.
BZVInvalidRequest요청이 요구 사항을 충족하지 않았습니다.
(예: 사용자 로그인 전에 광고 요청을 시도함)
요청의 인자로 올바른 값을 전달하는지 확인하세요.
BZVRequestTimeout네트워크 요청이 제한된 시간을 초과했습니다.네트워크 연결 상태를 확인하세요.
BZVEmptyResponse네트워크 응답이 비어 있습니다.
(예: 광고 요청에 성공했지만 응답으로 받은 광고의 개수가 '0'임)
버즈빌 담당자에게 오류 코드를 전달하세요.
BZVWaitingForResponse피드 지면에서 광고의 프리로드(preload) 요청을 처리 중일 때 프리로드를 다시 요청하면 발생할 수 있는 오류입니다. 이 오류 코드가 발생하더라도 광고 할당은 정상적으로 처리됩니다.프리로드를 중복으로 요청하지 않았는지 확인하세요.
BZVNetworkDisconnected네트워크 연결이 불안정합니다.네트워크 연결 상태를 확인하세요.
BZVAgeUnsatisfied사용자의 나이가 플랫폼 정책상 광고를 받을 수 있는 나이보다 어립니다.로그인 시 나이를 15세 이상으로 설정해 주세요.
BZVPrivacyPolicyDisagreed사용자가 개인정보 처리보호방침에 동의하지 않았습니다.광고를 요청하기 전에 개인정보 처리보호방침에 동의하였는지 확인하세요.
BZVUnknownError식별이 불가능한 오류입니다.SDK 연동과 앱 빌드 과정에서 오류가 없었는지 점검해 보세요.

다음은 네이티브 광고 요청 시 오류를 처리하는 예시입니다.

let nativeAdRequest = BZVNativeAdRequest()
let buzzAdNative = BZVBuzzAdNative(unitId: "YOUR_NATIVE_UNIT_ID")
buzzAdNative.loadAd(with: nativeAdRequest) { nativeAd in
// 할당된 광고가 있으면 호출됩니다.
} onFailure: { error in
if let rawError = error as? BZVError {
switch rawError.code {
case .serverError:
print("server error")
case .invalidRequest:
print("invalid request")
case .requestTimeout:
print("request timeout")
case .emptyResponse:
print("empty response")
case .unkwounError:
print("unknown error")
default:
break
}
} else {
// BZVErrorDomain에 속하지 않는 오류를 처리합니다.
}
}

iOS 10 및 이하 버전의 사용자 기기에서 앱이 비정상적으로 종료됩니다

  • 오류 원인: BuzzAd iOS용 SDK는 iOS 11 이상의 기기에서 작동하므로 iOS 11 미만의 기기에서 BuzzAd iOS용 SDK 코드를 호출되면 앱이 비정상적으로 종료될 수 있습니다.
  • 해결 방법: 앱이 iOS 11 미만의 기기를 지원하는 경우 iOS 11 이상의 버전에서만 BuzzAd iOS용 SDK 코드를 호출해야 합니다. 자세한 내용은 iOS 11 이상에서만 SDK가 동작하도록 구현 토픽을 참고하세요.

앱에서 다크모드 활성화 시 피드 지면의 광고 뷰 텍스트가 보이지 않습니다

  • 오류 원인: 앱의 다크모드가 활성화되어 피드 광고 뷰의 텍스트가 보이지 않습니다.
  • 해결 방법: 일반 광고 디자인 자체 구현하기 토픽을 참고하여 광고 디자인을 자체 구현하고 텍스트를 노출하는 뷰(예: titleLabel, descriptionLabel)의 색상을 배경색 이외의 색상으로 지정하고 다크모드에서 식별 가능한 명도를 적용하여 문제를 해결하세요.

✏️   참고
다크모드에 적합한 텍스트 색상의 가이드라인에 대해서는 Apple의 공식 문서를 참고하세요.