Benefit JS SDK에서는 다양한 곳에서 에러가 발생할 가능성이 있고, 이 중 퍼블리셔가 다룰 수 있도록 에러에 대한 callback을 등록하는 곳은 다음 세 곳이 있습니다.

  1. BuzzAdBenefit.ensureAuthenticated..then(() => {}, onAuthError);
  2. BuzzAdBenefit.loadAd(config).then(onLoaded, onAdError);
  3. const AdListener = {
  ...
  onVideoError: onVideoError
};
BuzzAdBenefit.registerNativeAd(nativeAd, placementView, adListener);

본 문서에서는 위의 각 세 단계에서 발생하는 에러의 종류와 권장 처리 방법에 대해서 서술합니다. 정제된 에러 문자열의 경우 SDK의 업데이트에 따라 새로운 것이 추가되거나 기존의 것이 삭제될 수 있습니다.

1. onAuthError

에러 상황 설명

서버 에러 등의 이유로 UserProfile 및 기기 정보를 버즈빌 서버에 등록하는데 실패한 경우입니다. 버즈빌 서버에 로그인이 안된 상태이므로 현재는 광고를 보여줄 수 없습니다. 추후 SDK 업데이트에 따라 정제된 에러 문자열로 변경될 수 있습니다.

에러 종류 설명

정제되지 않은 에러 객체를 직접 받게 됩니다.

권장 처리 방법

일시적인 오류일 가능성이 높습니다. 아직 광고가 표시되지 않았으며, 더 이상의 광고 할당 진행이 어려우므로 광고 영역을 보이지 않게 합니다.

2. onAdError

에러 상황 설명

버즈빌 서버에 광고를 요청을 했을 때, 광고를 받지 못한 경우입니다. 아직 광고가 보이지 않는 상태이면 그대로 광고 영역이 보이지 않게 유지하는 것으로 처리할 수 있고, 이미 어떤 광고가 보이는 상태에서 새로 광고를 요청했을 때 광고 요청에 실패한 경우는 아무것도 하지 않아 기존 광고를 그대로 보이게 유지하거나, 광고 영역을 숨기는 등 정책에 따라 처리하면 됩니다.

에러 종류 설명

정제된 다음의 문자열을 에러로 받게 됩니다.

권장 처리 방법

3. onVideoError

에러 상황 설명

비디오 광고를 사용자가 클릭한 이후 발생할 수 잇는 에러들입니다. 사용자가 비디오 광고를 보고 그에 대한 액션 이후에 발생한 에러이므로 광고 영역을 숨기는 것으로는 처리할 수 없고, 적절한 메시지를 사용자에게 (토스트 등의) 적합한 방법으로 전달해줄 필요가 있습니다.

에러 종류 설명

정제된 다음의 문자열을 에러로 받게 됩니다.

권장 처리 방법