The open-screen advertisement is mainly the full-screen advertisement view displayed when the APP is started. The development can display the designed view as long as the access standard is followed. After the display is completed, it will automatically close and enter the main interface of the application.
Supported ad size: The size of the open-screen ad is the size set when the developer requests the ad. It is recommended that the requested size be set to be consistent with the size of the display area to avoid material distortion.
**SDK rendering on-screen advertising: ** Open by default
**Template rendering on-screen advertisement: ** Need to apply
The SDK renders open-screen ads. Use the BUSplashAdView object to call the loadAdData method to request ads, and use addSubview to add ads for display. By setting the BUSplashAdDelegate agent, you can get callbacks such as ads, display, click, close, and jump.
You need to pass in the ad slot object when requesting an ad, and the ad slot ID must be passed in when the ad slot object is created
Field name | Field definition | Field type | Remarks |
SlotID | Code bit | NSString | Slot id |
frame | Size | CGRect | Ad request size |
Field name | Field definition | Field type | Remarks |
hideSkipButton | Whether to hide the skip button | BOOL type | Whether to customize the skip button BOOL type The default is NO |
tolerateTimeout | Timeout | NSTimeInterval | The default timeout is 3.5s |
needSplashZoomOutAd | Whether to set the dot-eye advertisement | BOOL | Whether the dot-eye advertisement is required The default is NO |
Use BUSplashAdView to create an object, use BUSplashAdView to call loadAdData to request ads
Callback Method | Notes |
splashAd: didFailWithError: | The returned error code (error) indicates the reason why the ad failed to load. For details of all error codes, please refer to the link [Link](https://www.csjplatform.com/help/doc/5de4cc6d78c8690012a90aa5?from=ad .oceanengine.com&id=5de4cc6d78c8690012a90aa5). |
splashAdDidLoad | Callback for successful ad loading |
Callback Method | Notes |
splashAdDidLoad: | Successful callback of SDK rendering open screen ad loading |
splashAd: didFailWithError: | The returned error code (error) indicates the reason why the ad failed to load. For details of all error codes, please refer to the link [Link](https://www.csjplatform.com/help/doc/5de4cc6d78c8690012a90aa5?from=ad .oceanengine.com&id=5de4cc6d78c8690012a90aa5) |
splashAdWillVisible: | SDK rendering on-screen ads will be displayed soon |
splashAdDidClick: | SDK rendering open screen ad click callback |
splashAdDidClose: | SDK renders the open-screen ad close callback. This callback will be triggered directly when the user clicks on the ad. It is recommended to directly remove the ad object in this callback method |
splashAdWillClose: | SDK rendering open-screen advertisement is about to close callback |
splashAdDidCloseOtherController:(BUSplashAdView *)splashAd interactionType: | This callback is called when the ad jumps to another controller and the controller is closed. interactionType: This parameter can distinguish the opened appstore/webpage/video ad details page |
splashAdDidClickSkip: | This callback is triggered when the user clicks the skip button, and the related logic after the user clicks to jump can be processed in this callback method |
splashAdCountdownToZero: | This callback will be triggered when the countdown is 0. If the client uses this callback method, it is recommended to remove ads in this callback method |
By setting the BUSplashAdDelegate agent, you can get callbacks such as clicks, closes, and jumps of advertisements. For other proxy methods, please refer to the AppDelegate class/BUDSplashViewController class #pragma mark-BUSplashAdView
section
splashAdDidClick
, splashAdDidClickSkip
, splashAd:didFailWithError
, splashAdDidCloseOtherController: interactionType
, and splashAdCountdownToZero
callback methods to remove ads to avoid abnormal situations: [self.splashView removeSplashView];For detailed access, please refer to the AppDelegate class/BUDSplashViewController class in the demo, and for the advertisement loading and display request part, please refer to the addSplashAD method/BUDSplashViewController class in the AppDelegate class. The buildupDefaultSplashView method
Template rendering open-screen ads use the BUNativeExpressSplashView object to call the loadAdData method to request ads, and use addSubview to add the ad object to display the ad. By setting the BUNativeExpressSplashViewDelegate agent, get the ad, display, Click, close, jump and other callbacks.
You need to pass in the ad slot object when requesting an ad, and the ad slot ID must be passed in when the ad slot object is created
Field name | Field definition | Field type | Remarks |
slotID | Code bit | NSString | Code bit ID |
adSize | Ad size | CGSize | Ad request size |
Field name | Field definition | Field type | Remarks |
hideSkipButton | Whether to customize the skip button | BOOL | Whether to customize the skip button The default is NO |
tolerateTimeout | Timeout | NSTimeInterval | The default timeout is 3.5s |
Use BUNativeExpressSplashView
to create objects, use BUNativeExpressSplashView
to call loadAdData
to request ads, and use addSubview
to add advertising objects to display ads
Set the hideSkipButton property of the BUNativeExpressSplashView object to YES, and the client can implement the skip button style and related jump logic by itself.
Callback Method | Notes |
nativeExpressSplashView: didFailWithError: | The returned error code (error) indicates the reason why the ad failed to load. Please refer to the link for details of all error codes. Link |
nativeExpressSplashViewDidLoad | Ad loading successfully callback |
nativeExpressSplashViewRenderFail: error: | Rendering failed, the rendering failed due to network or hardware reasons, you can change the mobile phone or network environment to test. It is recommended to upgrade to the latest version of the CSJ platform SDK |
nativeExpressSplashViewRenderSuccess: | Render success callback |
Callback Method | Notes |
nativeExpressSplashViewDidLoad: | Callback for successful loading of advertising materials |
nativeExpressSplashView: didFailWithError: | The returned error code (error) indicates the reason why the ad failed to load. Please refer to the link for details of all error codes. Link |
nativeExpressSplashViewRenderSuccess: | Render success callback |
nativeExpressSplashViewRenderFail: error: | Rendering failed, the rendering failed due to network or hardware reasons, you can change the mobile phone or network environment to test. It is recommended to upgrade to the latest version of CSJ |
SDKnativeExpressSplashViewWillVisible: | The template opening ad will be displayed soon |
nativeExpressSplashViewDidClick: | Click callback |
nativeExpressSplashViewDidClickSkip: | Click to skip callback |
nativeExpressSplashViewCountdownToZero: | This callback will be triggered when the countdown is 0. If the client uses this callback method, it is recommended to remove the advertisement in this callback method and set the advertisement object to nil |
nativeExpressSplashViewDidClose: | Ad close callback. This callback will be triggered directly when the user clicks on the ad. It is recommended to directly remove the ad object in this callback method and set the ad object to nil |
nativeExpressSplashViewFinishPlayDidPlayFinish:didFailWithError: | This callback will be triggered when the ad is played |
nativeExpressSplashViewDidCloseOtherController: interactionType: | This callback is called when the ad jumps to another controller and the controller is closed. InteractionType: This parameter can be distinguished from the opened appstore/webpage/video ad details page |
By setting the BUNativeExpressSplashViewDelegate agent, you can get the click, close, jump and other callbacks of the advertisement. For other proxy methods, please refer to the BUDExpressSplashViewController class #pragma mark-SplashAdView
section
splashAdDidClick
, splashAdDidClickSkip
, splashAd:didFailWithError
, splashAdDidCloseOtherController: interactionType
, and splashAdCountdownToZero
, perform the removal operation of advertisements to avoid abnormal situations. The developer needs to call the removeSplashView method provided by the CSJ first, and then use removeFromSuperview to try to remove it from the parent, which requires two removal operations;For detailed access, please refer to the BUDExpressSplashViewController class in Demo, and for the advertisement loading and display request part, please refer to the buildupDefaultSplashView method in the BUDExpressSplashViewController class.
How to use the screen opening and eye-catching ads: Initialize, add needSplashZoomOutAd settings
If the screen opening and finishing style is connected, the following logic must be implemented
Online Customer Service24/7 Online Customer Service BotManual customer service, weekdays 10~ 12 o'clock/14~ 19 o'clock