{"data":{"id":"76230","string_id":"3LR0cX","status":"1","parent_id":"76196","slug":"t6Xeoq","order":"11","name":"Advanced setup instructions","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"","published_time":"1709722533","add_time":"1709721447","update_time":"1783478283","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":"862704","string_id":"2jBRcW6A","status":"1","parent_id":"76230","slug":"2jBRcW6A","order":"19","name":"Auto Load","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783409850","add_time":"1783409456","update_time":"1783478001","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"862704","content":"The Auto Load mode is a one-stop request maintenance solution introduced by Taku. It can intelligently determine the preloading and caching timing of the next ad at multiple nodes based on the user's usage status and ad consumption progress. On the basis of meeting your operational strategy, it avoids the failure risk of real-time ad data loading and wasted impression opportunities, and reduces the negative sentiment of users caused by ads not being loaded or being loaded poorly. With the Auto Load solution, you can avoid repeated and tedious manual intervention in the request process, achieving immediate efficiency improvements.\n\nSupported ad formats: [**Rewarded Video Ad**](https:\/\/help.takuad.com\/en\/docs\/Fully-automatic-loading) and [**Interstitial Ad**](https:\/\/help.takuad.com\/en\/docs\/Fully-automatic-loading-mNfd).","pure_content":"The Auto Load mode is a one-stop request maintenance solution introduced by Taku. It can intelligently determine the preloading and caching timing of the next ad at multiple nodes based on the user's usage status and ad consumption progress. On the basis of meeting your operational strategy, it avoids the failure risk of real-time ad data loading and wasted impression opportunities, and reduces the negative sentiment of users caused by ads not being loaded or being loaded poorly. With the Auto Load solution, you can avoid repeated and tedious manual intervention in the request process, achieving immediate efficiency improvements.\nSupported ad formats: Rewarded Video Ad and Interstitial Ad.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783409456","update_time":"1783410555"},"pure_content":"The Auto Load mode is a one-stop request maintenance solution introduced by Taku. It can intelligently determine the preloading and caching timing of the next ad at multiple nodes based on the user's"},{"id":"862983","string_id":"20JQv4F0","status":"1","parent_id":"76230","slug":"20JQv4F0","order":"18","name":"Custom Adapter","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"0","add_time":"1783421010","update_time":"1783478001","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","file_type":"","auth_id":"[\"-1\"]","pure_content":""},{"id":"863425","string_id":"jJBA60pw","status":"1","parent_id":"76230","slug":"jJBA60pw","order":"17","name":"Resume Installation","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783477708","add_time":"1783477473","update_time":"1783478001","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"863425","content":"Introduction\n==\n\n**Prerequisite:** Android SDK v6.2.85 and above, only supported for China-region SDK.\n\n**Supported Ad Platforms:** Currently only supports the Topon ADX platform.\n\n**Resume Installation Introduction**: After users click on app-type ads, they download the APK from the ad. Since the current Android installation chain is relatively long, there may be some APKs that have been downloaded but not yet installed. Through the Resume Installation reminder API, developers can obtain valid APKs for prompting, allowing users to choose whether to continue the installation, thereby improving the app installation rate.\n\n**Activation Popup Reminder Introduction**: During user interaction with ads, there may be situations where the app has been downloaded but not installed, or installed but not opened. At this point, users can be prompted via a popup to maximize ad revenue. This feature is an upgrade of the Resume Installation reminder feature. Developers do not need to handle specific logic for app parsing and popups. Just calling the API allows popups to remind users to complete installation or activation at specified times.\n\n**Applicable Scenarios**: The Resume Installation method and Activation Popup Reminder are recommended to be used when the user exits the app, or while the user is browsing or using the app, without affecting the user experience.\n\nAPI Instructions\n=====\n\nATChinaSDKHandler\n-----------------\n\nUsed to obtain the ATApkManager object. Must be called after SDK Initialization.\n\n| Method Name | Method Description |\n|---|---|\n| getATApkManager(Context context) | context refers to the context. The developer's Activity must be passed here. This method can only be called after SDK Initialization, otherwise it will return null. |\n\nATApkManager\n------------\n\nATAPK data management class, used to obtain APK data and then perform installation.\n\n| Method Name | Method Description |\n|---|---|\n| showOpenOrInstallAppDialog(ATApkDialogClickListener dialogClickListener) | Through this API, you can check for apps that have been downloaded via the ad SDK but not installed, or installed but not activated. A popup prompts the user to install or open\/activate. Repeatedly calling this API will cyclically return apps not installed or installed but not activated in chronological order. |\n| setApkListener(ATApkListener apkListener) | Set the callback for loading ATApk. |\n| loadApk() | Load ATApk data. Only one ATApk can be obtained per call. Repeatedly calling this API will cyclically return apps not installed in chronological order. |\n| startInstall(ATApk apk) | Pass the ATApk data obtained from loadApk() to call the system installer for installation. |\n\nATApkDialogClickListener\n------------------------\n\nActivation Popup Reminder: The listener passed when calling the showOpenOrInstallAppDialog method. Developers need to implement the corresponding interface.\n\n| Method Name | Method Description |\n|---|---|\n| onShowResult(int resultType) | When this method is called back, the returned parameter values are: ATApkDialogClickListener.NO_DLG: No apps available to install or activate.
<\/br>ATApkDialogClickListener.INSTALL_APP_DLG: Popup prompts the user to install the app.
<\/br>ATApkDialogClickListener.OPEN_APP_DLG: Popup prompts the user to open and activate the app. |\n| onButtonClick(int clickType) | When this method is called back, the returned parameter values are: ATApkDialogClickListener.CONFIRM_BUTTON: After the popup, the user clicked confirm.
<\/br>ATApkDialogClickListener.CANCEL_BUTTON: After the popup, the user clicked cancel. |\n\nATApkListener\n-------------\n\nResume Installation: Before calling the loadApk method to obtain GDTAPK data, call the setApkListener method and pass this listener to listen for ATApk data retrieval.\n\n| Method Name | Method Description |\n|---|---|\n| onApkLoad(ATApk apk) | When this method is called back, ATApk data is returned. |\n| onError(String code, String msg, String networkFirmId) | When this method is called back, it provides some error messages related to obtaining ATApk data. code: Error code. 60001 indicates that there are currently no APKs pending installation. 60002 indicates that an exception occurred while obtaining the installation list. msg: Error message. networkFirmId: Ad platform ID. |\n\nATApk\n-----\n\nResume Installation: The data class returned by the ATApkListener interface, ATApk.\n\n| Method Name | Method Description |\n|---|---|\n| getPackageName() | Get the package name of the app ad. |\n| getTitle() | Get the title of the app ad. |\n| getDesc() | Get the description info of the app ad. |\n| getAppName() | Get the name of the app ad. |\n| getLogoUrl() | Get the icon address of the app ad. |\n\nIntegration Notes\n======\n\n1. The method callbacks for both the ATApkDialogClickListener and ATApkListener interfaces are executed on the main thread.\n2. For the showOpenOrInstallAppDialog method, it is recommended for developers to prompt when the user exits the app. It can also be called in any scenario.\n\nIntegration Code Sample\n======\n\n```\n\/**\n * When calling the system installer {@link com.anythink.china.api.ATApkManager#startInstall(com.anythink.china.api.ATApk)},\n * the interface will redirect to the installer interface. At this point, we do not provide a callback for whether the APK file installation has completed or failed.\n *\n * Therefore, developers can use the lifecycle callbacks of Activity or Fragment, combined with their own business logic, to make correct displays.\n *\n * For example, in an Activity, redirecting from the current app to the system installer interface will call back onPause() -> onStop();\n * Returning from the system installer interface to the app will call back onRestart() -> onStart() -> onResume().\n *\n * When the interface returns from the system installer, you can update the view by checking whether the APK has been installed {@link #isAPKInstalled(android.content.Context, java.lang.String)}.\n *\/\npublic class DownloadApkManagerActivity extends Activity implements View.OnClickListener {\n private static final String TAG = DownloadApkManagerActivity.class.getSimpleName();\n\n private ATApkManager mApkManager;\n private ATApk mApk;\n\n @Override\n protected void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n setContentView(R.layout.activity_download_apk_manager);\n\n mApkManager = ATChinaSDKHandler.getATApkManager(this);\n initListener();\n }\n\n @Override\n protected void onStart() {\n super.onStart();\n Log.d(TAG, \"onStart\");\n }\n\n @Override\n protected void onResume() {\n super.onResume();\n Log.d(TAG, \"onResume\");\n if (mApk != null && isAPKInstalled(this, mApk.getPackageName())) {\n \/\/ Update your view\n Log.i(TAG, \"APK file has been installed, you can update your view.\");\n }\n }\n\n @Override\n protected void onPause() {\n super.onPause();\n Log.d(TAG, \"onPause\");\n }\n\n @Override\n protected void onStop() {\n super.onStop();\n Log.d(TAG, \"onStop\");\n }\n\n @Override\n protected void onRestart() {\n super.onRestart();\n Log.d(TAG, \"onRestart\");\n }\n\n @Override\n protected void onDestroy() {\n super.onDestroy();\n Log.d(TAG, \"onDestroy\");\n }\n\n @Override\n public void onBackPressed() {\n showOpenOrInstallAppDialog(true);\n }\n\n private void initListener() {\n findViewById(R.id.bt_show_apk_dialog).setOnClickListener(this);\n findViewById(R.id.bt_load_apk).setOnClickListener(this);\n findViewById(R.id.bt_install_apk).setOnClickListener(this);\n\n if (mApkManager != null) {\n mApkManager.setApkListener(new ATApkListener() {\n @Override\n public void onApkLoad(ATApk apk) {\n if (apk != null) {\n DownloadApkManagerActivity.this.mApk = apk;\n Log.d(TAG, \"onApkLoad() >>> title: \" + apk.getTitle() + \" desc: \" + apk.getDesc() + \" appName: \" + apk.getAppName() +\n \" packageName: \" + apk.getPackageName() + \" logoUrl: \" + apk.getLogoUrl());\n } else {\n Log.d(TAG, \"apk is null.\");\n }\n }\n\n @Override\n public void onError(String code, String msg, String networkFirmId) {\n Log.e(TAG, \"onError() >>> code: \" + code + \" msg: \" + msg + \" networkFirmId: \" + networkFirmId);\n }\n });\n }\n }\n\n @Override\n public void onClick(View v) {\n if (mApkManager == null) {\n return;\n }\n int viewId = v.getId();\n if (viewId == R.id.bt_show_apk_dialog) {\n \/\/ Click button for activation popup reminder\n showOpenOrInstallAppDialog(false);\n } else if (viewId == R.id.bt_load_apk) {\n mApkManager.loadApk();\n } else {\n if (mApk != null) {\n mApkManager.startInstall(mApk);\n } else {\n Log.e(TAG, \"apk is null, can not start install.\");\n }\n }\n }\n\n private void showOpenOrInstallAppDialog(boolean isFromBackPress) {\n if (mApkManager != null) {\n mApkManager.showOpenOrInstallAppDialog(new ATApkDialogClickListener() {\n @Override\n public void onShowResult(int resultType) {\n Log.d(TAG, \"onShowResult() >>> resultType: \" + resultType);\n if (resultType == ATApkDialogClickListener.NO_DLG) {\n if (isFromBackPress) {\n finish();\n } else {\n Toast.makeText(DownloadApkManagerActivity.this, \"No apps available to install or activate.\", Toast.LENGTH_SHORT).show();\n }\n }\n }\n\n @Override\n public void onButtonClick(int clickType) {\n Log.d(TAG, \"onButtonClick() >>> clickType: \" + clickType);\n if (isFromBackPress) {\n finish();\n };\n }\n });\n }\n }\n\n \/**\n * This method is used to determine whether an APK has been installed.\n * @param context\n * @param pkgName\n * @return\n *\/\n private boolean isAPKInstalled(Context context, String pkgName) {\n if (TextUtils.isEmpty(pkgName)) {\n return false;\n }\n PackageManager pm = context.getPackageManager();\n try {\n PackageInfo packageInfo = pm.getPackageInfo(pkgName, PackageManager.GET_GIDS);\n return packageInfo != null;\n } catch (Throwable e) {\n return false;\n }\n }\n}\n```","pure_content":"Introduction\nPrerequisite: Android SDK v6.2.85 and above, only supported for China-region SDK.\nSupported Ad Platforms: Currently only supports the Topon ADX platform.\nResume Installation Introduction: After users click on app-type ads, they download the APK from the ad. Since the current Android installation chain is relatively long, there may be some APKs that have been downloaded but not yet installed. Through the Resume Installation reminder API, developers can obtain valid APKs for prompting, allowing users to choose whether to continue the installation, thereby improving the app installation rate.\nActivation Popup Reminder Introduction: During user interaction with ads, there may be situations where the app has been downloaded but not installed, or installed but not opened. At this point, users can be prompted via a popup to maximize ad revenue. This feature is an upgrade of the Resume Installation reminder feature. Developers do not need to handle specific logic for app parsing and popups. Just calling the API allows popups to remind users to complete installation or activation at specified times.\nApplicable Scenarios: The Resume Installation method and Activation Popup Reminder are recommended to be used when the user exits the app, or while the user is browsing or using the app, without affecting the user experience.\nAPI Instructions\nATChinaSDKHandler\nUsed to obtain the ATApkManager object. Must be called after SDK Initialization.\n\n\n\n Method Name\n Method Description\n\n\n\n\n getATApkManager(Context context)\n context refers to the context. The developer's Activity must be passed here. This method can only be called after SDK Initialization, otherwise it will return null.\n\n\n\nATApkManager\nATAPK data management class, used to obtain APK data and then perform installation.\n\n\n\n Method Name\n Method Description\n\n\n\n\n showOpenOrInstallAppDialog(ATApkDialogClickListener dialogClickListener)\n Through this API, you can check for apps that have been downloaded via the ad SDK but not installed, or installed but not activated. A popup prompts the user to install or open\/activate. Repeatedly calling this API will cyclically return apps not installed or installed but not activated in chronological order.\n\n\n setApkListener(ATApkListener apkListener)\n Set the callback for loading ATApk.\n\n\n loadApk()\n Load ATApk data. Only one ATApk can be obtained per call. Repeatedly calling this API will cyclically return apps not installed in chronological order.\n\n\n startInstall(ATApk apk)\n Pass the ATApk data obtained from loadApk() to call the system installer for installation.\n\n\n\nATApkDialogClickListener\nActivation Popup Reminder: The listener passed when calling the showOpenOrInstallAppDialog method. Developers need to implement the corresponding interface.\n\n\n\n Method Name\n Method Description\n\n\n\n\n onShowResult(int resultType)\n When this method is called back, the returned parameter values are: ATApkDialogClickListener.NO_DLG: No apps available to install or activate.ATApkDialogClickListener.INSTALL_APP_DLG: Popup prompts the user to install the app.ATApkDialogClickListener.OPEN_APP_DLG: Popup prompts the user to open and activate the app.\n\n\n onButtonClick(int clickType)\n When this method is called back, the returned parameter values are: ATApkDialogClickListener.CONFIRM_BUTTON: After the popup, the user clicked confirm.ATApkDialogClickListener.CANCEL_BUTTON: After the popup, the user clicked cancel.\n\n\n\nATApkListener\nResume Installation: Before calling the loadApk method to obtain GDTAPK data, call the setApkListener method and pass this listener to listen for ATApk data retrieval.\n\n\n\n Method Name\n Method Description\n\n\n\n\n onApkLoad(ATApk apk)\n When this method is called back, ATApk data is returned.\n\n\n onError(String code, String msg, String networkFirmId)\n When this method is called back, it provides some error messages related to obtaining ATApk data. code: Error code. 60001 indicates that there are currently no APKs pending installation. 60002 indicates that an exception occurred while obtaining the installation list. msg: Error message. networkFirmId: Ad platform ID.\n\n\n\nATApk\nResume Installation: The data class returned by the ATApkListener interface, ATApk.\n\n\n\n Method Name\n Method Description\n\n\n\n\n getPackageName()\n Get the package name of the app ad.\n\n\n getTitle()\n Get the title of the app ad.\n\n\n getDesc()\n Get the description info of the app ad.\n\n\n getAppName()\n Get the name of the app ad.\n\n\n getLogoUrl()\n Get the icon address of the app ad.\n\n\n\nIntegration Notes\n\nThe method callbacks for both the ATApkDialogClickListener and ATApkListener interfaces are executed on the main thread.\nFor the showOpenOrInstallAppDialog method, it is recommended for developers to prompt when the user exits the app. It can also be called in any scenario.\n\nIntegration Code Sample\n\/**\n * When calling the system installer {@link com.anythink.china.api.ATApkManager#startInstall(com.anythink.china.api.ATApk)},\n * the interface will redirect to the installer interface. At this point, we do not provide a callback for whether the APK file installation has completed or failed.\n *\n * Therefore, developers can use the lifecycle callbacks of Activity or Fragment, combined with their own business logic, to make correct displays.\n *\n * For example, in an Activity, redirecting from the current app to the system installer interface will call back onPause() -> onStop();\n * Returning from the system installer interface to the app will call back onRestart() -> onStart() -> onResume().\n *\n * When the interface returns from the system installer, you can update the view by checking whether the APK has been installed {@link #isAPKInstalled(android.content.Context, java.lang.String)}.\n *\/\npublic class DownloadApkManagerActivity extends Activity implements View.OnClickListener {\n private static final String TAG = DownloadApkManagerActivity.class.getSimpleName();\n\n private ATApkManager mApkManager;\n private ATApk mApk;\n\n @Override\n protected void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n setContentView(R.layout.activity_download_apk_manager);\n\n mApkManager = ATChinaSDKHandler.getATApkManager(this);\n initListener();\n }\n\n @Override\n protected void onStart() {\n super.onStart();\n Log.d(TAG, \"onStart\");\n }\n\n @Override\n protected void onResume() {\n super.onResume();\n Log.d(TAG, \"onResume\");\n if (mApk != null && isAPKInstalled(this, mApk.getPackageName())) {\n \/\/ Update your view\n Log.i(TAG, \"APK file has been installed, you can update your view.\");\n }\n }\n\n @Override\n protected void onPause() {\n super.onPause();\n Log.d(TAG, \"onPause\");\n }\n\n @Override\n protected void onStop() {\n super.onStop();\n Log.d(TAG, \"onStop\");\n }\n\n @Override\n protected void onRestart() {\n super.onRestart();\n Log.d(TAG, \"onRestart\");\n }\n\n @Override\n protected void onDestroy() {\n super.onDestroy();\n Log.d(TAG, \"onDestroy\");\n }\n\n @Override\n public void onBackPressed() {\n showOpenOrInstallAppDialog(true);\n }\n\n private void initListener() {\n findViewById(R.id.bt_show_apk_dialog).setOnClickListener(this);\n findViewById(R.id.bt_load_apk).setOnClickListener(this);\n findViewById(R.id.bt_install_apk).setOnClickListener(this);\n\n if (mApkManager != null) {\n mApkManager.setApkListener(new ATApkListener() {\n @Override\n public void onApkLoad(ATApk apk) {\n if (apk != null) {\n DownloadApkManagerActivity.this.mApk = apk;\n Log.d(TAG, \"onApkLoad() >>> title: \" + apk.getTitle() + \" desc: \" + apk.getDesc() + \" appName: \" + apk.getAppName() +\n \" packageName: \" + apk.getPackageName() + \" logoUrl: \" + apk.getLogoUrl());\n } else {\n Log.d(TAG, \"apk is null.\");\n }\n }\n\n @Override\n public void onError(String code, String msg, String networkFirmId) {\n Log.e(TAG, \"onError() >>> code: \" + code + \" msg: \" + msg + \" networkFirmId: \" + networkFirmId);\n }\n });\n }\n }\n\n @Override\n public void onClick(View v) {\n if (mApkManager == null) {\n return;\n }\n int viewId = v.getId();\n if (viewId == R.id.bt_show_apk_dialog) {\n \/\/ Click button for activation popup reminder\n showOpenOrInstallAppDialog(false);\n } else if (viewId == R.id.bt_load_apk) {\n mApkManager.loadApk();\n } else {\n if (mApk != null) {\n mApkManager.startInstall(mApk);\n } else {\n Log.e(TAG, \"apk is null, can not start install.\");\n }\n }\n }\n\n private void showOpenOrInstallAppDialog(boolean isFromBackPress) {\n if (mApkManager != null) {\n mApkManager.showOpenOrInstallAppDialog(new ATApkDialogClickListener() {\n @Override\n public void onShowResult(int resultType) {\n Log.d(TAG, \"onShowResult() >>> resultType: \" + resultType);\n if (resultType == ATApkDialogClickListener.NO_DLG) {\n if (isFromBackPress) {\n finish();\n } else {\n Toast.makeText(DownloadApkManagerActivity.this, \"No apps available to install or activate.\", Toast.LENGTH_SHORT).show();\n }\n }\n }\n\n @Override\n public void onButtonClick(int clickType) {\n Log.d(TAG, \"onButtonClick() >>> clickType: \" + clickType);\n if (isFromBackPress) {\n finish();\n };\n }\n });\n }\n }\n\n \/**\n * This method is used to determine whether an APK has been installed.\n * @param context\n * @param pkgName\n * @return\n *\/\n private boolean isAPKInstalled(Context context, String pkgName) {\n if (TextUtils.isEmpty(pkgName)) {\n return false;\n }\n PackageManager pm = context.getPackageManager();\n try {\n PackageInfo packageInfo = pm.getPackageInfo(pkgName, PackageManager.GET_GIDS);\n return packageInfo != null;\n } catch (Throwable e) {\n return false;\n }\n }\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783477473","update_time":"1783477708"},"pure_content":"Introduction\nPrerequisite: Android SDK v6.2.85 and above, only supported for China-region SDK.\nSupported Ad Platforms: Currently only supports the Topon ADX platform.\nResume Installation Introduction:"},{"id":"863423","string_id":"U5Rej9Gy","status":"1","parent_id":"76230","slug":"U5Rej9Gy","order":"16","name":"Multiple Loaded Callbacks","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783477753","add_time":"1783477263","update_time":"1783478001","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"863423","content":"Instruction on Supporting Multiple Loaded Callbacks for Ad Placement Load Success Events\n-------------------\n\nStarting from v6.3.70, a new callback, ATAdMultipleLoadedListener#onAdMultipleLoaded(ATRequestingInfo requestingInfo), has been added. It is used to return information about Ad Sources that are still loading (higher priced) and still bidding (unknown price) to the developer.\n\n- This callback may be triggered multiple times. It will be triggered again when a higher-priced Ad Source request succeeds.\n- Developers can decide whether to continue waiting for the results of these Ad Sources based on their needs.\n\n### 1. Check Whether There Are Ad Sources Still Loading or Bidding\n\nYou can listen via the following code:\n\n```\npublic class AdMultipleLoadedListener implements ATAdMultipleLoadedListener {\n\n \/**\n * The first triggering time occurs before the callback timing of the Ad Placement load success event. Afterwards, it will be triggered again when a higher-priced Ad Source request succeeds.\n * When the requestingInfo parameter is null, it indicates that there are no higher-priced Ad Sources still requesting, and no Ad Sources still bidding.\n * When the requestingInfo parameter is not null, you can call requestingInfo.getLoadingAdInfoList() to get the info of Ad Sources still loading (higher priced). It may return null.\n * When the requestingInfo parameter is not null, you can call requestingInfo.getBiddingAttemptAdInfoList() to get the info of Ad Sources still bidding (unknown price). It may return null.\n *\n *\/\n @Override\n public void onAdMultipleLoaded(ATRequestingInfo requestingInfo) {\n if (requestingInfo != null) {\n List loadingAdInfoList = requestingInfo.getLoadingAdInfoList();\n List biddingAttemptAdInfoList = requestingInfo.getBiddingAttemptAdInfoList();\n\n Log.i(TAG, \"onAdMultipleLoaded: loadingHigherPriceAdSize=\" + (loadingAdInfoList != null ? loadingAdInfoList.size() : 0) + \", \" + loadingAdInfoList\n + \"\\n\" + \"biddingAttemptAdSize=\" + (biddingAttemptAdInfoList != null ? biddingAttemptAdInfoList.size() : 0) + \", \" + biddingAttemptAdInfoList\n );\n } else {\n Log.i(TAG, \"onAdMultipleLoaded: loadingHigherPriceAdSize=0, biddingAttemptAdSize=0\");\n }\n }\n}\n\n\n\nmATRewardVideoAd().setAdMultipleLoadedListener(new AdMultipleLoadedListener());\/\/ Rewarded Video\n\/\/ mATInterstitial().setAdMultipleLoadedListener(new AdMultipleLoadedListener());\/\/ Interstitial Ad\n\/\/ mATSplashAd().setAdMultipleLoadedListener(new AdMultipleLoadedListener());\/\/ Splash Ad\n\/\/ mATBannerView().setAdMultipleLoadedListener(new AdMultipleLoadedListener());\/\/ Banner Ad\n\/\/ mATNative().setAdMultipleLoadedListener(new AdMultipleLoadedListener());\/\/ Native Ad\n<\/atadinfo><\/atadinfo>\n```\n\n### 2. Monitor the Results of Ad Sources Still Loading or Bidding\n\nWhen the developer needs to continue waiting for the results of Ad Source requests or bidding, set ATAdSourceStatusListener to listen.\n\n**Note**: For the ATAdInfo and ATAdSourceStatusListener mentioned in this document, please refer to [Callback Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description).","pure_content":"Instruction on Supporting Multiple Loaded Callbacks for Ad Placement Load Success Events\nStarting from v6.3.70, a new callback, ATAdMultipleLoadedListener#onAdMultipleLoaded(ATRequestingInfo requestingInfo), has been added. It is used to return information about Ad Sources that are still loading (higher priced) and still bidding (unknown price) to the developer.\n\nThis callback may be triggered multiple times. It will be triggered again when a higher-priced Ad Source request succeeds.\nDevelopers can decide whether to continue waiting for the results of these Ad Sources based on their needs.\n\n1. Check Whether There Are Ad Sources Still Loading or Bidding\nYou can listen via the following code:\npublic class AdMultipleLoadedListener implements ATAdMultipleLoadedListener {\n\n \/**\n * The first triggering time occurs before the callback timing of the Ad Placement load success event. Afterwards, it will be triggered again when a higher-priced Ad Source request succeeds.\n * When the requestingInfo parameter is null, it indicates that there are no higher-priced Ad Sources still requesting, and no Ad Sources still bidding.\n * When the requestingInfo parameter is not null, you can call requestingInfo.getLoadingAdInfoList() to get the info of Ad Sources still loading (higher priced). It may return null.\n * When the requestingInfo parameter is not null, you can call requestingInfo.getBiddingAttemptAdInfoList() to get the info of Ad Sources still bidding (unknown price). It may return null.\n *\n *\/\n @Override\n public void onAdMultipleLoaded(ATRequestingInfo requestingInfo) {\n if (requestingInfo != null) {\n List loadingAdInfoList = requestingInfo.getLoadingAdInfoList();\n List biddingAttemptAdInfoList = requestingInfo.getBiddingAttemptAdInfoList();\n\n Log.i(TAG, \"onAdMultipleLoaded: loadingHigherPriceAdSize=\" + (loadingAdInfoList != null ? loadingAdInfoList.size() : 0) + \", \" + loadingAdInfoList\n + \"\\n\" + \"biddingAttemptAdSize=\" + (biddingAttemptAdInfoList != null ? biddingAttemptAdInfoList.size() : 0) + \", \" + biddingAttemptAdInfoList\n );\n } else {\n Log.i(TAG, \"onAdMultipleLoaded: loadingHigherPriceAdSize=0, biddingAttemptAdSize=0\");\n }\n }\n}\n\n\n\nmATRewardVideoAd().setAdMultipleLoadedListener(new AdMultipleLoadedListener());\/\/ Rewarded Video\n\/\/ mATInterstitial().setAdMultipleLoadedListener(new AdMultipleLoadedListener());\/\/ Interstitial Ad\n\/\/ mATSplashAd().setAdMultipleLoadedListener(new AdMultipleLoadedListener());\/\/ Splash Ad\n\/\/ mATBannerView().setAdMultipleLoadedListener(new AdMultipleLoadedListener());\/\/ Banner Ad\n\/\/ mATNative().setAdMultipleLoadedListener(new AdMultipleLoadedListener());\/\/ Native Ad\n\n\n2. Monitor the Results of Ad Sources Still Loading or Bidding\nWhen the developer needs to continue waiting for the results of Ad Source requests or bidding, set ATAdSourceStatusListener to listen.\nNote: For the ATAdInfo and ATAdSourceStatusListener mentioned in this document, please refer to Callback Info Description.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783477264","update_time":"1783477753"},"pure_content":"Instruction on Supporting Multiple Loaded Callbacks for Ad Placement Load Success Events\nStarting from v6.3.70, a new callback, ATAdMultipleLoadedListener#onAdMultipleLoaded(ATRequestingInfo requestin"},{"id":"76245","string_id":"mSFELh","status":"1","parent_id":"76230","slug":"WeChat-mini-program-support","order":"15","name":"WeChat mini program support","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722537","add_time":"1709721476","update_time":"1783478001","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76245","content":"**1.** Introduction\n-----\n\nWeChat ecosystem ad refers to an ad type where, after the user clicks on the ad, it redirects to WeChat to open scenarios such as Mini Programs\/Mini Games\/Official Accounts\/WeCom, with subsequent behavior conversions occurring within WeChat.\n\nAfter integrating WeChat ecosystem ads following the process below, ad fill rate and eCPM can be effectively improved.\n\n**2.** Overall Integration Process\n---------\n\n\u2460 Create an app on the WeChat Open Platform and obtain the WeChat Open Platform AppID.\n\n\u2461 Embed the WeChat OpenSDK in the app.\n\n\u2462 Associate the WeChat Open Platform App ID with the current app.\n\n**3.** Detailed Steps\n-------\n\n### 3.1 Create an App on the WeChat Open Platform\n\n\u2460 Developers register on the [WeChat Open Platform](https:\/\/open.weixin.qq.com\/) and create a main account and app (can be skipped if already created historically).\n\n\u2461 In the [WeChat Open Platform](https:\/\/open.weixin.qq.com\/) Management Center, obtain the WeChat Open Platform AppID corresponding to the app.\n\n![](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/7PYK3umn\/663c37d57dffb.png)\n----------------------------------------------------------------------------------------------\n\n### 3.2 Embed WeChat OpenSDK in the App\n\nEnsure that the OpenSDK version is Android 5.3.1 or above.\n\n```\nimplementation 'com.tencent.mm.opensdk:wechat-sdk-android:+'\n```\n\nFor detailed methods and resources for embedding OpenSDK, please refer to [Android Integration Guide | WeChat Open Docs](https:\/\/developers.weixin.qq.com\/doc\/oplatform\/Mobile_App\/Access_Guide\/Android.html).\n\n### 3.3 Associate the App with the WeChat Open Platform App ID\n\n\u2460 The WeChat Open Platform App ID for each ad platform can be set through Taku's **unified configuration**.\n\n\u2461 For some ad platforms, you need to go to the corresponding dashboard to associate.\n\n#### 3.3.1 Taku Unified Configuration Instructions\n\n**\u25cf For Taku SDK Version >= 6.3.50**\n\nIn the [Taku Developer Platform](https:\/\/app.takuad.com\/m\/app), under the [Apps] module, find the app that needs to be associated with the App ID, click Edit, and then bind the WeChat Open Platform AppID with the specified app.\n\nThe specific operation is as shown below:\n\n![](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/7PYK3umn\/663c752784dda.png)\n\n![](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/7PYK3umn\/663c3cae10842.png)\n\n> **Note:** If the WeChat Mini Program AppID has already been set via the Taku SDK API, the AppID set via the API will take precedence.\n\n**\u25cf For 6.1.50 <= Taku SDK Version < 6.3.50**\n\nBefore ad loading, you need to call the code to set the WeChat Mini Program AppID via the Taku SDK API:\n\n```\nATSDK.setWXAppId( \"Your Wechat AppId\")\n```\n\n**\u25cf For Taku SDK Version < 6.1.50**\n\nBefore ad loading, you need to call the code to set the WeChat Mini Program AppID via the Taku SDK API:\n\n```\nMap custommap = new HashMap();\ncustommap.put(ATAdConst.KEY.WECHAT_APPID, \"Your Wechat AppId\");\n....\n\/\/ The CustomMap with the WeChat AppId must be set before Initialization.\nATSDK.initCustomMap(custommap);\n```\n\n#### 3.3.2 Configuration Instructions for Each Ad Platform\n\nThe following is the configuration instructions for associating the WeChat Mini Program App ID for each ad platform.\n\n| Ad Platform | Network Version | Other Notes |\n|---|---|---|\n| Kuaishou | 3.3.26 | The Mini Program AppID needs to be provided to Kuaishou's operations or business personnel for configuration. |\n| Mintegral | 16.1.8 | Can set the WeChat Mini Program AppID through Taku's **unified configuration**. |\n| Pangle (China) | Historical versions already supported | The WeChat AppID needs to be entered in the Pangle (China) dashboard. [Android SDK Support for WeChat Mini Program\/Mini Game Redirect Integration Solution](https:\/\/www.csjplatform.com\/supportcenter\/26769) |\n| GDT | Historical versions already supported | The WeChat AppID needs to be entered in the Tencent dashboard. [Android Support for WeChat Ecosystem Link E-Commerce Ad Redirect Integration Solution](https:\/\/developers.adnet.qq.com\/doc\/android\/union\/union_appendix_game) |\n| YouKeYing | 2.9.0.9 | The WeChat AppID needs to be associated in the YouKeYing dashboard. |\n| Sigmob | 4.6.0 | The WeChat AppID needs to be associated in the Sigmob dashboard. |\n| Baidu | 9.231 | Can set the WeChat Mini Program AppID through Taku's **unified configuration**. |\n| Taku ADX | 6.1.50 | Can set the WeChat Mini Program AppID through Taku's **unified configuration**. |\n| VIVO | 6.1.5.1 | Can set the WeChat Mini Program AppID through Taku's **unified configuration**. |\n\n\n\n#### 3.3.3 MTG Import Notes\n\n\/\/ Starting from SDK version 16.1.7, MTG ads support Mini Program redirect functionality. The SDK for non-Google Play markets will automatically import OpenSDK.\n\n\/\/ If developers do not wish to use Mini Programs, they can exclude it using exclude. Example:\n\n```\nimplementation ('com.mbridge.msdk.oversea:${adType}:${sdkVersion}'){\n exclude group: \"com.tencent.mm.opensdk\", module: \"wechat-sdk-android\"\n}\n```\n\n\/\/ If using the Google Play market version of the SDK and you want to use the Mini Program redirect functionality, you can manually import OpenSDK.\n\n```\nimplementation 'com.tencent.mm.opensdk:wechat-sdk-android:+'\n```","pure_content":"1. Introduction\nWeChat ecosystem ad refers to an ad type where, after the user clicks on the ad, it redirects to WeChat to open scenarios such as Mini Programs\/Mini Games\/Official Accounts\/WeCom, with subsequent behavior conversions occurring within WeChat.\nAfter integrating WeChat ecosystem ads following the process below, ad fill rate and eCPM can be effectively improved.\n2. Overall Integration Process\n\u2460 Create an app on the WeChat Open Platform and obtain the WeChat Open Platform AppID.\n\u2461 Embed the WeChat OpenSDK in the app.\n\u2462 Associate the WeChat Open Platform App ID with the current app.\n3. Detailed Steps\n3.1 Create an App on the WeChat Open Platform\n\u2460 Developers register on the WeChat Open Platform and create a main account and app (can be skipped if already created historically).\n\u2461 In the WeChat Open Platform Management Center, obtain the WeChat Open Platform AppID corresponding to the app.\n\n3.2 Embed WeChat OpenSDK in the App\nEnsure that the OpenSDK version is Android 5.3.1 or above.\nimplementation 'com.tencent.mm.opensdk:wechat-sdk-android:+'\n\nFor detailed methods and resources for embedding OpenSDK, please refer to Android Integration Guide | WeChat Open Docs.\n3.3 Associate the App with the WeChat Open Platform App ID\n\u2460 The WeChat Open Platform App ID for each ad platform can be set through Taku's unified configuration.\n\u2461 For some ad platforms, you need to go to the corresponding dashboard to associate.\n3.3.1 Taku Unified Configuration Instructions\n\u25cf For Taku SDK Version >= 6.3.50\nIn the Taku Developer Platform, under the [Apps] module, find the app that needs to be associated with the App ID, click Edit, and then bind the WeChat Open Platform AppID with the specified app.\nThe specific operation is as shown below:\n\n\n\nNote: If the WeChat Mini Program AppID has already been set via the Taku SDK API, the AppID set via the API will take precedence.\n\n\u25cf For 6.1.50 \nBefore ad loading, you need to call the code to set the WeChat Mini Program AppID via the Taku SDK API:\nATSDK.setWXAppId( \"Your Wechat AppId\")\n\n\u25cf For Taku SDK Version \nBefore ad loading, you need to call the code to set the WeChat Mini Program AppID via the Taku SDK API:\nMap custommap = new HashMap();\ncustommap.put(ATAdConst.KEY.WECHAT_APPID, \"Your Wechat AppId\");\n....\n\/\/ The CustomMap with the WeChat AppId must be set before Initialization.\nATSDK.initCustomMap(custommap);\n\n3.3.2 Configuration Instructions for Each Ad Platform\nThe following is the configuration instructions for associating the WeChat Mini Program App ID for each ad platform.\n\n\n\n Ad Platform\n Network Version\n Other Notes\n\n\n\n\n Kuaishou\n 3.3.26\n The Mini Program AppID needs to be provided to Kuaishou's operations or business personnel for configuration.\n\n\n Mintegral\n 16.1.8\n Can set the WeChat Mini Program AppID through Taku's unified configuration.\n\n\n Pangle (China)\n Historical versions already supported\n The WeChat AppID needs to be entered in the Pangle (China) dashboard. Android SDK Support for WeChat Mini Program\/Mini Game Redirect Integration Solution\n\n\n GDT\n Historical versions already supported\n The WeChat AppID needs to be entered in the Tencent dashboard. Android Support for WeChat Ecosystem Link E-Commerce Ad Redirect Integration Solution\n\n\n YouKeYing\n 2.9.0.9\n The WeChat AppID needs to be associated in the YouKeYing dashboard.\n\n\n Sigmob\n 4.6.0\n The WeChat AppID needs to be associated in the Sigmob dashboard.\n\n\n Baidu\n 9.231\n Can set the WeChat Mini Program AppID through Taku's unified configuration.\n\n\n Taku ADX\n 6.1.50\n Can set the WeChat Mini Program AppID through Taku's unified configuration.\n\n\n VIVO\n 6.1.5.1\n Can set the WeChat Mini Program AppID through Taku's unified configuration.\n\n\n\n3.3.3 MTG Import Notes\n\/\/ Starting from SDK version 16.1.7, MTG ads support Mini Program redirect functionality. The SDK for non-Google Play markets will automatically import OpenSDK.\n\/\/ If developers do not wish to use Mini Programs, they can exclude it using exclude. Example:\nimplementation ('com.mbridge.msdk.oversea:${adType}:${sdkVersion}'){\n exclude group: \"com.tencent.mm.opensdk\", module: \"wechat-sdk-android\"\n}\n\n\/\/ If using the Google Play market version of the SDK and you want to use the Mini Program redirect functionality, you can manually import OpenSDK.\nimplementation 'com.tencent.mm.opensdk:wechat-sdk-android:+'","is_draft":"0","editor_type":"2","file_path":"","add_time":"1709721478","update_time":"1783051267"},"pure_content":"1. Introduction\nWeChat ecosystem ad refers to an ad type where, after the user clicks on the ad, it redirects to WeChat to open scenarios such as Mini Programs\/Mini Games\/Official Accounts\/WeCom, with"},{"id":"384255","string_id":"cQF58mpc","status":"1","parent_id":"76230","slug":"Advanced-Settings-qAE1","order":"14","name":"Advanced Settings","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1742374966","add_time":"1742374966","update_time":"1783478001","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"384255","content":"# Advanced Settings TaKu\n\n**Advanced Settings**\n\n## \u25cf Block requests from specific platforms\n\n> **\ud83d\udca1Tips**\n>\n> - Required TaKu SDK version: v6.3.40 and above\n> - Must be called before `load()`\n> - [**network\\_firm\\_id**](https:\/\/help.takuad.com\/en\/docs\/2KR6QU)\n The `custom platform id` can be obtained by clicking on custom platform in\n the [TaKu backend](https:\/\/app.takuad.com\/m\/network)\n\n### **\u25cf Global Dimension**\n\n```java\nList networkFirmIdList = new ArrayList<>();\n\/\/ Input the ids of the ad platforms you wish to block\n\/\/ networkFirmIdList.add(\"network_firm_id\");\n\n\/\/ Set to block requests from specific platform ids\nATSDK.setForbidNetworkFirmIdList(networkFirmIdList);\n```\n\n### **\u25cf Ad Placement Dimension**\n\n```java\nList networkFirmIdList = new ArrayList<>();\n\/\/ Input the ids of the ad platforms you wish to block\n\/\/ networkFirmIdList.add(\"network_firm_id\");\n\n\/\/ Set not to initiate requests for specific platforms\nATSDK.setFilterNetworkFirmIdList(\"your placement id\", networkFirmIdList);\n\n\/\/ Set to allow displays for specific platforms\nATSDK.setAllowedShowNetworkFirmIdList(\"your placement id\", networkFirmIdList);\n\n\/\/ Set not to display ads for specific platforms\nATSDK.setForbidShowNetworkFirmIdList(\"your placement id\", networkFirmIdList);\n\n-----------------------------------------------------------------------------------\n\nList adSourceIdList = new ArrayList<>();\n\/\/ Input the ids of the ad sources you wish to block\n\/\/ adSourceIdList.add(\"ad_source_id\");\n\n\/\/ Set not to initiate requests for specific ad sources\nATSDK.setFilterAdSourceIdList(\"your placement id\", adSourceIdList);\n\n```\n\n## \u25cf Mark Risky Devices\n\n> **\ud83d\udca1Tips**\n>\n> - Required TaKu SDK version: v6.4.60 and above\n>\n> ```java\n> \/**\n> * Mark risky devices to filter out certain ad platforms\n> * @param risk Risk flag (1=enable filtering, 0=disable filtering)\n> * @param networkFirmIdList Ad Network IDs\n> *\/\n> ATSDK.setRiskFilterNetworkFirmIdList(int risk, List networkFirmIdList);\n> ```\n>\n> - [Refer here for ad platform IDs](https:\/\/help.takuad.com\/en\/docs\/2KR6QU)\n\n```java\n\/\/ Example\n\/\/ Enable filtering and filter out requests from specific platforms\nATSDK.setRiskFilterNetworkFirmIdList(1, Arrays.asList(\"Network 1\", \"Network 2\"));\n\n\/\/ Enable filtering and filter out all Network requests\nATSDK.setRiskFilterNetworkFirmIdList(1, null);\n```\n\n## \u25cf Custom Filtering Rules\n\n> **\ud83d\udca1Tips**\n>\n> - Required TaKu SDK version: v6.4.60 and above\n>\n> ```java\n> \/**\n> * Add custom filtering rules for an ad placement\n> * @param placementId Ad placement ID\n> * @param filter Filter criteria object\n> *\/\n> ATSDK.putFilter(String placementId, ATAdFilter filter)\n> ```\n>\n> - [Refer here for ad platform IDs](https:\/\/help.takuad.com\/en\/docs\/2KR6QU)\n> - `filterNetworkIds`, `filterBidTypes`, `filterNetworkPlacementIds`,`filterAdPrice` can be combined into a filtering\n rule as needed\n>\n>\n> ```java\n> \/\/ Remove custom filtering rules for an ad placement\n> ATSDK.removeFilterWithPlacementId(\"your placement id\");\n> \n> \/\/ Remove all custom filtering rules\n> ATSDK.removeFilters();\n> ```\n\n**\u25cf Example 1**\n\n> **Filtering rule: the following conditions must be met together:**\n> 1. Network restriction\n> - Target Network IDs: Network 1, Network 2\n> 2. Bid type restriction\n> - Filter types: Bidding ads (C2S\/S2S) and non-bidding ads (NORMAL) (i.e., exclude both real-time bidding and\n non-bidding ad types)\n> 3. Restriction on ad placements of ad platforms\n> - Target Network's ad placement IDs: Ad placement 1, Ad placement 2 (corresponds to the NetworkPlacementId field of ad\n platforms)\n> 4. Price range restriction (**\u26a0\ufe0fIf you write the price range as \u226410 and \u226550, it will be considered invalid**)\n> - Currency unit: USD dollars\n> - Price range: \u226510 and \u226450\n\n```java\nATSDK.putFilter(\"your placement id\", new ATWaterfallFilter()\n .filterNetworkIds(Arrays.asList(\"Network 1\", \"Network 2\")) \/\/ Filtering out specified network ids\n .filterBidTypes(Arrays.asList(ATWaterfallFilter.NORMAL, ATWaterfallFilter.C2S, ATWaterfallFilter.S2S)) \/\/ Filtering out bidding and non-bidding types\n .filterNetworkPlacementIds(Arrays.asList(\"network placement id 1\", \"network placement id 2\")) \/\/ Filtering out specified ad placement ids of ad platforms\n .filterAdPrice(new ATWaterfallFilter.PriceInterval(ATAdConst.CURRENCY.USD) \/\/ Select currency unit, filtering out specified price range\n \/\/ The example below shows the filtered price range is [10, 50]\n .moreThanPrice(10) \/\/ Greater than or equal to 10\n .lessThanPrice(50) \/\/ Less than or equal to 50\n ) \n);\n```\n\n**\u25cf Example 2**\n\n> **Filtering rule: either Condition 1 or Condition 2 needs to be satisfied (\ud83d\udca1Use `.orFilter()` to connect each\ncondition)**\n>\n> Condition 1\n>\n> 1. Network restriction\n> - Target Network IDs: Network 1, Network 2\n> 2. Bid type restriction\n> - Filter types: Non-bidding ads (NORMAL)\n> 3. Restriction on ad placements of ad platforms\n> - Target Network's ad placement IDs: Ad placement 1, Ad placement 2 (corresponds to the NetworkPlacementId field of ad\n platforms)\n> 4. Price range restriction\n> - Currency unit: RMB_CENT Chinese yuan cents\n> - Price range: \u22645000\n>\n> Condition 2\n> 1. Network restriction\n> - Target Network IDs: Network 3\n> 2. Bid type restriction\n> - Filter types: Bidding ads (C2S\/S2S)\n> 3. Restriction on ad placements of ad platforms\n> - Target Network's ad placement IDs: Ad placement 1 (corresponds to the NetworkPlacementId field of ad platforms)\n> 4. Price range restriction\n> - Currency unit: RMB Chinese yuan\n> - Price range: \u226510\n\n```java\nATSDK.putFilter(\"your placement id\", new ATWaterfallFilter()\n \/\/ Condition 1\n .filterNetworkIds(Arrays.asList(\"Network 1\", \"Network 2\")) \/\/ Filtering out specified Network ids\n .filterBidTypes(Arrays.asList(ATWaterfallFilter.NORMAL)) \/\/ Filtering out non-bidding types\n .filterNetworkPlacementIds(Arrays.asList(\"network placement id 1\", \"network placement id 2\")) \/\/ Filtering out specified ad placement ids of ad platforms\n .filterAdPrice(new ATWaterfallFilter.PriceInterval(ATAdConst.CURRENCY.RMB_CENT) \/\/ Select currency unit RMB cents, filtering out specified price range\n .lessThanPrice(5000) \/\/ Less than or equal to 5000\n )\n .orFilter()\n \/\/ Condition 2\n .filterNetworkIds(Arrays.asList(\"Network 3\")) \/\/ Filtering out specified Network ids\n .filterBidTypes(Arrays.asList(ATWaterfallFilter.C2S, ATWaterfallFilter.S2S)) \/\/ Filtering out bidding types\n .filterNetworkPlacementIds(Arrays.asList(\"network placement id 1\")) \/\/ Filtering out specified ad placement ids of ad platforms\n .filterAdPrice(new ATWaterfallFilter.PriceInterval(ATAdConst.CURRENCY.RMB) \/\/ Select currency unit RMB, filtering out specified price range\n .moreThanPrice(10) \/\/ Greater than or equal to 10\n )\n);\n```","pure_content":"Advanced Settings TaKu\nAdvanced Settings\n\u25cf Block requests from specific platforms\n\n\ud83d\udca1Tips\n\nRequired TaKu SDK version: v6.3.40 and above\nMust be called before load()\n\n\nnetwork_firm_id\nThe custom platform id can be obtained by clicking on custom platform in\nthe TaKu backend\n\n\n\n\u25cf Global Dimension\nList networkFirmIdList = new ArrayList<>();\n\/\/ Input the ids of the ad platforms you wish to block\n\/\/ networkFirmIdList.add(\"network_firm_id\");\n\n\/\/ Set to block requests from specific platform ids\nATSDK.setForbidNetworkFirmIdList(networkFirmIdList);\n\n\u25cf Ad Placement Dimension\nList networkFirmIdList = new ArrayList<>();\n\/\/ Input the ids of the ad platforms you wish to block\n\/\/ networkFirmIdList.add(\"network_firm_id\");\n\n\/\/ Set not to initiate requests for specific platforms\nATSDK.setFilterNetworkFirmIdList(\"your placement id\", networkFirmIdList);\n\n\/\/ Set to allow displays for specific platforms\nATSDK.setAllowedShowNetworkFirmIdList(\"your placement id\", networkFirmIdList);\n\n\/\/ Set not to display ads for specific platforms\nATSDK.setForbidShowNetworkFirmIdList(\"your placement id\", networkFirmIdList);\n\n-----------------------------------------------------------------------------------\n\nList adSourceIdList = new ArrayList<>();\n\/\/ Input the ids of the ad sources you wish to block\n\/\/ adSourceIdList.add(\"ad_source_id\");\n\n\/\/ Set not to initiate requests for specific ad sources\nATSDK.setFilterAdSourceIdList(\"your placement id\", adSourceIdList);\n\n\n\u25cf Mark Risky Devices\n\n\ud83d\udca1Tips\n\nRequired TaKu SDK version: v6.4.60 and above\n\n\/**\n * Mark risky devices to filter out certain ad platforms\n * @param risk Risk flag (1=enable filtering, 0=disable filtering)\n * @param networkFirmIdList Ad Network IDs\n *\/\nATSDK.setRiskFilterNetworkFirmIdList(int risk, List networkFirmIdList);\n\n\n\nRefer here for ad platform IDs\n\n\n\n\/\/ Example\n\/\/ Enable filtering and filter out requests from specific platforms\nATSDK.setRiskFilterNetworkFirmIdList(1, Arrays.asList(\"Network 1\", \"Network 2\"));\n\n\/\/ Enable filtering and filter out all Network requests\nATSDK.setRiskFilterNetworkFirmIdList(1, null);\n\n\u25cf Custom Filtering Rules\n\n\ud83d\udca1Tips\n\nRequired TaKu SDK version: v6.4.60 and above\n\n\/**\n * Add custom filtering rules for an ad placement\n * @param placementId Ad placement ID\n * @param filter Filter criteria object\n *\/\nATSDK.putFilter(String placementId, ATAdFilter filter)\n\n\n\nRefer here for ad platform IDs\n\n\nfilterNetworkIds, filterBidTypes, filterNetworkPlacementIds,filterAdPrice can be combined into a filtering\nrule as needed\n\n\/\/ Remove custom filtering rules for an ad placement\nATSDK.removeFilterWithPlacementId(\"your placement id\");\n\n\/\/ Remove all custom filtering rules\nATSDK.removeFilters();\n\n\n\u25cf Example 1\n\nFiltering rule: the following conditions must be met together:\n\nNetwork restriction\n\n\nTarget Network IDs: Network 1, Network 2\n\n\nBid type restriction\n\n\nFilter types: Bidding ads (C2S\/S2S) and non-bidding ads (NORMAL) (i.e., exclude both real-time bidding and\nnon-bidding ad types)\n\n\nRestriction on ad placements of ad platforms\n\n\nTarget Network's ad placement IDs: Ad placement 1, Ad placement 2 (corresponds to the NetworkPlacementId field of ad\nplatforms)\n\n\nPrice range restriction (\u26a0\ufe0fIf you write the price range as \u226410 and \u226550, it will be considered invalid)\n\n\nCurrency unit: USD dollars\nPrice range: \u226510 and \u226450\n\n\nATSDK.putFilter(\"your placement id\", new ATWaterfallFilter()\n .filterNetworkIds(Arrays.asList(\"Network 1\", \"Network 2\")) \/\/ Filtering out specified network ids\n .filterBidTypes(Arrays.asList(ATWaterfallFilter.NORMAL, ATWaterfallFilter.C2S, ATWaterfallFilter.S2S)) \/\/ Filtering out bidding and non-bidding types\n .filterNetworkPlacementIds(Arrays.asList(\"network placement id 1\", \"network placement id 2\")) \/\/ Filtering out specified ad placement ids of ad platforms\n .filterAdPrice(new ATWaterfallFilter.PriceInterval(ATAdConst.CURRENCY.USD) \/\/ Select currency unit, filtering out specified price range\n \/\/ The example below shows the filtered price range is [10, 50]\n .moreThanPrice(10) \/\/ Greater than or equal to 10\n .lessThanPrice(50) \/\/ Less than or equal to 50\n ) \n);\n\n\u25cf Example 2\n\nFiltering rule: either Condition 1 or Condition 2 needs to be satisfied (\ud83d\udca1Use .orFilter() to connect each\ncondition)\nCondition 1\n\nNetwork restriction\n\n\nTarget Network IDs: Network 1, Network 2\n\n\nBid type restriction\n\n\nFilter types: Non-bidding ads (NORMAL)\n\n\nRestriction on ad placements of ad platforms\n\n\nTarget Network's ad placement IDs: Ad placement 1, Ad placement 2 (corresponds to the NetworkPlacementId field of ad\nplatforms)\n\n\nPrice range restriction\n\n\nCurrency unit: RMB_CENT Chinese yuan cents\nPrice range: \u22645000\n\nCondition 2\n\nNetwork restriction\n\n\nTarget Network IDs: Network 3\n\n\nBid type restriction\n\n\nFilter types: Bidding ads (C2S\/S2S)\n\n\nRestriction on ad placements of ad platforms\n\n\nTarget Network's ad placement IDs: Ad placement 1 (corresponds to the NetworkPlacementId field of ad platforms)\n\n\nPrice range restriction\n\n\nCurrency unit: RMB Chinese yuan\nPrice range: \u226510\n\n\nATSDK.putFilter(\"your placement id\", new ATWaterfallFilter()\n \/\/ Condition 1\n .filterNetworkIds(Arrays.asList(\"Network 1\", \"Network 2\")) \/\/ Filtering out specified Network ids\n .filterBidTypes(Arrays.asList(ATWaterfallFilter.NORMAL)) \/\/ Filtering out non-bidding types\n .filterNetworkPlacementIds(Arrays.asList(\"network placement id 1\", \"network placement id 2\")) \/\/ Filtering out specified ad placement ids of ad platforms\n .filterAdPrice(new ATWaterfallFilter.PriceInterval(ATAdConst.CURRENCY.RMB_CENT) \/\/ Select currency unit RMB cents, filtering out specified price range\n .lessThanPrice(5000) \/\/ Less than or equal to 5000\n )\n .orFilter()\n \/\/ Condition 2\n .filterNetworkIds(Arrays.asList(\"Network 3\")) \/\/ Filtering out specified Network ids\n .filterBidTypes(Arrays.asList(ATWaterfallFilter.C2S, ATWaterfallFilter.S2S)) \/\/ Filtering out bidding types\n .filterNetworkPlacementIds(Arrays.asList(\"network placement id 1\")) \/\/ Filtering out specified ad placement ids of ad platforms\n .filterAdPrice(new ATWaterfallFilter.PriceInterval(ATAdConst.CURRENCY.RMB) \/\/ Select currency unit RMB, filtering out specified price range\n .moreThanPrice(10) \/\/ Greater than or equal to 10\n )\n);","is_draft":"0","editor_type":"2","file_path":"","add_time":"1742374966","update_time":"1748605240"},"pure_content":"Advanced Settings TaKu\nAdvanced Settings\n\u25cf Block requests from specific platforms\n\n\ud83d\udca1Tips\n\nRequired TaKu SDK version: v6.3.40 and above\nMust be called before load()\n\n\nnetwork_firm_id\nThe custom platfor"},{"id":"863427","string_id":"myhkjegG","status":"1","parent_id":"76230","slug":"myhkjegG","order":"13","name":"One-Tap Mute","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783477970","add_time":"1783477932","update_time":"1783478001","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"863427","content":"**1**. One-Tap Mute Feature Description\n-----------\n\nYou can configure the volume of third-party ad SDKs to be muted with a single setting via code. This API takes effect in real time. It is recommended to call it before Initialization.\n\n> This feature is supported in SDK v6.5.15 and above. Friendly Reminder: Custom Adapter is not supported.\n\n**2.** Supported Scope\n-------\n\n| Platform | Supported Ad Formats |\n|---|---|\n| GDT | Native (Self-Rendering and Template), Interstitial, Rewarded |\n| Baidu | Native Self-Rendering and Native Video formats |\n| Kuaishou | Native Self-Rendering, Native Draw, Interstitial, Rewarded |\n| iQIYI | Native Self-Rendering, Native Template, Banner, Interstitial, Rewarded |\n| Meishu | Rewarded, Native Template |\n| VIVO | Native Self-Rendering, Banner, Splash, Interstitial, Rewarded |\n| Alibaba Tanx | Native Self-Rendering, Rewarded |\n| MTG | Native, Interstitial, Rewarded |\n| Meishu | Interstitial, Rewarded, Native |\n| Tanx | Rewarded, Native |\n\n**3.** Sample Code\n-------\n\n```\n\/\/ Supported in v6.5.15 and above. Call before SDK Initialization.\nATSDKGlobalSetting.setAdMuted(true);\n```\n\n\n\n\n\n\n\n> ### Notes\n> \n> - If the setAdMuted API is called, the API setting takes precedence. Setting it to true mutes the audio, and setting it to false unmutes it.\n> - If the setAdMuted API is not called and the Taku dashboard has a configuration, the Taku dashboard configuration takes precedence.","pure_content":"1. One-Tap Mute Feature Description\nYou can configure the volume of third-party ad SDKs to be muted with a single setting via code. This API takes effect in real time. It is recommended to call it before Initialization.\n\nThis feature is supported in SDK v6.5.15 and above. Friendly Reminder: Custom Adapter is not supported.\n\n2. Supported Scope\n\n\n\n Platform\n Supported Ad Formats\n\n\n\n\n GDT\n Native (Self-Rendering and Template), Interstitial, Rewarded\n\n\n Baidu\n Native Self-Rendering and Native Video formats\n\n\n Kuaishou\n Native Self-Rendering, Native Draw, Interstitial, Rewarded\n\n\n iQIYI\n Native Self-Rendering, Native Template, Banner, Interstitial, Rewarded\n\n\n Meishu\n Rewarded, Native Template\n\n\n VIVO\n Native Self-Rendering, Banner, Splash, Interstitial, Rewarded\n\n\n Alibaba Tanx\n Native Self-Rendering, Rewarded\n\n\n MTG\n Native, Interstitial, Rewarded\n\n\n Meishu\n Interstitial, Rewarded, Native\n\n\n Tanx\n Rewarded, Native\n\n\n\n3. Sample Code\n\/\/ Supported in v6.5.15 and above. Call before SDK Initialization.\nATSDKGlobalSetting.setAdMuted(true);\n\n\nNotes\n\nIf the setAdMuted API is called, the API setting takes precedence. Setting it to true mutes the audio, and setting it to false unmutes it.\nIf the setAdMuted API is not called and the Taku dashboard has a configuration, the Taku dashboard configuration takes precedence.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783477932","update_time":"1783477970"},"pure_content":"1. One-Tap Mute Feature Description\nYou can configure the volume of third-party ad SDKs to be muted with a single setting via code. This API takes effect in real time. It is recommended to call it bef"},{"id":"863428","string_id":"kYrG22p9","status":"1","parent_id":"76230","slug":"kYrG22p9","order":"12","name":"Multi-Instance Mode","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783478034","add_time":"1783477933","update_time":"1783478034","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"863428","content":"> **\ud83d\udca1Tips**\n> \n> - Taku SDK Version Requirement: v6.5.80 and above.\n> - Added ATAdCreateConfig constructor support for setting multi-instance request mode.\n> - Ad cache and ad object are associated at the instance dimension.\n\n#### Example\n\n```\n\/\/ Banner\nATBannerView mBannerView = new ATBannerView(this);\nmBannerView.setPlacementId(placementId, new ATAdCreateConfig.Builder().setMultiton(true).build());\n```\n\n```\n\/\/ Native\nATAdCreateConfig build = new ATAdCreateConfig.Builder().setMultiton(true).build();\nATNative mATNative = new ATNative(this, placementId, new ATNativeNetworkListener() {\n @Override\n public void onNativeAdLoaded() {\n \n }\n\n @Override\n public void onNativeAdLoadFail(AdError adError) {\n \n }\n }, build);\n```","pure_content":"\ud83d\udca1Tips\n\nTaku SDK Version Requirement: v6.5.80 and above.\nAdded ATAdCreateConfig constructor support for setting multi-instance request mode.\nAd cache and ad object are associated at the instance dimension.\n\n\nExample\n\/\/ Banner\nATBannerView mBannerView = new ATBannerView(this);\nmBannerView.setPlacementId(placementId, new ATAdCreateConfig.Builder().setMultiton(true).build());\n\n\/\/ Native\nATAdCreateConfig build = new ATAdCreateConfig.Builder().setMultiton(true).build();\nATNative mATNative = new ATNative(this, placementId, new ATNativeNetworkListener() {\n @Override\n public void onNativeAdLoaded() {\n \n }\n\n @Override\n public void onNativeAdLoadFail(AdError adError) {\n \n }\n }, build);","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783477933","update_time":"1783478034"},"pure_content":"\ud83d\udca1Tips\n\nTaku SDK Version Requirement: v6.5.80 and above.\nAdded ATAdCreateConfig constructor support for setting multi-instance request mode.\nAd cache and ad object are associated at the instance dimen"},{"id":"863429","string_id":"jD8K5cTG","status":"1","parent_id":"76230","slug":"jD8K5cTG","order":"11","name":"Baidu Two-Stage Reward","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783478026","add_time":"1783477935","update_time":"1783478026","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"863429","content":"> **\ud83d\udca1Tips**\n> \n> - Taku SDK Version Requirement: v6.5.70 and above.\n> - Baidu SDK Version Requirement: v9.432 and above.\n\n#### Example\n\n```\n\/\/ 1. When requesting an ad, pass in the Baidu RewardVideoRewardInfo object. \n Map localMap = new HashMap<>();\n localMap.put(ATAdConst.KEY.USER_ID, userid);\n localMap.put(ATAdConst.KEY.USER_CUSTOM_DATA, userdata);\n\n RewardVideoRewardInfo rewardInfo = RewardVideoRewardInfo.builder()\n \/\/ Select reward type, 1: Inflated Reward, 2: Doubled Reward\n .setRewardType(new Random().nextInt(2) + 1)\n \/\/ Basic reward value, enter a number, supports up to 5 digits\n .setBasicReward(\"9999\")\n \/\/ Basic reward unit, supports up to 3 characters\n .setBasicUnit(\"coins\")\n \/\/ Two-stage reward value, enter a number, supports up to 5 digits\n .setAdvancedReward(\"99999\")\n \/\/ Two-stage reward unit, supports up to 3 characters\n .setAdvancedUnit(\"coins\")\n \/\/ When the reward type is Doubled Reward, the reward multiplier needs to be entered\n .setMultiple(\"2\").create();\n\n localMap.put(BaiduATConst.BD_REWARD_INFO, rewardInfo);\n\n mRewardVideoAd.setLocalExtra(localMap);\n mRewardVideoAd.load();\n\n\/\/ 2. When the reward callback is received, rewardMap is the reward info returned by Baidu.\n @Override\n public void onReward(ATAdInfo entity) {\n if (entity.getNetworkFirmId() == BaiduATConst.NETWORK_FIRM_ID) {\n Map extInfoMap = entity.getExtInfoMap();\n if (extInfoMap != null){\n Object rewardInfoObj = extInfoMap.get(ATAdConst.REWARD_EXTRA.REWARD_INFO);\n if (rewardInfoObj instanceof Map) {\n Map rewardMap = (Map) rewardInfoObj;\n }\n }\n }\n\n }\n```","pure_content":"\ud83d\udca1Tips\n\nTaku SDK Version Requirement: v6.5.70 and above.\nBaidu SDK Version Requirement: v9.432 and above.\n\n\nExample\n\/\/ 1. When requesting an ad, pass in the Baidu RewardVideoRewardInfo object. \n Map localMap = new HashMap();\n localMap.put(ATAdConst.KEY.USER_ID, userid);\n localMap.put(ATAdConst.KEY.USER_CUSTOM_DATA, userdata);\n\n RewardVideoRewardInfo rewardInfo = RewardVideoRewardInfo.builder()\n \/\/ Select reward type, 1: Inflated Reward, 2: Doubled Reward\n .setRewardType(new Random().nextInt(2) + 1)\n \/\/ Basic reward value, enter a number, supports up to 5 digits\n .setBasicReward(\"9999\")\n \/\/ Basic reward unit, supports up to 3 characters\n .setBasicUnit(\"coins\")\n \/\/ Two-stage reward value, enter a number, supports up to 5 digits\n .setAdvancedReward(\"99999\")\n \/\/ Two-stage reward unit, supports up to 3 characters\n .setAdvancedUnit(\"coins\")\n \/\/ When the reward type is Doubled Reward, the reward multiplier needs to be entered\n .setMultiple(\"2\").create();\n\n localMap.put(BaiduATConst.BD_REWARD_INFO, rewardInfo);\n\n mRewardVideoAd.setLocalExtra(localMap);\n mRewardVideoAd.load();\n\n\/\/ 2. When the reward callback is received, rewardMap is the reward info returned by Baidu.\n @Override\n public void onReward(ATAdInfo entity) {\n if (entity.getNetworkFirmId() == BaiduATConst.NETWORK_FIRM_ID) {\n Map extInfoMap = entity.getExtInfoMap();\n if (extInfoMap != null){\n Object rewardInfoObj = extInfoMap.get(ATAdConst.REWARD_EXTRA.REWARD_INFO);\n if (rewardInfoObj instanceof Map) {\n Map rewardMap = (Map) rewardInfoObj;\n }\n }\n }\n\n }","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783477935","update_time":"1783478026"},"pure_content":"\ud83d\udca1Tips\n\nTaku SDK Version Requirement: v6.5.70 and above.\nBaidu SDK Version Requirement: v9.432 and above.\n\n\nExample\n\/\/ 1. When requesting an ad, pass in the Baidu RewardVideoRewardInfo object."}],"content":{"icon":"","desc":"","content_id":"76230","add_time":"1709721447","update_time":"1709722533","content":"","is_traffic_less":"0","file_type":""},"hot_list":[],"user_read_num":"0","is_auth":"0"},"msg":"Success","code":200}