Skip to content
:docs

Troubleshooting

An error code appears

If a Buzzvil SDK method fails, NSError is returned through the onFailure callback. Use the table below to identify and resolve the cause.

Error codeCauseResolution
BZVServerErrorAn error occurred on the Buzzvil server.Send the error code to your Buzzvil representative.
BZVInvalidRequestThe request did not meet the requirements.
(For example, an ad was requested before the user logged in.)
Check that the request arguments contain valid values.
BZVRequestTimeoutThe network request timed out.Check the network connection.
BZVEmptyResponseThe network response is empty.
(For example, an ad request succeeded but returned zero ads.)
Send the error code to your Buzzvil representative.
BZVWaitingForResponseThis error can occur if you request another preload while a preload request is already being processed for BenefitHub. Ad allocation still proceeds normally when this error occurs.Check that you have not requested a duplicate preload.
BZVNetworkDisconnectedThe network connection is unstable.Check the network connection.
BZVAgeUnsatisfiedThe user is younger than the minimum age allowed to receive ads under the platform policy.Set the age to 15 or older during login.
BZVPrivacyPolicyDisagreedThe user has not agreed to the privacy policy.Check that the user agreed to the privacy policy before requesting ads.
BZVUnknownErrorAn unidentified error occurred.Check for errors in the SDK integration and app build.

The following example handles errors when requesting native ads.

Swift
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에 속하지 않는 오류를 처리합니다.
  }
}

The app crashes on iOS 12 or earlier

  • Cause: Buzzvil SDK requires iOS 13 or later. Calling SDK code on an earlier version may crash the app.

  • Solution: If your app supports earlier iOS versions, call SDK code only on iOS 13 or later. See Run the SDK only on iOS 13 or later.

BenefitHub ad text is invisible in dark mode

  • Cause: The app's dark mode makes text in BenefitHub ad views invisible.
  • Solution: Follow Implement a custom ad design and set text views such as titleLabel and descriptionLabel to colors that contrast with the background and remain legible in dark mode.