{"data":{"id":"862754","string_id":"WFMcibpD","status":"1","parent_id":"76196","slug":"WFMcibpD","order":"14","name":"Ad Format","type":"1","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"Welch","published_time":"0","add_time":"1783411464","update_time":"1783421014","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","tags":[],"parent_name":"SDK Access Guide","parent_type":"1","parent_slug":"cUkkAX","child":[{"id":"76213","string_id":"IWVOHb","status":"1","parent_id":"862754","slug":"Rewarded-Video-Ad-i1Ow","order":"6","name":"Rewarded Video Ad","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722527","add_time":"1709721416","update_time":"1783411581","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76213","content":"

1. Introduction to rewarded video ads<\/h2>

Rewarded video ads are rewarded video ads that aggregate other third-party advertising platforms and can be implemented using the API provided by the SDK Advertisement loading and playback. Currently, two integration methods are supported. It is recommended to use fully automatic loading. The specific instructions are as follows:<\/p>

Mode<\/th> Description<\/th><\/tr>

Manual loading<\/td> You can choose the appropriate time to load the ad through the API. For details, see: Manual loading of rewarded video ads<\/a><\/td><\/tr>

Fully automatic loading<\/td>

One-stop request launched by Taku The maintenance plan can automatically determine the preloading and caching timing of the next advertisement based on the user's usage status and ad consumption progress to achieve better loading effects. For details, see: Fully automatic loading of rewarded video ads<\/a><\/td><\/tr><\/tbody><\/table>

2. Best practice scenarios<\/h2>

2.1 Manual loading<\/h3>
Suitable for scenarios: daily check-in, limited tasks. <\/p>
Advantages: The overall process is clear and flexible, and developers can control the timing of loading ads and the timing of preloading. <\/p>
Impact: Developers are required to have a certain understanding of ad loading and preloading timing. <\/p>

2.2 Fully automatic loading<\/h3>
Suitable scenarios: mission scene types, unlocking props (levels, Game Again) category, etc. <\/p>
Advantages: Ensure that ads are filled, ads can be displayed, and waiting time for loading is avoided. <\/p>
Impact: It may lead to a reduction in impression rate, but it will not affect revenue. <\/p>

<\/p>","pure_content":"1. Introduction to rewarded video adsRewarded video ads are rewarded video ads that aggregate other third-party advertising platforms and can be implemented using the API provided by the SDK Advertisement loading and playback. Currently, two integration methods are supported. It is recommended to use fully automatic loading. The specific instructions are as follows:ModeDescriptionManual loadingYou can choose the appropriate time to load the ad through the API. For details, see: Manual loading of rewarded video adsFully automatic loadingOne-stop request launched by Taku The maintenance plan can automatically determine the preloading and caching timing of the next advertisement based on the user's usage status and ad consumption progress to achieve better loading effects. For details, see: Fully automatic loading of rewarded video ads2. Best practice scenarios2.1 Manual loadingSuitable for scenarios: daily check-in, limited tasks. Advantages: The overall process is clear and flexible, and developers can control the timing of loading ads and the timing of preloading. Impact: Developers are required to have a certain understanding of ad loading and preloading timing. 2.2 Fully automatic loadingSuitable scenarios: mission scene types, unlocking props (levels, Game Again) category, etc. Advantages: Ensure that ads are filled, ads can be displayed, and waiting time for loading is avoided. Impact: It may lead to a reduction in impression rate, but it will not affect revenue.","is_draft":"0","editor_type":"1","file_path":"","add_time":"1709721417","update_time":"1783411581"},"pure_content":"1. Introduction to rewarded video adsRewarded video ads are rewarded video ads that aggregate other third-party advertising platforms and can be implemented using the API provided by the SDK Advertise"},{"id":"76216","string_id":"S8pTzV","status":"1","parent_id":"862754","slug":"Interstitial-ad-PO06","order":"5","name":"Interstitial ad","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722528","add_time":"1709721421","update_time":"1783411581","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76216","content":"

1. Introduction to interstitial advertising<\/span><\/h2>

Interstitial ads are an aggregation of image interstitial ads and video interstitial ads from other third-party advertising platforms. Both ad types can use the API of the SDK to load and play ads. Currently, two integration methods are supported. It is recommended to use fully automatic loading. The specific instructions are as follows:<\/p>

Mode<\/th> Description<\/th><\/tr>

Manual loading<\/td> You can choose the right time to call the ad loading through API , see for details: Manual loading of interstitial ads<\/a><\/td><\/tr>

Fully automatic loading<\/td>

TopOn's one-stop request maintenance solution can be based on the user's usage status and Ad consumption progress, automatically determines the preloading and caching timing of the next ad to achieve better loading effects. For details, see: Full automatic loading of interstitial ads<\/a><\/td><\/tr><\/tbody><\/table>

<\/h2>","pure_content":"1. Introduction to interstitial advertisingInterstitial ads are an aggregation of image interstitial ads and video interstitial ads from other third-party advertising platforms. Both ad types can use the API of the SDK to load and play ads. Currently, two integration methods are supported. It is recommended to use fully automatic loading. The specific instructions are as follows:ModeDescriptionManual loadingYou can choose the right time to call the ad loading through API , see for details: Manual loading of interstitial adsFully automatic loadingTopOn's one-stop request maintenance solution can be based on the user's usage status and Ad consumption progress, automatically determines the preloading and caching timing of the next ad to achieve better loading effects. For details, see: Full automatic loading of interstitial ads","is_draft":"0","editor_type":"1","file_path":"","add_time":"1709721422","update_time":"1783411581"},"pure_content":"1. Introduction to interstitial advertisingInterstitial ads are an aggregation of image interstitial ads and video interstitial ads from other third-party advertising platforms. Both ad types can use"},{"id":"76219","string_id":"TLJpji","status":"1","parent_id":"862754","slug":"Splash-ad","order":"4","name":"Splash ad","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722529","add_time":"1709721425","update_time":"1783411581","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76219","content":"1. Splash Ad Introduction\n- \n*\n\n### 1.1 Integration Suggestions\n\nTo improve the loading efficiency of Splash Ads, you can refer to [Cold Start Strategy](https:\/\/help.takuad.com\/en\/docs\/OPEtKSdg) and [SDK Preset Strategy](https:\/\/help.takuad.com\/en\/docs\/TVGLPdoI). For details, please refer to [Splash Ad Integration Best Practices](https:\/\/help.takuad.com\/en\/docs\/n0aKZzB9).\n\n2. API Instructions\n-\n\n### 2.1 Ad Loading\n\nATSplashAd: The loading class for Splash ads.\n\n| Method | Description |\n| ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ATSplashAd(Context context, String placementId, ATSplashAdListener listener, int fetchAdTimeout) | Splash initialization method. Parameter descriptions: context: Context used for loading ads (recommended to pass an Activity). placementId: Taku's Splash Ad placement ID. listener: Ad event listener. fetchAdTimeout: Ad load timeout in milliseconds. Note: The default ad load timeout is 5000ms. |\n| ATSplashAd(Context context, String placementId, ATSplashAdListener listener) | Splash initialization method. Same parameter meaning as above. |\n| void loadAd() | Initiate ad loading. |\n\nAd Loading:\n\n```\n\/\/ Note: xxx needs to be replaced with your Splash Ad timeout value, unit: milliseconds.\nATSplashAd splashAd = new ATSplashAd(context, placementId, listner, xxx);\nsplashAd.loadAd();\n```\n\n###\n\n### 2.2 Ad Display\n\nATSplashAd:\n\n| Method | Description |\n| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| boolean isAdReady() | Determine whether the current ATSplashAd has a displayable ad. |\n| void show(Activity activity, ViewGroup container) | Display a Splash ad. Parameter descriptions: activity: The Activity displaying the ad. container: The container displaying the ad. |\n| void show(Activity activity, final ViewGroup container, ATSplashSkipInfo atSplashSkipInfo) | Use a custom SkipView to display a Splash ad. Same parameter meaning as above. atSplashSkipInfo: Custom SkipView feature class. Custom SkipView is only effective for the following ads: MyOffer, Adx, OnlineAPI, Pangle (China). Please refer to Demo. |\n| void show(Activity activity, ViewGroup container, ATShowConfig showConfig) | (Added in v6.3.10) Display a Splash ad in a specified scenario. Parameter descriptions:
activity: The Activity displaying the ad.
container: The container displaying the ad.
showConfig: Extra parameters that can be passed during display, as follows:
1. ATShowConfig#showCustomExt(String showCustomExt): Can pass custom parameters during display. The passed parameter will be returned via ATAdInfo#getShowCustomExt().
2. ATShowConfig#scenarioId(String scenarioId): Can pass an ad scenario, same as show(Activity activity, ViewGroup container,String scenario). |\n| void show(Activity activity, final ViewGroup container, ATSplashSkipInfo atSplashSkipInfo, ATShowConfig showConfig) | (Added in v6.3.10) Display a Splash ad in a specified scenario using a custom SkipView. Same parameter meaning as above. atSplashSkipInfo: Custom SkipView feature class. Custom SkipView is only effective for the following ads: MyOffer, Adx, OnlineAPI, Pangle (China). Please refer to Demo. |\n| void entryAdScenario(String placementId, String scenarioId) | Enter business scenario for current Ad Placement cache status statistics. Here scenario refers to the ad display scenario (optional, can be directly passed as null). For creating scenario parameters from the dashboard and usage, please refer to [Business Scenario Cache Status Statistics](https:\/\/help.takuad.com\/en\/docs\/zUl0fvpD). |\n| void entryAdScenario(String scenarioId) | (v6.5.80 and above) Enter business scenario for current Ad Placement cache status statistics. Here scenario refers to the ad display scenario (optional, can be directly passed as null). For creating scenario parameters from the dashboard and usage, please refer to [Business Scenario Cache Status Statistics](https:\/\/help.takuad.com\/en\/docs\/zUl0fvpD). |\n\nAd Display:**\n\n```\n \/*\n To count scenario arrival rate, related info can be found at \"https:\/\/help.takuad.com\/docs\/1RWLAv\"\n Call the \"enter ad scenario\" method when the ad triggering conditions are met, for example:\n ** If the ad scenario is to display an ad after a cleanup is finished, call it when the cleanup is finished;\n * 1. First call \"entryAdScenario\"\n * 2. Then call \"isAdReady\" to check if it is displayable\n * 3. Finally call \"show\" to display\n * 4. Passing the scenario ID into scenario will only result in data showing in the dashboard's scenario management (optional).\n *\/\n ATSplashAd.entryAdScenario(\"your splash placementID\", \"your scenarioID\");\n\/\/ v6.5.80 and above\n splashAd.entryAdScenario(\"your scenarioID\");\n\/\/ Before displaying, check that there is a cached ad and the current Activity is in the foreground.\nif (splashAd.isAdReady() && inForeBackground) {\n \/\/ The container size should be at least 75% of the screen.\n splashAd.show(activity, container\uff0c\"your scenarioID\");\n}\n```\n\nPassing Custom Parameters During Display:\n\nTaku SDK v6.3.10 and above supports developers passing custom parameters during display. Custom parameters passed during display are independent of custom parameters passed during Load. Custom parameters passed during display can be returned in the Taku SDK callback info.\n\n### 2.3 Local Parameters\n\nATSplashAd:\n\n| Method | Description |\n| ---------------------- | --------------------------------- |\n| void setLocalExtra(Map) | Set local parameters. The key is obtained via ATAdConst.KEY. |\n\nATAdConst.KEY: Predefined Key values for LocalExtra local parameters.\n\n| Key | Description |\n| ---------- | ---- |\n| AD\\_WIDTH | Ad width. |\n| AD\\_HEIGHT | Ad height. |\n\n### 2.4 Ad Object\n\nATSplashAd:\n\n| Method | Description |\n| ------------------ | -------------------------------------------------------------------------------------------------------------------------- |\n| checkAdStatus | Get the status object ATAdStatusInfo of the current Ad Placement. |\n| checkValidAdCaches | Query the ATAdInfo objects of all cached info for the current Ad Placement. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. [See ATAdInfo Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description) |\n\nATAdStatusInfo: Status object of the Ad Placement.\n\n| Method | Description |\n| ------------------- | -------------------------------------------------------------------------------------------------------- |\n| boolean isLoading() | Determine whether the current Ad Placement is currently loading an ad. |\n| boolean isReady() | Determine whether the current Ad Placement has a displayable ad. Same function as ATSplashAd.isAdReady(). |\n| getATTopAdInfo | Get the ad cache info ATAdInfo object with the highest priority for the current Ad Placement. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. [See ATAdInfo Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description) |\n\n### 2.5 Ad Listener\n\nATSplashAdListener: Event callback class for Splash ads.\n\n| Method | Description |\n| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| void onAdLoaded(boolean isTimeout) | Ad load success callback. isTimeout: Whether the ad load time exceeded the time specified by fetchAdTimeout. |\n| void onNoAdError(AdError error) | Ad load failure callback. You can get the full error info via AdError.getFullErrorInfo(). Please refer to [AdError](https:\/\/help.takuad.com\/en\/docs\/Error-code-description-ua8l).
Note: Do not execute the ad loading method in this callback for retry, otherwise it may cause many unnecessary requests and may cause the app to lag. |\n| void onAdShow(ATAdInfo atAdInfo) | Ad impression callback. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. [See ATAdInfo Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description) |\n| void onAdClick(ATAdInfo atAdInfo) | Ad click callback. Same parameter meaning as above. |\n| void onAdDismiss(ATAdInfo entity, ATSplashAdExtraInfo splashAdExtraInfo) | Ad close callback. Same parameter meaning as above. ATSplashAdExtraInfo: Splash Ad close extra info, including the Splash Eyelet Ad control interface class. Developers can use this interface to control the display of eyelet ads.
Note: (1) When the Splash Ad creative of Pangle (China) or GDT supports eyelet features, splashEyeAd will not be null. (2) When displaying a Kuaishou Splash Ad, splashEyeAd will be a non-null value, but it does not necessarily mean that this Kuaishou Splash Ad creative supports eyelet features. When it is not supported, calling the IATSplashEyeAd#show() method will directly call back the ATSplashEyeAdListener#onAdDismiss() method. (3) When splashEyeAd is not null but the developer does not want to support the eyelet feature, splashEyeAd.destroy() must be called to release resources, then navigate to the main page or remove the Splash View. |\n| void onAdLoadTimeout | Ad load timeout callback. Handle the Splash Ad load timeout here.
Note: (1) After the ad load timeout callback, the Splash Ad is still loading. If it loads successfully, it will trigger onAdLoaded(true). (2) If the Splash Ad loaded this time is not displayed, it will be placed in the cache for the next display. |\n\nATSplashExListener: Inherits from `ATSplashAdListener`, methods are the same as `ATSplashAdListener`, with additional callback descriptions as follows:\n\n| Method | Description |\n| ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| void onDeeplinkCallback(ATAdInfo atAdInfo, boolean isSuccess) | Deeplink callback, for Adx, OnlineApi ads. isSuccess: Whether successful. |\n| void onDownloadConfirm(Context context, ATAdInfo atAdInfo, View clickView, ATNetworkConfirmInfo networkConfirmInfo) | Callback method when an app-type ad click triggers a download. ATNetworkConfirmInfo: Callback info provided by the third-party ad platform (Currently only GDT's GDTDownloadFirmInfo is available.) ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. [See ATAdInfo Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description) |\n| void onSplashAdReward(ATAdInfo atAdInfo) | v6.6.21 and above (GDT reward support). |\n\nIATSplashEyeAd: Control class for Splash Eyelet Ads.\n\n| Method | Description |\n| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |\n| show(Context context, Rect rect, ATSplashEyeAdListener atSplashEyeAdListener) | Display a Splash Eyelet (V+, small window) ad. context: Context. rect: The display size of the Splash Eyelet Ad when the zoom animation ends, starting from the top-left corner of the screen (Note: Kuaishou requires this parameter to be passed.) atSplashEyeAdListener: Splash Eyelet Ad event listener. |\n| getSuggestedSize(Context context) | Get the recommended ad display size when the zoom animation ends (Currently only Pangle (China) returns this. It is recommended to prioritize using this size.) |\n| onFinished | When the zoom animation finishes, the developer must call this method to notify the SDK to display the ad's close button. |\n\nATSplashEyeAdListener: Event callback class for Splash Eyelet Ads.\n\n| Method | Description |\n| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| onAnimationStart(View splashView) | The developer needs to execute the zoom animation of the Splash Eyelet Ad in this callback. splashView: View of the Splash ad.
Note: (1) Sample code for the zoom animation can be referenced in the Demo. (2) When the zoom animation ends, IATSplashEyeAd#onFinished() must be called. (3) Kuaishou will not trigger this callback. Kuaishou's zoom animation cannot be controlled. |\n| onAdDismiss(boolean isSupportEyeSplash, String errorMsg) | Splash Eyelet Ad close callback. It is recommended to call IATSplashEyeAd#destroy() in this callback. isSupportEyeSplash: Whether Splash Eyelet is supported. errorMsg: When an error occurs, the error message will be displayed here.
Note: The timing of each platform triggering this callback varies; it may be when the close button is clicked or when the ad playback ends. |\n\nATSplashSkipInfo: Custom SkipView feature class.\n\n| Method | Description |\n| ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ATSplashSkipInfo(View skipView, long countDownDuration, long callbackInterval, ATSplashSkipAdListener atSplashSkipAdListener) | Custom SkipView feature class constructor. skipView: The developer's custom skip button View. countDownDuration: Total countdown duration (unit: ms), default 5s, minimum can be set to 2s. callbackInterval: Trigger interval for the countdown callback (unit: ms), default triggers the ATSplashSkipAdListener#onAdTick() callback every 1s, minimum can be set to 20ms. atSplashSkipAdListener: Custom SkipView event listener class.
Note: (1) When skipView is passed as null, the custom SkipView feature will not take effect. (2) If the developer wishes to customize the countdown animation, the trigger interval of the countdown callback can be changed via the callbackInterval parameter. |\n| ATSplashSkipInfo(View skipView, ATSplashSkipAdListener atSplashSkipAdListener) | Custom SkipView feature class constructor. Same parameter meaning as above. |\n\nATSplashSkipAdListener: Custom SkipView event listener class.\n\n| Method | Description |\n| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |\n| onAdTick(long duration, long remainder) | Countdown callback. Developers can update the countdown animation in this callback. duration: Total countdown duration (unit: ms). remainder: Current remaining countdown progress (unit: ms). |\n| isSupportCustomSkipView(boolean isSupport) | Callback notifying the developer whether the currently displayed ad supports the custom SkipView. isSupport: true means the currently displayed ad platform supports it, false means it does not.
Note: (1) The developer can determine in this callback that when isSupport is true, set skipView to visible. |\n\n3. Sample Code\n- \n***\n\n```\n\/\/ Note: xxx needs to be replaced with your Splash Ad timeout value, unit: milliseconds.\nATSplashAd splashAd = new ATSplashAd(context, placementId, listner, xxx);\nsplashAd.loadAd();\n\n \/*\n To count scenario arrival rate, related info can be found at \"https:\/\/docs.takuad.com\/#\/zh-cn\/android\/NetworkAccess\/scenario\/scenario\"\n Call the \"enter ad scenario\" method when the ad triggering conditions are met, for example:\n ** If the ad scenario is to display an ad after a cleanup is finished, call it when the cleanup is finished;\n * 1. First call \"entryAdScenario\"\n * 2. Then call \"isAdReady\" to check if it is displayable\n * 3. Finally call \"show\" to display\n * 4. Passing the scenario ID into scenario will only result in data showing in the dashboard's scenario management (optional).\n \/\n ATSplashAd.entryAdScenario(\"your splash placementID\", \"your scenarioID\");\n\/\/ Before displaying, check that there is a cached ad and the current Activity is in the foreground.\nif (splashAd.isAdReady() && inForeBackground) {\n \/\/ The container size should be at least 75% of the screen.\n splashAd.show(activity, container\uff0c\"your scenarioID\");\n}\n```\n\nFor detailed Splash Ad sample code, please refer to the SplashAdActivity class in [Demo](https:\/\/github.com\/TakuMediation\/Taku_Android_Demo).\n\nCold Start Sample:\n\n```\nATSplashExListener listener = new ATSplashExListener() {\n ......\n @Override\n public void onAdLoaded(boolean isTimeout) {\n \/\/ When the load has not timed out\n if(!isTimeout){\n \/\/ Display the ad when the current Activity is in the foreground\n if(inForeBackground){\n \/\/ The container size should be at least 75% of the screen.\n splashAd.show(activity, container);\n }else{\n \/\/ Wait for the app to return to the foreground before displaying\n needShowSplashAd = true;\n }\n }\n }\n\n @Override\n public void onAdLoadTimeout() {\n \/\/ After load timeout, directly navigate to the main interface.\n jumpToMainActivity();\n }\n\n @Override\n public void onNoAdError(AdError adError) {\n \/\/ Navigate directly to the main interface on load failure.\n jumpToMainActivity();\n }\n\n @Override\n public void onAdShow(ATAdInfo entity) {\n\n }\n\n @Override\n public void onAdDismiss(ATAdInfo entity, ATSplashAdExtraInfo splashAdExtraInfo) {\n \/\/ =1 Undifferentiated =2 Skip ended =3 Countdown ended =4 Ad click ended =99 Splash display failed\n if(splashAdExtraInfo.getDismissType()==ATAdConst.DISMISS_TYPE.SHOWFAILED){\n }\n \/\/ Navigate to the main interface after the Splash Ad display is closed.\n \/\/ Note: Some platforms do not pause the countdown when navigating to the landing page. Even while viewing the landing page, onAdDismiss will still be called back after the countdown ends.\n \/\/ Therefore, special handling is required during page navigation. Refer to the sample code below for details.\n jumpToMainActivity();\n }\n ......\n};\n\n\/\/ Note: xxx needs to be replaced with your Splash Ad timeout value, unit: milliseconds.\nATSplashAd splashAd = new ATSplashAd(context, placementId, listner, xxx);\n\nif (splashAd.isAdReady()) {\n \/\/ The container size should be at least 75% of the screen.\n splashAd.show(activity, container);\n}else{\n splashAd.loadAd();\n}\n```\n\n`onAdDismiss() ` Splash Ad page navigation sample:\n\n```\n\/\/ Flag for whether a page navigation is needed\nboolean needJump;\n\n@Override\nprotected void onResume() {\n super.onResume();\n if (needJump) {\n jumpToMainActivity();\n }\n needJump = true;\n}\n\n@Override\nprotected void onPause() {\n super.onPause();\n needJump = false;\n}\n\npublic void jumpToMainActivity() {\n if (!needJump) {\n needJump = true;\n return;\n }\n Intent intent = new Intent(this, YourMainActivity.class);\n startActivity(intent);\n finish();\n}\n```\n\n4. Ad Platform-Specific Configuration Instructions\n- \n\n\n### 4.1 Admob\n\nAdmob's Splash Ad does not need to depend on a container for display; it can only be displayed full-screen. After the ad is displayed, there will be no countdown and it will not auto-skip.\n\n### 4.2 Baidu\n\nIf you have integrated Baidu SDK's Splash Ad, you need to select the SkipView display style in the Baidu dashboard (Baidu dashboard defaults to not displaying the SkipView).\n\n### 4.3 Pangle (China)\n\nBefore loading the ad, the ad width and height must be set. An example is as follows:\n\n```\n\/\/ Note: xxx needs to be replaced with your Splash Ad timeout value, unit: milliseconds.\nsplashAd = new ATSplashAd(this, placementId, atMediationRequestInfo, this, xxx); \nMap localMap = new HashMap<>(); \nlocalMap.put(ATAdConst.KEY.AD_WIDTH, width);\/\/ Unit: px \nlocalMap.put(ATAdConst.KEY.AD_HEIGHT, height);\/\/ Unit: px \nsplashAd.setLocalExtra(localMap); \nsplashAd.loadAd();\n```\n\nNote: If the set width and height are inconsistent with the container width and height during display, or if the template rendering option in the Taku dashboard does not correspond to the Pangle (China) dashboard, the ad may appear incomplete, blurry, or distorted.\n\n5. Splash Eyelet Ad Sample\n- \n\n\n> Note:\n>\n> \u2460 Since it is not guaranteed that an eyelet-supporting Splash Ad will always load, for fill rate issues with Splash Ad eyelet creative materials, please contact the ad platform for handling.\n>\n> \u2461 For the sample code below, please refer to the Demo.\n\n### 5.1 The Splash Activity and the Eyelet Ad Display Activity Are Not the Same\n\n(1) Create a SplashEyeAdHolder class to cache the IATSplashEyeAd instance.\n\n```\npublic class SplashEyeAdHolder {\n public static IATSplashEyeAd splashEyeAd;\n}\n```\n\n```\npublic class SplashAdShowActivity extends Activity implements ATSplashAdListener {\n ...\n @Override\n public void onAdDismiss(ATAdInfo entity, ATSplashAdExtraInfo splashAdExtraInfo) {\n Log.i(TAG, \"onAdDismiss:\\n\" + entity.toString());\n\n \/\/ (1) When the Splash Ad creative of Pangle (China) or GDT supports eyelet features, splashEyeAd will not be null.\n \/\/ (2) When displaying a Kuaishou Splash Ad, splashEyeAd will be a non-null value, but it does not necessarily mean that this Kuaishou Splash Ad creative supports eyelet features. When it is not supported, calling the IATSplashEyeAd#show() method will directly call back the ATSplashEyeAdListener#onAdDismiss() method.\n \/\/ (3) When splashEyeAd is not null but the developer does not want to support the eyelet feature, splashEyeAd.destroy() must be called to release resources, then navigate to the main page or remove the Splash View.\n\n SplashEyeAdHolder.splashEyeAd = splashAdExtraInfo.getAtSplashEyeAd();\n\n jumpToMainActivity();\n }\n}\n```\n\n(2) Set the Splash Ad related info (SplashZoomOutManager, please refer to the Demo), while navigating to the home screen Activity and cancelling the page navigation animation, then close the current page.\n\n```\npublic class SplashAdShowActivity extends Activity implements ATSplashAdListener {\n ...\n public void jumpToMainActivity() {\n if (!hasHandleJump) {\n hasHandleJump = true;\n\n if (SplashEyeAdHolder.splashEyeAd != null) {\n try {\n SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());\n zoomOutManager.setSplashInfo(container.getChildAt(0),\n getWindow().getDecorView());\n } catch (Throwable e) {\n Log.e(TAG, \"jumpToMainActivity: ------------------------------------------ error\");\n e.printStackTrace();\n }\n\n Intent intent = new Intent(this, TestMainActivity.class);\n startActivity(intent);\n\n overridePendingTransition(0, 0);\n }\n\n finish();\n Toast.makeText(this, \"start your MainActivity.\", Toast.LENGTH_SHORT).show();\n }\n }\n}\n```\n\n(3) In the home screen Activity, create the `showSplashEyeAd()` method.\n\n```\npublic class TestMainActivity extends Activity {\n ...\n private void showSplashEyeAd() {\n\n if (SplashEyeAdHolder.splashEyeAd == null) {\n return;\n }\n\n SplashEyeAdHolder.splashEyeAd.show(TestMainActivity.this, null, new ATSplashEyeAdListener() {\n @Override\n public void onAnimationStart(View splashView) {\n \/\/ Execute the zoom animation\n SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());\n\n \/\/ It is recommended to prioritize using the size returned by IATSplashEyeAd#getSuggestedSize() as the target size for the zoom animation.\n int[] suggestedSize = SplashEyeAdHolder.splashEyeAd.getSuggestedSize(getApplicationContext());\n if (suggestedSize != null) {\n zoomOutManager.setSplashEyeAdViewSize(suggestedSize[0], suggestedSize[1]);\n }\n zoomOutManager.startZoomOut((ViewGroup) getWindow().getDecorView(),\n findViewById(android.R.id.content), new SplashZoomOutManager.AnimationCallBack() {\n\n @Override\n public void animationStart(int animationTime) {\n\n }\n\n @Override\n public void animationEnd() {\n Log.i(TAG, \"animationEnd---------: eye ad\");\n\n \/\/ When the zoom animation finishes, IATSplashEyeAd#onFinished() must be called to notify the SDK.\n SplashEyeAdHolder.splashEyeAd.onFinished();\n }\n });\n\n }\n\n @Override\n public void onAdDismiss(boolean isSupportEyeSplash, String errorMsg) {\n Log.i(TAG, \"onAdDismiss---------: close eye ad\");\n\n \/\/ It is recommended to call IATSplashEyeAd#destroy() in this callback to release resources, as well as release other resources, to avoid memory leaks.\n SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());\n zoomOutManager.clearStaticData();\n\n SplashEyeAdHolder.splashEyeAd.destroy();\n SplashEyeAdHolder.splashEyeAd = null;\n }\n });\n }\n\n}\n```\n\n(4) In the home screen Activity, call `showSplashEyeAd()` to display the eyelet ad (it is recommended to call `showSplashEyeAd()` in the `onAttachedToWindow()` callback).\n\n```\n public class TestMainActivity extends Activity {\n ...\n @Override\n public void onAttachedToWindow() {\n super.onAttachedToWindow();\n\n showSplashEyeAd();\n }\n}\n```\n\n### 5.2 The Splash Activity and the Eyelet Ad Display Activity Are the Same\n\n```\npublic class SplashAdShowActivity extends Activity implements ATSplashAdListener {\n ...\n @Override\n public void onAdDismiss(ATAdInfo entity, IATSplashEyeAd splashEyeAd) {\n Log.i(TAG, \"onAdDismiss:\\n\" + entity.toString());\n\n \/\/ (1) When the Splash Ad creative of Pangle (China) or GDT supports eyelet features, splashEyeAd will not be null.\n \/\/ (2) When displaying a Kuaishou Splash Ad, splashEyeAd will be a non-null value, but it does not necessarily mean that this Kuaishou Splash Ad creative supports eyelet features. When it is not supported, calling the IATSplashEyeAd#show() method will directly call back the ATSplashEyeAdListener#onAdDismiss() method.\n \/\/ (3) When splashEyeAd is not null but the developer does not want to support the eyelet feature, splashEyeAd.destroy() must be called to release resources, then navigate to the main page or remove the Splash View.\n\n\n if (container != null) {\n container.removeAllViews();\n container.setVisibility(View.GONE);\n } \n\n \/\/ Display the eyelet ad\n showSplashEyeAd(splashEyeAd);\n }\n\n private void showSplashEyeAd(IATSplashEyeAd splashEyeAd) {\n if (splashEyeAd == null) {\n return;\n }\n\n splashEyeAd.show(SplashAdShowInCurrentActivity.this, null, new ATSplashEyeAdListener() {\n @Override\n public void onAnimationStart(View splashView) {\n \/\/ Execute the zoom animation\n SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());\n\n \/\/ It is recommended to prioritize using the size returned by IATSplashEyeAd#getSuggestedSize() as the target size for the zoom animation.\n int[] suggestedSize = splashEyeAd.getSuggestedSize(getApplicationContext());\n if (suggestedSize != null) {\n zoomOutManager.setSplashEyeAdViewSize(suggestedSize[0], suggestedSize[1]);\n }\n\n zoomOutManager.setSplashInfo(splashView, getWindow().getDecorView());\n ViewGroup content = findViewById(android.R.id.content);\n zoomOutManager.startZoomOut(splashView, content, content, new SplashZoomOutManager.AnimationCallBack() {\n\n @Override\n public void animationStart(int animationTime) {\n\n }\n\n @Override\n public void animationEnd() {\n Log.i(TAG, \"animationEnd---------: eye ad\");\n\n \/\/ When the zoom animation finishes, IATSplashEyeAd#onFinished() must be called to notify the SDK.\n splashEyeAd.onFinished();\n }\n });\n\n\n }\n\n @Override\n public void onAdDismiss(boolean isSupportEyeSplash, String errorMsg) {\n Log.i(TAG, \"onAdDismiss---------: eye ad\");\n\n \/\/ It is recommended to call IATSplashEyeAd#destroy() in this callback to release resources, as well as release other resources, to avoid memory leaks.\n SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());\n zoomOutManager.clearStaticData();\n splashEyeAd.destroy();\n }\n });\n }\n}\n```\n\n6. First-Launch Splash Loading Efficiency Improvement Plan\n- \n\n\nBackground: When loading a Splash Ad for the first time after app installation, Taku first needs to pull the configured Ad Placement info from the dashboard and cache it locally, and only then will it request ads from the ad platform. This involves two network requests (sequential), which affects the Splash Ad loading efficiency. Below are two ways to improve the Splash load efficiency after the app's first launch.\n\n### 6.1 (v6.1.78 and later) Preset Strategy Configuration (Recommended)\n\n> To improve the ad loading effect during the first cold start, create a traffic group with SDK Preset Strategy on the Splash Ad Placement, then configure the waterfall in this traffic group. It is also recommended to add a Fallback Ad Source, and finally export the SDK Preset Strategy and preload it into the app. For specific integration documentation, see the SDK [Preset Strategy Usage Instructions](https:\/\/help.takuad.com\/en\/docs\/TVGLPdoI).\n\nConfiguration Effect: This allows the SDK preset Splash strategy to be implemented, while also enabling the Fallback Ad Source functionality. That is: this fallback Ad Source will initiate requests in parallel with the overall waterfall under the Ad Placement. And the user will not necessarily use the fallback ad on the first request; instead, the waterfall and fallback Ad Source requests proceed in parallel normally, achieving maximum monetization value.\n\n> Note: The preset strategy is only used when there is no locally cached strategy available.**","pure_content":"1. Splash Ad Introduction\n\n1.1 Integration Suggestions\nTo improve the loading efficiency of Splash Ads, you can refer to Cold Start Strategy and SDK Preset Strategy. For details, please refer to Splash Ad Integration Best Practices.\n2. API Instructions\n2.1 Ad Loading\nATSplashAd: The loading class for Splash ads.\n\n\n\n Method\n Description\n\n\n\n\n ATSplashAd(Context context, String placementId, ATSplashAdListener listener, int fetchAdTimeout)\n Splash initialization method. Parameter descriptions: context: Context used for loading ads (recommended to pass an Activity). placementId: Taku's Splash Ad placement ID. listener: Ad event listener. fetchAdTimeout: Ad load timeout in milliseconds. Note: The default ad load timeout is 5000ms.\n\n\n ATSplashAd(Context context, String placementId, ATSplashAdListener listener)\n Splash initialization method. Same parameter meaning as above.\n\n\n void loadAd()\n Initiate ad loading.\n\n\n\nAd Loading:\n\/\/ Note: xxx needs to be replaced with your Splash Ad timeout value, unit: milliseconds.\nATSplashAd splashAd = new ATSplashAd(context, placementId, listner, xxx);\nsplashAd.loadAd();\n\n\n2.2 Ad Display\nATSplashAd:\n\n\n\n Method\n Description\n\n\n\n\n boolean isAdReady()\n Determine whether the current ATSplashAd has a displayable ad.\n\n\n void show(Activity activity, ViewGroup container)\n Display a Splash ad. Parameter descriptions: activity: The Activity displaying the ad. container: The container displaying the ad.\n\n\n void show(Activity activity, final ViewGroup container, ATSplashSkipInfo atSplashSkipInfo)\n Use a custom SkipView to display a Splash ad. Same parameter meaning as above. atSplashSkipInfo: Custom SkipView feature class. Custom SkipView is only effective for the following ads: MyOffer, Adx, OnlineAPI, Pangle (China). Please refer to Demo.\n\n\n void show(Activity activity, ViewGroup container, ATShowConfig showConfig)\n (Added in v6.3.10) Display a Splash ad in a specified scenario. Parameter descriptions: activity: The Activity displaying the ad. container: The container displaying the ad. showConfig: Extra parameters that can be passed during display, as follows:1. ATShowConfig#showCustomExt(String showCustomExt): Can pass custom parameters during display. The passed parameter will be returned via ATAdInfo#getShowCustomExt(). 2. ATShowConfig#scenarioId(String scenarioId): Can pass an ad scenario, same as show(Activity activity, ViewGroup container,String scenario).\n\n\n void show(Activity activity, final ViewGroup container, ATSplashSkipInfo atSplashSkipInfo, ATShowConfig showConfig)\n (Added in v6.3.10) Display a Splash ad in a specified scenario using a custom SkipView. Same parameter meaning as above. atSplashSkipInfo: Custom SkipView feature class. Custom SkipView is only effective for the following ads: MyOffer, Adx, OnlineAPI, Pangle (China). Please refer to Demo.\n\n\n void entryAdScenario(String placementId, String scenarioId)\n Enter business scenario for current Ad Placement cache status statistics. Here scenario refers to the ad display scenario (optional, can be directly passed as null). For creating scenario parameters from the dashboard and usage, please refer to Business Scenario Cache Status Statistics.\n\n\n void entryAdScenario(String scenarioId)\n (v6.5.80 and above) Enter business scenario for current Ad Placement cache status statistics. Here scenario refers to the ad display scenario (optional, can be directly passed as null). For creating scenario parameters from the dashboard and usage, please refer to Business Scenario Cache Status Statistics.\n\n\n\nAd Display:\n \/*\n To count scenario arrival rate, related info can be found at \"https:\/\/help.takuad.com\/docs\/1RWLAv\"\n Call the \"enter ad scenario\" method when the ad triggering conditions are met, for example:\n ** If the ad scenario is to display an ad after a cleanup is finished, call it when the cleanup is finished;\n * 1. First call \"entryAdScenario\"\n * 2. Then call \"isAdReady\" to check if it is displayable\n * 3. Finally call \"show\" to display\n * 4. Passing the scenario ID into scenario will only result in data showing in the dashboard's scenario management (optional).\n \/\n ATSplashAd.entryAdScenario(\"your splash placementID\", \"your scenarioID\");\n\/\/ v6.5.80 and above\n splashAd.entryAdScenario(\"your scenarioID\");\n\/\/ Before displaying, check that there is a cached ad and the current Activity is in the foreground.\nif (splashAd.isAdReady() && inForeBackground) {\n \/\/ The container size should be at least 75% of the screen.\n splashAd.show(activity, container\uff0c\"your scenarioID\");\n}\n\nPassing Custom Parameters During Display:\nTaku SDK v6.3.10 and above supports developers passing custom parameters during display. Custom parameters passed during display are independent of custom parameters passed during Load. Custom parameters passed during display can be returned in the Taku SDK callback info.\n2.3 Local Parameters\nATSplashAd:\n\n\n\n Method\n Description\n\n\n\n\n void setLocalExtra(Map)\n Set local parameters. The key is obtained via ATAdConst.KEY.\n\n\n\nATAdConst.KEY: Predefined Key values for LocalExtra local parameters.\n\n\n\n Key\n Description\n\n\n\n\n AD_WIDTH\n Ad width.\n\n\n AD_HEIGHT\n Ad height.\n\n\n\n2.4 Ad Object\nATSplashAd:\n\n\n\n Method\n Description\n\n\n\n\n checkAdStatus\n Get the status object ATAdStatusInfo of the current Ad Placement.\n\n\n checkValidAdCaches\n Query the ATAdInfo objects of all cached info for the current Ad Placement. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. See ATAdInfo Info Description\n\n\n\nATAdStatusInfo: Status object of the Ad Placement.\n\n\n\n Method\n Description\n\n\n\n\n boolean isLoading()\n Determine whether the current Ad Placement is currently loading an ad.\n\n\n boolean isReady()\n Determine whether the current Ad Placement has a displayable ad. Same function as ATSplashAd.isAdReady().\n\n\n getATTopAdInfo\n Get the ad cache info ATAdInfo object with the highest priority for the current Ad Placement. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. See ATAdInfo Info Description\n\n\n\n2.5 Ad Listener\nATSplashAdListener: Event callback class for Splash ads.\n\n\n\n Method\n Description\n\n\n\n\n void onAdLoaded(boolean isTimeout)\n Ad load success callback. isTimeout: Whether the ad load time exceeded the time specified by fetchAdTimeout.\n\n\n void onNoAdError(AdError error)\n Ad load failure callback. You can get the full error info via AdError.getFullErrorInfo(). Please refer to AdError. Note: Do not execute the ad loading method in this callback for retry, otherwise it may cause many unnecessary requests and may cause the app to lag.\n\n\n void onAdShow(ATAdInfo atAdInfo)\n Ad impression callback. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. See ATAdInfo Info Description\n\n\n void onAdClick(ATAdInfo atAdInfo)\n Ad click callback. Same parameter meaning as above.\n\n\n void onAdDismiss(ATAdInfo entity, ATSplashAdExtraInfo splashAdExtraInfo)\n Ad close callback. Same parameter meaning as above. ATSplashAdExtraInfo: Splash Ad close extra info, including the Splash Eyelet Ad control interface class. Developers can use this interface to control the display of eyelet ads. Note: (1) When the Splash Ad creative of Pangle (China) or GDT supports eyelet features, splashEyeAd will not be null. (2) When displaying a Kuaishou Splash Ad, splashEyeAd will be a non-null value, but it does not necessarily mean that this Kuaishou Splash Ad creative supports eyelet features. When it is not supported, calling the IATSplashEyeAd#show() method will directly call back the ATSplashEyeAdListener#onAdDismiss() method. (3) When splashEyeAd is not null but the developer does not want to support the eyelet feature, splashEyeAd.destroy() must be called to release resources, then navigate to the main page or remove the Splash View.\n\n\n void onAdLoadTimeout\n Ad load timeout callback. Handle the Splash Ad load timeout here. Note: (1) After the ad load timeout callback, the Splash Ad is still loading. If it loads successfully, it will trigger onAdLoaded(true). (2) If the Splash Ad loaded this time is not displayed, it will be placed in the cache for the next display.\n\n\n\nATSplashExListener: Inherits from ATSplashAdListener, methods are the same as ATSplashAdListener, with additional callback descriptions as follows:\n\n\n\n Method\n Description\n\n\n\n\n void onDeeplinkCallback(ATAdInfo atAdInfo, boolean isSuccess)\n Deeplink callback, for Adx, OnlineApi ads. isSuccess: Whether successful.\n\n\n void onDownloadConfirm(Context context, ATAdInfo atAdInfo, View clickView, ATNetworkConfirmInfo networkConfirmInfo)\n Callback method when an app-type ad click triggers a download. ATNetworkConfirmInfo: Callback info provided by the third-party ad platform (Currently only GDT's GDTDownloadFirmInfo is available.) ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. See ATAdInfo Info Description\n\n\n void onSplashAdReward(ATAdInfo atAdInfo)\n v6.6.21 and above (GDT reward support).\n\n\n\nIATSplashEyeAd: Control class for Splash Eyelet Ads.\n\n\n\n Method\n Description\n\n\n\n\n show(Context context, Rect rect, ATSplashEyeAdListener atSplashEyeAdListener)\n Display a Splash Eyelet (V+, small window) ad. context: Context. rect: The display size of the Splash Eyelet Ad when the zoom animation ends, starting from the top-left corner of the screen (Note: Kuaishou requires this parameter to be passed.) atSplashEyeAdListener: Splash Eyelet Ad event listener.\n\n\n getSuggestedSize(Context context)\n Get the recommended ad display size when the zoom animation ends (Currently only Pangle (China) returns this. It is recommended to prioritize using this size.)\n\n\n onFinished\n When the zoom animation finishes, the developer must call this method to notify the SDK to display the ad's close button.\n\n\n\nATSplashEyeAdListener: Event callback class for Splash Eyelet Ads.\n\n\n\n Method\n Description\n\n\n\n\n onAnimationStart(View splashView)\n The developer needs to execute the zoom animation of the Splash Eyelet Ad in this callback. splashView: View of the Splash ad. Note: (1) Sample code for the zoom animation can be referenced in the Demo. (2) When the zoom animation ends, IATSplashEyeAd#onFinished() must be called. (3) Kuaishou will not trigger this callback. Kuaishou's zoom animation cannot be controlled.\n\n\n onAdDismiss(boolean isSupportEyeSplash, String errorMsg)\n Splash Eyelet Ad close callback. It is recommended to call IATSplashEyeAd#destroy() in this callback. isSupportEyeSplash: Whether Splash Eyelet is supported. errorMsg: When an error occurs, the error message will be displayed here. Note: The timing of each platform triggering this callback varies; it may be when the close button is clicked or when the ad playback ends.\n\n\n\nATSplashSkipInfo: Custom SkipView feature class.\n\n\n\n Method\n Description\n\n\n\n\n ATSplashSkipInfo(View skipView, long countDownDuration, long callbackInterval, ATSplashSkipAdListener atSplashSkipAdListener)\n Custom SkipView feature class constructor. skipView: The developer's custom skip button View. countDownDuration: Total countdown duration (unit: ms), default 5s, minimum can be set to 2s. callbackInterval: Trigger interval for the countdown callback (unit: ms), default triggers the ATSplashSkipAdListener#onAdTick() callback every 1s, minimum can be set to 20ms. atSplashSkipAdListener: Custom SkipView event listener class. Note: (1) When skipView is passed as null, the custom SkipView feature will not take effect. (2) If the developer wishes to customize the countdown animation, the trigger interval of the countdown callback can be changed via the callbackInterval parameter.\n\n\n ATSplashSkipInfo(View skipView, ATSplashSkipAdListener atSplashSkipAdListener)\n Custom SkipView feature class constructor. Same parameter meaning as above.\n\n\n\nATSplashSkipAdListener: Custom SkipView event listener class.\n\n\n\n Method\n Description\n\n\n\n\n onAdTick(long duration, long remainder)\n Countdown callback. Developers can update the countdown animation in this callback. duration: Total countdown duration (unit: ms). remainder: Current remaining countdown progress (unit: ms).\n\n\n isSupportCustomSkipView(boolean isSupport)\n Callback notifying the developer whether the currently displayed ad supports the custom SkipView. isSupport: true means the currently displayed ad platform supports it, false means it does not. Note: (1) The developer can determine in this callback that when isSupport is true, set skipView to visible.\n\n\n\n3. Sample Code\n\n\/\/ Note: xxx needs to be replaced with your Splash Ad timeout value, unit: milliseconds.\nATSplashAd splashAd = new ATSplashAd(context, placementId, listner, xxx);\nsplashAd.loadAd();\n\n \/\n To count scenario arrival rate, related info can be found at \"https:\/\/docs.takuad.com\/#\/zh-cn\/android\/NetworkAccess\/scenario\/scenario\"\n Call the \"enter ad scenario\" method when the ad triggering conditions are met, for example:\n ** If the ad scenario is to display an ad after a cleanup is finished, call it when the cleanup is finished;\n * 1. First call \"entryAdScenario\"\n * 2. Then call \"isAdReady\" to check if it is displayable\n * 3. Finally call \"show\" to display\n * 4. Passing the scenario ID into scenario will only result in data showing in the dashboard's scenario management (optional).\n *\/\n ATSplashAd.entryAdScenario(\"your splash placementID\", \"your scenarioID\");\n\/\/ Before displaying, check that there is a cached ad and the current Activity is in the foreground.\nif (splashAd.isAdReady() && inForeBackground) {\n \/\/ The container size should be at least 75% of the screen.\n splashAd.show(activity, container\uff0c\"your scenarioID\");\n}\n\nFor detailed Splash Ad sample code, please refer to the SplashAdActivity class in Demo.\nCold Start Sample:\nATSplashExListener listener = new ATSplashExListener() {\n ......\n @Override\n public void onAdLoaded(boolean isTimeout) {\n \/\/ When the load has not timed out\n if(!isTimeout){\n \/\/ Display the ad when the current Activity is in the foreground\n if(inForeBackground){\n \/\/ The container size should be at least 75% of the screen.\n splashAd.show(activity, container);\n }else{\n \/\/ Wait for the app to return to the foreground before displaying\n needShowSplashAd = true;\n }\n }\n }\n\n @Override\n public void onAdLoadTimeout() {\n \/\/ After load timeout, directly navigate to the main interface.\n jumpToMainActivity();\n }\n\n @Override\n public void onNoAdError(AdError adError) {\n \/\/ Navigate directly to the main interface on load failure.\n jumpToMainActivity();\n }\n\n @Override\n public void onAdShow(ATAdInfo entity) {\n\n }\n\n @Override\n public void onAdDismiss(ATAdInfo entity, ATSplashAdExtraInfo splashAdExtraInfo) {\n \/\/ =1 Undifferentiated =2 Skip ended =3 Countdown ended =4 Ad click ended =99 Splash display failed\n if(splashAdExtraInfo.getDismissType()==ATAdConst.DISMISS_TYPE.SHOWFAILED){\n }\n \/\/ Navigate to the main interface after the Splash Ad display is closed.\n \/\/ Note: Some platforms do not pause the countdown when navigating to the landing page. Even while viewing the landing page, onAdDismiss will still be called back after the countdown ends.\n \/\/ Therefore, special handling is required during page navigation. Refer to the sample code below for details.\n jumpToMainActivity();\n }\n ......\n};\n\n\/\/ Note: xxx needs to be replaced with your Splash Ad timeout value, unit: milliseconds.\nATSplashAd splashAd = new ATSplashAd(context, placementId, listner, xxx);\n\nif (splashAd.isAdReady()) {\n \/\/ The container size should be at least 75% of the screen.\n splashAd.show(activity, container);\n}else{\n splashAd.loadAd();\n}\n\nonAdDismiss() Splash Ad page navigation sample:\n\/\/ Flag for whether a page navigation is needed\nboolean needJump;\n\n@Override\nprotected void onResume() {\n super.onResume();\n if (needJump) {\n jumpToMainActivity();\n }\n needJump = true;\n}\n\n@Override\nprotected void onPause() {\n super.onPause();\n needJump = false;\n}\n\npublic void jumpToMainActivity() {\n if (!needJump) {\n needJump = true;\n return;\n }\n Intent intent = new Intent(this, YourMainActivity.class);\n startActivity(intent);\n finish();\n}\n\n4. Ad Platform-Specific Configuration Instructions\n\n4.1 Admob\nAdmob's Splash Ad does not need to depend on a container for display; it can only be displayed full-screen. After the ad is displayed, there will be no countdown and it will not auto-skip.\n4.2 Baidu\nIf you have integrated Baidu SDK's Splash Ad, you need to select the SkipView display style in the Baidu dashboard (Baidu dashboard defaults to not displaying the SkipView).\n4.3 Pangle (China)\nBefore loading the ad, the ad width and height must be set. An example is as follows:\n\/\/ Note: xxx needs to be replaced with your Splash Ad timeout value, unit: milliseconds.\nsplashAd = new ATSplashAd(this, placementId, atMediationRequestInfo, this, xxx); \nMap localMap = new HashMap(); \nlocalMap.put(ATAdConst.KEY.AD_WIDTH, width);\/\/ Unit: px \nlocalMap.put(ATAdConst.KEY.AD_HEIGHT, height);\/\/ Unit: px \nsplashAd.setLocalExtra(localMap); \nsplashAd.loadAd();\n\nNote: If the set width and height are inconsistent with the container width and height during display, or if the template rendering option in the Taku dashboard does not correspond to the Pangle (China) dashboard, the ad may appear incomplete, blurry, or distorted.\n5. Splash Eyelet Ad Sample\n\n\nNote:\n\u2460 Since it is not guaranteed that an eyelet-supporting Splash Ad will always load, for fill rate issues with Splash Ad eyelet creative materials, please contact the ad platform for handling.\n\u2461 For the sample code below, please refer to the Demo.\n\n5.1 The Splash Activity and the Eyelet Ad Display Activity Are Not the Same\n(1) Create a SplashEyeAdHolder class to cache the IATSplashEyeAd instance.\npublic class SplashEyeAdHolder {\n public static IATSplashEyeAd splashEyeAd;\n}\n\npublic class SplashAdShowActivity extends Activity implements ATSplashAdListener {\n ...\n @Override\n public void onAdDismiss(ATAdInfo entity, ATSplashAdExtraInfo splashAdExtraInfo) {\n Log.i(TAG, \"onAdDismiss:\\n\" + entity.toString());\n\n \/\/ (1) When the Splash Ad creative of Pangle (China) or GDT supports eyelet features, splashEyeAd will not be null.\n \/\/ (2) When displaying a Kuaishou Splash Ad, splashEyeAd will be a non-null value, but it does not necessarily mean that this Kuaishou Splash Ad creative supports eyelet features. When it is not supported, calling the IATSplashEyeAd#show() method will directly call back the ATSplashEyeAdListener#onAdDismiss() method.\n \/\/ (3) When splashEyeAd is not null but the developer does not want to support the eyelet feature, splashEyeAd.destroy() must be called to release resources, then navigate to the main page or remove the Splash View.\n\n SplashEyeAdHolder.splashEyeAd = splashAdExtraInfo.getAtSplashEyeAd();\n\n jumpToMainActivity();\n }\n}\n\n(2) Set the Splash Ad related info (SplashZoomOutManager, please refer to the Demo), while navigating to the home screen Activity and cancelling the page navigation animation, then close the current page.\npublic class SplashAdShowActivity extends Activity implements ATSplashAdListener {\n ...\n public void jumpToMainActivity() {\n if (!hasHandleJump) {\n hasHandleJump = true;\n\n if (SplashEyeAdHolder.splashEyeAd != null) {\n try {\n SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());\n zoomOutManager.setSplashInfo(container.getChildAt(0),\n getWindow().getDecorView());\n } catch (Throwable e) {\n Log.e(TAG, \"jumpToMainActivity: ------------------------------------------ error\");\n e.printStackTrace();\n }\n\n Intent intent = new Intent(this, TestMainActivity.class);\n startActivity(intent);\n\n overridePendingTransition(0, 0);\n }\n\n finish();\n Toast.makeText(this, \"start your MainActivity.\", Toast.LENGTH_SHORT).show();\n }\n }\n}\n\n(3) In the home screen Activity, create the showSplashEyeAd() method.\npublic class TestMainActivity extends Activity {\n ...\n private void showSplashEyeAd() {\n\n if (SplashEyeAdHolder.splashEyeAd == null) {\n return;\n }\n\n SplashEyeAdHolder.splashEyeAd.show(TestMainActivity.this, null, new ATSplashEyeAdListener() {\n @Override\n public void onAnimationStart(View splashView) {\n \/\/ Execute the zoom animation\n SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());\n\n \/\/ It is recommended to prioritize using the size returned by IATSplashEyeAd#getSuggestedSize() as the target size for the zoom animation.\n int[] suggestedSize = SplashEyeAdHolder.splashEyeAd.getSuggestedSize(getApplicationContext());\n if (suggestedSize != null) {\n zoomOutManager.setSplashEyeAdViewSize(suggestedSize[0], suggestedSize[1]);\n }\n zoomOutManager.startZoomOut((ViewGroup) getWindow().getDecorView(),\n findViewById(android.R.id.content), new SplashZoomOutManager.AnimationCallBack() {\n\n @Override\n public void animationStart(int animationTime) {\n\n }\n\n @Override\n public void animationEnd() {\n Log.i(TAG, \"animationEnd---------: eye ad\");\n\n \/\/ When the zoom animation finishes, IATSplashEyeAd#onFinished() must be called to notify the SDK.\n SplashEyeAdHolder.splashEyeAd.onFinished();\n }\n });\n\n }\n\n @Override\n public void onAdDismiss(boolean isSupportEyeSplash, String errorMsg) {\n Log.i(TAG, \"onAdDismiss---------: close eye ad\");\n\n \/\/ It is recommended to call IATSplashEyeAd#destroy() in this callback to release resources, as well as release other resources, to avoid memory leaks.\n SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());\n zoomOutManager.clearStaticData();\n\n SplashEyeAdHolder.splashEyeAd.destroy();\n SplashEyeAdHolder.splashEyeAd = null;\n }\n });\n }\n\n}\n\n(4) In the home screen Activity, call showSplashEyeAd() to display the eyelet ad (it is recommended to call showSplashEyeAd() in the onAttachedToWindow() callback).\n public class TestMainActivity extends Activity {\n ...\n @Override\n public void onAttachedToWindow() {\n super.onAttachedToWindow();\n\n showSplashEyeAd();\n }\n}\n\n5.2 The Splash Activity and the Eyelet Ad Display Activity Are the Same\npublic class SplashAdShowActivity extends Activity implements ATSplashAdListener {\n ...\n @Override\n public void onAdDismiss(ATAdInfo entity, IATSplashEyeAd splashEyeAd) {\n Log.i(TAG, \"onAdDismiss:\\n\" + entity.toString());\n\n \/\/ (1) When the Splash Ad creative of Pangle (China) or GDT supports eyelet features, splashEyeAd will not be null.\n \/\/ (2) When displaying a Kuaishou Splash Ad, splashEyeAd will be a non-null value, but it does not necessarily mean that this Kuaishou Splash Ad creative supports eyelet features. When it is not supported, calling the IATSplashEyeAd#show() method will directly call back the ATSplashEyeAdListener#onAdDismiss() method.\n \/\/ (3) When splashEyeAd is not null but the developer does not want to support the eyelet feature, splashEyeAd.destroy() must be called to release resources, then navigate to the main page or remove the Splash View.\n\n\n if (container != null) {\n container.removeAllViews();\n container.setVisibility(View.GONE);\n } \n\n \/\/ Display the eyelet ad\n showSplashEyeAd(splashEyeAd);\n }\n\n private void showSplashEyeAd(IATSplashEyeAd splashEyeAd) {\n if (splashEyeAd == null) {\n return;\n }\n\n splashEyeAd.show(SplashAdShowInCurrentActivity.this, null, new ATSplashEyeAdListener() {\n @Override\n public void onAnimationStart(View splashView) {\n \/\/ Execute the zoom animation\n SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());\n\n \/\/ It is recommended to prioritize using the size returned by IATSplashEyeAd#getSuggestedSize() as the target size for the zoom animation.\n int[] suggestedSize = splashEyeAd.getSuggestedSize(getApplicationContext());\n if (suggestedSize != null) {\n zoomOutManager.setSplashEyeAdViewSize(suggestedSize[0], suggestedSize[1]);\n }\n\n zoomOutManager.setSplashInfo(splashView, getWindow().getDecorView());\n ViewGroup content = findViewById(android.R.id.content);\n zoomOutManager.startZoomOut(splashView, content, content, new SplashZoomOutManager.AnimationCallBack() {\n\n @Override\n public void animationStart(int animationTime) {\n\n }\n\n @Override\n public void animationEnd() {\n Log.i(TAG, \"animationEnd---------: eye ad\");\n\n \/\/ When the zoom animation finishes, IATSplashEyeAd#onFinished() must be called to notify the SDK.\n splashEyeAd.onFinished();\n }\n });\n\n\n }\n\n @Override\n public void onAdDismiss(boolean isSupportEyeSplash, String errorMsg) {\n Log.i(TAG, \"onAdDismiss---------: eye ad\");\n\n \/\/ It is recommended to call IATSplashEyeAd#destroy() in this callback to release resources, as well as release other resources, to avoid memory leaks.\n SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());\n zoomOutManager.clearStaticData();\n splashEyeAd.destroy();\n }\n });\n }\n}\n\n6. First-Launch Splash Loading Efficiency Improvement Plan\n\nBackground: When loading a Splash Ad for the first time after app installation, Taku first needs to pull the configured Ad Placement info from the dashboard and cache it locally, and only then will it request ads from the ad platform. This involves two network requests (sequential), which affects the Splash Ad loading efficiency. Below are two ways to improve the Splash load efficiency after the app's first launch.\n6.1 (v6.1.78 and later) Preset Strategy Configuration (Recommended)\n\nTo improve the ad loading effect during the first cold start, create a traffic group with SDK Preset Strategy on the Splash Ad Placement, then configure the waterfall in this traffic group. It is also recommended to add a Fallback Ad Source, and finally export the SDK Preset Strategy and preload it into the app. For specific integration documentation, see the SDK Preset Strategy Usage Instructions.\n\nConfiguration Effect: This allows the SDK preset Splash strategy to be implemented, while also enabling the Fallback Ad Source functionality. That is: this fallback Ad Source will initiate requests in parallel with the overall waterfall under the Ad Placement. And the user will not necessarily use the fallback ad on the first request; instead, the waterfall and fallback Ad Source requests proceed in parallel normally, achieving maximum monetization value.\n\nNote: The preset strategy is only used when there is no locally cached strategy available.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1709721426","update_time":"1783411581"},"pure_content":"1. Splash Ad Introduction\n\n1.1 Integration Suggestions\nTo improve the loading efficiency of Splash Ads, you can refer to Cold Start Strategy and SDK Preset Strategy. For details, please refer to Splas"},{"id":"76220","string_id":"upP77b","status":"1","parent_id":"862754","slug":"Banner-Ad-LAGw","order":"3","name":"Banner Ad","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722529","add_time":"1709721427","update_time":"1783411581","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76220","content":"1. Banner Ad Introduction\n---------\n\n### 1.1 Integration Suggestions\n\n#### 1.1.1 Width and Height Settings\n\n- Width and height can be customized, but they need to be consistent with the aspect ratio configured in the TopOn dashboard, and adjustments should be made based on actual results. For specific implementation, please refer to [Demo](https:\/\/github.com\/toponteam\/TPN-Android-Demo).\n\n#### 1.1.2 Auto-Refresh\n\n- It is disabled by default. You can configure the refresh interval in the TopOn dashboard's Ad Placement Advanced Settings to enable or disable refresh.\n- The Banner Ad View must be added to the window and visible to trigger auto-refresh.\n- If the ad platform provides an auto-refresh feature, it is recommended to disable the ad platform's auto-refresh and only use TopOn's auto-refresh to avoid conflicts that may lead to unforeseen issues.\n- After enabling auto-refresh, add ATBannerView to the layout, ensure it is in a visible state, and call `load()` once. Subsequent display and refresh will be automatically executed by the SDK.\n\n#### 1.1.3 Destroying Resources\n\n- When it is no longer necessary to display the Banner Ad, remove ATBannerView from the layout and call the `ATBannerView#destroy()` method to destroy the current ad resources.\n\n2. API Instructions\n--------\n\n### 2.1 Ad Loading and Display\n\nATBannerView: Banner ad loading class, also a View for displaying Banner ads.\n\n| Method | Description |\n|---|---|\n| void setPlacementId(String bannerTakuPlacementID) | Set the Banner ad placement ID, where bannerTakuPlacementID is obtained by creating a Banner Ad Placement in the Taku dashboard (must be set). |\n| void loadAd() | Banner ad loading. |\n\n\n\nAd Loading and Display:\n\n```\nATBannerView mBannerView = new ATBannerView(BannerAdActivity.this); \nmBannerView.setPlacementId(bannerTakuPlacementID); \nmBannerView.loadAd();\n```\n\n### 2.2 Ad Scenario\n\nATBannerView:\n\n| Method | Description |\n|---|---|\n| void setShowConfig(ATShowConfig showConfig) | (Added in v6.3.10) Set the ad scenario (for subsequently displayed ads). showConfig: Extra parameters can be passed during display, as follows: 1. ATShowConfig#showCustomExt(String showCustomExt): Can pass custom parameters during display. The passed parameter will be returned via ATAdInfo#getShowCustomExt(). 2. ATShowConfig#scenarioId(String scenarioId): Can pass an ad scenario, same as setScenario(String scenario). |\n\n\n\nScenario Example:\n\n```\nmBannerView.setScenario(\"your scenarioID\");\n```\n\nPassing Custom Parameters During Display:\n\nTaku SDK v6.3.10 and above supports developers passing custom parameters during display. Custom parameters passed during display are independent of custom parameters passed during Load. Custom parameters passed during display can be returned in the Taku SDK callback info.\n\n### 2.3 Banner Ad Size Settings\n\nATBannerView:\n\n| Method | Description |\n|---|---|\n| void setLocalExtra(Map) | Set local parameters. |\n\n\n\n(1) The sizes of each Ad Source under a Banner Ad Placement should preferably be the same or have similar proportions.\n\n(2) Before calling the load method to load an ad, the width and height values must be passed via `setLocalExtra()`.\n\n```\nATBannerView mBannerView = new ATBannerView(BannerAdActivity.this); \nmBannerView.setPlacementId(bannerTakuPlacementID); \nint width = getResources().getDisplayMetrics().widthPixels;\/\/ Set a width value, such as screen width. \nint height = (int) (width \/ (320 \/ 50f));\/\/ Convert height value according to the ratio. \nMap localMap = new HashMap<>(); \nlocalMap.put(ATAdConst.KEY.AD_WIDTH, width); \nlocalMap.put(ATAdConst.KEY.AD_HEIGHT, height); \nmBannerView.setLocalExtra(localMap); \nmBannerView.loadAd();\n```\n\nIf the above code causes the Banner to sometimes be tall and sometimes short, use the following sample code to limit the height:\n\n```\nint width = getResources().getDisplayMetrics().widthPixels;\/\/ Set a width value, such as screen width. \nint height = (int) (width \/ (320 \/ 50f));\/\/ Must be consistent with the aspect ratio of the Banner Ad Source configured in the Taku dashboard. Assume the size is 320x50. \nmBannerView.setLayoutParams(new FrameLayout.LayoutParams(width, height)); \n...\n```\n\n### 2.4 Banner Ad Removal Instructions\n\nATBannerView:\n\n| Method | Description |\n|---|---|\n| destroy | Banner ad destruction (call when removing). |\n\n\n\nBanner removal can occur in the following situations:\n\n- When `onBannerClose()` is called back, manually use code to remove ATBannerView from the parent layout.\n- Manually use code to remove ATBannerView from the parent layout based on the developer's needs.\n\n> Note: When `onBannerClose()` is called back, if removal is not manually performed via code, the Banner Ad will be auto-refreshed once.\n\n### 2.5 Ad Object\n\nATBannerView:\n\n| Method | Description |\n|---|---|\n| checkAdStatus | Get the status object ATAdStatusInfo of the current Ad Placement. See the API description of the ATAdStatusInfo object below. |\n| checkValidAdCaches | Query the ATAdInfo objects of all cached info for the current Ad Placement. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. [See ATAdInfo Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description) |\n\n\n\nATAdStatusInfo: Status object of the Ad Placement.\n\n| Method | Description |\n|---|---|\n| boolean isLoading() | Determine whether the current Ad Placement is currently loading an ad. |\n| boolean isReady() | Determine whether the current Ad Placement has a displayable ad. |\n| getATTopAdInfo | Get the ad cache info ATAdInfo object with the highest priority for the current Ad Placement. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. [See ATAdInfo Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description) |\n\n\n\n### 2.6 Ad Listener\n\nATBannerView:\n\n| Method | Description |\n|---|---|\n| setBannerAdListener(ATBannerListener listener) | Set the Banner ad listener callback. ATBannerListener is the interface class that needs to implement ad event callbacks. |\n| setAdDownloadListener(ATAppDownloadListener listener) | Set the download status listener callback. listener: Download status event callback listener. Currently only supports the following platforms: Pangle (China). |\n| setAdSourceStatusListener(ATAdSourceStatusListener listener) | Set the Ad Source level event listener callback. ATAdSourceStatusListener is the interface class that needs to implement Ad Source level event callbacks. [See ATAdSourceStatusListener Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description) |\n\n\n\nATBannerListener: Event callback listener for Banner ads.\n\n| Method | Description |\n|---|---|\n| void onBannerLoaded | Ad load success callback. |\n| void onBannerFailed(AdError error) | Ad load failure callback. You can get the full error info via AdError.getFullErrorInfo(). Please refer to [AdError](https:\/\/help.takuad.com\/en\/docs\/Error-code-description-ua8l). Note: Do not execute the ad loading method in this callback for retry, otherwise it may cause many unnecessary requests and may cause the app to lag. |\n| void onBannerShow(ATAdInfo atAdInfo) | Ad impression callback. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. [See ATAdInfo Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description) |\n| void onBannerClicked(ATAdInfo atAdInfo) | Ad click callback. Same parameter meaning as above. |\n| void onBannerClose(ATAdInfo atAdInfo) | Ad close callback (some ad platforms have this callback). Same parameter meaning as above. |\n| void onBannerAutoRefreshed(ATAdInfo atAdInfo) | Ad auto-refresh callback. Same parameter meaning as above. |\n| void onBannerAutoRefreshFail(AdError error) | Ad auto-refresh failure callback. Same parameter meaning as above. |\n\n\n\nListener Example:\n\n```\nmBannerView.setBannerAdListener(new ATBannerListener() {\n @Override\n public void onBannerLoaded() { \n }\n\n @Override\n public void onBannerFailed(AdError adError) {\n \/\/ Note: Do not execute the ad loading method in this callback for retry, otherwise it may cause many unnecessary requests and may cause the app to lag.\n \/\/ AdError, please refer to https:\/\/docs.takuad.com\/#\/zh-cn\/android\/android_doc\/android_test?id=aderror\n Log.e(TAG, \"onBannerFailed:\" + adError.getFullErrorInfo());\n }\n\n @Override\n public void onBannerClicked(ATAdInfo atAdInfo) {\n }\n\n @Override\n public void onBannerShow(ATAdInfo atAdInfo) {\n \/\/ ATAdInfo can distinguish ad platforms and obtain the ad placement ID of the ad platform, etc.\n \/\/ Please refer to https:\/\/docs.takuad.com\/#\/zh-cn\/android\/android_doc\/android_sdk_callback_access?id=callback_info\n\n }\n\n @Override\n public void onBannerClose(ATAdInfo atAdInfo) {\n if (mBannerView != null && mBannerView.getParent() != null) {\n ((ViewGroup) mBannerView.getParent()).removeView(mBannerView);\n }\n }\n\n @Override\n public void onBannerAutoRefreshed(ATAdInfo atAdInfo) {\n }\n\n @Override\n public void onBannerAutoRefreshFail(AdError adError) {\n \/\/ AdError: https:\/\/docs.takuad.com\/#\/zh-cn\/android\/android_doc\/android_test?id=aderror\n Log.e(TAG, \"onBannerAutoRefreshFail:\" + adError.getFullErrorInfo());\n }\n});\n```\n\nATBannerExListener: Inherits from `ATBannerListener`, methods are the same as `ATBannerListener`, with additional callback descriptions as follows:\n\n| Method | Description |\n|---|---|\n| void onDeeplinkCallback(boolean isRefresh, ATAdInfo atAdInfo, boolean isSuccess) | Deeplink callback, for Adx, OnlineApi ads. isRefresh: Whether it is an auto-refresh. isSuccess: Whether successful. |\n| void onDownloadConfirm(Context context, ATAdInfo atAdInfo, View clickView, ATNetworkConfirmInfo networkConfirmInfo) | Callback method when an app-type ad click triggers a download. ATNetworkConfirmInfo: Callback info provided by the third-party ad platform (Currently only GDT's GDTDownloadFirmInfo is available.) ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. [See ATAdInfo Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description) |\n\n\n\nATAppDownloadListener: (Only supported by China-region SDK) Download status event callback listener. \nCurrently only supports the following platforms: Pangle (China).\n\n| Method | Description |\n|---|---|\n| void onDownloadStart(ATAdInfo atAdInfo, long totalBytes, long currBytes, String fileName, String appName) | Download start callback. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. [See ATAdInfo Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description) totalBytes: Total file size (unit: bytes). currBytes: Currently downloaded size (unit: bytes). fileName: File name. appName: App name corresponding to the file. |\n| void onDownloadUpdate(ATAdInfo atAdInfo, long totalBytes, long currBytes, String fileName, String appName) | Download progress update callback. Same parameter meaning as above. |\n| void onDownloadPause(ATAdInfo atAdInfo, long totalBytes, long currBytes, String fileName, String appName) | Download pause callback. Same parameter meaning as above. |\n| void onDownloadFinish(ATAdInfo adInfo, long totalBytes, String fileName, String appName) | Download complete callback. Same parameter meaning as above. |\n| void onDownloadFail(ATAdInfo adInfo, long totalBytes, long currBytes, String fileName, String appName) | Download failure callback. Same parameter meaning as above. |\n| void onInstalled(ATAdInfo adInfo, String fileName, String appName) | APK installation complete callback. Same parameter meaning as above. |\n\n\n\n3. Sample Code\n-------\n\n```\nATBannerView mBannerView = new ATBannerView(BannerAdActivity.this);\nmBannerView.setPlacementId(bannerTakuPlacementID);\n\nint width = getResources().getDisplayMetrics().widthPixels;\/\/ Set a width value, such as screen width.\nint height = ViewGroup.LayoutParams.WRAP_CONTENT;\n\n\/\/ If the Banner sometimes appears tall and sometimes short, use this code:\n\/\/ float ratio = 320\/50f;\/\/ Must be consistent with the aspect ratio of the Banner Ad Source configured in the Taku dashboard. Assume the size is 320x50.\n\/\/ int width = getResources().getDisplayMetrics().widthPixels;\/\/ Set a width value, such as screen width.\n\/\/ int height = (int) (width \/ ratio);\n\nmBannerView.setLayoutParams(new FrameLayout.LayoutParams(width, height));\n\nframeLayout.addView(mBannerView);\nmBannerView.setBannerAdListener(new ATBannerListener() {\n @Override\n public void onBannerLoaded() { \n }\n\n @Override\n public void onBannerFailed(AdError adError) {\n \/\/ Note: Do not execute the ad loading method in this callback for retry, otherwise it may cause many unnecessary requests and may cause the app to lag.\n \/\/ AdError, please refer to https:\/\/docs.takuad.com\/#\/zh-cn\/android\/android_doc\/android_test?id=aderror\n Log.e(TAG, \"onBannerFailed:\" + adError.getFullErrorInfo());\n }\n\n @Override\n public void onBannerClicked(ATAdInfo atAdInfo) {\n }\n\n @Override\n public void onBannerShow(ATAdInfo atAdInfo) {\n \/\/ ATAdInfo can distinguish ad platforms and obtain the ad placement ID of the ad platform, etc.\n \/\/ Please refer to https:\/\/docs.takuad.com\/#\/zh-cn\/android\/android_doc\/android_sdk_callback_access?id=callback_info\n\n }\n\n @Override\n public void onBannerClose(ATAdInfo atAdInfo) {\n if (mBannerView != null && mBannerView.getParent() != null) {\n ((ViewGroup) mBannerView.getParent()).removeView(mBannerView);\n }\n }\n\n @Override\n public void onBannerAutoRefreshed(ATAdInfo atAdInfo) {\n }\n\n @Override\n public void onBannerAutoRefreshFail(AdError adError) {\n \/\/ AdError: https:\/\/docs.takuad.com\/#\/zh-cn\/android\/android_doc\/android_test?id=aderror\n Log.e(TAG, \"onBannerAutoRefreshFail:\" + adError.getFullErrorInfo());\n }\n});\n\/\/ Passing the scenario ID into scenario will only result in data showing in the dashboard's scenario management.\nmBannerView.setScenario(\"your scenarioID\");\nmBannerView.loadAd();\n```\n\nFor detailed Banner Ad sample code, please refer to the BannerAdActivity class in [Demo](https:\/\/github.com\/TakuMediation\/Taku_Android_Demo).\n\n4. Ad Platform-Specific Configuration Instructions\n-------------\n\n### 4.1 Admob Adaptive Banner\n\nThe Taku SDK supports Admob's adaptive banners, including adaptive anchored banners and adaptive inline banners. The adaptive anchored banner is recommended. Developers need to use the following code to set the adaptive banner type, the screen orientation for adaptation, and the banner width (unit: px).\n\n```\n...\n\nMap localExtra = new HashMap<>();\n\n\/\/ since v5.7.0, Admob Adaptive Banner (Adaptive Anchored Banner, Adaptive Inline Banner)\nlocalExtra.put(AdmobATConst.ADAPTIVE_TYPE, AdmobATConst.ADAPTIVE_ANCHORED);\/\/ Adaptive Anchored Banner\n\/\/localExtra.put(AdmobATConst.ADAPTIVE_TYPE, AdmobATConst.ADAPTIVE_INLINE);\/\/ Adaptive Inline Banner\n\nlocalExtra.put(AdmobATConst.ADAPTIVE_ORIENTATION, AdmobATConst.ORIENTATION_CURRENT);\n\/\/localExtra.put(AdmobATConst.ADAPTIVE_ORIENTATION, AdmobATConst.ORIENTATION_PORTRAIT);\n\/\/localExtra.put(AdmobATConst.ADAPTIVE_ORIENTATION, AdmobATConst.ORIENTATION_LANDSCAPE);\n\nlocalExtra.put(AdmobATConst.ADAPTIVE_WIDTH, width);\n\nmBannerView.setLocalExtra(localExtra);\n\nmBannerView.loadAd();\n```\n\nNote: When using Admob's adaptive banner, the height of the banner parent container must not be restricted. An example is as follows:\n\n```\n...\nmBannerView.setLayoutParams(new FrameLayout.LayoutParams(width, ViewGroup.LayoutParams.WRAP_CONTENT));\n\nmBannerView.loadAd();\n```\n\n5. About Ad Platform Compliance App Download Popup\n------------------\n\n### 5.1 Pangle (China)\n\n```\n\/\/ Call this method before Initializing the Taku SDK.\nTTATInitManager.getInstance().setIsOpenDirectDownload(false)\n```","pure_content":"1. Banner Ad Introduction\n1.1 Integration Suggestions\n1.1.1 Width and Height Settings\n\nWidth and height can be customized, but they need to be consistent with the aspect ratio configured in the TopOn dashboard, and adjustments should be made based on actual results. For specific implementation, please refer to Demo.\n\n1.1.2 Auto-Refresh\n\nIt is disabled by default. You can configure the refresh interval in the TopOn dashboard's Ad Placement Advanced Settings to enable or disable refresh.\nThe Banner Ad View must be added to the window and visible to trigger auto-refresh.\nIf the ad platform provides an auto-refresh feature, it is recommended to disable the ad platform's auto-refresh and only use TopOn's auto-refresh to avoid conflicts that may lead to unforeseen issues.\nAfter enabling auto-refresh, add ATBannerView to the layout, ensure it is in a visible state, and call load() once. Subsequent display and refresh will be automatically executed by the SDK.\n\n1.1.3 Destroying Resources\n\nWhen it is no longer necessary to display the Banner Ad, remove ATBannerView from the layout and call the ATBannerView#destroy() method to destroy the current ad resources.\n\n2. API Instructions\n2.1 Ad Loading and Display\nATBannerView: Banner ad loading class, also a View for displaying Banner ads.\n\n\n\n Method\n Description\n\n\n\n\n void setPlacementId(String bannerTakuPlacementID)\n Set the Banner ad placement ID, where bannerTakuPlacementID is obtained by creating a Banner Ad Placement in the Taku dashboard (must be set).\n\n\n void loadAd()\n Banner ad loading.\n\n\n\nAd Loading and Display:\nATBannerView mBannerView = new ATBannerView(BannerAdActivity.this); \nmBannerView.setPlacementId(bannerTakuPlacementID); \nmBannerView.loadAd();\n\n2.2 Ad Scenario\nATBannerView:\n\n\n\n Method\n Description\n\n\n\n\n void setShowConfig(ATShowConfig showConfig)\n (Added in v6.3.10) Set the ad scenario (for subsequently displayed ads). showConfig: Extra parameters can be passed during display, as follows: 1. ATShowConfig#showCustomExt(String showCustomExt): Can pass custom parameters during display. The passed parameter will be returned via ATAdInfo#getShowCustomExt(). 2. ATShowConfig#scenarioId(String scenarioId): Can pass an ad scenario, same as setScenario(String scenario).\n\n\n\nScenario Example:\nmBannerView.setScenario(\"your scenarioID\");\n\nPassing Custom Parameters During Display:\nTaku SDK v6.3.10 and above supports developers passing custom parameters during display. Custom parameters passed during display are independent of custom parameters passed during Load. Custom parameters passed during display can be returned in the Taku SDK callback info.\n2.3 Banner Ad Size Settings\nATBannerView:\n\n\n\n Method\n Description\n\n\n\n\n void setLocalExtra(Map)\n Set local parameters.\n\n\n\n(1) The sizes of each Ad Source under a Banner Ad Placement should preferably be the same or have similar proportions.\n(2) Before calling the load method to load an ad, the width and height values must be passed via setLocalExtra().\nATBannerView mBannerView = new ATBannerView(BannerAdActivity.this); \nmBannerView.setPlacementId(bannerTakuPlacementID); \nint width = getResources().getDisplayMetrics().widthPixels;\/\/ Set a width value, such as screen width. \nint height = (int) (width \/ (320 \/ 50f));\/\/ Convert height value according to the ratio. \nMap localMap = new HashMap(); \nlocalMap.put(ATAdConst.KEY.AD_WIDTH, width); \nlocalMap.put(ATAdConst.KEY.AD_HEIGHT, height); \nmBannerView.setLocalExtra(localMap); \nmBannerView.loadAd();\n\nIf the above code causes the Banner to sometimes be tall and sometimes short, use the following sample code to limit the height:\nint width = getResources().getDisplayMetrics().widthPixels;\/\/ Set a width value, such as screen width. \nint height = (int) (width \/ (320 \/ 50f));\/\/ Must be consistent with the aspect ratio of the Banner Ad Source configured in the Taku dashboard. Assume the size is 320x50. \nmBannerView.setLayoutParams(new FrameLayout.LayoutParams(width, height)); \n...\n\n2.4 Banner Ad Removal Instructions\nATBannerView:\n\n\n\n Method\n Description\n\n\n\n\n destroy\n Banner ad destruction (call when removing).\n\n\n\nBanner removal can occur in the following situations:\n\nWhen onBannerClose() is called back, manually use code to remove ATBannerView from the parent layout.\nManually use code to remove ATBannerView from the parent layout based on the developer's needs.\n\n\nNote: When onBannerClose() is called back, if removal is not manually performed via code, the Banner Ad will be auto-refreshed once.\n\n2.5 Ad Object\nATBannerView:\n\n\n\n Method\n Description\n\n\n\n\n checkAdStatus\n Get the status object ATAdStatusInfo of the current Ad Placement. See the API description of the ATAdStatusInfo object below.\n\n\n checkValidAdCaches\n Query the ATAdInfo objects of all cached info for the current Ad Placement. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. See ATAdInfo Info Description\n\n\n\nATAdStatusInfo: Status object of the Ad Placement.\n\n\n\n Method\n Description\n\n\n\n\n boolean isLoading()\n Determine whether the current Ad Placement is currently loading an ad.\n\n\n boolean isReady()\n Determine whether the current Ad Placement has a displayable ad.\n\n\n getATTopAdInfo\n Get the ad cache info ATAdInfo object with the highest priority for the current Ad Placement. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. See ATAdInfo Info Description\n\n\n\n2.6 Ad Listener\nATBannerView:\n\n\n\n Method\n Description\n\n\n\n\n setBannerAdListener(ATBannerListener listener)\n Set the Banner ad listener callback. ATBannerListener is the interface class that needs to implement ad event callbacks.\n\n\n setAdDownloadListener(ATAppDownloadListener listener)\n Set the download status listener callback. listener: Download status event callback listener. Currently only supports the following platforms: Pangle (China).\n\n\n setAdSourceStatusListener(ATAdSourceStatusListener listener)\n Set the Ad Source level event listener callback. ATAdSourceStatusListener is the interface class that needs to implement Ad Source level event callbacks. See ATAdSourceStatusListener Description\n\n\n\nATBannerListener: Event callback listener for Banner ads.\n\n\n\n Method\n Description\n\n\n\n\n void onBannerLoaded\n Ad load success callback.\n\n\n void onBannerFailed(AdError error)\n Ad load failure callback. You can get the full error info via AdError.getFullErrorInfo(). Please refer to AdError. Note: Do not execute the ad loading method in this callback for retry, otherwise it may cause many unnecessary requests and may cause the app to lag.\n\n\n void onBannerShow(ATAdInfo atAdInfo)\n Ad impression callback. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. See ATAdInfo Info Description\n\n\n void onBannerClicked(ATAdInfo atAdInfo)\n Ad click callback. Same parameter meaning as above.\n\n\n void onBannerClose(ATAdInfo atAdInfo)\n Ad close callback (some ad platforms have this callback). Same parameter meaning as above.\n\n\n void onBannerAutoRefreshed(ATAdInfo atAdInfo)\n Ad auto-refresh callback. Same parameter meaning as above.\n\n\n void onBannerAutoRefreshFail(AdError error)\n Ad auto-refresh failure callback. Same parameter meaning as above.\n\n\n\nListener Example:\nmBannerView.setBannerAdListener(new ATBannerListener() {\n @Override\n public void onBannerLoaded() { \n }\n\n @Override\n public void onBannerFailed(AdError adError) {\n \/\/ Note: Do not execute the ad loading method in this callback for retry, otherwise it may cause many unnecessary requests and may cause the app to lag.\n \/\/ AdError, please refer to https:\/\/docs.takuad.com\/#\/zh-cn\/android\/android_doc\/android_test?id=aderror\n Log.e(TAG, \"onBannerFailed:\" + adError.getFullErrorInfo());\n }\n\n @Override\n public void onBannerClicked(ATAdInfo atAdInfo) {\n }\n\n @Override\n public void onBannerShow(ATAdInfo atAdInfo) {\n \/\/ ATAdInfo can distinguish ad platforms and obtain the ad placement ID of the ad platform, etc.\n \/\/ Please refer to https:\/\/docs.takuad.com\/#\/zh-cn\/android\/android_doc\/android_sdk_callback_access?id=callback_info\n\n }\n\n @Override\n public void onBannerClose(ATAdInfo atAdInfo) {\n if (mBannerView != null && mBannerView.getParent() != null) {\n ((ViewGroup) mBannerView.getParent()).removeView(mBannerView);\n }\n }\n\n @Override\n public void onBannerAutoRefreshed(ATAdInfo atAdInfo) {\n }\n\n @Override\n public void onBannerAutoRefreshFail(AdError adError) {\n \/\/ AdError: https:\/\/docs.takuad.com\/#\/zh-cn\/android\/android_doc\/android_test?id=aderror\n Log.e(TAG, \"onBannerAutoRefreshFail:\" + adError.getFullErrorInfo());\n }\n});\n\nATBannerExListener: Inherits from ATBannerListener, methods are the same as ATBannerListener, with additional callback descriptions as follows:\n\n\n\n Method\n Description\n\n\n\n\n void onDeeplinkCallback(boolean isRefresh, ATAdInfo atAdInfo, boolean isSuccess)\n Deeplink callback, for Adx, OnlineApi ads. isRefresh: Whether it is an auto-refresh. isSuccess: Whether successful.\n\n\n void onDownloadConfirm(Context context, ATAdInfo atAdInfo, View clickView, ATNetworkConfirmInfo networkConfirmInfo)\n Callback method when an app-type ad click triggers a download. ATNetworkConfirmInfo: Callback info provided by the third-party ad platform (Currently only GDT's GDTDownloadFirmInfo is available.) ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. See ATAdInfo Info Description\n\n\n\nATAppDownloadListener: (Only supported by China-region SDK) Download status event callback listener.\nCurrently only supports the following platforms: Pangle (China).\n\n\n\n Method\n Description\n\n\n\n\n void onDownloadStart(ATAdInfo atAdInfo, long totalBytes, long currBytes, String fileName, String appName)\n Download start callback. ATAdInfo: Ad information object, can distinguish ad platforms, mainly contains ID info of third-party Mediation platforms. See ATAdInfo Info Description totalBytes: Total file size (unit: bytes). currBytes: Currently downloaded size (unit: bytes). fileName: File name. appName: App name corresponding to the file.\n\n\n void onDownloadUpdate(ATAdInfo atAdInfo, long totalBytes, long currBytes, String fileName, String appName)\n Download progress update callback. Same parameter meaning as above.\n\n\n void onDownloadPause(ATAdInfo atAdInfo, long totalBytes, long currBytes, String fileName, String appName)\n Download pause callback. Same parameter meaning as above.\n\n\n void onDownloadFinish(ATAdInfo adInfo, long totalBytes, String fileName, String appName)\n Download complete callback. Same parameter meaning as above.\n\n\n void onDownloadFail(ATAdInfo adInfo, long totalBytes, long currBytes, String fileName, String appName)\n Download failure callback. Same parameter meaning as above.\n\n\n void onInstalled(ATAdInfo adInfo, String fileName, String appName)\n APK installation complete callback. Same parameter meaning as above.\n\n\n\n3. Sample Code\nATBannerView mBannerView = new ATBannerView(BannerAdActivity.this);\nmBannerView.setPlacementId(bannerTakuPlacementID);\n\nint width = getResources().getDisplayMetrics().widthPixels;\/\/ Set a width value, such as screen width.\nint height = ViewGroup.LayoutParams.WRAP_CONTENT;\n\n\/\/ If the Banner sometimes appears tall and sometimes short, use this code:\n\/\/ float ratio = 320\/50f;\/\/ Must be consistent with the aspect ratio of the Banner Ad Source configured in the Taku dashboard. Assume the size is 320x50.\n\/\/ int width = getResources().getDisplayMetrics().widthPixels;\/\/ Set a width value, such as screen width.\n\/\/ int height = (int) (width \/ ratio);\n\nmBannerView.setLayoutParams(new FrameLayout.LayoutParams(width, height));\n\nframeLayout.addView(mBannerView);\nmBannerView.setBannerAdListener(new ATBannerListener() {\n @Override\n public void onBannerLoaded() { \n }\n\n @Override\n public void onBannerFailed(AdError adError) {\n \/\/ Note: Do not execute the ad loading method in this callback for retry, otherwise it may cause many unnecessary requests and may cause the app to lag.\n \/\/ AdError, please refer to https:\/\/docs.takuad.com\/#\/zh-cn\/android\/android_doc\/android_test?id=aderror\n Log.e(TAG, \"onBannerFailed:\" + adError.getFullErrorInfo());\n }\n\n @Override\n public void onBannerClicked(ATAdInfo atAdInfo) {\n }\n\n @Override\n public void onBannerShow(ATAdInfo atAdInfo) {\n \/\/ ATAdInfo can distinguish ad platforms and obtain the ad placement ID of the ad platform, etc.\n \/\/ Please refer to https:\/\/docs.takuad.com\/#\/zh-cn\/android\/android_doc\/android_sdk_callback_access?id=callback_info\n\n }\n\n @Override\n public void onBannerClose(ATAdInfo atAdInfo) {\n if (mBannerView != null && mBannerView.getParent() != null) {\n ((ViewGroup) mBannerView.getParent()).removeView(mBannerView);\n }\n }\n\n @Override\n public void onBannerAutoRefreshed(ATAdInfo atAdInfo) {\n }\n\n @Override\n public void onBannerAutoRefreshFail(AdError adError) {\n \/\/ AdError: https:\/\/docs.takuad.com\/#\/zh-cn\/android\/android_doc\/android_test?id=aderror\n Log.e(TAG, \"onBannerAutoRefreshFail:\" + adError.getFullErrorInfo());\n }\n});\n\/\/ Passing the scenario ID into scenario will only result in data showing in the dashboard's scenario management.\nmBannerView.setScenario(\"your scenarioID\");\nmBannerView.loadAd();\n\nFor detailed Banner Ad sample code, please refer to the BannerAdActivity class in Demo.\n4. Ad Platform-Specific Configuration Instructions\n4.1 Admob Adaptive Banner\nThe Taku SDK supports Admob's adaptive banners, including adaptive anchored banners and adaptive inline banners. The adaptive anchored banner is recommended. Developers need to use the following code to set the adaptive banner type, the screen orientation for adaptation, and the banner width (unit: px).\n...\n\nMap localExtra = new HashMap();\n\n\/\/ since v5.7.0, Admob Adaptive Banner (Adaptive Anchored Banner, Adaptive Inline Banner)\nlocalExtra.put(AdmobATConst.ADAPTIVE_TYPE, AdmobATConst.ADAPTIVE_ANCHORED);\/\/ Adaptive Anchored Banner\n\/\/localExtra.put(AdmobATConst.ADAPTIVE_TYPE, AdmobATConst.ADAPTIVE_INLINE);\/\/ Adaptive Inline Banner\n\nlocalExtra.put(AdmobATConst.ADAPTIVE_ORIENTATION, AdmobATConst.ORIENTATION_CURRENT);\n\/\/localExtra.put(AdmobATConst.ADAPTIVE_ORIENTATION, AdmobATConst.ORIENTATION_PORTRAIT);\n\/\/localExtra.put(AdmobATConst.ADAPTIVE_ORIENTATION, AdmobATConst.ORIENTATION_LANDSCAPE);\n\nlocalExtra.put(AdmobATConst.ADAPTIVE_WIDTH, width);\n\nmBannerView.setLocalExtra(localExtra);\n\nmBannerView.loadAd();\n\nNote: When using Admob's adaptive banner, the height of the banner parent container must not be restricted. An example is as follows:\n...\nmBannerView.setLayoutParams(new FrameLayout.LayoutParams(width, ViewGroup.LayoutParams.WRAP_CONTENT));\n\nmBannerView.loadAd();\n\n5. About Ad Platform Compliance App Download Popup\n5.1 Pangle (China)\n\/\/ Call this method before Initializing the Taku SDK.\nTTATInitManager.getInstance().setIsOpenDirectDownload(false)","is_draft":"0","editor_type":"2","file_path":"","add_time":"1709721428","update_time":"1783411581"},"pure_content":"1. Banner Ad Introduction\n1.1 Integration Suggestions\n1.1.1 Width and Height Settings\n\nWidth and height can be customized, but they need to be consistent with the aspect ratio configured in the TopOn"},{"id":"76221","string_id":"xCvb9l","status":"1","parent_id":"862754","slug":"Native-zxn8","order":"2","name":"Native","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722530","add_time":"1709721428","update_time":"1783411581","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76221","content":"

1. Introduction to native advertising<\/span><\/h2>

Currently supported native advertising access methods are: Self-rendering information flow advertising<\/strong><\/span> , Template information flow advertisement<\/strong><\/span>, Draw information flow advertisement<\/strong><\/span><\/p>

Note: <\/strong><\/span> The above native ad styles use the same set of APIs for access, and developers can mix different native styles in the same waterfall flow<\/p>