FAQ

1. Integration questions and self-test guidelines

1.1 Integration Guide

Please refer to the instructions of the integration document to complete the introduction configuration and API call of the SDK. If you have any questions about the integration document, please refer to TopOn Integration Tool for external demos, it is recommended to select the latest version of the SDK when integrating.

1.2 Test Guide

is For convenience and convenience in testing ads and troubleshooting related issues, please refer to How to test ads. It is recommended to open the SDK log and troubleshoot related issues through the logs.

1.3 Check the SDK version

• TopOn SDK version number: can be called ATSDK.getSDKVersionName();
• Check the SDK version of the advertising platform: refer to Check the SDK and version of the advertising platform

1.4 View the log of the advertising platform SDK

Call this method before SDK initialization: ATSDK.setNetworkLogDebug(true); in Filtering in Android Studio's Logcat anythink Please refer to TopOn SDK Log Open the SDK log and view "networkVersion"field

1.5 common error codes

To facilitate troubleshooting, the SDK provides common error codes and error descriptions. Please refer to Error Code Description to troubleshoot and confirm the problem.

1.6 Get device id (test mode, traffic grouping)

• Call this method before SDK initialization: ATSDK.setNetworkLogDebug(true);< /span> Filter anythink in Android Studio's Logcat to view

2. Guidelines for solving common classification problems

2.1 Compilation error

• ReferenceCompilation problem description

2.2 Advertisement Filling failure or no ads can be displayed

• ReferenceAdvertising Description of the problem of no filling
• Refer toExplanation of the abnormal display of native Native ads
• Banner ad display exception: refer to Banner ad display exception explanation
• Abnormal opening screen display: refer to Explanation of abnormal opening screen display
• Rewarded videos & interstitial ads display abnormally: ReferenceRewarded videos & interstitials Description of abnormal advertising display

3. Frequently asked questions about SDK-related background configuration

3.1 configuration does not take effect (background configuration, test mode, traffic grouping)

1. Background configuration changes do not take effect?

• The background configuration will take effect within a few seconds to a few minutes, but the SDK will be cached locally for half an hour. If you need to test immediately, please clear the application data , reinstall or set the time back one hour
• If clearing application data, reinstalling, etc. still does not take effect, it may be that the background configuration has not taken effect yet, please check more Wait a few minutes, clear the app data or reinstall and try again

2. The test mode does not take effect?

• Please check whether the device ID configured in the TopOn background is correct, < strong>GAID and AndroidID need to be obtained from the Debug log of our SDK
• Refer to the first point above

3. Traffic grouping does not take effect?

• Refer to the first point
• If custom rules are configured , please check whether the custom rules have been correctly passed into the code. You can print out the key and value in the code for troubleshooting
• If the device ID is configured , please check whether the device ID configured in the TopOn background is correct, GAID and AndroidID need to be obtained from the Debug log of our SDK

3.2 Number of parallel requests, automatic request for advertising function (TopOn background advertising slot-advanced settings)

• Number of parallel requests: When advertisements are displayed frequently and the next advertisement needs to be played immediately after playing, the number of parallel requests can be adjusted appropriately. Generally, is 2~3. Too many parallel requests will consume bandwidth and affect user experience. When displaying ads, cached ads will be displayed first based on the order of ad sources.
• Automatically request ads: After closing the ad, TopOn SDK will automatically call the load method for this ad slot. The loading result will not be called back to the outside, and the loading will fail. There will be no retries. It is recommended that developers implement this logic themselves. Developers who have not implemented this logic can turn on this function

3.3 for Certain users, devices, regions, etc. issue different advertising sources

• ReferenceTraffic grouping description

4 Frequently Asked Questions about SDK Privacy Permissions

4.1 What permissions are required for TopOn SDK

4.3 Click The App cannot be downloaded normally after advertising

1. Check whether the network is normal;

2. Some advertising platforms need to apply for storage permission;

3. Whether the incoming Context is Activity

4.4 The application platform prompts webview to access file risks

TopOn SDK will use webview internally to access files. setAllowFileAccessFromFileURLs and setAllowUniversalAccessFromFileURLs are set to true. The following methods have been used to limit the file access scope for protection. ：

1. Fixed HTML files can be placed in the assets or res directory file:///android asset and file:///android_res. It can also be accessed when the API is turned on;

2. HTML files that may be updated are placed in the /data/data/(app) directory to avoid being Third-party replacement or modification;

3. When whitelisting restrictions on file domain requests, special cases of "../../" need to be handled

4.5 Can the self-rendering information flow advertising logo be removed

Before calling the prepare api, ATNativePrepareInfo.setChoiceViewLayoutParams passes in a FrameLayout.LayoutParams. You can pass in a negative value of marginLeft to remove the choiceicon from the visible area

5 View more information about the advertising platform

5.1 View through the naming of the advertising platform SDK package

The SDKs of each advertising platform used by TopOn SDK are as follows: (The version number of the advertising platform SDK can be viewed through the naming of the respective SDK package)