Menu

Integration Checklist

This checklist is designed to help you systematically verify the app integration process, ensuring seamless connection and efficient operation of the ad SDK.


I. API Usage Check

  • When initializing the app, be sure to use the correct App Key and App ID, and ensure that the placement IDs of each ad format match the TopOn dashboard configuration.
  • After the SDK is initialized, all placements should be able to load and display ads normally.

II. Ad Format Check

● Rewarded Video Ad

  • Correctly initialize the ATRewardVideoAd instance and set the placement ID.
  • Set the ad event Listener (ATRewardVideoListener).
  • Correctly call the ad loading method (load).
  • Check if the ad is ready before displaying it (isReady).
  • Correctly call the ad display method (show).
  • Correctly perform preloading (onRewardedVideoAdFailed, onRewardedVideoAdPlayFailed, onRewardedVideoAdClosed).
  • ❗ Note: Do not directly retry loading the ad in onRewardedVideoAdFailed. A delayed operation is required. See the Sample Code for details.
  • [Optional] Set up the ad revenue listener (setAdRevenueListener).

● Interstitial Ad

  • Correctly initialize the ATInterstitial instance and set the placement ID.
  • Set the ad event Listener (ATInterstitialListener).
  • Correctly call the ad loading method (load).
  • Check if the ad is ready before displaying it (isReady).
  • Correctly call the ad display method (show).
  • Correctly perform preloading (onInterstitialAdLoadFail, onInterstitialAdVideoError, onInterstitialAdClose).
  • ❗ Note: Do not directly retry loading the ad in onInterstitialAdLoadFail. A delayed operation is required. See the Sample Code for details.
  • [Optional] Set up the ad revenue listener (setAdRevenueListener).

● Splash Ad

  • Correctly initialize the ATSplashAd instance and set the placement ID and timeout duration (in milliseconds).
  • Set the ad event Listener (ATSplashAdEZListener).
  • Correctly call the ad loading method (loadAd).
  • Check if the ad is ready before displaying it (isReady).
  • Correctly call the ad display method (show) and correctly pass in SplashAdContainer.
  • Note: If there is a brand logo area, pass the correct width and height information for SplashAdContainer, with the height being ideally greater than 80% of the screen.
  • Correctly perform preloading (onAdDismiss) for warm-start splash.
  • [Optional] Set up the ad revenue listener (setAdRevenueListener).

● Banner Ad

  • Correctly initialize the ATBannerView instance and set the placement ID and BannerViewContainer.
  • When adding ATBannerView, set the width and height information: ATBannerView.setLayoutParams(new FrameLayout.LayoutParams(width, height));.
  • Set the ad event Listener (ATBannerListener).
  • Correctly set the Banner Size (setLocalExtra).
  • Correctly call the ad loading method (loadAd).
  • Correctly set the visibility of the container to properly render the ad.
  • Correctly call the ad display method (show).
  • [Optional] Set up the ad revenue listener (setAdRevenueListener).
  • Correctly release ad resources (destroy).

● Native Ad

  • Correctly initialize the ATNative instance and set the placement ID.
  • Set the ad event Listener (ATNativeNetworkListener).
  • Correctly call the ad loading method (makeAdRequest).
  • Self-Rendering Ad: Correctly bind ATNativePrepareInfo and SelfRenderView.
  • Template Ad: ATNativeAdView needs to have its width and height set and correctly call the renderAdContainer and prepare methods.
  • Correctly perform preloading (onNativeAdLoadFail).
  • ❗ Note: Do not directly retry loading the ad in onNativeAdLoadFail. A delayed operation is required. See the Sample Code for details.
  • [Optional] Set up the ad revenue listener (setAdRevenueListener).
  • Correctly release ad resources (destroy).

● Rewarded Video Ad

  • Correctly initialize the TURewardVideoAd instance and set the placement ID.
  • Set the ad event Listener (TURewardVideoListener).
  • Correctly call the ad loading method (load).
  • Check if the ad is ready before displaying it (isReady).
  • Correctly call the ad display method (show).
  • Correctly perform preloading (onRewardedVideoAdFailed, onRewardedVideoAdPlayFailed, onRewardedVideoAdClosed).
  • [Optional] Set up the ad revenue listener (setAdRevenueListener).

● Interstitial Ad

  • Correctly initialize the TURewardedInterstitial instance and set the placement ID.
  • Set the ad event Listener (TURewardedInterstitialListener).
  • Correctly call the ad loading method (load).
  • Check if the ad is ready before displaying it (isReady).
  • Correctly call the ad display method (show).
  • Correctly perform preloading (onInterstitialAdLoadFail, onInterstitialAdVideoError, onInterstitialAdClose).
  • [Optional] Set up the ad revenue listener (setAdRevenueListener).

● Splash Ad

  • Correctly initialize the TUSplashAd instance and set the placement ID and timeout duration (in milliseconds).
  • Set the ad event Listener (TUSplashAdEZListener).
  • Correctly call the ad loading method (loadAd).
  • Check if the ad is ready before displaying it (isReady).
  • Correctly call the ad display method (show) and correctly pass in SplashAdContainer.
  • Note: If there is a brand logo area, pass the correct width and height information for SplashAdContainer, with the height being ideally greater than 80% of the screen.
  • Correctly perform preloading (onAdDismiss) for warm-start splash.
  • [Optional] Set up the ad revenue listener (setAdRevenueListener).

● Banner Ad

  • Correctly initialize the TUBannerView instance and set the placement ID and BannerViewContainer.
  • When adding TUBannerView, set the width and height information: TUBannerView.setLayoutParams(new FrameLayout.LayoutParams(width, height));.
  • Set the ad event Listener (TUBannerListener).
  • Correctly set the Banner Size (setLocalExtra).
  • Correctly call the ad loading method (loadAd).
  • Correctly set the visibility of the container to properly render the ad.
  • [Optional] Set up the ad revenue listener (setAdRevenueListener).
  • Correctly release ad resources (destroy).

● Native Ad

  • Correctly initialize the TUNative instance and set the placement ID.
  • Set the ad event Listener (TUNativeNetworkListener).
  • Correctly call the ad loading method (makeAdRequest).
  • Self-Rendering Ad: Correctly bind TUNativePrepareInfo and SelfRenderView.
  • Template Ad: TUNativeAdView needs to have its width and height set and correctly call the renderAdContainer and prepare methods.
  • Correctly perform preloading (onNativeAdLoadFail).
  • [Optional] Set up the ad revenue listener (setAdRevenueListener).
  • Correctly release ad resources (destroy).

III. General Check Items

  • Use the Debug Tool to verify ad integration (ATDebuggerUITest.showDebuggerUI(context);).
  • Enable the debug log switch during the debugging phase (ATSDK.setNetworkLogDebug(true);).
  • Use the Debug Tool to verify ad integration (TUDebuggerUITest.showDebuggerUI(context);).
  • Enable the debug log switch during the debugging phase (TUSDK.setNetworkLogDebug(true);).

IV. Compliance Check

  • The app-ads.txt file has been correctly uploaded.

V. Third-Party Revenue Reporting

  • Please refer to the Sample Code for value retrieval and reporting.

Previous
Google Data Security Guidelines
Next
Testing Checklist
Last modified: 2026-07-08Powered by