Monetization

Error Codes

Error Model Overview πŸ”—

The Chartboost Monetization SDK uses CHBError (ChartboostMonetizationError in Swift) to communicate failures. Error codes are numeric integers prefixed with CB_ in their string representation.

// Accessing the error code
if let error = error as? ChartboostMonetizationError {
    print("Code: \(error.code)")           // numeric code, e.g. 313
    print("Description: \(error.localizedDescription)") // "[CB_313 - CB_LOAD_NO_AD] ..."
}

Error Categories πŸ”—

Range Category Description
1XX Initialization Errors during SDK initialization
2XX Connectivity Network and connectivity errors
3XX Load Errors during ad load
4XX Show Errors during ad show
5XX Render Errors during ad rendering
9XX Other Errors that do not fit other categories

Initialization Errors (1XX) πŸ”—

Code Constant Message Resolution
100 CB_INITIALIZATION_UNKNOWN_ERROR Initialization has failed. An unknown error has occurred. Try again. If the problem persists, contact Chartboost Support with your console logs.
101 CB_INITIALIZATION_DISABLED Initialization has failed. Initialization has been disabled by the server. Update to a newer SDK version or contact Chartboost Support.
102 CB_INITIALIZATION_INVALID_CREDENTIALS Initialization has failed. Invalid/empty credentials were supplied. Double check that the supplied app ID and app signature are correct.
103 CB_INITIALIZATION_NO_CONTEXT Initialization has failed. No Application Context supplied. (Android only) N/A on iOS.
104 CB_INITIALIZATION_INVALID_CONFIGURATION Initialization has failed. Invalid/malformed app configuration from ad server. Contact Chartboost Support. Forward a copy of Chartboost network traffic.
105 CB_INITIALIZATION_INTERNAL_ERROR Initialization has failed. An internal error happened during initialization. Check console logs. If persistent, contact Chartboost Support with console logs.
106 CB_INITIALIZATION_OS_VERSION_NOT_SUPPORTED Initialization has failed. Ad serving for this OS version is not supported. N/A
107 CB_INITIALIZATION_PERMISSIONS_NOT_SET Initialization has failed. App is missing declared permissions. (Android only) N/A on iOS.

Connectivity Errors (2XX) πŸ”—

Code Constant Message Resolution
200 CB_CONNECTIVITY_UNKNOWN_ERROR Network request failed. An unknown error has occurred. Try again. Contact Chartboost Support with console logs if persistent.
201 CB_CONNECTIVITY_NO_INTERNET Network request failed. No Internet connectivity. Ensure there is Internet connectivity and try again.
202 CB_CONNECTIVITY_NETWORK_ERROR Network request failed. A networking error has occurred. Typically resolves itself. If persistent, contact Chartboost Support with network traffic logs.
203 CB_CONNECTIVITY_SERVER_ERROR Network request failed due to a server error. Typically resolves itself. If persistent, contact Chartboost Support with network traffic logs.
204 CB_CONNECTIVITY_TIMED_OUT Network request failed. Network request timed out. Typically resolves itself. If persistent, contact Chartboost Support with network traffic logs.
205 CB_CONNECTIVITY_INTERNAL_ERROR Network request failed. An internal error occurred. Check console logs. If persistent, contact Chartboost Support with console logs.

Load Errors (3XX) πŸ”—

Code Constant Message Resolution
300 CB_LOAD_UNKNOWN_ERROR Ad load has failed. An unknown error has occurred. Try again. Contact Chartboost Support with console logs if persistent.
301 CB_LOAD_DISABLED Ad load has failed. Ad loading has been disabled by the server. Update to a newer SDK version or contact Chartboost Support.
302 CB_LOAD_NOT_INITIALIZED Ad load has failed. SDK initialization not started or still in progress. Ensure the SDK has completed initialization before loading ads.
303 CB_LOAD_IN_PROGRESS Ad load has failed. Ad load already in progress. Wait until the current ad load is done before loading another ad.
304 CB_LOAD_ALREADY_LOADED Ad load has failed. Ad is already loaded. Show the ad before loading another.
305 CB_LOAD_INVALID_PLACEMENT Ad load has failed. Placement is invalid or empty. Ensure the placement matches the value entered on the Chartboost dashboard.
306 CB_LOAD_NO_CONTEXT No View Controller provided to load the ad. Ensure that a View Controller is provided.
307 CB_LOAD_RATE_LIMITED Ad load has failed. Too many ad requests in a short amount of time. Implement an exponential backoff strategy to avoid rate limiting.
308 CB_LOAD_INVALID_REQUEST Ad load has failed. Ad request was invalid/malformed. Contact Chartboost Support with network traffic logs.
309 CB_LOAD_INVALID_RESPONSE Ad load has failed. Ad response was invalid/malformed. Contact Chartboost Support with network traffic logs.
310 CB_LOAD_INVALID_ADM Ad load has failed. Ad markup string is invalid or empty. Contact Chartboost Support or mediator’s support with network traffic logs.
311 CB_LOAD_INTERNAL_ERROR Ad load has failed. An internal error happened during ad load. Check console logs. If persistent, contact Chartboost Support.
312 CB_LOAD_NO_STORAGE Ad load has failed. Insufficient storage to load the ad. Typically resolves itself. Contact Chartboost Support with console logs if persistent.
313 CB_LOAD_NO_AD Ad load has failed. No ad available. Try again. Verify dashboard settings if the problem persists.
314 CB_LOAD_NO_MRAID_JS Ad load has failed. mraid.js is missing. Verify that the Chartboost Monetization integration is correct.
315 CB_LOAD_INVALID_HTML Ad load has failed. Invalid HTML document or snippet. Typically resolves itself. Contact Chartboost Support with network and console logs.
316 CB_LOAD_WEBVIEW_FAILED Ad load has failed. The WebView failed to load the creative. Typically resolves itself. Contact Chartboost Support with network and console logs.
317 CB_LOAD_WEBVIEW_CRASHED Ad load has failed. The WebView process crashed. Typically resolves itself. Contact Chartboost Support with network and console logs.
318 CB_LOAD_INVALID_ASSET_URL Ad load has failed. Invalid asset URL. N/A
319 CB_LOAD_VAST_ERROR Ad load has failed. VAST error. Typically resolves itself. Contact Chartboost Support with network and console logs.
320 CB_LOAD_ASSET_UNAVAILABLE Ad load has failed. Asset is unavailable. Typically resolves itself. Contact Chartboost Support with network and console logs.
321 CB_LOAD_UNSUPPORTED_CODEC Ad load has failed. Video codec is unsupported. Typically resolves itself. Contact Chartboost Support with network and console logs.
322 CB_LOAD_TIMED_OUT Ad load has failed. Operation has timed out. Typically resolves itself. Contact Chartboost Support with network and console logs.

