{"data":{"id":"68407","string_id":"vAMKgN","status":"1","parent_id":"68373","slug":"t6Xeoq","order":"4","name":"Advanced","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"","published_time":"1707211442","add_time":"1707205586","update_time":"1783493558","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","tags":[],"parent_name":"SDK Integration Guides","parent_type":"1","parent_slug":"cUkkAX","child":[{"id":"162901","string_id":"BoeaE4lM","status":"1","parent_id":"68407","slug":"Fully-automatic-loading-F6tB","order":"11","name":"Fully automatic loading","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"Fully automatic loading","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1727681118","add_time":"1726119317","update_time":"1783502107","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"162901","content":"# Rewarded Video Ad\n\n## 1. Integration Suggestions\n\n### \u25cf Ad Loading\n\n

\n\n> * If the Ad Placement is set to Auto Load, you **do not need** to call the `ATRewardVideoAd#load()` method to load the ad\n> * We recommend initializing the auto-load Rewarded Video ad on the main page\n> * The **context** of `ATRewardVideoAutoAd#init()` must be an **Activity**, to avoid loading failures on some platforms\n\n<\/div>\n\n

\n\n> * If the Ad Placement is set to Auto Load, you **do not need** to call the `TURewardVideoAd#load()` method to load the ad\n> * We recommend initializing the auto-load Rewarded Video ad on the main page\n> * The **context** of `TURewardVideoAutoAd#init()` must be an **Activity**, to avoid loading failures on some platforms\n\n<\/div>\n\n### \u25cf Ad Display\n\n> * Before displaying, check whether `isAdReady()` is ready. Once ready, call `show()` to display the ad; if not ready, start loading the ad and wait for the load to succeed;\n> * Before displaying, first check whether **the app is in the foreground**. Calling `show()` while in the background may cause the ad to be displayed outside the app or fail to display properly;\n> * The auto-load Rewarded Video implements the auto-load logic internally, so avoid displaying the ad directly in the `onRewardVideoAutoLoaded` callback\n\n### \u25cf Server-Side Callback\n\n> * Auto-load Rewarded Video supports the server-side callback (S2S) reward delivery mechanism, and also supports the server-side callback feature of each ad platform. Please refer to [Rewarded Video Server-Side Reward (S2S) Guide](https:\/\/help.toponad.net\/cn\/docs\/msbnkj)\n\n\n## 2. Load an Ad\n\n

\n\n```java\n\/\/--------------------- Method 1 -------------------------\n\/\/Pass in the Ad Placement id directly during initialization; one or more ids are supported.\nString[] placementIdArr = new String[]{\"your placementId_1 \", \"your placementId_2\"};\n\/\/If you need to set the server-side callback localExtra info, make sure to do it before ATRewardVideoAutoAd.init()\nsetPlacementIdLocalExtra(placementIdArr);\nATRewardVideoAutoAd.init(activity, placementIdArr, new ATRewardVideoAutoLoadListener() {\n @Override\n public void onRewardVideoAutoLoaded(String placementId) {}\n\n @Override\n public void onRewardVideoAutoLoadFail(String placementId, AdError adError) {}\n});\n\/\/--------------------- Method 1 -------------------------\n\n\/\/--------------------- Method 2 -------------------------\n\/\/Initialize first, then pass in the Ad Placement id; one or more ids are supported\nString[] placementIdArr = new String[]{\"your placementId_1 \", \"your placementId_2\"};\n\/\/If you need to set the server-side callback localExtra info, make sure to do it before ATRewardVideoAutoAd.init()\nsetPlacementIdLocalExtra(placementIdArr);\nATRewardVideoAutoAd.init(activity, null, new ATRewardVideoAutoLoadListener() {\n @Override\n public void onRewardVideoAutoLoaded(String placementId) {}\n @Override\n public void onRewardVideoAutoLoadFail(String placementId, AdError adError) {}\n});\n\/\/addPlacementId() must be called after ATRewardVideoAutoAd.init()\nATRewardVideoAutoAd.addPlacementId(placementIdArr);\n\/\/--------------------- Method 2 -------------------------\n\n\/\/Set the server-side callback localExtra info\nprivate void setPlacementIdLocalExtra(String... placementIdArr) {\n for (String placementId : placementIdArr) {\n String userid = \"test_userid_001\";\n String userdata = \"test_userdata_001\";\n Map localMap = new HashMap<>();\n localMap.put(ATAdConst.KEY.USER_ID, userid);\n localMap.put(ATAdConst.KEY.USER_CUSTOM_DATA, userdata);\n \/\/Takes effect from the next ad load\n ATRewardVideoAutoAd.setLocalExtra(placementId, localMap);\n }\n}\n```\n\n<\/div>\n\n

\n\n```java\n\/\/--------------------- Method 1 -------------------------\n\/\/Pass in the Ad Placement id directly during initialization; one or more ids are supported.\nString[] placementIdArr = new String[]{\"your placementId_1 \", \"your placementId_2\"};\n\/\/If you need to set the server-side callback localExtra info, make sure to do it before TURewardVideoAutoAd.init()\nsetPlacementIdLocalExtra(placementIdArr);\nTURewardVideoAutoAd.init(activity, placementIdArr, new TURewardVideoAutoLoadListener() {\n @Override\n public void onRewardVideoAutoLoaded(String placementId) {}\n\n @Override\n public void onRewardVideoAutoLoadFail(String placementId, AdError adError) {}\n});\n\/\/--------------------- Method 1 -------------------------\n\n\/\/--------------------- Method 2 -------------------------\n\/\/Initialize first, then pass in the Ad Placement id; one or more ids are supported\nString[] placementIdArr = new String[]{\"your placementId_1 \", \"your placementId_2\"};\n\/\/If you need to set the server-side callback localExtra info, make sure to do it before TURewardVideoAutoAd.init()\nsetPlacementIdLocalExtra(placementIdArr);\nTURewardVideoAutoAd.init(activity, null, new TURewardVideoAutoLoadListener() {\n @Override\n public void onRewardVideoAutoLoaded(String placementId) {}\n @Override\n public void onRewardVideoAutoLoadFail(String placementId, AdError adError) {}\n});\n\/\/addPlacementId() must be called after TURewardVideoAutoAd.init()\nTURewardVideoAutoAd.addPlacementId(placementIdArr);\n\/\/--------------------- Method 2 -------------------------\n\n\/\/Set the server-side callback localExtra info\nprivate void setPlacementIdLocalExtra(String... placementIdArr) {\n for (String placementId : placementIdArr) {\n String userid = \"test_userid_001\";\n String userdata = \"test_userdata_001\";\n Map localMap = new HashMap<>();\n localMap.put(TUAdConst.KEY.USER_ID, userid);\n localMap.put(TUAdConst.KEY.USER_CUSTOM_DATA, userdata);\n \/\/Takes effect from the next ad load\n TURewardVideoAutoAd.setLocalExtra(placementId, localMap);\n }\n}\n```\n\n<\/div>\n\n> **Note:**\n>\n> * If the Ad Placement IDs are the same, both `init()` and `addPlacementId()` only need to be called once.\n\n\n## 3. Show the Ad\n\n

\n\n```java\nATRewardVideoAutoAd.show(activity, \"your placement id\", new ATRewardVideoAutoEventListener() {\n @Override\n public void onRewardedVideoAdPlayStart(ATAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdPlayEnd(ATAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdPlayFailed(AdError adError, ATAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdClosed(ATAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdPlayClicked(ATAdInfo adInfo) {}\n \n @Override\n public void onReward(ATAdInfo adInfo) {}\n});\n```\n\n<\/div>\n\n

\n\n```java\nTURewardVideoAutoAd.show(activity, \"your placement id\", new TURewardVideoAutoEventListener() {\n @Override\n public void onRewardedVideoAdPlayStart(TUAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdPlayEnd(TUAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdPlayFailed(AdError adError, TUAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdClosed(TUAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdPlayClicked(TUAdInfo adInfo) {}\n \n @Override\n public void onReward(TUAdInfo adInfo) {}\n});\n```\n\n<\/div>\n\n## 4. API Reference\n\n

\n\n\u25cf ATRewardVideoAutoAd\n> Operation class for loading and displaying auto-load Rewarded Video ads\n\n| Method | Description |\n| :-- | --- |\n| void init(Context context, String[] placementIds, [ATRewardVideoAutoLoadListener](https:\/\/help.toponad.net\/cn\/docs\/ji-li-shi-pin-guang-gao-quan-zi-dong-jia-zai#%E2%97%8FATRewardVideoAutoLoadListener) loadListener) | Initialization method for the auto-load Rewarded Video ad; after initialization, it automatically starts loading ads for the specified Ad Placements <\/br>context: an activity is recommended <\/br>placementIds: Ad Placement IDs to enable Auto Load (you may pass null first and later call `addPlacementId()` to pass the Ad Placement IDs) <\/br>loadListener: ad fill callback |\n| void addPlacementId(String... placementIds) | Set multiple auto-load Rewarded Video Ad Placement ids for auto loading <\/br>placementIds: Ad Placement IDs to be auto-loaded |\n| void removePlacementId(String... placementIds) | Cancel auto loading for multiple auto-load Rewarded Video Ad Placement ids <\/br>placementIds: Ad Placement IDs that no longer need to be auto-loaded |\n| void setLocalExtra(String placementId, Map localExtra) | Set local parameters for the specified Ad Placement <\/br>placementId: Ad Placement ID <\/br>localExtra: local parameters, whose keys are obtained via **AdConst.KEY** |\n| boolean isAdReady(String placementId) | Determine whether the Ad Placement has an ad available to display <\/br>placementId: Ad Placement ID to query |\n| void show(Activity activity, String placementId, [ATRewardVideoAutoEventListener](https:\/\/help.toponad.net\/cn\/docs\/ji-li-shi-pin-guang-gao-quan-zi-dong-jia-zai#%E2%97%8F_ATRewardVideoAutoEventListener) eventListener) | Display the Rewarded Video ad of this Ad Placement <\/br>activity: the Activity that displays the ad <\/br>placementId: Ad Placement ID to display <\/br>eventListener: Rewarded Video ad display and reward callback |\n| void show(Activity activity, String placementId, ATShowConfig showConfig, ATRewardVideoAutoEventListener eventListener) | Display the Rewarded Video ad of this Ad Placement <\/br>activity: the Activity that displays the ad <\/br>placementId: Ad Placement ID to display <\/br>showConfig: ad display configuration, including custom parameters and the Ad Scenario <\/br>eventListener: Rewarded Video ad display and reward callback |\n\n\n\u25cf ATRewardVideoAutoLoadListener\n> Callback listener for auto-load Rewarded Video ad loading events\n\n| Method | Description |\n| --- | --- |\n| void onRewardVideoAutoLoaded(String placementId) | Callback for a successful ad load of the corresponding Ad Placement <\/br>placementId: the corresponding Ad Placement ID |\n| void onRewardVideoAutoLoadFail(String placementId, AdError errorCode) | Callback for a failed ad load of the corresponding Ad Placement <\/br>placementId: Ad Placement ID <\/br>errorCode: ad load failure info |\n\n\n\u25cf ATRewardVideoAutoEventListener\n> Callback listener for auto-load Rewarded Video ad display events\n\n| Method | Description |\n| --- | --- |\n| void onRewardedVideoAdPlayStart([ATAdInfo](https:\/\/help.toponad.net\/docs\/Callback-Information-cAVk) adInfo) | Callback when the ad starts playing (i.e. the Rewarded Video impression callback) <\/br>adInfo: ad info object |\n| void onRewardedVideoAdPlayEnd(ATAdInfo adInfo) | Callback when the ad finishes playing <\/br>adInfo: ad info object |\n| void onRewardedVideoAdPlayFailed(AdError adError, ATAdInfo adInfo) | Callback when the ad fails to play <\/br>adError: ad info object <\/br>adInfo: ad display failure info |\n| void onReward(ATAdInfo adInfo) | This callback is triggered when the reward is delivered. **We recommend that developers deliver the reward in this callback, which is generally called before onRewardedVideoAdClosed** <\/br>adInfo: ad info object |\n| void onRewardedVideoAdClosed(ATAdInfo adInfo) | Ad close callback <\/br>adInfo: ad info object |\n| void onRewardedVideoAdPlayClicked(ATAdInfo adInfo) | Ad click <\/br>adInfo: ad info object |\n| void onDeeplinkCallback(ATAdInfo adInfo, boolean isSuccess) | deeplink callback, for Adx and OnlineApi ads <\/br>adInfo: ad info object <\/br>isSuccess: whether it succeeded, true = success, false = failure |\n\n<\/div>\n\n

\n\n\u25cf TURewardVideoAutoAd\n> Operation class for loading and displaying auto-load Rewarded Video ads\n\n| Method | Description |\n| :-- | --- |\n| void init(Context context, String[] placementIds, [TURewardVideoAutoLoadListener](https:\/\/help.toponad.net\/cn\/docs\/ji-li-shi-pin-guang-gao-quan-zi-dong-jia-zai#%E2%97%8FTURewardVideoAutoLoadListener) loadListener) | Initialization method for the auto-load Rewarded Video ad; after initialization, it automatically starts loading ads for the specified Ad Placements <\/br>context: an activity is recommended <\/br>placementIds: Ad Placement IDs to enable Auto Load (you may pass null first and later call `addPlacementId()` to pass the Ad Placement IDs) <\/br>loadListener: ad fill callback |\n| void addPlacementId(String... placementIds) | Set multiple auto-load Rewarded Video Ad Placement ids for auto loading <\/br>placementIds: Ad Placement IDs to be auto-loaded |\n| void removePlacementId(String... placementIds) | Cancel auto loading for multiple auto-load Rewarded Video Ad Placement ids <\/br>placementIds: Ad Placement IDs that no longer need to be auto-loaded |\n| void setLocalExtra(String placementId, Map localExtra) | Set local parameters for the specified Ad Placement <\/br>placementId: Ad Placement ID <\/br>localExtra: local parameters, whose keys are obtained via **TUAdConst.KEY** |\n| boolean isAdReady(String placementId) | Determine whether the Ad Placement has an ad available to display <\/br>placementId: Ad Placement ID to query |\n| void show(Activity activity, String placementId, [TURewardVideoAutoEventListener](https:\/\/help.toponad.net\/cn\/docs\/ji-li-shi-pin-guang-gao-quan-zi-dong-jia-zai#%E2%97%8F_TURewardVideoAutoEventListener) eventListener) | Display the Rewarded Video ad of this Ad Placement <\/br>activity: the Activity that displays the ad <\/br>placementId: Ad Placement ID to display <\/br>eventListener: Rewarded Video ad display and reward callback |\n| void show(Activity activity, String placementId, TUShowConfig showConfig, TURewardVideoAutoEventListener eventListener) | Display the Rewarded Video ad of this Ad Placement <\/br>activity: the Activity that displays the ad <\/br>placementId: Ad Placement ID to display <\/br>showConfig: ad display configuration, including custom parameters and the Ad Scenario <\/br>eventListener: Rewarded Video ad display and reward callback |\n\n\n\u25cf TURewardVideoAutoLoadListener\n> Callback listener for auto-load Rewarded Video ad loading events\n\n| Method | Description |\n| --- | --- |\n| void onRewardVideoAutoLoaded(String placementId) | Callback for a successful ad load of the corresponding Ad Placement <\/br>placementId: the corresponding Ad Placement ID |\n| void onRewardVideoAutoLoadFail(String placementId, AdError errorCode) | Callback for a failed ad load of the corresponding Ad Placement <\/br>placementId: Ad Placement ID <\/br>errorCode: ad load failure info |\n\n\n\u25cf TURewardVideoAutoEventListener\n> Callback listener for auto-load Rewarded Video ad display events\n\n| Method | Description |\n| --- | --- |\n| void onRewardedVideoAdPlayStart([TUAdInfo](https:\/\/help.toponad.net\/docs\/Callback-Information-cAVk) adInfo) | Callback when the ad starts playing (i.e. the Rewarded Video impression callback) <\/br>adInfo: ad info object |\n| void onRewardedVideoAdPlayEnd(TUAdInfo adInfo) | Callback when the ad finishes playing <\/br>adInfo: ad info object |\n| void onRewardedVideoAdPlayFailed(AdError adError, TUAdInfo adInfo) | Callback when the ad fails to play <\/br>adError: ad info object <\/br>adInfo: ad display failure info |\n| void onReward(TUAdInfo adInfo) | This callback is triggered when the reward is delivered. **We recommend that developers deliver the reward in this callback, which is generally called before onRewardedVideoAdClosed** <\/br>adInfo: ad info object |\n| void onRewardedVideoAdClosed(TUAdInfo adInfo) | Ad close callback <\/br>adInfo: ad info object |\n| void onRewardedVideoAdPlayClicked(TUAdInfo adInfo) | Ad click <\/br>adInfo: ad info object |\n| void onDeeplinkCallback(TUAdInfo adInfo, boolean isSuccess) | deeplink callback, for Adx and OnlineApi ads <\/br>adInfo: ad info object <\/br>isSuccess: whether it succeeded, true = success, false = failure |\n\n<\/div>\n\n---\n\n## 5. Demo Reference\n\nCode example: [Demo](https:\/\/github.com\/toponteam\/TPN-Android-Demo)RewardVideoAdActivity\n\n---\n\n# Interstitial Ad\n\n## 1. Integration Suggestions\n\n### \u25cf Ad Loading\n\n

\n\n> * If the Ad Placement is set to Auto Load, do not call the `ATInterstitial#load()` method to load the ad\n> * We recommend initializing the auto-load Rewarded Video ad on the main page\n> * The **context** of `ATInterstitialAutoAd#init()` must be an **Activity**, to avoid loading failures on some platforms\n\n<\/div>\n\n

\n\n> * If the Ad Placement is set to Auto Load, do not call the `TUInterstitial#load()` method to load the ad\n> * We recommend initializing the auto-load Rewarded Video ad on the main page\n> * The **context** of `TUInterstitialAutoAd#init()` must be an **Activity**, to avoid loading failures on some platforms\n\n<\/div>\n\n### \u25cf Ad Display\n\n> * Before displaying, check whether `isAdReady()` is ready. Once ready, call `show()` to display the ad; if not ready, start loading the ad and wait for the load to succeed;\n> * Before displaying, first check whether **the app is in the foreground**. Calling `show()` while in the background may cause the ad to be displayed outside the app or fail to display properly;\n> * The auto-load Interstitial implements the auto-load logic internally, so avoid displaying the ad directly in the `onInterstitialAutoLoaded()` callback\n\n\n## 2. Load an Ad\n\n

\n\n```java\nATInterstitialAutoAd.show(activity, \"your placement id\", new ATInterstitialAutoEventListener() {\n @Override\n public void onInterstitialAdShow(ATAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdVideoStart(ATAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdVideoEnd(ATAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdVideoError(AdError adError) {}\n \n @Override\n public void onInterstitialAdClose(ATAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdClicked(ATAdInfo adInfo) {}\n});\n```\n<\/div>\n\n

\n\n```java\nTUInterstitialAutoAd.show(activity, \"your placement id\", new TUInterstitialAutoEventListener() {\n @Override\n public void onInterstitialAdShow(TUAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdVideoStart(TUAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdVideoEnd(TUAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdVideoError(AdError adError) {}\n \n @Override\n public void onInterstitialAdClose(TUAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdClicked(TUAdInfo adInfo) {}\n});\n```\n\n<\/div>\n\n## 4. API Reference\n\n

\n\n\u25cf ATInterstitialAutoAd\n\n> Operation class for loading and displaying auto-load Interstitial ads\n\n| Method | Description |\n| ------------------------------------------------------------ | ------------------------------------------------------------ |\n| void init(Context context, String[] placementIds, [ATInterstitialAutoLoadListener](https:\/\/help.toponad.net\/cn\/docs\/cha-ping-guang-gao-quan-zi-dong-jia-zai#%E2%97%8FATInterstitialAutoLoadListener) loadListener) | Initialization method for the auto-load Interstitial ad; after initialization, it automatically starts loading ads for the specified Ad Placements <\/br>context: an activity is recommended <\/br>placementIds: Ad Placement IDs to enable Auto Load (you may pass null first and later call `addPlacementId()` to pass the Ad Placement ids) <\/br>loadListener: ad fill callback |\n| void addPlacementId(String... placementIds) | Set multiple auto-load Interstitial Ad Placement ids for auto loading <\/br>placementIds: Ad Placement IDs to be auto-loaded |\n| void removePlacementId(String... placementIds) | Cancel auto loading for multiple auto-load Interstitial Ad Placement ids <\/br>placementIds: Ad Placement IDs that no longer need to be auto-loaded |\n| void setLocalExtra(String placementId, Map localExtra) | Set custom parameters for the specified Ad Placement <\/br>placementId: Ad Placement ID <\/br>localExtra: custom parameters, whose keys are obtained via **ATAdConst.KEY** |\n| boolean isAdReady(String placementId) | Determine whether the Ad Placement has an ad available to display <\/br>placementId: Ad Placement ID to query |\n| void show(Activity activity, String placementId, [ATInterstitialAutoEventListener](https:\/\/help.toponad.net\/cn\/docs\/cha-ping-guang-gao-quan-zi-dong-jia-zai#%E2%97%8FATInterstitialAutoEventListener) eventListener) | Display the Interstitial ad of this Ad Placement <\/br>activity: the Activity that displays the ad <\/br>placementId: Ad Placement ID to display <\/br>eventListener: Interstitial ad display callback |\n| void show(Activity activity, String placementId, ATShowConfig showConfig, ATInterstitialAutoEventListener eventListener) | Display the Interstitial ad of this Ad Placement <\/br>activity: the Activity that displays the ad <\/br>placementId: Ad Placement ID to display <\/br>showConfig: ad display configuration, including custom parameters and the Ad Scenario <\/br>eventListener: Interstitial ad display callback |\n\n\n\u25cf ATInterstitialAutoLoadListener\n> Callback listener for auto-load Interstitial ad loading events\n\n| Method | Description |\n| ------------------------------------------------------------ | ------------------------------------------------------------ |\n| void onInterstitialAutoLoaded(String placementId) | Callback for a successful ad load of the corresponding Ad Placement <\/br>placementId: the corresponding Ad Placement ID |\n| void onInterstitialAutoLoadFail(String placementId, AdError adError) | Callback for a failed ad load of the corresponding Ad Placement <\/br>placementId: Ad Placement ID <\/br>adError: ad load failure info |\n\n\n\u25cf ATInterstitialAutoEventListener\n> Callback listener for auto-load Interstitial ad display events\n\n| Method | Description |\n| ------------------------------------------------------------ | ------------------------------------------------------------ |\n| void onInterstitialAdShow([ATAdInfo](https:\/\/help.toponad.net\/cn\/docs\/hui-diao-xin-xi-shuo-ming#1._ATAdInfo) adInfo) | Ad display callback <\/br>adInfo: ad info object |\n| void onInterstitialAdVideoStart(ATAdInfo adInfo) | Callback when the video ad starts playing <\/br>adInfo: ad info object |\n| void onInterstitialAdVideoAdPlayEnd(ATAdInfo adInfo) | Callback when the ad finishes playing <\/br>adInfo: ad info object |\n| void onInterstitialAdVideoError(AdError adError) | Ad display failure callback <\/br>adError: ad display failure info |\n| void onInterstitialAdClose(ATAdInfo adInfo) | Ad close callback <\/br>adInfo: ad info object |\n| void onInterstitialAdClicked(ATAdInfo adInfo) | Ad click <\/br>adInfo: ad info object |\n| void onDeeplinkCallback(ATAdInfo adInfo, boolean isSuccess) | deeplink callback, for Adx and Online API ads <\/br>adInfo: ad info object <\/br>isSuccess: whether it succeeded, true = success, false = failure |\n\n<\/div>\n\n

\n\n\u25cf TUInterstitialAutoAd\n\n> Operation class for loading and displaying auto-load Interstitial ads\n\n| Method | Description |\n| ------------------------------------------------------------ | ------------------------------------------------------------ |\n| void init(Context context, String[] placementIds, [TUInterstitialAutoLoadListener](https:\/\/help.toponad.net\/cn\/docs\/cha-ping-guang-gao-quan-zi-dong-jia-zai#%E2%97%8FTUInterstitialAutoLoadListener) loadListener) | Initialization method for the auto-load Interstitial ad; after initialization, it automatically starts loading ads for the specified Ad Placements <\/br>context: an activity is recommended <\/br>placementIds: Ad Placement IDs to enable Auto Load (you may pass null first and later call `addPlacementId()` to pass the Ad Placement ids) <\/br>loadListener: ad fill callback |\n| void addPlacementId(String... placementIds) | Set multiple auto-load Interstitial Ad Placement ids for auto loading <\/br>placementIds: Ad Placement IDs to be auto-loaded |\n| void removePlacementId(String... placementIds) | Cancel auto loading for multiple auto-load Interstitial Ad Placement ids <\/br>placementIds: Ad Placement IDs that no longer need to be auto-loaded |\n| void setLocalExtra(String placementId, Map localExtra) | Set custom parameters for the specified Ad Placement <\/br>placementId: Ad Placement ID <\/br>localExtra: custom parameters, whose keys are obtained via **TUAdConst.KEY** |\n| boolean isAdReady(String placementId) | Determine whether the Ad Placement has an ad available to display <\/br>placementId: Ad Placement ID to query |\n| void show(Activity activity, String placementId, [TUInterstitialAutoEventListener](https:\/\/help.toponad.net\/cn\/docs\/cha-ping-guang-gao-quan-zi-dong-jia-zai#%E2%97%8FTUInterstitialAutoEventListener) eventListener) | Display the Interstitial ad of this Ad Placement <\/br>activity: the Activity that displays the ad placementId: Ad Placement ID to display <\/br>eventListener: Interstitial ad display callback |\n| void show(Activity activity, String placementId, TUShowConfig showConfig, TUInterstitialAutoEventListener eventListener) | Display the Interstitial ad of this Ad Placement <\/br>activity: the Activity that displays the ad <\/br>placementId: Ad Placement ID to display <\/br>showConfig: ad display configuration, including custom parameters and the Ad Scenario <\/br>eventListener: Interstitial ad display callback |\n\n\n\u25cf TUInterstitialAutoLoadListener\n> Callback listener for auto-load Interstitial ad loading events\n\n| Method | Description |\n| ------------------------------------------------------------ | ------------------------------------------------------------ |\n| void onInterstitialAutoLoaded(String placementId) | Callback for a successful ad load of the corresponding Ad Placement <\/br>placementId: the corresponding Ad Placement ID |\n| void onInterstitialAutoLoadFail(String placementId, AdError adError) | Callback for a failed ad load of the corresponding Ad Placement <\/br>placementId: Ad Placement ID <\/br>adError: ad load failure info |\n\n\n\u25cf TUInterstitialAutoEventListener\n> Callback listener for auto-load Interstitial ad display events\n\n| Method | Description |\n| ------------------------------------------------------------ | ------------------------------------------------------------ |\n| void onInterstitialAdShow([TUAdInfo](https:\/\/help.toponad.net\/docs\/Callback-Information-cAVk) adInfo) | Ad display callback adInfo: ad info object |\n| void onInterstitialAdVideoStart(TUAdInfo adInfo) | Callback when the video ad starts playing <\/br>adInfo: ad info object |\n| void onInterstitialAdVideoAdPlayEnd(TUAdInfo adInfo) | Callback when the ad finishes playing <\/br>adInfo: ad info object |\n| void onInterstitialAdVideoError(AdError adError) | Ad display failure callback <\/br>adError: ad display failure info |\n| void onInterstitialAdClose(TUAdInfo adInfo) | Ad close callback <\/br>adInfo: ad info object |\n| void onInterstitialAdClicked(TUAdInfo adInfo) | Ad click <\/br>adInfo: ad info object |\n| void onDeeplinkCallback(TUAdInfo adInfo, boolean isSuccess) | deeplink callback, for Adx and Online API ads <\/br>adInfo: ad info object <\/br>isSuccess: whether it succeeded, true = success, false = failure |\n\n<\/div>\n\n## 5. Demo Reference\n\nCode example: [Demo](https:\/\/github.com\/toponteam\/TPN-Android-Demo)InterstitialAdActivity.java","pure_content":"Rewarded Video Ad\n1. Integration Suggestions\n\u25cf Ad Loading\n\n\n\nIf the Ad Placement is set to Auto Load, you do not need to call the ATRewardVideoAd#load() method to load the ad\nWe recommend initializing the auto-load Rewarded Video ad on the main page\nThe context of ATRewardVideoAutoAd#init() must be an Activity, to avoid loading failures on some platforms\n\n\n\n\n\n\nIf the Ad Placement is set to Auto Load, you do not need to call the TURewardVideoAd#load() method to load the ad\nWe recommend initializing the auto-load Rewarded Video ad on the main page\nThe context of TURewardVideoAutoAd#init() must be an Activity, to avoid loading failures on some platforms\n\n\n\n\u25cf Ad Display\n\n\nBefore displaying, check whether isAdReady() is ready. Once ready, call show() to display the ad; if not ready, start loading the ad and wait for the load to succeed;\nBefore displaying, first check whether the app is in the foreground. Calling show() while in the background may cause the ad to be displayed outside the app or fail to display properly;\nThe auto-load Rewarded Video implements the auto-load logic internally, so avoid displaying the ad directly in the onRewardVideoAutoLoaded callback\n\n\n\u25cf Server-Side Callback\n\n\nAuto-load Rewarded Video supports the server-side callback (S2S) reward delivery mechanism, and also supports the server-side callback feature of each ad platform. Please refer to Rewarded Video Server-Side Reward (S2S) Guide\n\n\n\n2. Load an Ad\n\n\/\/--------------------- Method 1 -------------------------\n\/\/Pass in the Ad Placement id directly during initialization; one or more ids are supported.\nString[] placementIdArr = new String[]{\"your placementId_1 \", \"your placementId_2\"};\n\/\/If you need to set the server-side callback localExtra info, make sure to do it before ATRewardVideoAutoAd.init()\nsetPlacementIdLocalExtra(placementIdArr);\nATRewardVideoAutoAd.init(activity, placementIdArr, new ATRewardVideoAutoLoadListener() {\n @Override\n public void onRewardVideoAutoLoaded(String placementId) {}\n\n @Override\n public void onRewardVideoAutoLoadFail(String placementId, AdError adError) {}\n});\n\/\/--------------------- Method 1 -------------------------\n\n\/\/--------------------- Method 2 -------------------------\n\/\/Initialize first, then pass in the Ad Placement id; one or more ids are supported\nString[] placementIdArr = new String[]{\"your placementId_1 \", \"your placementId_2\"};\n\/\/If you need to set the server-side callback localExtra info, make sure to do it before ATRewardVideoAutoAd.init()\nsetPlacementIdLocalExtra(placementIdArr);\nATRewardVideoAutoAd.init(activity, null, new ATRewardVideoAutoLoadListener() {\n @Override\n public void onRewardVideoAutoLoaded(String placementId) {}\n @Override\n public void onRewardVideoAutoLoadFail(String placementId, AdError adError) {}\n});\n\/\/addPlacementId() must be called after ATRewardVideoAutoAd.init()\nATRewardVideoAutoAd.addPlacementId(placementIdArr);\n\/\/--------------------- Method 2 -------------------------\n\n\/\/Set the server-side callback localExtra info\nprivate void setPlacementIdLocalExtra(String... placementIdArr) {\n for (String placementId : placementIdArr) {\n String userid = \"test_userid_001\";\n String userdata = \"test_userdata_001\";\n Map localMap = new HashMap();\n localMap.put(ATAdConst.KEY.USER_ID, userid);\n localMap.put(ATAdConst.KEY.USER_CUSTOM_DATA, userdata);\n \/\/Takes effect from the next ad load\n ATRewardVideoAutoAd.setLocalExtra(placementId, localMap);\n }\n}\n\n\n\n\/\/--------------------- Method 1 -------------------------\n\/\/Pass in the Ad Placement id directly during initialization; one or more ids are supported.\nString[] placementIdArr = new String[]{\"your placementId_1 \", \"your placementId_2\"};\n\/\/If you need to set the server-side callback localExtra info, make sure to do it before TURewardVideoAutoAd.init()\nsetPlacementIdLocalExtra(placementIdArr);\nTURewardVideoAutoAd.init(activity, placementIdArr, new TURewardVideoAutoLoadListener() {\n @Override\n public void onRewardVideoAutoLoaded(String placementId) {}\n\n @Override\n public void onRewardVideoAutoLoadFail(String placementId, AdError adError) {}\n});\n\/\/--------------------- Method 1 -------------------------\n\n\/\/--------------------- Method 2 -------------------------\n\/\/Initialize first, then pass in the Ad Placement id; one or more ids are supported\nString[] placementIdArr = new String[]{\"your placementId_1 \", \"your placementId_2\"};\n\/\/If you need to set the server-side callback localExtra info, make sure to do it before TURewardVideoAutoAd.init()\nsetPlacementIdLocalExtra(placementIdArr);\nTURewardVideoAutoAd.init(activity, null, new TURewardVideoAutoLoadListener() {\n @Override\n public void onRewardVideoAutoLoaded(String placementId) {}\n @Override\n public void onRewardVideoAutoLoadFail(String placementId, AdError adError) {}\n});\n\/\/addPlacementId() must be called after TURewardVideoAutoAd.init()\nTURewardVideoAutoAd.addPlacementId(placementIdArr);\n\/\/--------------------- Method 2 -------------------------\n\n\/\/Set the server-side callback localExtra info\nprivate void setPlacementIdLocalExtra(String... placementIdArr) {\n for (String placementId : placementIdArr) {\n String userid = \"test_userid_001\";\n String userdata = \"test_userdata_001\";\n Map localMap = new HashMap();\n localMap.put(TUAdConst.KEY.USER_ID, userid);\n localMap.put(TUAdConst.KEY.USER_CUSTOM_DATA, userdata);\n \/\/Takes effect from the next ad load\n TURewardVideoAutoAd.setLocalExtra(placementId, localMap);\n }\n}\n\n\n\nNote:\n\nIf the Ad Placement IDs are the same, both init() and addPlacementId() only need to be called once.\n\n\n3. Show the Ad\n\nATRewardVideoAutoAd.show(activity, \"your placement id\", new ATRewardVideoAutoEventListener() {\n @Override\n public void onRewardedVideoAdPlayStart(ATAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdPlayEnd(ATAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdPlayFailed(AdError adError, ATAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdClosed(ATAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdPlayClicked(ATAdInfo adInfo) {}\n \n @Override\n public void onReward(ATAdInfo adInfo) {}\n});\n\n\n\nTURewardVideoAutoAd.show(activity, \"your placement id\", new TURewardVideoAutoEventListener() {\n @Override\n public void onRewardedVideoAdPlayStart(TUAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdPlayEnd(TUAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdPlayFailed(AdError adError, TUAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdClosed(TUAdInfo adInfo) {}\n \n @Override\n public void onRewardedVideoAdPlayClicked(TUAdInfo adInfo) {}\n \n @Override\n public void onReward(TUAdInfo adInfo) {}\n});\n\n\n4. API Reference\n\n\u25cf ATRewardVideoAutoAd\n\nOperation class for loading and displaying auto-load Rewarded Video ads\n\n\n\n\n Method\n Description\n\n\n\n\n void init(Context context, String[] placementIds, ATRewardVideoAutoLoadListener loadListener)\n Initialization method for the auto-load Rewarded Video ad; after initialization, it automatically starts loading ads for the specified Ad Placements context: an activity is recommended placementIds: Ad Placement IDs to enable Auto Load (you may pass null first and later call addPlacementId() to pass the Ad Placement IDs) loadListener: ad fill callback\n\n\n void addPlacementId(String... placementIds)\n Set multiple auto-load Rewarded Video Ad Placement ids for auto loading placementIds: Ad Placement IDs to be auto-loaded\n\n\n void removePlacementId(String... placementIds)\n Cancel auto loading for multiple auto-load Rewarded Video Ad Placement ids placementIds: Ad Placement IDs that no longer need to be auto-loaded\n\n\n void setLocalExtra(String placementId, Map localExtra)\n Set local parameters for the specified Ad Placement placementId: Ad Placement ID localExtra: local parameters, whose keys are obtained via AdConst.KEY\n\n\n boolean isAdReady(String placementId)\n Determine whether the Ad Placement has an ad available to display placementId: Ad Placement ID to query\n\n\n void show(Activity activity, String placementId, ATRewardVideoAutoEventListener eventListener)\n Display the Rewarded Video ad of this Ad Placement activity: the Activity that displays the ad placementId: Ad Placement ID to display eventListener: Rewarded Video ad display and reward callback\n\n\n void show(Activity activity, String placementId, ATShowConfig showConfig, ATRewardVideoAutoEventListener eventListener)\n Display the Rewarded Video ad of this Ad Placement activity: the Activity that displays the ad placementId: Ad Placement ID to display showConfig: ad display configuration, including custom parameters and the Ad Scenario eventListener: Rewarded Video ad display and reward callback\n\n\n\n\u25cf ATRewardVideoAutoLoadListener\n\nCallback listener for auto-load Rewarded Video ad loading events\n\n\n\n\n Method\n Description\n\n\n\n\n void onRewardVideoAutoLoaded(String placementId)\n Callback for a successful ad load of the corresponding Ad Placement placementId: the corresponding Ad Placement ID\n\n\n void onRewardVideoAutoLoadFail(String placementId, AdError errorCode)\n Callback for a failed ad load of the corresponding Ad Placement placementId: Ad Placement ID errorCode: ad load failure info\n\n\n\n\u25cf ATRewardVideoAutoEventListener\n\nCallback listener for auto-load Rewarded Video ad display events\n\n\n\n\n Method\n Description\n\n\n\n\n void onRewardedVideoAdPlayStart(ATAdInfo adInfo)\n Callback when the ad starts playing (i.e. the Rewarded Video impression callback) adInfo: ad info object\n\n\n void onRewardedVideoAdPlayEnd(ATAdInfo adInfo)\n Callback when the ad finishes playing adInfo: ad info object\n\n\n void onRewardedVideoAdPlayFailed(AdError adError, ATAdInfo adInfo)\n Callback when the ad fails to play adError: ad info object adInfo: ad display failure info\n\n\n void onReward(ATAdInfo adInfo)\n This callback is triggered when the reward is delivered. We recommend that developers deliver the reward in this callback, which is generally called before onRewardedVideoAdClosed adInfo: ad info object\n\n\n void onRewardedVideoAdClosed(ATAdInfo adInfo)\n Ad close callback adInfo: ad info object\n\n\n void onRewardedVideoAdPlayClicked(ATAdInfo adInfo)\n Ad click adInfo: ad info object\n\n\n void onDeeplinkCallback(ATAdInfo adInfo, boolean isSuccess)\n deeplink callback, for Adx and OnlineApi ads adInfo: ad info object isSuccess: whether it succeeded, true = success, false = failure\n\n\n\n\n\n\u25cf TURewardVideoAutoAd\n\nOperation class for loading and displaying auto-load Rewarded Video ads\n\n\n\n\n Method\n Description\n\n\n\n\n void init(Context context, String[] placementIds, TURewardVideoAutoLoadListener loadListener)\n Initialization method for the auto-load Rewarded Video ad; after initialization, it automatically starts loading ads for the specified Ad Placements context: an activity is recommended placementIds: Ad Placement IDs to enable Auto Load (you may pass null first and later call addPlacementId() to pass the Ad Placement IDs) loadListener: ad fill callback\n\n\n void addPlacementId(String... placementIds)\n Set multiple auto-load Rewarded Video Ad Placement ids for auto loading placementIds: Ad Placement IDs to be auto-loaded\n\n\n void removePlacementId(String... placementIds)\n Cancel auto loading for multiple auto-load Rewarded Video Ad Placement ids placementIds: Ad Placement IDs that no longer need to be auto-loaded\n\n\n void setLocalExtra(String placementId, Map localExtra)\n Set local parameters for the specified Ad Placement placementId: Ad Placement ID localExtra: local parameters, whose keys are obtained via TUAdConst.KEY\n\n\n boolean isAdReady(String placementId)\n Determine whether the Ad Placement has an ad available to display placementId: Ad Placement ID to query\n\n\n void show(Activity activity, String placementId, TURewardVideoAutoEventListener eventListener)\n Display the Rewarded Video ad of this Ad Placement activity: the Activity that displays the ad placementId: Ad Placement ID to display eventListener: Rewarded Video ad display and reward callback\n\n\n void show(Activity activity, String placementId, TUShowConfig showConfig, TURewardVideoAutoEventListener eventListener)\n Display the Rewarded Video ad of this Ad Placement activity: the Activity that displays the ad placementId: Ad Placement ID to display showConfig: ad display configuration, including custom parameters and the Ad Scenario eventListener: Rewarded Video ad display and reward callback\n\n\n\n\u25cf TURewardVideoAutoLoadListener\n\nCallback listener for auto-load Rewarded Video ad loading events\n\n\n\n\n Method\n Description\n\n\n\n\n void onRewardVideoAutoLoaded(String placementId)\n Callback for a successful ad load of the corresponding Ad Placement placementId: the corresponding Ad Placement ID\n\n\n void onRewardVideoAutoLoadFail(String placementId, AdError errorCode)\n Callback for a failed ad load of the corresponding Ad Placement placementId: Ad Placement ID errorCode: ad load failure info\n\n\n\n\u25cf TURewardVideoAutoEventListener\n\nCallback listener for auto-load Rewarded Video ad display events\n\n\n\n\n Method\n Description\n\n\n\n\n void onRewardedVideoAdPlayStart(TUAdInfo adInfo)\n Callback when the ad starts playing (i.e. the Rewarded Video impression callback) adInfo: ad info object\n\n\n void onRewardedVideoAdPlayEnd(TUAdInfo adInfo)\n Callback when the ad finishes playing adInfo: ad info object\n\n\n void onRewardedVideoAdPlayFailed(AdError adError, TUAdInfo adInfo)\n Callback when the ad fails to play adError: ad info object adInfo: ad display failure info\n\n\n void onReward(TUAdInfo adInfo)\n This callback is triggered when the reward is delivered. We recommend that developers deliver the reward in this callback, which is generally called before onRewardedVideoAdClosed adInfo: ad info object\n\n\n void onRewardedVideoAdClosed(TUAdInfo adInfo)\n Ad close callback adInfo: ad info object\n\n\n void onRewardedVideoAdPlayClicked(TUAdInfo adInfo)\n Ad click adInfo: ad info object\n\n\n void onDeeplinkCallback(TUAdInfo adInfo, boolean isSuccess)\n deeplink callback, for Adx and OnlineApi ads adInfo: ad info object isSuccess: whether it succeeded, true = success, false = failure\n\n\n\n\n\n5. Demo Reference\nCode example: DemoRewardVideoAdActivity\n\nInterstitial Ad\n1. Integration Suggestions\n\u25cf Ad Loading\n\n\n\nIf the Ad Placement is set to Auto Load, do not call the ATInterstitial#load() method to load the ad\nWe recommend initializing the auto-load Rewarded Video ad on the main page\nThe context of ATInterstitialAutoAd#init() must be an Activity, to avoid loading failures on some platforms\n\n\n\n\n\n\nIf the Ad Placement is set to Auto Load, do not call the TUInterstitial#load() method to load the ad\nWe recommend initializing the auto-load Rewarded Video ad on the main page\nThe context of TUInterstitialAutoAd#init() must be an Activity, to avoid loading failures on some platforms\n\n\n\n\u25cf Ad Display\n\n\nBefore displaying, check whether isAdReady() is ready. Once ready, call show() to display the ad; if not ready, start loading the ad and wait for the load to succeed;\nBefore displaying, first check whether the app is in the foreground. Calling show() while in the background may cause the ad to be displayed outside the app or fail to display properly;\nThe auto-load Interstitial implements the auto-load logic internally, so avoid displaying the ad directly in the onInterstitialAutoLoaded() callback\n\n\n2. Load an Ad\n\n\/\/--------------------- Method 1 -------------------------\n\/\/Pass in the Ad Placement id directly during initialization; one or more ids are supported.\nString[] placementIdArr = new String[]{\"your placementId_1 \", \"your placementId_2\"};\nATInterstitialAutoAd.init(activity, placementIdArr, new ATInterstitialAutoLoadListener() {\n @Override\n public void onInterstitialAutoLoaded(String placementId) {}\n\n @Override\n public void onInterstitialAutoLoadFail(String placementId, AdError adError) {}\n});\n\/\/--------------------- Method 1 -------------------------\n\n\/\/--------------------- Method 2 -------------------------\n\/\/Initialize first, then pass in the Ad Placement id; one or more ids are supported\nString[] placementIdArr = new String[]{\"your placementId_1 \", \"your placementId_2\"};\nATInterstitialAutoAd.init(activity, null, new ATInterstitialAutoLoadListener() {\n @Override\n public void onInterstitialAutoLoaded(String placementId) {}\n\n @Override\n public void onInterstitialAutoLoadFail(String placementId, AdError adError) {}\n});\n\/\/addPlacementId() must be called after ATInterstitialAutoAd.init()\nATInterstitialAutoAd.addPlacementId(placementIdArr);\n\/\/--------------------- Method 2 -------------------------\n\n\n\n\/\/--------------------- Method 1 -------------------------\n\/\/Pass in the Ad Placement id directly during initialization; one or more ids are supported.\nString[] placementIdArr = new String[]{\"your placementId_1 \", \"your placementId_2\"};\nTUInterstitialAutoAd.init(activity, placementIdArr, new TUInterstitialAutoLoadListener() {\n @Override\n public void onInterstitialAutoLoaded(String placementId) {}\n\n @Override\n public void onInterstitialAutoLoadFail(String placementId, AdError adError) {}\n});\n\/\/--------------------- Method 1 -------------------------\n\n\/\/--------------------- Method 2 -------------------------\n\/\/Initialize first, then pass in the Ad Placement id; one or more ids are supported\nString[] placementIdArr = new String[]{\"your placementId_1 \", \"your placementId_2\"};\nTUInterstitialAutoAd.init(activity, null, new TUInterstitialAutoLoadListener() {\n @Override\n public void onInterstitialAutoLoaded(String placementId) {}\n\n @Override\n public void onInterstitialAutoLoadFail(String placementId, AdError adError) {}\n});\n\/\/addPlacementId() must be called after TUInterstitialAutoAd.init()\nTUInterstitialAutoAd.addPlacementId(placementIdArr);\n\/\/--------------------- Method 2 -------------------------\n\n\n\nNote:\n\nIf the Ad Placement IDs are the same, both init() and addPlacementId() only need to be called once\n\n\n3. Show the Ad\n\nATInterstitialAutoAd.show(activity, \"your placement id\", new ATInterstitialAutoEventListener() {\n @Override\n public void onInterstitialAdShow(ATAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdVideoStart(ATAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdVideoEnd(ATAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdVideoError(AdError adError) {}\n \n @Override\n public void onInterstitialAdClose(ATAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdClicked(ATAdInfo adInfo) {}\n});\n\n\n\nTUInterstitialAutoAd.show(activity, \"your placement id\", new TUInterstitialAutoEventListener() {\n @Override\n public void onInterstitialAdShow(TUAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdVideoStart(TUAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdVideoEnd(TUAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdVideoError(AdError adError) {}\n \n @Override\n public void onInterstitialAdClose(TUAdInfo adInfo) {}\n \n @Override\n public void onInterstitialAdClicked(TUAdInfo adInfo) {}\n});\n\n\n4. API Reference\n\n\u25cf ATInterstitialAutoAd\n\nOperation class for loading and displaying auto-load Interstitial ads\n\n\n\n\n Method\n Description\n\n\n\n\n void init(Context context, String[] placementIds, ATInterstitialAutoLoadListener loadListener)\n Initialization method for the auto-load Interstitial ad; after initialization, it automatically starts loading ads for the specified Ad Placements context: an activity is recommended placementIds: Ad Placement IDs to enable Auto Load (you may pass null first and later call addPlacementId() to pass the Ad Placement ids) loadListener: ad fill callback\n\n\n void addPlacementId(String... placementIds)\n Set multiple auto-load Interstitial Ad Placement ids for auto loading placementIds: Ad Placement IDs to be auto-loaded\n\n\n void removePlacementId(String... placementIds)\n Cancel auto loading for multiple auto-load Interstitial Ad Placement ids placementIds: Ad Placement IDs that no longer need to be auto-loaded\n\n\n void setLocalExtra(String placementId, Map localExtra)\n Set custom parameters for the specified Ad Placement placementId: Ad Placement ID localExtra: custom parameters, whose keys are obtained via ATAdConst.KEY\n\n\n boolean isAdReady(String placementId)\n Determine whether the Ad Placement has an ad available to display placementId: Ad Placement ID to query\n\n\n void show(Activity activity, String placementId, ATInterstitialAutoEventListener eventListener)\n Display the Interstitial ad of this Ad Placement activity: the Activity that displays the ad placementId: Ad Placement ID to display eventListener: Interstitial ad display callback\n\n\n void show(Activity activity, String placementId, ATShowConfig showConfig, ATInterstitialAutoEventListener eventListener)\n Display the Interstitial ad of this Ad Placement activity: the Activity that displays the ad placementId: Ad Placement ID to display showConfig: ad display configuration, including custom parameters and the Ad Scenario eventListener: Interstitial ad display callback\n\n\n\n\u25cf ATInterstitialAutoLoadListener\n\nCallback listener for auto-load Interstitial ad loading events\n\n\n\n\n Method\n Description\n\n\n\n\n void onInterstitialAutoLoaded(String placementId)\n Callback for a successful ad load of the corresponding Ad Placement placementId: the corresponding Ad Placement ID\n\n\n void onInterstitialAutoLoadFail(String placementId, AdError adError)\n Callback for a failed ad load of the corresponding Ad Placement placementId: Ad Placement ID adError: ad load failure info\n\n\n\n\u25cf ATInterstitialAutoEventListener\n\nCallback listener for auto-load Interstitial ad display events\n\n\n\n\n Method\n Description\n\n\n\n\n void onInterstitialAdShow(ATAdInfo adInfo)\n Ad display callback adInfo: ad info object\n\n\n void onInterstitialAdVideoStart(ATAdInfo adInfo)\n Callback when the video ad starts playing adInfo: ad info object\n\n\n void onInterstitialAdVideoAdPlayEnd(ATAdInfo adInfo)\n Callback when the ad finishes playing adInfo: ad info object\n\n\n void onInterstitialAdVideoError(AdError adError)\n Ad display failure callback adError: ad display failure info\n\n\n void onInterstitialAdClose(ATAdInfo adInfo)\n Ad close callback adInfo: ad info object\n\n\n void onInterstitialAdClicked(ATAdInfo adInfo)\n Ad click adInfo: ad info object\n\n\n void onDeeplinkCallback(ATAdInfo adInfo, boolean isSuccess)\n deeplink callback, for Adx and Online API ads adInfo: ad info object isSuccess: whether it succeeded, true = success, false = failure\n\n\n\n\n\n\u25cf TUInterstitialAutoAd\n\nOperation class for loading and displaying auto-load Interstitial ads\n\n\n\n\n Method\n Description\n\n\n\n\n void init(Context context, String[] placementIds, TUInterstitialAutoLoadListener loadListener)\n Initialization method for the auto-load Interstitial ad; after initialization, it automatically starts loading ads for the specified Ad Placements context: an activity is recommended placementIds: Ad Placement IDs to enable Auto Load (you may pass null first and later call addPlacementId() to pass the Ad Placement ids) loadListener: ad fill callback\n\n\n void addPlacementId(String... placementIds)\n Set multiple auto-load Interstitial Ad Placement ids for auto loading placementIds: Ad Placement IDs to be auto-loaded\n\n\n void removePlacementId(String... placementIds)\n Cancel auto loading for multiple auto-load Interstitial Ad Placement ids placementIds: Ad Placement IDs that no longer need to be auto-loaded\n\n\n void setLocalExtra(String placementId, Map localExtra)\n Set custom parameters for the specified Ad Placement placementId: Ad Placement ID localExtra: custom parameters, whose keys are obtained via TUAdConst.KEY\n\n\n boolean isAdReady(String placementId)\n Determine whether the Ad Placement has an ad available to display placementId: Ad Placement ID to query\n\n\n void show(Activity activity, String placementId, TUInterstitialAutoEventListener eventListener)\n Display the Interstitial ad of this Ad Placement activity: the Activity that displays the ad placementId: Ad Placement ID to display eventListener: Interstitial ad display callback\n\n\n void show(Activity activity, String placementId, TUShowConfig showConfig, TUInterstitialAutoEventListener eventListener)\n Display the Interstitial ad of this Ad Placement activity: the Activity that displays the ad placementId: Ad Placement ID to display showConfig: ad display configuration, including custom parameters and the Ad Scenario eventListener: Interstitial ad display callback\n\n\n\n\u25cf TUInterstitialAutoLoadListener\n\nCallback listener for auto-load Interstitial ad loading events\n\n\n\n\n Method\n Description\n\n\n\n\n void onInterstitialAutoLoaded(String placementId)\n Callback for a successful ad load of the corresponding Ad Placement placementId: the corresponding Ad Placement ID\n\n\n void onInterstitialAutoLoadFail(String placementId, AdError adError)\n Callback for a failed ad load of the corresponding Ad Placement placementId: Ad Placement ID adError: ad load failure info\n\n\n\n\u25cf TUInterstitialAutoEventListener\n\nCallback listener for auto-load Interstitial ad display events\n\n\n\n\n Method\n Description\n\n\n\n\n void onInterstitialAdShow(TUAdInfo adInfo)\n Ad display callback adInfo: ad info object\n\n\n void onInterstitialAdVideoStart(TUAdInfo adInfo)\n Callback when the video ad starts playing adInfo: ad info object\n\n\n void onInterstitialAdVideoAdPlayEnd(TUAdInfo adInfo)\n Callback when the ad finishes playing adInfo: ad info object\n\n\n void onInterstitialAdVideoError(AdError adError)\n Ad display failure callback adError: ad display failure info\n\n\n void onInterstitialAdClose(TUAdInfo adInfo)\n Ad close callback adInfo: ad info object\n\n\n void onInterstitialAdClicked(TUAdInfo adInfo)\n Ad click adInfo: ad info object\n\n\n void onDeeplinkCallback(TUAdInfo adInfo, boolean isSuccess)\n deeplink callback, for Adx and Online API ads adInfo: ad info object isSuccess: whether it succeeded, true = success, false = failure\n\n\n\n\n5. Demo Reference\nCode example: DemoInterstitialAdActivity.java","is_draft":"0","editor_type":"2","file_path":"","add_time":"1726119317","update_time":"1783502107"},"pure_content":"Rewarded Video Ad\n1. Integration Suggestions\n\u25cf Ad Loading\n\n\n\nIf the Ad Placement is set to Auto Load, you do not need to call the ATRewardVideoAd#load() method to load the ad\nWe recommend initializing"},{"id":"162808","string_id":"bHDTqxUQ","status":"1","parent_id":"68407","slug":"Custom-advertising-platform","order":"10","name":"Custom Network","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"Custom Network","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1727681294","add_time":"1726111185","update_time":"1783495864","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"3","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"162808","content":"

1. Using the Custom Network Adapter<\/h2>\n

Check how to create a custom network in the TopOn dashboard<\/a><\/p>\n<\/blockquote>\n

(1) You only need to inherit the relevant classes and override the corresponding methods. You don’t need to call any methods in the custom Adapter; once the custom ad source is configured in the TopOn dashboard, the SDK will call the appropriate methods in the custom Adapter at the right time.<\/p>\n

(2) When you use the TopOn <\/span>API to load ads, you need to notify the TopOn SDK of the custom network<\/span> ad load results by calling<\/span>ATCustomLoadListener#onAdCacheLoaded<\/code>and<\/span>ATCustomLoadListener#onAdLoadError<\/code>. Even<\/span>tually, you will receive a notification from the TopOn SDK via a successful load callback.<\/span><\/p>\n

<\/p>\n

(3) After the TopOn SDK fetches the ad strategy, it will convert the configured parameters from the diagram above into a Map, and passes it to theloadCustomNetworkAd(Context context, Map serverExtra, Map localExtra)<\/code>. You can obtain the related parameters (AppID<\/strong>, AppKey<\/strong>, PlacementID<\/strong>, etc<\/strong>.) through the serverExtra<\/strong><\/span>.<\/span><\/p>\n

<\/p>\n

2. <\/span>Public Abstract Methods and Ad Load Event Callbacks<\/h2>\n\u25cf <\/span>Implementation of Public Abstract Methods<\/h3>\n<\/colgroup>\n\n\n\n\n\n\n\nMethod<\/strong><\/td>\n Description<\/strong><\/td>\n<\/tr>\n
void getNetworkPlacementId()<\/td>\n Provide the ad placement ID for the custom ad platform being loaded.<\/td>\n<\/tr>\n
void getNetworkSDKVersion()<\/td>\n Provide the SDK version of the custom ad platform being loaded.<\/td>\n<\/tr>\n
void destory()<\/td>\n Implement the destruction logic for the custom ad platform.<\/td>\n<\/tr>\n
boolean setUserDataConsent(Context context, boolean isConsent, boolean isEUTraffic)<\/td>\n (Optional)<\/strong>Provide information on user consent and whether the user is in the EU for the custom ad platform to implement GDPR settings. ( If implemented, return true; TopOn will use this for statistical purposes<\/strong>)
context<\/strong>: Context
isConsent<\/strong>: Whether the user has given consent
isEUTraffic<\/strong>: Whether the traffic is from the EU<\/td>\n<\/tr>\n
Map getNetworkInfoMap()<\/td>\n (Optional)<\/strong>Provide custom information for the custom ad. In this method, you can create a Map and add additional information to this Map before returning it. You can then retrieve this additional information via the ATAdInfo#getExtInfoMap()<\/code> method in the TopOn SDK’s callback methods.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n <\/p>\n
\u25cf <\/span>Ad Load Event Callbacks<\/h3>\nUse the ATCustomLoadListener <\/code>member variable in the Adapter to implement ad load result callbacks.<\/p>\n
<\/colgroup>\n\n\n\n\nMethod<\/strong><\/td>\n Description<\/strong><\/td>\n<\/tr>\n
void onAdCacheLoaded(BaseAd... baseAds)<\/td>\n When the ad content and materials are successfully loaded, call this method to notify the TopOn SDK. Ultimately, you will receive a notification from the TopOn SDK via a successful load callback.
baseAds<\/strong>: Primarily used for providing ad objects to native ad callbacks; other ad formats do not require this parameter.<\/td>\n<\/tr>\n
void onAdLoadError(String errorCode, String errorMsg)<\/td>\n When the ad fails to load, call this method to notify the TopOn SDK. The TopOn SDK will then callback the failure method to notify the developer (errorCode and errorMsg will be encapsulated in the AdError object within the TopOn SDK callback method).
errorCode<\/strong>: Error code information
errorMsg<\/strong>: Detailed error message<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\u26a0\ufe0f<\/span>Note<\/strong>: When using the ATCustomLoadListener <\/code>member variable, ensure to handle null checks<\/strong>.<\/p>\n<\/blockquote>\n
 <\/p>\n
3. Using the Custom Network Adapter and Precautions<\/h2>\n\u25cf <\/span>Set the Waterfall request strategy<\/h3>\n\n\u26a0\ufe0f<\/span>Note<\/strong>:<\/span><\/p>\n
\n\nWhen adding a custom network in the TopOn dashboard, ensure that the Adapter class name is configured with the full path (package name + class name); otherwise, the Adapter class will not be created properly during ad loading.<\/p>\n<\/li>\n
\nWhen building the release package, ensure that the Adapter class is not obfuscated. Example obfuscation rules<\/p>\n<\/li>\n<\/ul>\n
# Replace <AdapterClassName> with your own Adapter class name\n-keep class <Adapter class name> { *;} \n-keepclassmembers public class <Adapter class name> { \n    public *; \n}<\/code><\/pre>\n<\/blockquote>","pure_content":"1. Using the Custom Network Adapter\n\nCheck how to create a custom network in the TopOn dashboard\n\n(1) You only need to inherit the relevant classes and override the corresponding methods. You don\u2019t need to call any methods in the custom Adapter; once the custom ad source is configured in the TopOn dashboard, the SDK will call the appropriate methods in the custom Adapter at the right time.\n(2) When you use the TopOn\u00a0API to load ads, you need to notify the TopOn SDK of the custom network ad load results by callingATCustomLoadListener#onAdCacheLoadedandATCustomLoadListener#onAdLoadError. Eventually, you will receive a notification from the TopOn SDK via a successful load callback.\n\n(3) After the TopOn SDK fetches the ad strategy, it will convert the configured parameters from the diagram above into a Map, and passes it to theloadCustomNetworkAd(Context context, Map serverExtra, Map localExtra). You can obtain the related parameters (AppID, AppKey, PlacementID, etc.) through the serverExtra.\n\u00a0\n2.\u00a0Public Abstract Methods and Ad Load Event Callbacks\n\u25cf Implementation of Public Abstract Methods\n\n\n\n Method\n Description\n\n\n void getNetworkPlacementId()\n Provide the ad placement ID for the custom ad platform being loaded.\n\n\n void getNetworkSDKVersion()\n Provide the SDK version of the custom ad platform being loaded.\n\n\n void destory()\n Implement the destruction logic for the custom ad platform.\n\n\n boolean setUserDataConsent(Context context, boolean isConsent, boolean isEUTraffic)\n (Optional)Provide information on user consent and whether the user is in the EU for the custom ad platform to implement GDPR settings. ( If implemented, return true; TopOn will use this for statistical purposes)context: ContextisConsent: Whether the user has given consentisEUTraffic: Whether the traffic is from the EU\n\n\n Map getNetworkInfoMap()\n (Optional)Provide custom information for the custom ad. In this method, you can create a Map and add additional information to this Map before returning it. You can then retrieve this additional information via the ATAdInfo#getExtInfoMap() method in the TopOn SDK\u2019s callback methods.\n\n\n\n\u00a0\n\u25cf Ad Load Event Callbacks\nUse the ATCustomLoadListener member variable in the Adapter to implement ad load result callbacks.\n\n\n\n Method\n Description\n\n\n void onAdCacheLoaded(BaseAd... baseAds)\n When the ad content and materials are successfully loaded, call this method to notify the TopOn SDK. Ultimately, you will receive a notification from the TopOn SDK via a successful load callback.baseAds: Primarily used for providing ad objects to native ad callbacks; other ad formats do not require this parameter.\n\n\n void onAdLoadError(String errorCode, String errorMsg)\n When the ad fails to load, call this method to notify the TopOn SDK. The TopOn SDK will then callback the failure method to notify the developer (errorCode and errorMsg will be encapsulated in the AdError object within the TopOn SDK callback method).errorCode: Error code informationerrorMsg: Detailed error message\n\n\n\n\n\u26a0\ufe0fNote: When using the ATCustomLoadListener member variable, ensure to handle null checks.\n\n\u00a0\n3. Using the Custom Network Adapter and Precautions\n\u25cf Set the Waterfall request strategy\n\n\u26a0\ufe0fNote:\n\n\nWhen adding a custom network in the TopOn dashboard, ensure that the Adapter class name is configured with the full path (package name + class name); otherwise, the Adapter class will not be created properly during ad loading.\n\n\nWhen building the release package, ensure that the Adapter class is not obfuscated. Example obfuscation rules\n\n\n# Replace  with your own Adapter class name\n-keep class  { *;} \n-keepclassmembers public class  { \n    public *; \n}","is_draft":"0","editor_type":"3","file_path":"","add_time":"1726111185","update_time":"1748604694"},"pure_content":"1. Using the Custom Network Adapter\n\nCheck how to create a custom network in the TopOn dashboard\n\n(1) You only need to inherit the relevant classes and override the corresponding methods. You don\u2019t ne"},{"id":"160181","string_id":"C4Ivm1","status":"1","parent_id":"68407","slug":"Admob-content-mapping-function","order":"9","name":"AdMob Content mapping for apps","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"AdMob Content mapping for apps","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1727680917","add_time":"1725871909","update_time":"1783495864","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"3","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"160181","content":"1. AdMob content mapping<\/span><\/span><\/span><\/h2>\nContent mapping for apps helps you deliver contextually relevant ads to your users and helps ensure ads are placed near content that’s suitable for your advertisers. This enables more advertisers to bid safely on your inventory, which may help to maximize your revenue. For more details, please refer to here<\/a>.<\/p>\n
\n\u26a0\ufe0f<\/span>Note:<\/strong> By default, only one URL is allowed. Multi-content URL support allows for up to 4 URLs, and you need to apply to AdMob for this feature.<\/span><\/span><\/span><\/div>\n<\/blockquote>\n <\/div>\n2. Sample code<\/span><\/span><\/span><\/h2>\n\u25cf <\/span>Add content mapping URL<\/span><\/span><\/span><\/h3>\n\/\/ Supports inputting 1 to 4 URLs\nMap<String, Object> localExtra = new HashMap<>();\nArrayList<String> urls = new ArrayList<String>();\nurls.add(\"https:\/\/www.example1.com\");\nurls.add(\"https:\/\/www.example2.com\");\nurls.add(\"https:\/\/www.example3.com\");\nurls.add(\"https:\/\/www.example4.com\");\nlocalExtra.put(AdmobATConst.CONTENT_URLS,urls);\n\n\/\/ Taking ATNative native ads as an example, call setLocalExtra() to pass in content mapping URLs before loading ads\nmATNative.setLocalExtra(localExtra);\n\n\/\/ Loading ad\nmATNative.makeAdRequest();<\/code><\/pre>\n\n\u26a0\ufe0fNote:<\/span><\/span><\/span><\/strong> <\/span><\/span><\/span>The content mapping URLs you enter will remain effective continuously; you do not need to pass the same URL with every request. If a change is necessary, simply pass in the new content.<\/span><\/span><\/span><\/p>\n<\/blockquote>\n
 <\/p>\n
\u25cf <\/span>Unmap content URL<\/span><\/span><\/span><\/h3>\n\/\/ Inputs an empty urls\nMap<String, Object> localExtra = new HashMap<>();\nArrayList<String> urls = new ArrayList<String>();\nlocalExtra.put(AdmobATConst.CONTENT_URLS,urls);\n\n\/\/ Taking ATNative native ads as an example, call setLocalExtra() to pass in content mapping URLs before loading ads\nmATNative.setLocalExtra(localExtra);\n\n\/\/ Loading ad\nmATNative.makeAdRequest();<\/code><\/pre>","pure_content":"1. AdMob content mapping\nContent mapping for apps helps you deliver contextually relevant ads to your users and helps ensure ads are placed near content that\u2019s suitable for your advertisers. This enables more advertisers to bid safely on your inventory, which may help to maximize your revenue. For more details, please refer to here.\n\n\u26a0\ufe0fNote: By default, only one URL is allowed. Multi-content URL support allows for up to 4 URLs, and you need to apply to AdMob for this feature.\n\n\u00a0\n2. Sample code\n\u25cf Add content mapping URL\n\/\/ Supports inputting 1 to 4 URLs\nMap localExtra = new HashMap<>();\nArrayList urls = new ArrayList();\nurls.add(\"https:\/\/www.example1.com\");\nurls.add(\"https:\/\/www.example2.com\");\nurls.add(\"https:\/\/www.example3.com\");\nurls.add(\"https:\/\/www.example4.com\");\nlocalExtra.put(AdmobATConst.CONTENT_URLS,urls);\n\n\/\/ Taking ATNative native ads as an example, call setLocalExtra() to pass in content mapping URLs before loading ads\nmATNative.setLocalExtra(localExtra);\n\n\/\/ Loading ad\nmATNative.makeAdRequest();\n\n\u26a0\ufe0fNote:\u00a0The content mapping URLs you enter will remain effective continuously; you do not need to pass the same URL with every request. If a change is necessary, simply pass in the new content.\n\n\u00a0\n\u25cf\u00a0Unmap content URL\n\/\/ Inputs an empty urls\nMap localExtra = new HashMap<>();\nArrayList urls = new ArrayList();\nlocalExtra.put(AdmobATConst.CONTENT_URLS,urls);\n\n\/\/ Taking ATNative native ads as an example, call setLocalExtra() to pass in content mapping URLs before loading ads\nmATNative.setLocalExtra(localExtra);\n\n\/\/ Loading ad\nmATNative.makeAdRequest();","is_draft":"0","editor_type":"3","file_path":"","add_time":"1725871909","update_time":"1748604694"},"pure_content":"1. AdMob content mapping\nContent mapping for apps helps you deliver contextually relevant ads to your users and helps ensure ads are placed near content that\u2019s suitable for your advertisers. This enab"},{"id":"863715","string_id":"3jUPIIRP","status":"1","parent_id":"68407","slug":"3jUPIIRP","order":"8","name":"Third-Party Revenue Reporting (v6.3.70+)","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783495094","add_time":"1783494905","update_time":"1783495864","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"863715","content":"## 1. Firebase\n> The TopOn SDK supports obtaining the revenue of real-time displayed ads. You can listen to the `onAdRevenuePaid()` callback to get the eCPM value of the currently displayed ad to record the Google Analytics ad\\_impression event.\n\n> **\u203c\ufe0f Note**: **When using Firebase with AdMob integrated in association, AdMob's non-bidding sources do not need to be reported.**\n\n\n\n```java\npublic void handleFirebase(ATAdInfo adInfo) {\n    FirebaseAnalytics mFirebaseAnalytics = FirebaseAnalytics.getInstance(mActivity);\n    if (adInfo != null) {\n        \/\/ When using Firebase with AdMob integrated in association, AdMob's non-bidding sources do not need to be reported.\n        \/\/ if (adInfo.getNetworkFirmId() == 2 && adInfo.isHeaderBiddingAdsource() == 0) return;\n        FirebaseAnalytics mFirebaseAnalytics = FirebaseAnalytics.getInstance(mActivity);\n        Bundle params = new Bundle();\n        \/\/ Revenue parameter configuration\n        params.putString(FirebaseAnalytics.Param.AD_PLATFORM, \"TopOn\");\n        params.putString(FirebaseAnalytics.Param.AD_SOURCE, adInfo.getNetworkName());\n        params.putString(FirebaseAnalytics.Param.AD_FORMAT, adInfo.getFormat());\n        params.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, adInfo.getNetworkPlacementId());\n        params.putDouble(FirebaseAnalytics.Param.VALUE, adInfo.getPublisherRevenue());\n        params.putString(FirebaseAnalytics.Param.CURRENCY, adInfo.getCurrency());\n        mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, params);\n    }\n} \n```\n\n<\/div>\n\n\n\n```java\npublic void handleFirebase(TUAdInfo adInfo) {\n    FirebaseAnalytics mFirebaseAnalytics = FirebaseAnalytics.getInstance(mActivity);\n    if (adInfo != null) {\n        \/\/ When using Firebase with AdMob integrated in association, AdMob's non-bidding sources do not need to be reported.\n        if (adInfo.getNetworkFirmId() == 2 && adInfo.isHeaderBiddingAdsource() == 0) return;\n        FirebaseAnalytics mFirebaseAnalytics = FirebaseAnalytics.getInstance(mActivity);\n        Bundle params = new Bundle();\n        \/\/ Revenue parameter configuration\n        params.putString(FirebaseAnalytics.Param.AD_PLATFORM, \"TopOn\");\n        params.putString(FirebaseAnalytics.Param.AD_SOURCE, adInfo.getNetworkName());\n        params.putString(FirebaseAnalytics.Param.AD_FORMAT, adInfo.getFormat());\n        params.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, adInfo.getNetworkPlacementId());\n        params.putDouble(FirebaseAnalytics.Param.VALUE, adInfo.getPublisherRevenue());\n        params.putString(FirebaseAnalytics.Param.CURRENCY, adInfo.getCurrency());\n        mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, params);\n    }\n} \n```\n\n<\/div>\n\nCall the `handleFirebase()` method in the `onAdRevenuePaid(ATAdInfo adInfo)` callback of the following ad types:\n\n### \u25cf Banner Ad\n\n\n\nReturn revenue in the `onAdRevenuePaid(ATAdInfo adInfo)` callback method of `ATBannerView#setAdRevenueListener()`. The sample code is as follows:\n\n```java\nmBannerView.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n```\n\n<\/div>\n\n\n\nReturn revenue in the `onAdRevenuePaid(TUAdInfo adInfo)` callback method of `TUBannerView#setAdRevenueListener()`. The sample code is as follows:\n\n```java\nmBannerView.setAdRevenueListener(new TUAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(TUAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n```\n\n<\/div>\n\n### \u25cf Native Ad\n\n\n\nReturn revenue in the `onAdRevenuePaid(ATAdInfo adInfo)` callback method of `NativeAd#setAdRevenueListener()`. The sample code is as follows:\n\n```java\nmNativeAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n```\n\n<\/div>\n\n\n\nReturn revenue in the `onAdRevenuePaid(TUAdInfo adInfo)` callback method of `NativeAd#setAdRevenueListener()`. The sample code is as follows:\n\n```java\nmNativeAd.setAdRevenueListener(new TUAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(TUAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n```\n\n<\/div>\n\n### \u25cf Rewarded Video\n\n\n\nReturn revenue in the `onAdRevenuePaid(ATAdInfo adInfo)` callback method of `ATRewardVideoAd#setAdRevenueListener()`. The sample code is as follows:\n\n```java\nmRewardVideoAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n```\n\n<\/div>\n\n\n\nReturn revenue in the `onAdRevenuePaid(TUAdInfo adInfo)` callback method of `TURewardVideoAd#setAdRevenueListener()`. The sample code is as follows:\n\n```java\nmRewardVideoAd.setAdRevenueListener(new TUAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(TUAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n```\n\n<\/div>\n\n### \u25cf Interstitial Ad\n\n\n\nReturn revenue in the `onAdRevenuePaid(ATAdInfo adInfo)` callback method of `ATInterstitial#setAdRevenueListener()`. The sample code is as follows:\n\n```java\nmInterstitialAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n```\n\n<\/div>\n\n\n\nReturn revenue in the `onAdRevenuePaid(TUAdInfo adInfo)` callback method of `TUInterstitial#setAdRevenueListener()`. The sample code is as follows:\n\n```java\nmInterstitialAd.setAdRevenueListener(new TUAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(TUAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n```\n\n<\/div>\n\n### \u25cf Splash Ad\n\n\n\nReturn revenue in the `onAdRevenuePaid(ATAdInfo adInfo)` callback method of `ATSplashAd#setAdRevenueListener()`. The sample code is as follows:\n\n```java\nmSplashAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n```\n\n<\/div>\n\n\n\nReturn revenue in the `onAdRevenuePaid(TUAdInfo adInfo)` callback method of `TUSplashAd#setAdRevenueListener()`. The sample code is as follows:\n\n```java\nmSplashAd.setAdRevenueListener(new TUAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(TUAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n```\n\n<\/div>\n\n---\n\n## 2. Adjust\n\n\n\nRefer to Firebase above. Call the following `handleAdjustRevenueReport` method in the `onAdRevenuePaid(ATAdInfo adInfo)` of each ad type:\n\n```java\npublic void handleAdjustRevenueReport(ATAdInfo adInfo) {\n    \/\/ Supported in adjust 4.38.1 and above\n    AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue( \"topon_sdk\");\n    adjustAdRevenue.setRevenue(adInfo.getPublisherRevenue(), adInfo.getCurrency());\n\n    \/\/ Optional configuration\n    adjustAdRevenue.setAdRevenueNetwork(String.valueOf(adInfo.getNetworkFirmId()));\n    adjustAdRevenue.setAdRevenueUnit(adInfo.getAdsourceId());\n    adjustAdRevenue.setAdRevenuePlacement(adInfo.getPlacementId());\n\n    \/\/ Send revenue data\n    Adjust.trackAdRevenue(adjustAdRevenue);\n}\n```\n\n<\/div>\n\n\n\nRefer to Firebase above. Call the following `handleAdjustRevenueReport` method in the `onAdRevenuePaid(TUAdInfo adInfo)` of each ad type:\n\n```java\npublic void handleAdjustRevenueReport(TUAdInfo adInfo) {\n    \/\/ Supported in adjust 4.38.1 and above\n    AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue( AdjustConfig.AD_REVENUE_TOPON);\n    adjustAdRevenue.setRevenue(adInfo.getPublisherRevenue(), adInfo.getCurrency());\n\n    \/\/ Optional configuration\n    adjustAdRevenue.setAdRevenueNetwork(String.valueOf(adInfo.getNetworkFirmId()));\n    adjustAdRevenue.setAdRevenueUnit(adInfo.getAdsourceId());\n    adjustAdRevenue.setAdRevenuePlacement(adInfo.getPlacementId());\n\n    \/\/ Send revenue data\n    Adjust.trackAdRevenue(adjustAdRevenue);\n}\n```\n\n<\/div>\n\n---\n\n## 3. AppsFlyer\n\n\n\nRefer to Firebase above. Call the following `handleAppsFlyerRevenueReport` method in the `onAdRevenuePaid(ATAdInfo adInfo)` of each ad type:\n\n```java\npublic void handleAppsFlyerRevenueReport(ATAdInfo adInfo) {\n    \n    \/\/ v6.3.10+\n    String monetizationNetwork = adInfo.getNetworkName(); \n    Currency currency = Currency.getInstance(Locale.US);\n    if (\"CNY\".equalsIgnoreCase(adInfo.getCurrency())) {\n        currency = Currency.getInstance(Locale.CHINA);\n    }\n    Map customParams = new HashMap<>();\n\n    AppsFlyerAdRevenue.logAdRevenue(monetizationNetwork, MediationNetwork.Topon, currency, adInfo.getPublisherRevenue(), customParams);\n}\n```\n\n<\/div>\n\n\n\nRefer to Firebase above. Call the following `handleAppsFlyerRevenueReport` method in the `onAdRevenuePaid(TUAdInfo adInfo)` of each ad type:\n\n```java\npublic void handleAppsFlyerRevenueReport(TUAdInfo adInfo) {\n    \n    \/\/ v6.3.10+\n    String monetizationNetwork = adInfo.getNetworkName(); \n    Currency currency = Currency.getInstance(Locale.US);\n    if (\"CNY\".equalsIgnoreCase(adInfo.getCurrency())) {\n        currency = Currency.getInstance(Locale.CHINA);\n    }\n    Map customParams = new HashMap<>();\n\n    AppsFlyerAdRevenue.logAdRevenue(monetizationNetwork, MediationNetwork.Topon, currency, adInfo.getPublisherRevenue(), customParams);\n}\n```\n\n<\/div>","pure_content":"1. Firebase\n\nThe TopOn SDK supports obtaining the revenue of real-time displayed ads. You can listen to the onAdRevenuePaid() callback to get the eCPM value of the currently displayed ad to record the Google Analytics ad_impression event.\n\n\n\u203c\ufe0f Note: When using Firebase with AdMob integrated in association, AdMob's non-bidding sources do not need to be reported.\n\n\npublic void handleFirebase(ATAdInfo adInfo) {\n    FirebaseAnalytics mFirebaseAnalytics = FirebaseAnalytics.getInstance(mActivity);\n    if (adInfo != null) {\n        \/\/ When using Firebase with AdMob integrated in association, AdMob's non-bidding sources do not need to be reported.\n        \/\/ if (adInfo.getNetworkFirmId() == 2 && adInfo.isHeaderBiddingAdsource() == 0) return;\n        FirebaseAnalytics mFirebaseAnalytics = FirebaseAnalytics.getInstance(mActivity);\n        Bundle params = new Bundle();\n        \/\/ Revenue parameter configuration\n        params.putString(FirebaseAnalytics.Param.AD_PLATFORM, \"TopOn\");\n        params.putString(FirebaseAnalytics.Param.AD_SOURCE, adInfo.getNetworkName());\n        params.putString(FirebaseAnalytics.Param.AD_FORMAT, adInfo.getFormat());\n        params.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, adInfo.getNetworkPlacementId());\n        params.putDouble(FirebaseAnalytics.Param.VALUE, adInfo.getPublisherRevenue());\n        params.putString(FirebaseAnalytics.Param.CURRENCY, adInfo.getCurrency());\n        mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, params);\n    }\n} \n\n\n\npublic void handleFirebase(TUAdInfo adInfo) {\n    FirebaseAnalytics mFirebaseAnalytics = FirebaseAnalytics.getInstance(mActivity);\n    if (adInfo != null) {\n        \/\/ When using Firebase with AdMob integrated in association, AdMob's non-bidding sources do not need to be reported.\n        if (adInfo.getNetworkFirmId() == 2 && adInfo.isHeaderBiddingAdsource() == 0) return;\n        FirebaseAnalytics mFirebaseAnalytics = FirebaseAnalytics.getInstance(mActivity);\n        Bundle params = new Bundle();\n        \/\/ Revenue parameter configuration\n        params.putString(FirebaseAnalytics.Param.AD_PLATFORM, \"TopOn\");\n        params.putString(FirebaseAnalytics.Param.AD_SOURCE, adInfo.getNetworkName());\n        params.putString(FirebaseAnalytics.Param.AD_FORMAT, adInfo.getFormat());\n        params.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, adInfo.getNetworkPlacementId());\n        params.putDouble(FirebaseAnalytics.Param.VALUE, adInfo.getPublisherRevenue());\n        params.putString(FirebaseAnalytics.Param.CURRENCY, adInfo.getCurrency());\n        mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, params);\n    }\n} \n\n\nCall the handleFirebase() method in the onAdRevenuePaid(ATAdInfo adInfo) callback of the following ad types:\n\u25cf Banner Ad\n\nReturn revenue in the onAdRevenuePaid(ATAdInfo adInfo) callback method of ATBannerView#setAdRevenueListener(). The sample code is as follows:\nmBannerView.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\n\n\nReturn revenue in the onAdRevenuePaid(TUAdInfo adInfo) callback method of TUBannerView#setAdRevenueListener(). The sample code is as follows:\nmBannerView.setAdRevenueListener(new TUAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(TUAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\n\n\u25cf Native Ad\n\nReturn revenue in the onAdRevenuePaid(ATAdInfo adInfo) callback method of NativeAd#setAdRevenueListener(). The sample code is as follows:\nmNativeAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\n\n\nReturn revenue in the onAdRevenuePaid(TUAdInfo adInfo) callback method of NativeAd#setAdRevenueListener(). The sample code is as follows:\nmNativeAd.setAdRevenueListener(new TUAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(TUAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\n\n\u25cf Rewarded Video\n\nReturn revenue in the onAdRevenuePaid(ATAdInfo adInfo) callback method of ATRewardVideoAd#setAdRevenueListener(). The sample code is as follows:\nmRewardVideoAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\n\n\nReturn revenue in the onAdRevenuePaid(TUAdInfo adInfo) callback method of TURewardVideoAd#setAdRevenueListener(). The sample code is as follows:\nmRewardVideoAd.setAdRevenueListener(new TUAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(TUAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\n\n\u25cf Interstitial Ad\n\nReturn revenue in the onAdRevenuePaid(ATAdInfo adInfo) callback method of ATInterstitial#setAdRevenueListener(). The sample code is as follows:\nmInterstitialAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\n\n\nReturn revenue in the onAdRevenuePaid(TUAdInfo adInfo) callback method of TUInterstitial#setAdRevenueListener(). The sample code is as follows:\nmInterstitialAd.setAdRevenueListener(new TUAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(TUAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\n\n\u25cf Splash Ad\n\nReturn revenue in the onAdRevenuePaid(ATAdInfo adInfo) callback method of ATSplashAd#setAdRevenueListener(). The sample code is as follows:\nmSplashAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\n\n\nReturn revenue in the onAdRevenuePaid(TUAdInfo adInfo) callback method of TUSplashAd#setAdRevenueListener(). The sample code is as follows:\nmSplashAd.setAdRevenueListener(new TUAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(TUAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\n\n\n2. Adjust\n\nRefer to Firebase above. Call the following handleAdjustRevenueReport method in the onAdRevenuePaid(ATAdInfo adInfo) of each ad type:\npublic void handleAdjustRevenueReport(ATAdInfo adInfo) {\n    \/\/ Supported in adjust 4.38.1 and above\n    AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue( \"topon_sdk\");\n    adjustAdRevenue.setRevenue(adInfo.getPublisherRevenue(), adInfo.getCurrency());\n\n    \/\/ Optional configuration\n    adjustAdRevenue.setAdRevenueNetwork(String.valueOf(adInfo.getNetworkFirmId()));\n    adjustAdRevenue.setAdRevenueUnit(adInfo.getAdsourceId());\n    adjustAdRevenue.setAdRevenuePlacement(adInfo.getPlacementId());\n\n    \/\/ Send revenue data\n    Adjust.trackAdRevenue(adjustAdRevenue);\n}\n\n\n\nRefer to Firebase above. Call the following handleAdjustRevenueReport method in the onAdRevenuePaid(TUAdInfo adInfo) of each ad type:\npublic void handleAdjustRevenueReport(TUAdInfo adInfo) {\n    \/\/ Supported in adjust 4.38.1 and above\n    AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue( AdjustConfig.AD_REVENUE_TOPON);\n    adjustAdRevenue.setRevenue(adInfo.getPublisherRevenue(), adInfo.getCurrency());\n\n    \/\/ Optional configuration\n    adjustAdRevenue.setAdRevenueNetwork(String.valueOf(adInfo.getNetworkFirmId()));\n    adjustAdRevenue.setAdRevenueUnit(adInfo.getAdsourceId());\n    adjustAdRevenue.setAdRevenuePlacement(adInfo.getPlacementId());\n\n    \/\/ Send revenue data\n    Adjust.trackAdRevenue(adjustAdRevenue);\n}\n\n\n\n3. AppsFlyer\n\nRefer to Firebase above. Call the following handleAppsFlyerRevenueReport method in the onAdRevenuePaid(ATAdInfo adInfo) of each ad type:\npublic void handleAppsFlyerRevenueReport(ATAdInfo adInfo) {\n    \n    \/\/ v6.3.10+\n    String monetizationNetwork = adInfo.getNetworkName(); \n    Currency currency = Currency.getInstance(Locale.US);\n    if (\"CNY\".equalsIgnoreCase(adInfo.getCurrency())) {\n        currency = Currency.getInstance(Locale.CHINA);\n    }\n    Map customParams = new HashMap();\n\n    AppsFlyerAdRevenue.logAdRevenue(monetizationNetwork, MediationNetwork.Topon, currency, adInfo.getPublisherRevenue(), customParams);\n}\n\n\n\nRefer to Firebase above. Call the following handleAppsFlyerRevenueReport method in the onAdRevenuePaid(TUAdInfo adInfo) of each ad type:\npublic void handleAppsFlyerRevenueReport(TUAdInfo adInfo) {\n    \n    \/\/ v6.3.10+\n    String monetizationNetwork = adInfo.getNetworkName(); \n    Currency currency = Currency.getInstance(Locale.US);\n    if (\"CNY\".equalsIgnoreCase(adInfo.getCurrency())) {\n        currency = Currency.getInstance(Locale.CHINA);\n    }\n    Map customParams = new HashMap();\n\n    AppsFlyerAdRevenue.logAdRevenue(monetizationNetwork, MediationNetwork.Topon, currency, adInfo.getPublisherRevenue(), customParams);\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783494905","update_time":"1783495094"},"pure_content":"1. Firebase\n\nThe TopOn SDK supports obtaining the revenue of real-time displayed ads. You can listen to the onAdRevenuePaid() callback to get the eCPM value of the currently displayed ad to record the"},{"id":"161387","string_id":"PLQHxS0r","status":"1","parent_id":"68407","slug":"Revenue-reporting","order":"7","name":"Revenue Reporting","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1725977419","add_time":"1725973520","update_time":"1783495864","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"3","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"161387","content":"1. <\/span>Firebase<\/h2>\n\nThe TopOn SDK supports real-time revenue acquisition for ads. You can obtain the eCPM value of the current ad by using onAdRevenuePaid()<\/code> to record the ad_impression<\/strong> event in Google Analytics.<\/p>\n<\/blockquote>\n
\n\u203c\ufe0f Note<\/strong><\/span>: When linking Firebase with AdMob mediation, non-bidding sources from AdMob do not require reporting.<\/strong><\/span><\/p>\n<\/blockquote>\n
public void handleFirebase(ATAdInfo adInfo) {\n    FirebaseAnalytics mFirebaseAnalytics = FirebaseAnalytics.getInstance(mActivity);\n    if (adInfo != null) {\n        \/\/ When linking Firebase with AdMob mediation, non-bidding sources from AdMob do not require reporting.\n        if (adInfo.getNetworkFirmId() == 2 && adInfo.isHeaderBiddingAdsource() == 0) return;\n        FirebaseAnalytics mFirebaseAnalytics = FirebaseAnalytics.getInstance(mActivity);\n        Bundle params = new Bundle();\n        params.putString(FirebaseAnalytics.Param.AD_PLATFORM, \"TopOn\");\n        params.putString(FirebaseAnalytics.Param.AD_SOURCE, adInfo.getNetworkName());\n        params.putString(FirebaseAnalytics.Param.AD_FORMAT, adInfo.getFormat());\n        params.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, adInfo.getNetworkPlacementId());\n        params.putDouble(FirebaseAnalytics.Param.VALUE, adInfo.getPublisherRevenue());\n        params.putString(FirebaseAnalytics.Param.CURRENCY, adInfo.getCurrency());\n        mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, params);\n    }\n} <\/code><\/pre>\nPlease call handleFirebase()<\/code> within the onAdRevenuePaid(ATAdInfo adInfo)<\/code> for the following ad format:<\/p>\n
\u25cf <\/span>Banner Ads<\/h3>\nReport revenue in onAdRevenuePaid(ATAdInfo adInfo)<\/code>ofATBannerView#setAdRevenueListener()<\/code>. An example of the code is as below:<\/p>\n
mBannerView.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});<\/code><\/pre>\n <\/p>\n
\u25cf <\/span>Native Ads<\/h3>\nReport revenue in onAdRevenuePaid(ATAdInfo adInfo)<\/code>ofNativeAd#setAdRevenueListener()<\/code>. An example of the code is as below:<\/p>\n
mNativeAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});<\/code><\/pre>\n <\/p>\n
\u25cf <\/span>Interstitial Ads<\/h3>\nReport revenue in onAdRevenuePaid(ATAdInfo adInfo)<\/code>ofATInterstitial#setAdRevenueListener()<\/code>. An example of the code is as below:<\/p>\n
mInterstitialAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});<\/code><\/pre>\n <\/p>\n
\u25cf Rewarded Ads<\/span><\/h3>\nReport revenue in onAdRevenuePaid(ATAdInfo adInfo)<\/code>ofATRewardVideoAd#setAdRevenueListener()<\/code>. An example of the code is as below:<\/p>\n
mRewardVideoAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});<\/code><\/pre>\n <\/p>\n
\u25cf <\/span>Splash Ads<\/h3>\nReport revenue in onAdRevenuePaid(ATAdInfo adInfo)<\/code>ofATSplashAd#setAdRevenueListener()<\/code>. An example of the code is as below:<\/p>\n
mSplashAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});<\/code><\/pre>\n <\/p>\n
2. <\/span>Adjust<\/h2>\nRefer to the above solution and call handleAdjustRevenueReport()<\/code>inonAdRevenuePaid(ATAdInfo adInfo)<\/code> for each ad format:<\/p>\n
public void handleAdjustRevenueReport(ATAdInfo atAdInfo) {\n    AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue( AdjustConfig.AD_REVENUE_TOPON);\n    adjustAdRevenue.setRevenue(atAdInfo.getPublisherRevenue(), atAdInfo.getCurrency());\n\n    \/\/ option\n    adjustAdRevenue.setAdRevenueNetwork(String.valueOf(atAdInfo.getNetworkFirmId()));\n    adjustAdRevenue.setAdRevenueUnit(atAdInfo.getAdsourceId());\n    adjustAdRevenue.setAdRevenuePlacement(atAdInfo.getPlacementId());\n\n    \/\/ report revenue\n    Adjust.trackAdRevenue(adjustAdRevenue);\n}<\/code><\/pre>\n <\/p>\n
3. <\/span>AppsFlyer<\/h2>\nRefer to the above solution and call handleAppsFlyerRevenueReport()<\/code>inonAdRevenuePaid(ATAdInfo adInfo)<\/code> for each ad format:<\/p>\n
public void handleAppsFlyerRevenueReport(ATAdInfo atAdInfo) {\n    \/\/before v6.3.10\n    \/\/String monetizationNetwork = atAdInfo.getNetworkFirmId(); \n    \n    \/\/v6.3.10+\n    String monetizationNetwork = atAdInfo.getNetworkName(); \n    Currency currency = Currency.getInstance(Locale.US);\n    if (\"CNY\".equalsIgnoreCase(atAdInfo.getCurrency())) {\n        currency = Currency.getInstance(Locale.CHINA);\n    }\n    Map customParams = new HashMap<>();\n\n    AppsFlyerAdRevenue.logAdRevenue(monetizationNetwork, MediationNetwork.Topon, currency, atAdInfo.getPublisherRevenue(), customParams);\n}<\/code><\/pre>","pure_content":"1. Firebase\n\nThe TopOn SDK supports real-time revenue acquisition for ads. You can obtain the eCPM value of the current ad by using\u00a0onAdRevenuePaid() to record the\u00a0ad_impression event in Google Analytics.\n\n\n\u203c\ufe0f\u00a0Note: When linking Firebase with AdMob mediation, non-bidding sources from AdMob do not require reporting.\n\npublic void handleFirebase(ATAdInfo adInfo) {\n    FirebaseAnalytics mFirebaseAnalytics = FirebaseAnalytics.getInstance(mActivity);\n    if (adInfo != null) {\n        \/\/ When linking Firebase with AdMob mediation, non-bidding sources from AdMob do not require reporting.\n        if (adInfo.getNetworkFirmId() == 2 && adInfo.isHeaderBiddingAdsource() == 0) return;\n        FirebaseAnalytics mFirebaseAnalytics = FirebaseAnalytics.getInstance(mActivity);\n        Bundle params = new Bundle();\n        params.putString(FirebaseAnalytics.Param.AD_PLATFORM, \"TopOn\");\n        params.putString(FirebaseAnalytics.Param.AD_SOURCE, adInfo.getNetworkName());\n        params.putString(FirebaseAnalytics.Param.AD_FORMAT, adInfo.getFormat());\n        params.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, adInfo.getNetworkPlacementId());\n        params.putDouble(FirebaseAnalytics.Param.VALUE, adInfo.getPublisherRevenue());\n        params.putString(FirebaseAnalytics.Param.CURRENCY, adInfo.getCurrency());\n        mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, params);\n    }\n} \nPlease call handleFirebase() within the onAdRevenuePaid(ATAdInfo adInfo) for the following ad format:\n\u25cf Banner Ads\nReport revenue in onAdRevenuePaid(ATAdInfo adInfo)ofATBannerView#setAdRevenueListener(). An example of the code is as below:\nmBannerView.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\u00a0\n\u25cf Native Ads\nReport revenue in onAdRevenuePaid(ATAdInfo adInfo)ofNativeAd#setAdRevenueListener(). An example of the code is as below:\nmNativeAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\u00a0\n\u25cf Interstitial Ads\nReport revenue in onAdRevenuePaid(ATAdInfo adInfo)ofATInterstitial#setAdRevenueListener(). An example of the code is as below:\nmInterstitialAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\u00a0\n\u25cf Rewarded Ads\nReport revenue in onAdRevenuePaid(ATAdInfo adInfo)ofATRewardVideoAd#setAdRevenueListener(). An example of the code is as below:\nmRewardVideoAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\u00a0\n\u25cf Splash Ads\nReport revenue in onAdRevenuePaid(ATAdInfo adInfo)ofATSplashAd#setAdRevenueListener(). An example of the code is as below:\nmSplashAd.setAdRevenueListener(new ATAdRevenueListener() {\n    @Override\n    public void onAdRevenuePaid(ATAdInfo adInfo) {\n        handleFirebase(adInfo);\n    }\n});\n\u00a0\n2. Adjust\nRefer to the above solution and call handleAdjustRevenueReport()inonAdRevenuePaid(ATAdInfo adInfo)\u00a0for each ad format:\npublic void handleAdjustRevenueReport(ATAdInfo atAdInfo) {\n    AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue( AdjustConfig.AD_REVENUE_TOPON);\n    adjustAdRevenue.setRevenue(atAdInfo.getPublisherRevenue(), atAdInfo.getCurrency());\n\n    \/\/ option\n    adjustAdRevenue.setAdRevenueNetwork(String.valueOf(atAdInfo.getNetworkFirmId()));\n    adjustAdRevenue.setAdRevenueUnit(atAdInfo.getAdsourceId());\n    adjustAdRevenue.setAdRevenuePlacement(atAdInfo.getPlacementId());\n\n    \/\/ report revenue\n    Adjust.trackAdRevenue(adjustAdRevenue);\n}\n\u00a0\n3. AppsFlyer\nRefer to the above solution and call handleAppsFlyerRevenueReport()inonAdRevenuePaid(ATAdInfo adInfo) for each ad format:\npublic void handleAppsFlyerRevenueReport(ATAdInfo atAdInfo) {\n    \/\/before v6.3.10\n    \/\/String monetizationNetwork = atAdInfo.getNetworkFirmId(); \n    \n    \/\/v6.3.10+\n    String monetizationNetwork = atAdInfo.getNetworkName(); \n    Currency currency = Currency.getInstance(Locale.US);\n    if (\"CNY\".equalsIgnoreCase(atAdInfo.getCurrency())) {\n        currency = Currency.getInstance(Locale.CHINA);\n    }\n    Map customParams = new HashMap<>();\n\n    AppsFlyerAdRevenue.logAdRevenue(monetizationNetwork, MediationNetwork.Topon, currency, atAdInfo.getPublisherRevenue(), customParams);\n}","is_draft":"0","editor_type":"3","file_path":"","add_time":"1725973520","update_time":"1752831799"},"pure_content":"1. Firebase\n\nThe TopOn SDK supports real-time revenue acquisition for ads. You can obtain the eCPM value of the current ad by using\u00a0onAdRevenuePaid() to record the\u00a0ad_impression event in Google Analyt"},{"id":"383652","string_id":"3uhe5GxF","status":"1","parent_id":"68407","slug":"Advanced-Settings-qAE1","order":"6","name":"Advanced Settings","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1742371677","add_time":"1742366541","update_time":"1783495864","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"383652","content":"## \u25cf Block requests from specific platforms\n\n> **\ud83d\udca1Tips**\n>\n> - Required TopOn SDK version: v6.3.40 and above\n> - Must be called before `load()`\n> - [**network\\_firm\\_id**](https:\/\/help.toponad.net\/docs\/2KR6QU)\n    The `custom Network id` can be obtained by clicking on custom network in\n    the [TopOn dashboard](https:\/\/portal.toponad.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 Network 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 TopOn 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 network firm id](https:\/\/help.toponad.net\/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 TopOn 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 network firm id](https:\/\/help.toponad.net\/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":"\u25cf Block requests from specific platforms\n\n\ud83d\udca1Tips\n\nRequired TopOn SDK version: v6.3.40 and above\nMust be called before load()\n\n\nnetwork_firm_id\nThe custom Network id can be obtained by clicking on custom network in\nthe TopOn dashboard\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 Network 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 TopOn 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 network firm id\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 TopOn 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 network firm id\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":"1742366541","update_time":"1748604695"},"pure_content":"\u25cf Block requests from specific platforms\n\n\ud83d\udca1Tips\n\nRequired TopOn SDK version: v6.3.40 and above\nMust be called before load()\n\n\nnetwork_firm_id\nThe custom Network id can be obtained by clicking on custo"},{"id":"601207","string_id":"3tcVoTp7","status":"1","parent_id":"68407","slug":"OneTap-Mute","order":"5","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":"1756111987","add_time":"1756111756","update_time":"1783495864","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"601207","content":"## 1. One-Tap Mute Functionality  \n\nYou can programmatically mute third-party ad SDKs via this interface. Settings take effect immediately and can be configured during initialization or before loading any ad placement.  \n\n> Supported in SDK v6.5.15 and above.\n\n---\n\n## 2. Compatibility  \n\n| Network | Supported Ad Formats |  \n|:---:|:---:|  \n| AdMob | All formats |  \n| Inmobi | All formats |  \n| AppLovin | All formats |  \n| Mintegral | Native, Interstitial, Rewarded Video |  \n| Fyber | Rewarded, Interstitial, Banner |  \n| Bigo | Native |  \n| Xiaomi Columbus | Native |  \n| Max | All formats |  \n| Appnext | Native |  \n| Taurusx | Rewarded, Interstitial, Splash |  \n\n> ! Note: Custom ad networks are not supported\n\n---\n\n## 3. Implementation  \n\n```java\n\/\/ Supported in v6.5.15+ | Call before SDK initialization  \nATSDKGlobalSetting.setAdMuted(true);  \n```\n\n---\n\n## 4. Note\n\n> - setAdMuted(`true`) enables mute, setAdMuted(`false`) disables\n> - API configuration takes precedence over dashboard settings","pure_content":"1. One-Tap Mute Functionality\nYou can programmatically mute third-party ad SDKs via this interface. Settings take effect immediately and can be configured during initialization or before loading any ad placement.\n\nSupported in SDK v6.5.15 and above.\n\n\n2. Compatibility\n\n\n\n Network\n Supported Ad Formats\n\n\n\n\n AdMob\n All formats\n\n\n Inmobi\n All formats\n\n\n AppLovin\n All formats\n\n\n Mintegral\n Native, Interstitial, Rewarded Video\n\n\n Fyber\n Rewarded, Interstitial, Banner\n\n\n Bigo\n Native\n\n\n Xiaomi Columbus\n Native\n\n\n Max\n All formats\n\n\n Appnext\n Native\n\n\n Taurusx\n Rewarded, Interstitial, Splash\n\n\n\n\n! Note: Custom ad networks are not supported\n\n\n3. Implementation\n\/\/ Supported in v6.5.15+ | Call before SDK initialization  \nATSDKGlobalSetting.setAdMuted(true);  \n\n\n4. Note\n\n\nsetAdMuted(true) enables mute, setAdMuted(false) disables\nAPI configuration takes precedence over dashboard settings","is_draft":"0","editor_type":"2","file_path":"","add_time":"1756111756","update_time":"1765277052"},"pure_content":"1. One-Tap Mute Functionality\nYou can programmatically mute third-party ad SDKs via this interface. Settings take effect immediately and can be configured during initialization or before loading any a"},{"id":"741186","string_id":"P1PuTTao","status":"1","parent_id":"68407","slug":"Multi-instance-mode","order":"4","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":"\u5c0fT","published_time":"1773886625","add_time":"1773295239","update_time":"1783495864","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"741186","content":"**\ud83d\udca1Tips**\n\n* TaKu SDK Version Requirement: v6.5.80 or higher\n* Add support for the singleton request mode in the constructor of ATAdCreateConfig\n* Advertising cache and ad object dimension association\n\n#### [example](https:\/\/help.takuad.com\/docs\/SzD0zQXT?preview=1#%E7%A4%BA%E4%BE%8B)\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            @Override\n            public void onNativeAdLoadFail(AdError adError) {\n            }\n        }, build);\n```","pure_content":"\ud83d\udca1Tips\n\nTaKu SDK Version Requirement: v6.5.80 or higher\nAdd support for the singleton request mode in the constructor of ATAdCreateConfig\nAdvertising cache and ad object dimension association\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            @Override\n            public void onNativeAdLoadFail(AdError adError) {\n            }\n        }, build);","is_draft":"0","editor_type":"2","file_path":"","add_time":"1773295239","update_time":"1773886625"},"pure_content":"\ud83d\udca1Tips\n\nTaKu SDK Version Requirement: v6.5.80 or higher\nAdd support for the singleton request mode in the constructor of ATAdCreateConfig\nAdvertising cache and ad object dimension association\n\nexample"},{"id":"160190","string_id":"PTUtYJ","status":"1","parent_id":"68407","slug":"TopOn-ADX-reports-OAID","order":"3","name":"TopOn ADX reports OAID","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1726038904","add_time":"1725873605","update_time":"1783495864","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"3","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"160190","content":"\n\ud83d\udca1<\/span>Tips: <\/strong><\/span>For TopOn ADX and Cross Promotion, starting from version v6.3.70, TopOn SDK supports OAID reporting.<\/p>\n<\/blockquote>\n
In app\/build.gradle <\/strong>file, add the following code:<\/p>\n
dependencies {\n    api \"com.anythink.sdk:opt_oaid-tpn:<Version>\" \n}<\/code><\/pre>\n\nNote: <\/strong>Please replace <\/strong><\/code> with the actual version of the TopOn SDK you are integrating, for example: 6.4.08<\/strong><\/code>.<\/p>\n<\/blockquote>","pure_content":"\ud83d\udca1Tips: For TopOn ADX and Cross Promotion, starting from version v6.3.70, TopOn SDK supports OAID reporting.\n\nIn app\/build.gradle\u00a0file, add the following code:\ndependencies {\n    api \"com.anythink.sdk:opt_oaid-tpn:\" \n}\n\nNote: Please replace  with the actual version of the TopOn SDK you are integrating, for example:\u00a06.4.08.","is_draft":"0","editor_type":"3","file_path":"","add_time":"1725873605","update_time":"1748604694"},"pure_content":"\ud83d\udca1Tips: For TopOn ADX and Cross Promotion, starting from version v6.3.70, TopOn SDK supports OAID reporting.\n\nIn app\/build.gradle\u00a0file, add the following code:\ndependencies {\n    api \"com.anythink.sdk"}],"content":{"icon":"","desc":"","content_id":"68407","add_time":"1707205586","update_time":"1720603051","content":"","is_traffic_less":"0","file_type":""},"hot_list":[],"user_read_num":"0","is_auth":"0"},"msg":"Success","code":200}