Troubleshooting Guidelines for Frequently Asked Questions about Splash Ads in iOS SDK

1. Advertisement loading exception

1.1 Advertisement is not filled or loaded with errors

Please refer to the explanation of the problem of no filling in advertisements.

1.2 Problem of no callback in advertisements

1.2.1 Confirm whether the listening object is configured

• Developers are asked to check whether a Delegate has been set up for ad loading in the code, and parameters need to be passed separately for each ad slot;

1.2.2 Check whether the integration is correct

• Recheck the integration document: SDK configuration, and confirm whether all the files in the downloaded SDK compressed package have been introduced into the project. You can call the integrated detection api to check the advertisement. Integration of platforms.

Troubleshoot each advertising platform one by one to determine whether it is a problem with one advertising platform or all advertising platforms:

• When an advertising platform does not have a callback:
• If only the results are loaded callback, when there is no display and other subsequent callbacks
• Please check whether the load in the code is called in the close callback. Some advertising platforms do not support it. Calling load in the callback before close will cause the problem of no callback, typically with Sigmob.
• Developers please check Third-party advertising platform error codes, if no solution is found in the document, developers are asked to use the debugger mode in our document in their own projects. test.
• If only one callback is missing, please use another test machine to test to see if the same situation exists.

2. Ad display issues

2.1 The plash takes too long to load

Please refer to the document to optimize the screen timeout.

2.2 Unusual click on splash

The jump of the advertising platform will rely on the incoming window information displayed on the splash. Please ensure that this window object is the main window and can support the advertisement jump display after close.

2.3 The top of the open screen AD is blocked or the logoView view at the bottom is blocked

We have added a new display API from version 6.2.96, which allows you to pass the controller that needs to display the Splash advertisement. The required controller is different according to different scenes. Instead of UITabBarController, you can pass UINavigationController. If you have a UITabBarController, you pass in a UITabBarController, so you can avoid the problem of logoView being blocked or the top being blocked.

/// v6.2.96+
/// - Parameters:
///   - placementID: placementID
///   - scene: scene ID
///   - window: show container window,If it is nil, it defaults to the key window.
///   - viewController: show container viewController,If it is nil, it defaults to the top view controller.
///   - extra: extra parameter
///   - delegate: event delegate
- (void)showSplashWithPlacementID:(NSString *)placementID scene:(NSString *)scene
                           window:(UIWindow *)window
                           inViewController:(UIViewController*)viewController
                            extra:(NSDictionary *)extra
                         delegate:(id<ATSplashDelegate>)delegate;
                         
/// available ios 13.0
- (void)showSplashWithPlacementID:(NSString *)placementID scene:(NSString *)scene
                           window:(UIWindow *)window
                      windowScene:(UIWindowScene * _Nullable)windowScene
                      inViewController:(UIViewController*)viewController
                         delegate:(id<ATSplashDelegate>)delegate API_AVAILABLE(ios(13.0));

- (void)showSplashWithPlacementID:(NSString*)placementID config:(ATShowConfig *)config
                           window:(UIWindow*)window
                      windowScene:(UIWindowScene *)windowScene
                 inViewController:(UIViewController*)viewController
                            extra:(NSDictionary *)extra
                         delegate:(id<ATSplashDelegate>)delegate  API_AVAILABLE(ios(13.0));