Show Errors (4XX) πŸ”—

Code Constant Message Resolution
400 CB_SHOW_UNKNOWN_ERROR Ad show has failed. An unknown error has occurred. Try again. Contact Chartboost Support with console logs if persistent.
401 CB_SHOW_NO_AD Ad show has failed. No loaded ad to show. Try loading another ad and ensure it is ready before showing.
402 CB_SHOW_AD_EXPIRED Ad show has failed. Ad has expired. Try loading another ad and ensure it is ready before showing.
403 CB_SHOW_AD_INVALIDATED Ad show has failed. Ad has been invalidated. Try loading another ad and ensure it is ready before showing.
404 CB_SHOW_NO_CONTEXT No View Controller to show the ad in. Ensure that a View Controller is provided.
405 CB_SHOW_FULLSCREEN_ALREADY_SHOWING Ad show has failed. A fullscreen ad is already showing. Dismiss the fullscreen ad before presenting another one.
406 CB_SHOW_TIMED_OUT Ad show has failed. Operation has timed out. Try again. Contact Chartboost Support with console logs if persistent.
407 CB_SHOW_ASSET_UNAVAILABLE Ad show has failed. Asset is unavailable. N/A
408 CB_SHOW_DISABLED Ad show has failed. Ad showing has been disabled by the server. Update to a newer SDK version or contact Chartboost Support.
409 CB_SHOW_NOT_INITIALIZED Ad show has failed. SDK initialization not started or in progress. Ensure the SDK has completed initialization before loading/showing ads.

Render Errors (5XX) πŸ”—

Code Constant Message Resolution
500 CB_RENDER_UNKNOWN_ERROR Ad rendering has failed. An unknown error has occurred. Try again. Contact Chartboost Support with console logs if persistent.
501 CB_RENDER_VIDEO_PLAYBACK_ERROR Ad rendering has failed. There was an error with the video player. Try again. Contact Chartboost Support with console logs if persistent.
502 CB_RENDER_INVALID_CLICKTHROUGH_URL Clickthrough has failed. Invalid or unrecognized clickthrough. N/A
503 CB_RENDER_ASSET_UNAVAILABLE Ad render has failed. Asset is unavailable. N/A
504 CB_RENDER_INTERNAL_ERROR Ad render has failed. An internal error happened during ad rendering. Check console logs. If persistent, contact Chartboost Support.
505 CB_RENDER_WEBVIEW_MRAID_UNLOAD Ad rendering has failed. MRAID requested unloading the ad. Try again. Contact Chartboost Support with console logs if persistent.
506 CB_RENDER_WEBVIEW_TERMINATED Ad rendering has failed. Web content process terminated. Try again. Contact Chartboost Support with console logs if persistent.
507 CB_RENDER_MISSING_SKAN_PARAMETERS Ad rendering has failed. SKAN attribution parameters are missing. Try again. Contact Chartboost Support with console logs if persistent.

Other Errors (9XX) πŸ”—

Code Constant Message Resolution
900 CB_OTHER_UNKNOWN_ERROR An internal error has occurred. Try again. If the problem persists, contact Chartboost Support with your console logs.

Legacy Error Codes (Deprecated) πŸ”—

Error Description
InternetUnavailable Fires when there is no internet connection on the test device. Troubleshoot possible device network connection issues.
NetworkFailure Fires when a network request fails for any reason. Check your network settings and make sure your device is connected to the internet. If you still experience this error, please send Charles Web Proxy logs of the event to our support team.
NoAdFound Fires when our ad server hasn’t found an appropriate ad to deliver to the device. This could be due to location, campaign filters, fill rate, or other factors. Try troubleshooting here β–Ά
SessionNotStarted A valid Chartboost session has not been detected. Check that your app ID and app signature are correct and that you have properly initialized Chartboost.
AssetDownloadFailure Fires when the download of one of the assets required by an ad fails while caching the ad.
PublisherDisabled Fires when your account has been disabled by Chartboost. Contact our support team if you think this is due to some mistake.
AdAlreadyVisible Fires if you try to show two full-screen ads at the same time.
PresentationFailure Fires if the ad presentation fails.
NoCachedAd Fires if you try to show a non-cached interstitial or rewarded ad.