{"data":{"id":"68445","string_id":"MolFLG","status":"1","parent_id":"68373","slug":"UC0qle","order":"8","name":"iOS Guide","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"","add_time":"1707205652","update_time":"1751517718","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":"115923","string_id":"8Mjt2b","status":"1","parent_id":"68445","slug":"integrated","order":"12","name":"Integration","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1719303866","update_time":"1754546808","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"115923","content":"## 1\\. Prerequisites\n\n+ Latest version of Xcode\n+ [Register and log in to](https:\/\/portal.toponad.com\/m\/login) TopOn account and add the application in [application management](https:\/\/portal.toponad.com\/m\/app)\n+ Download [the Demo Project](https:\/\/github.com\/toponteam\/TopOn-iOS-Pod-Demo)\n\n> You can download or update Xcode in [the AppStore](https:\/\/developer.apple.com\/xcode\/) , or log in to [the Apple Developer Resource Center](https:\/\/developer.apple.com\/download\/all\/?q=Xcode) to download a specific version. (Third-party download tools may not be supported).\n\n## 2\\. Import TopOn iOS SDK into the project\n\nWe provide the following two ways to import TopOn iOS SDK:\n\n+ CocoaPods (preferred)\n+ Manual download and import\n\n> The easiest way to import the SDK into an iOS project is to use CocoaPods. If you are new to CocoaPods, please refer to [the official CocoaPods website.](https:\/\/guides.cocoapods.org\/using\/using-cocoapods)\n\n### 2.1 CocoaPods (preferred)\n\nPlease click [here](https:\/\/portal.toponad.com\/m\/sdk\/download) to go to the SDK Download Center. You can refer to the following picture steps to select and generate the code in the Podfile according to your needs.\n\n> Please do not leave the SDK Download Center page after generating the relevant code, as the content will be used in the subsequent docking process.\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/68871a41bb318.png)\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/68871a5d75489.png)\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/68871a8eda7fb.png)\n\n> After switching to the path where the podfile is located, execute `pod install --repo-update` in the terminal to install it\n\n### 2.2 Manual download and import\n\n#### 2.2.1 Manually download TopOn iOS SDK\n\nPlease click [here](https:\/\/portal.toponad.com\/m\/sdk\/download) to go to the SDK Download Center. You can refer to the following sample images, select the advertising platform according to your needs and then download the TopOn iOS SDK.\n\n> + Please do not leave the SDK Download Center page after downloading the SDK, as the content will be used in the subsequent docking process.\n> + After you click \"Generate Access Code\", the system will process your request immediately. After your patient waiting, the download link will be successfully generated and you can click the \"Download\" button.\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/68871aaa793fd.png)\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/68871a5d75489.png)\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/68871b0df316b.png)\n\n#### 2.2.2 Manually import the TopOn iOS SDK\n\n\u2460 Please unzip the ZIP file you downloaded in the previous step, and then drag it into your Xcode project.\n\n\u2461 Modify the Xcode project Build Setting (please refer to the picture below).\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/688719c314b53.png)\n\n\u2462 Please return to the SDK Download Center page, check the \"SDK Import Tips\" column, and add the dependencies listed in the column to the Xcode project.\n\n> Depending on the type of advertising platform you have selected, the \"SDK Introduction Prompt\" column may appear additionally (as shown below). If the \"SDK Introduction Prompt\" column does not appear after you have selected the advertising platform and clicked \"Generate Access Code\", you can skip this step and continue with the subsequent access process.\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/68871b7eaf3c9.png)\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/688719c344738.png)\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/688719c313580.png)\n\n> At this point, you have completed the introduction of TopOn iOS SDK, but please do not leave the \"SDK Download Center\" page, as the subsequent docking process will still use its content.\n\n## 3\\. Update your Info.plist\n\n### 3.1 Open Info.plist\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/688719c32c2ca.png)\n\n### 3.2 Add SKAdNetworkItems key\n\n> The SKAdNetwork ID of UnityAds is different for each project. If you choose this advertising platform, please refer to the one generated by the UnityAds background. You need to go to the UnityAds management background to check it.\n\nPlease return to the \" SDK Download Center\" page opened above and add the content listed in the \"SKAdNetwork IDs Code\" column to your Info.plist file, as shown below:\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/68871b92dcc41.png)\n\n### 3.3 Add LSApplicationQueriesSchemes key\n\nPlease return to the \" SDK Download Center\" page opened above, or directly copy the code below and add the contents listed in the following columns to your Info.plist file. Please refer to the figure below:\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/68871bc89963b.png)\n\n### 3.4 **Add NSUserTrackingUsageDescription key**\n\n> Starting from iOS14.5, applications can only access users' IDFA data and deliver targeted ads to users with the user's explicit permission.\n> \n> The IDFA will not be available until the app calls the [App Tracking Transparency](https:\/\/developer.apple.com\/documentation\/apptrackingtransparency?language=objc) framework to request app tracking authorization from the end user. If an app does not make this request, the IDFA read will return a string of all 0s.\n\n```markup\nNSUserTrackingUsageDescription<\/key>\nWrite Your ATT Desc<\/string>\n```\n\n### 3.5 Add NSAppTransportSecurity key\n\n> After iOS 10, the Allow Arbitrary Loads in Web Content key is ignored when it exists.\n\n```markup\nNSAppTransportSecurity<\/key>\n\n NSAllowsArbitraryLoads<\/key>\n \n<\/dict>\n```\n\n### 3.6 Adding **the GADApplicationIdentifier key** to the AdMob platform\n\n> Due to AdMob requirements, this key is only added if you check the box to use the platform. For more information, go [here](https:\/\/support.google.com\/admob\/answer\/7356431?hl=zh-Hans) .\n\n```markup\nGADApplicationIdentifier<\/key>\nYour GADApplicationIdentifier <\/string>\n\n```\n\n## 4\\. Request app tracking permission from users to obtain IDFA\n\nYou need to apply for app tracking permissions from users through App Tracking Transparency.\n\n> + Before you use the following method, you need to set the NSUserTrackingUsageDescription key in your Info.plist file. [Click here](\/docs\/integrated?preview=1#3.5_Add_NSAppTransportSecurity_key) for details.\n> + If you need to adapt GDPR or Google UMP in your project, [please go here](\/docs\/Google-UMP-shi-pei-shi-yong-zhi-nan-fMgm) to configure it without adding the following code.\n\n```objc\n#import \n#import \n#import \n\n@implementation AppDelegate\n \n- (void)applicationDidBecomeActive:(UIApplication *)application {\n if (@available(iOS 14, *)) {\n \/\/iOS 14\n [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {\n\n }];\n } else {\n NSString * idfaStr = [ASIdentifierManager sharedManager].advertisingIdentifier.UUIDString;\n }\n}\n\n@end\n```\n\n> In iOS 15 and above, calling this API will prompt for authorization only when the application state is\u00a0`UIApplicationStateActive`. If another permission request is waiting for user confirmation, the authorization prompt will not be displayed. Therefore, you can choose one of the following options as a backup solution:\n> \n> + After launching the app, wait 1 to 2 seconds to check and apply for permissions.\n> + Check and apply for permissions in the main controller's\u00a0`ViewDidAppear`\u00a0method.\n\n## 5\\. Enable debug logging\n\n```objc\n - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {\n \n \/\/....\n \/\/SDK log switch\n [ATAPI setLogEnabled:YES];\/\/Turn on debug logs\n \/\/....\n \n return YES;\n}\n```\n\n## 6\\. SDK integration verification\n\nYou can check whether the SDK integration of each advertising platform is normal based on the log output by this method.\n\n> Please note that this feature needs to be removed before the package can be put on the shelves.\n\n```objc\n - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {\n \n \/\/....\n \/\/Open SDK logs\n [ATAPI setLogEnabled:YES];\/\/Turn on debug logs\n\n \/\/After logs open\n [ATAPI integrationChecking];\n\n return YES;\n}\n```\n\nSample output:\n\n![](https:\/\/resource-wangsu.helplook.net\/docker_production\/wa7y4l\/article\/8Mjt2b\/688719c30bcd4.png)\n\n## 7\\. Initialize SDK\n\n> 1\\. If your app is launched in the EU, please configure GDPR **before initialization** . If you choose the Admob platform, you need to set up [Google UMP](\/docs\/Google-UMP-shi-pei-shi-yong-zhi-nan-fMgm) for launch in the EU . After setting up Google UMP, you do not need to perform additional GDPR configuration.\n> \n> 2\\. If your app needs to display a privacy policy and request user consent when the user first launches the app, please refer to [TopOn Privacy Policy](\/docs\/Privacy-Policy)\u00a0.\n\n```objc\n - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {\n\n \/\/ Init SDK\n [[ATAPI sharedInstance] startWithAppID:@\"Your AppID\" appKey:@\"Your appKey\" error:nil];\n \/\/....\n \n return YES;\n}\n```","pure_content":"1. Prerequisites\n\nLatest version of Xcode\n\nRegister and log in to TopOn account and add the application in application management\n\nDownload the Demo Project\n\n\n\nYou can download or update Xcode in the AppStore , or log in to the Apple Developer Resource Center to download a specific version. (Third-party download tools may not be supported).\n\n2. Import TopOn iOS SDK into the project\nWe provide the following two ways to import TopOn iOS SDK:\n\nCocoaPods (preferred)\nManual download and import\n\n\nThe easiest way to import the SDK into an iOS project is to use CocoaPods. If you are new to CocoaPods, please refer to the official CocoaPods website.\n\n2.1 CocoaPods (preferred)\nPlease click here to go to the SDK Download Center. You can refer to the following picture steps to select and generate the code in the Podfile according to your needs.\n\nPlease do not leave the SDK Download Center page after generating the relevant code, as the content will be used in the subsequent docking process.\n\n\n\n\n\nAfter switching to the path where the podfile is located, execute pod install --repo-update in the terminal to install it\n\n2.2 Manual download and import\n2.2.1 Manually download TopOn iOS SDK\nPlease click here to go to the SDK Download Center. You can refer to the following sample images, select the advertising platform according to your needs and then download the TopOn iOS SDK.\n\n\nPlease do not leave the SDK Download Center page after downloading the SDK, as the content will be used in the subsequent docking process.\nAfter you click \"Generate Access Code\", the system will process your request immediately. After your patient waiting, the download link will be successfully generated and you can click the \"Download\" button.\n\n\n\n\n\n2.2.2 Manually import the TopOn iOS SDK\n\u2460 Please unzip the ZIP file you downloaded in the previous step, and then drag it into your Xcode project.\n\u2461 Modify the Xcode project Build Setting (please refer to the picture below).\n\n\u2462 Please return to the SDK Download Center page, check the \"SDK Import Tips\" column, and add the dependencies listed in the column to the Xcode project.\n\nDepending on the type of advertising platform you have selected, the \"SDK Introduction Prompt\" column may appear additionally (as shown below). If the \"SDK Introduction Prompt\" column does not appear after you have selected the advertising platform and clicked \"Generate Access Code\", you can skip this step and continue with the subsequent access process.\n\n\n\n\n\nAt this point, you have completed the introduction of TopOn iOS SDK, but please do not leave the \"SDK Download Center\" page, as the subsequent docking process will still use its content.\n\n3. Update your Info.plist\n3.1 Open Info.plist\n\n3.2 Add SKAdNetworkItems key\n\nThe SKAdNetwork ID of UnityAds is different for each project. If you choose this advertising platform, please refer to the one generated by the UnityAds background. You need to go to the UnityAds management background to check it.\n\nPlease return to the \" SDK Download Center\" page opened above and add the content listed in the \"SKAdNetwork IDs Code\" column to your Info.plist file, as shown below:\n\n3.3 Add LSApplicationQueriesSchemes key\nPlease return to the \" SDK Download Center\" page opened above, or directly copy the code below and add the contents listed in the following columns to your Info.plist file. Please refer to the figure below:\n\n3.4 Add NSUserTrackingUsageDescription key\n\nStarting from iOS14.5, applications can only access users' IDFA data and deliver targeted ads to users with the user's explicit permission.\nThe IDFA will not be available until the app calls the App Tracking Transparency framework to request app tracking authorization from the end user. If an app does not make this request, the IDFA read will return a string of all 0s.\n\nNSUserTrackingUsageDescription<\/key>\nWrite Your ATT Desc<\/string>\n\n3.5 Add NSAppTransportSecurity key\n\nAfter iOS 10, the Allow Arbitrary Loads in Web Content key is ignored when it exists.\n\nNSAppTransportSecurity<\/key>\n\n NSAllowsArbitraryLoads<\/key>\n \n<\/dict>\n\n3.6 Adding the GADApplicationIdentifier key to the AdMob platform\n\nDue to AdMob requirements, this key is only added if you check the box to use the platform. For more information, go here .\n\nGADApplicationIdentifier<\/key>\nYour GADApplicationIdentifier <\/string>\n\n\n4. Request app tracking permission from users to obtain IDFA\nYou need to apply for app tracking permissions from users through App Tracking Transparency.\n\n\nBefore you use the following method, you need to set the NSUserTrackingUsageDescription key in your Info.plist file. Click here for details.\nIf you need to adapt GDPR or Google UMP in your project, please go here to configure it without adding the following code.\n\n\n#import \n#import \n#import \n\n@implementation AppDelegate\n \n- (void)applicationDidBecomeActive:(UIApplication *)application {\n if (@available(iOS 14, *)) {\n \/\/iOS 14\n [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {\n\n }];\n } else {\n NSString * idfaStr = [ASIdentifierManager sharedManager].advertisingIdentifier.UUIDString;\n }\n}\n\n@end\n\n\nIn iOS 15 and above, calling this API will prompt for authorization only when the application state is\u00a0UIApplicationStateActive. If another permission request is waiting for user confirmation, the authorization prompt will not be displayed. Therefore, you can choose one of the following options as a backup solution:\n\nAfter launching the app, wait 1 to 2 seconds to check and apply for permissions.\nCheck and apply for permissions in the main controller's\u00a0ViewDidAppear\u00a0method.\n\n\n5. Enable debug logging\n - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {\n \n \/\/....\n \/\/SDK log switch\n [ATAPI setLogEnabled:YES];\/\/Turn on debug logs\n \/\/....\n \n return YES;\n}\n\n6. SDK integration verification\nYou can check whether the SDK integration of each advertising platform is normal based on the log output by this method.\n\nPlease note that this feature needs to be removed before the package can be put on the shelves.\n\n - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {\n \n \/\/....\n \/\/Open SDK logs\n [ATAPI setLogEnabled:YES];\/\/Turn on debug logs\n\n \/\/After logs open\n [ATAPI integrationChecking];\n\n return YES;\n}\n\nSample output:\n\n7. Initialize SDK\n\n1. If your app is launched in the EU, please configure GDPR before initialization . If you choose the Admob platform, you need to set up Google UMP for launch in the EU . After setting up Google UMP, you do not need to perform additional GDPR configuration.\n2. If your app needs to display a privacy policy and request user consent when the user first launches the app, please refer to TopOn Privacy Policy\u00a0.\n\n - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {\n\n \/\/ Init SDK\n [[ATAPI sharedInstance] startWithAppID:@\"Your AppID\" appKey:@\"Your appKey\" error:nil];\n \/\/....\n \n return YES;\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1719303869","update_time":"1754546798"},"pure_content":"1. Prerequisites\n\nLatest version of Xcode\n\nRegister and log in to TopOn account and add the application in application management\n\nDownload the Demo Project\n\n\n\nYou can download or update Xcode in the"},{"id":"115971","string_id":"GRlOmB","status":"1","parent_id":"68445","slug":"GRlOmB","order":"11","name":"AD Formats","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1719306114","update_time":"1753783517","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","file_type":"","auth_id":"[\"-1\"]","pure_content":""},{"id":"68472","string_id":"pxxrcf","status":"1","parent_id":"68445","slug":"bR8N2L","order":"10","name":"Advanced","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1707205695","update_time":"1753783517","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","file_type":"","auth_id":"[\"-1\"]","pure_content":""},{"id":"577714","string_id":"N4NLVZm4","status":"1","parent_id":"68445","slug":"nb8EPo","order":"9","name":"Privacy Policy","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1753685485","update_time":"1753783517","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","file_type":"","auth_id":"[\"-1\"]","pure_content":""},{"id":"68490","string_id":"cWhOQw","status":"1","parent_id":"68445","slug":"3MffkL","order":"8","name":"Testing Networks","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1707205728","update_time":"1753783517","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","file_type":"","auth_id":"[\"-1\"]","pure_content":""},{"id":"554842","string_id":"PeMKw4WW","status":"1","parent_id":"68445","slug":"Integration-Checklist","order":"7","name":"Integration Checklist","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u51cc\u5929\u5b50","add_time":"1752231130","update_time":"1754885144","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"554842","content":"This checklist is designed to help you systematically verify the application integration process, ensuring seamless integration and efficient operation of the advertising SDK.\n\n---\n\n## 1. API Usage Check\n\n- During application initialization, make sure to use the correct `App Key` and `App ID`, and ensure that the placement IDs for each ad format match the configuration in the Taku dashboard; also check that the application `Bundle ID` matches the configuration\n- Check permission configurations in Info.plist such as ATT and HTTP\n- After SDK initialization, all placements should be able to load and display ads normally\n\n---\n\n## 2. Ad Format Check\n\n### Rewarded Video Ads\n- [ ] Correctly set `Placement ID`\n- [ ] Implement ad event Delegate (`ATRewardedVideoDelegate`)\n- [ ] Correctly call ad loading method (`loadADWithPlacementID`)\n- [ ] Check if ad is ready before showing (`rewardedVideoReadyForPlacementID`)\n- [ ] Correctly call ad display method and set delegate (`showRewardedVideoWithPlacementID:config:inViewController:delegate:`), avoid calling display APIs in `- (void)viewWillAppear:(BOOL)animated` and `- (void)viewWillDisappear:(BOOL)animated`\n- [ ] Correctly implement preloading (`didFailToLoadADWithPlacementID` requires a delay before initiating preloading, for details see [Sample Code](\/docs\/Rewarded-video-ads#2.%20Load%20Rewarded%20Video%20Ad); `rewardedVideoDidFailToPlayForPlacementID` requires no delay; `rewardedVideoDidCloseForPlacementID` requires no delay)\n- [ ] [Optional] Set ad revenue listener (`didRevenueForPlacementID`)\n\n### Interstitial Ads\n- [ ] Correctly set `Placement ID`\n- [ ] Implement ad event Delegate (`ATInterstitialDelegate`)\n- [ ] Correctly call ad loading method (`loadADWithPlacementID`)\n- [ ] Check if ad is ready before showing (`interstitialReadyForPlacementID`)\n- [ ] Correctly call ad display method and set delegate, ensure the input parameter controller can normally present ads in the ad scenario (`showInterstitialWithPlacementID:showConfig:inViewController:delegate:nativeMixViewBlock:`), avoid calling display APIs in `- (void)viewWillAppear:(BOOL)animated` and `- (void)viewWillDisappear:(BOOL)animated`\n- [ ] Correctly implement preloading (`didFailToLoadADWithPlacementID` requires a delay before initiating preloading, for details see [Sample Code](\/docs\/Interstitial-Ads-srKk#2.%20Loading%20Interstitial%20Ads); `interstitialDidFailToPlayVideoForPlacementID` requires no delay; `interstitialDidCloseForPlacementID` requires no delay)\n- [ ] [Optional] Set ad revenue listener (`didRevenueForPlacementID`)\n\n### Splash Ads\n- [ ] Correctly set `Placement ID`\n- [ ] Set ad event Delegate (`ATSplashDelegate`)\n- [ ] Correctly call ad loading method (`loadADWithPlacementID`)\n- [ ] Check if ad is ready before showing (`showSplashWithPlacementID:config:window:inViewController:extra:delegate:`)\n- [ ] Correctly call ad display method and set delegate, ensure the input parameter Window and controller can normally present ads in the ad scenario (`showAdWithWindow:viewController:withExtra:`), avoid calling display APIs in `- (void)viewWillAppear:(BOOL)animated` and `- (void)viewWillDisappear:(BOOL)animated`\n- [ ] Correctly set timeout duration (`kATSplashExtraTolerateTimeoutKey`)\n- [ ] For hot start splash scenarios, correctly implement preloading (`splashDidCloseForPlacementID` requires preloading)\n- [ ] [Optional] Set ad revenue listener (`didRevenueForPlacementID`)\n\n### Banner Ads\n- [ ] Correctly set `Placement ID`\n- [ ] Set ad event Delegate (`ATBannerDelegate`)\n- [ ] Correctly set Banner Size (`kATAdLoadingExtraBannerAdSizeKey`)\n- [ ] Correctly call ad loading method (`loadADWithPlacementID`)\n- [ ] Check if ad is ready before showing (`bannerAdReadyForPlacementID`)\n- [ ] Correctly call ad display method (`retrieveBannerViewForPlacementID`)\n- [ ] Correctly set the visibility of `ATBannerView` and its container to properly display ads\n- [ ] Correctly set the `delegate` of `ATBannerView` and its `presentingViewController`\n- [ ] [Optional] Set ad revenue listener (`revenueDelegate`)\n- [ ] `Auto-refresh` feature configuration: `TopOn Dashboard > App Management > Select Target App > Enter Target Banner Placement > Advanced Settings`\n- [ ] When temporarily not displaying, you can set the banner object's `isHidden`; when permanently not displaying, you need to destroy it with `destroyBanner`\n\n### Native Self-Rendered Ads\n- [ ] Correctly set `Placement ID`\n- [ ] Set ad event Delegate (`ATNativeADDelegate`)\n- [ ] Correctly call ad loading method (`loadADWithPlacementID`)\n- [ ] Use `ATNativeADConfiguration` for pre-display configuration\n- [ ] Correctly create `ATNativeAdOffer` through `getNativeAdOfferWithPlacementID` and use after null check\n- [ ] Self-rendered ads: Create self-rendered view, and correctly assign values and layout to components based on the information content in `ATNativeAdOffer`\n- [ ] Correctly create native ad view through `[[ATNativeADView alloc] initWithConfiguration:config currentOffer:placementID:]`\n- [ ] Self-rendered ads: Correctly call `[nativeADView getMediaView]` to get `mediaView` object, check for null, and if not null, need to correctly add layout\n- [ ] Self-rendered ads: Call `registerClickableViewArray` to correctly pass in UI controls for registering click events\n- [ ] Self-rendered ads: Call `ATNativePrepareInfo loadPrepareInfo:` to correctly pass in UI controls to be bound for rendering\n- [ ] Correctly call `rendererWithNativeAdView:selfRenderView:adInfo:` for rendering, then set `nativeADView` to visible\n- [ ] Correctly implement preloading (`didFailToLoadADWithPlacementID` requires a delay before initiating preloading, for details see [Sample Code](\/docs\/Native-Advertising#2.%20Loading%20Ads); `didTapCloseButtonInAdView` requires no delay)\n- [ ] [Optional] Set ad revenue listener (`didRevenueForPlacementID`)\n- [ ] Correctly release ad resources (`destroyNative`, `ATNativeAdOffer=nil`)\n\n### Native Template Ads\n- [ ] Correctly set `Placement ID`\n- [ ] Set ad event Delegate (`ATNativeADDelegate`)\n- [ ] Correctly call ad loading method (`loadADWithPlacementID`)\n- [ ] Use `ATNativeADConfiguration` for pre-display configuration\n- [ ] Correctly create `ATNativeAdOffer` through `getNativeAdOfferWithPlacementID` and use after null check\n- [ ] Correctly create native ad view through `[[ATNativeADView alloc] initWithConfiguration:config currentOffer:placementID:]`\n- [ ] Correctly call `rendererWithNativeAdView:selfRenderView:adInfo:` for rendering, then set `nativeADView` to visible\n- [ ] Correctly implement preloading (`didFailToLoadADWithPlacementID` requires a delay before initiating preloading, for details see [Sample Code](\/docs\/Native-Advertising#2.%20Loading%20Ads); `didTapCloseButtonInAdView` requires no delay)\n- [ ] [Optional] Set ad revenue listener (`didRevenueForPlacementID`)\n- [ ] Correctly release ad resources (`destroyNative`)\n\n---\n\n## 3. General Check Items\n\n- [ ] Use debugging tools to verify ad integration status (`[[ATDebuggerAPI sharedInstance] showDebuggerInViewController:vc showType:ATShowDebugUIPresent debugkey:@\"Enter your DebugKey, DebugKey can be obtained from Backend->Account Management->Key, DebugKey needs to correspond with AppID and AppKey\"];`)\n- [ ] Enable debug log switch during debugging phase (`[ATAPI setLogEnabled:YES];`)\n\n---\n\n## 4. Third-Party Revenue Reporting\n\n- [ ] For value reporting, please refer to [Sample Code](\/docs\/rgJOQXRU)","pure_content":"This checklist is designed to help you systematically verify the application integration process, ensuring seamless integration and efficient operation of the advertising SDK.\n\n1. API Usage Check\n\nDuring application initialization, make sure to use the correct App Key and App ID, and ensure that the placement IDs for each ad format match the configuration in the Taku dashboard; also check that the application Bundle ID matches the configuration\nCheck permission configurations in Info.plist such as ATT and HTTP\nAfter SDK initialization, all placements should be able to load and display ads normally\n\n\n2. Ad Format Check\nRewarded Video Ads\n\n[ ] Correctly set Placement ID\n\n[ ] Implement ad event Delegate (ATRewardedVideoDelegate)\n[ ] Correctly call ad loading method (loadADWithPlacementID)\n[ ] Check if ad is ready before showing (rewardedVideoReadyForPlacementID)\n[ ] Correctly call ad display method and set delegate (showRewardedVideoWithPlacementID:config:inViewController:delegate:), avoid calling display APIs in - (void)viewWillAppear:(BOOL)animated and - (void)viewWillDisappear:(BOOL)animated\n\n[ ] Correctly implement preloading (didFailToLoadADWithPlacementID requires a delay before initiating preloading, for details see Sample Code; rewardedVideoDidFailToPlayForPlacementID requires no delay; rewardedVideoDidCloseForPlacementID requires no delay)\n[ ] [Optional] Set ad revenue listener (didRevenueForPlacementID)\n\nInterstitial Ads\n\n[ ] Correctly set Placement ID\n\n[ ] Implement ad event Delegate (ATInterstitialDelegate)\n[ ] Correctly call ad loading method (loadADWithPlacementID)\n[ ] Check if ad is ready before showing (interstitialReadyForPlacementID)\n[ ] Correctly call ad display method and set delegate, ensure the input parameter controller can normally present ads in the ad scenario (showInterstitialWithPlacementID:showConfig:inViewController:delegate:nativeMixViewBlock:), avoid calling display APIs in - (void)viewWillAppear:(BOOL)animated and - (void)viewWillDisappear:(BOOL)animated\n\n[ ] Correctly implement preloading (didFailToLoadADWithPlacementID requires a delay before initiating preloading, for details see Sample Code; interstitialDidFailToPlayVideoForPlacementID requires no delay; interstitialDidCloseForPlacementID requires no delay)\n[ ] [Optional] Set ad revenue listener (didRevenueForPlacementID)\n\nSplash Ads\n\n[ ] Correctly set Placement ID\n\n[ ] Set ad event Delegate (ATSplashDelegate)\n[ ] Correctly call ad loading method (loadADWithPlacementID)\n[ ] Check if ad is ready before showing (showSplashWithPlacementID:config:window:inViewController:extra:delegate:)\n[ ] Correctly call ad display method and set delegate, ensure the input parameter Window and controller can normally present ads in the ad scenario (showAdWithWindow:viewController:withExtra:), avoid calling display APIs in - (void)viewWillAppear:(BOOL)animated and - (void)viewWillDisappear:(BOOL)animated\n\n[ ] Correctly set timeout duration (kATSplashExtraTolerateTimeoutKey)\n[ ] For hot start splash scenarios, correctly implement preloading (splashDidCloseForPlacementID requires preloading)\n[ ] [Optional] Set ad revenue listener (didRevenueForPlacementID)\n\nBanner Ads\n\n[ ] Correctly set Placement ID\n\n[ ] Set ad event Delegate (ATBannerDelegate)\n[ ] Correctly set Banner Size (kATAdLoadingExtraBannerAdSizeKey)\n[ ] Correctly call ad loading method (loadADWithPlacementID)\n[ ] Check if ad is ready before showing (bannerAdReadyForPlacementID)\n[ ] Correctly call ad display method (retrieveBannerViewForPlacementID)\n[ ] Correctly set the visibility of ATBannerView and its container to properly display ads\n[ ] Correctly set the delegate of ATBannerView and its presentingViewController\n\n[ ] [Optional] Set ad revenue listener (revenueDelegate)\n[ ] Auto-refresh feature configuration: TopOn Dashboard > App Management > Select Target App > Enter Target Banner Placement > Advanced Settings\n\n[ ] When temporarily not displaying, you can set the banner object's isHidden; when permanently not displaying, you need to destroy it with destroyBanner\n\n\nNative Self-Rendered Ads\n\n[ ] Correctly set Placement ID\n\n[ ] Set ad event Delegate (ATNativeADDelegate)\n[ ] Correctly call ad loading method (loadADWithPlacementID)\n[ ] Use ATNativeADConfiguration for pre-display configuration\n[ ] Correctly create ATNativeAdOffer through getNativeAdOfferWithPlacementID and use after null check\n[ ] Self-rendered ads: Create self-rendered view, and correctly assign values and layout to components based on the information content in ATNativeAdOffer\n\n[ ] Correctly create native ad view through [[ATNativeADView alloc] initWithConfiguration:config currentOffer:placementID:]\n\n[ ] Self-rendered ads: Correctly call [nativeADView getMediaView] to get mediaView object, check for null, and if not null, need to correctly add layout\n[ ] Self-rendered ads: Call registerClickableViewArray to correctly pass in UI controls for registering click events\n[ ] Self-rendered ads: Call ATNativePrepareInfo loadPrepareInfo: to correctly pass in UI controls to be bound for rendering\n[ ] Correctly call rendererWithNativeAdView:selfRenderView:adInfo: for rendering, then set nativeADView to visible\n[ ] Correctly implement preloading (didFailToLoadADWithPlacementID requires a delay before initiating preloading, for details see Sample Code; didTapCloseButtonInAdView requires no delay)\n[ ] [Optional] Set ad revenue listener (didRevenueForPlacementID)\n[ ] Correctly release ad resources (destroyNative, ATNativeAdOffer=nil)\n\nNative Template Ads\n\n[ ] Correctly set Placement ID\n\n[ ] Set ad event Delegate (ATNativeADDelegate)\n[ ] Correctly call ad loading method (loadADWithPlacementID)\n[ ] Use ATNativeADConfiguration for pre-display configuration\n[ ] Correctly create ATNativeAdOffer through getNativeAdOfferWithPlacementID and use after null check\n[ ] Correctly create native ad view through [[ATNativeADView alloc] initWithConfiguration:config currentOffer:placementID:]\n\n[ ] Correctly call rendererWithNativeAdView:selfRenderView:adInfo: for rendering, then set nativeADView to visible\n[ ] Correctly implement preloading (didFailToLoadADWithPlacementID requires a delay before initiating preloading, for details see Sample Code; didTapCloseButtonInAdView requires no delay)\n[ ] [Optional] Set ad revenue listener (didRevenueForPlacementID)\n[ ] Correctly release ad resources (destroyNative)\n\n\n3. General Check Items\n\n[ ] Use debugging tools to verify ad integration status ([[ATDebuggerAPI sharedInstance] showDebuggerInViewController:vc showType:ATShowDebugUIPresent debugkey:@\"Enter your DebugKey, DebugKey can be obtained from Backend->Account Management->Key, DebugKey needs to correspond with AppID and AppKey\"];)\n[ ] Enable debug log switch during debugging phase ([ATAPI setLogEnabled:YES];)\n\n\n4. Third-Party Revenue Reporting\n\n[ ] For value reporting, please refer to Sample Code","is_draft":"0","editor_type":"2","file_path":"","add_time":"1752231130","update_time":"1754885144"},"pure_content":"This checklist is designed to help you systematically verify the application integration process, ensuring seamless integration and efficient operation of the advertising SDK.\n\n1. API Usage Check\n\nDur"},{"id":"577682","string_id":"sqLJ7986","status":"1","parent_id":"68445","slug":"Testing-Checklist","order":"6","name":"Testing Checklist","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u51cc\u5929\u5b50","add_time":"1753681804","update_time":"1754885235","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"577682","content":"Please refer to the following testing points during testing to ensure that all functions and experiences meet expectations\n\n## 1. Initialize SDK when the application starts\n- [ ] If you want to launch and publish in the EU region, you need to execute the GDPR compliance popup process before initializing the SDK\n- [ ] Clarify which advertising platforms are integrated (such as Admob, Meta, etc.), and pay attention to whether each advertising platform SDK is correctly integrated\n\n---\n\n## 2. Preload ads after SDK initialization is completed\n- [ ] Execute the logic of loading ads at staggered peaks to avoid simultaneous high-concurrency requests for loading ads\n- [ ] Rewarded, interstitial, splash, and native ad formats globally reuse the same Ad instance object\n\n---\n\n## 3. Rewarded Video & Interstitial Ads\n- [ ] After SDK initialization is completed or when entering the application homepage scene, make the first loading request in advance\n- [ ] Call `isReady` before displaying ads to check if they are available for display. If `YES`, display them; if `NO`, request to load ads\n- [ ] Rewards for rewarded videos need to be distributed in the `rewardedVideoDidRewardSuccessForPlacemenID:extra:` callback, and it is necessary to test whether rewards can be successfully distributed\n- [ ] After the ad is closed, call `load` in the close callback to preload the ad\n- [ ] Prevent multiple clicks: When displaying rewarded or interstitial ads, prevent multiple clicks to avoid repeated pop-up ads\n\n---\n\n## 4. Splash Ads\n- [ ] If there is custom timeout logic, the same timeout time needs to be passed to the SDK\n- [ ] Loading timeout needs to jump to the application homepage; if not timeout, display ads in the `didFinishLoadingSplashADWithPlacementID:isTimeout:` callback\n- [ ] Preload for hot start splash in `splashDidCloseForPlacementID:extra:`\n- [ ] When the application switches to the background or the page switches, call `isReady` to check if there is an available cache, and preload when `NO`\n- [ ] Whether the `splashDidCloseForPlacementID:extra:` callback is normal when clicking skip, and whether jumping to browser\/AppStore is normal\n\n---\n\n## 5. Banner Ads\n \n- [ ] `Auto refresh` needs to be uniformly used [ Dashboard > Select App > Edit Banner Ad Mediation Unit > Advanced Settings](https:\/\/portal.ad.net\/m\/app), and the auto refresh function needs to be turned off in each advertising platform dashboard\n- [ ] After dashboard enables the auto refresh function, check whether auto refresh is normal\n \n---\n\n## 6. Native Ads\n- [ ] After `didFinishLoadingADWithPlacementID:` loads successfully, if you need to hold the ad object yourself, you need to check for null, that is, when getting `ATNativeAdOffer *offer` or `ATNativeADView *nativeADView`, you need to determine whether it is empty, and only when it is not empty can you normally hold and use it.\n- [ ] Self-rendering: Each material in `SelfRenderView` needs to be bound for rendering, pay attention to whether `didShowNativeAdInAdView` is triggered normally\n- [ ] Resource release: When using NativeAd instance globally, release resources when the application exits; when bound to the controller, call `destroyNative` of the ATNativeADView instance object in dealloc, and self-rendering also needs to correctly release the `ATNativeAdOffer` object\n- [ ] Different platforms have different rendering requirements, and it is necessary to ensure that all advertising platforms can normally fill, display and trigger the `didShowNativeAdInAdView` callback\n\n---\n\n## 7. SDK Debug Log\n\n> **Suggestion**: For the waterfall configuration of each ad placement, test that the ad sources of each third-party advertising platform can be normally filled and displayed before launching the application\n \n- [ ] Log TAG filtering: `ATAdLog`\n- [ ] Check and confirm through logs that all ad sources configured on each aggregation platform can be filled, and their loading, filling, display, and click callbacks can be triggered normally\n \n---","pure_content":"Please refer to the following testing points during testing to ensure that all functions and experiences meet expectations\n1. Initialize SDK when the application starts\n\n[ ] If you want to launch and publish in the EU region, you need to execute the GDPR compliance popup process before initializing the SDK\n[ ] Clarify which advertising platforms are integrated (such as Admob, Meta, etc.), and pay attention to whether each advertising platform SDK is correctly integrated\n\n\n2. Preload ads after SDK initialization is completed\n\n[ ] Execute the logic of loading ads at staggered peaks to avoid simultaneous high-concurrency requests for loading ads\n[ ] Rewarded, interstitial, splash, and native ad formats globally reuse the same Ad instance object\n\n\n3. Rewarded Video & Interstitial Ads\n\n[ ] After SDK initialization is completed or when entering the application homepage scene, make the first loading request in advance\n[ ] Call isReady before displaying ads to check if they are available for display. If YES, display them; if NO, request to load ads\n[ ] Rewards for rewarded videos need to be distributed in the rewardedVideoDidRewardSuccessForPlacemenID:extra: callback, and it is necessary to test whether rewards can be successfully distributed\n[ ] After the ad is closed, call load in the close callback to preload the ad\n[ ] Prevent multiple clicks: When displaying rewarded or interstitial ads, prevent multiple clicks to avoid repeated pop-up ads\n\n\n4. Splash Ads\n\n[ ] If there is custom timeout logic, the same timeout time needs to be passed to the SDK\n[ ] Loading timeout needs to jump to the application homepage; if not timeout, display ads in the didFinishLoadingSplashADWithPlacementID:isTimeout: callback\n[ ] Preload for hot start splash in splashDidCloseForPlacementID:extra:\n\n[ ] When the application switches to the background or the page switches, call isReady to check if there is an available cache, and preload when NO\n\n[ ] Whether the splashDidCloseForPlacementID:extra: callback is normal when clicking skip, and whether jumping to browser\/AppStore is normal\n\n\n5. Banner Ads\n\n[ ] Auto refresh needs to be uniformly used Dashboard > Select App > Edit Banner Ad Mediation Unit > Advanced Settings, and the auto refresh function needs to be turned off in each advertising platform dashboard\n[ ] After dashboard enables the auto refresh function, check whether auto refresh is normal\n\n\n6. Native Ads\n\n[ ] After didFinishLoadingADWithPlacementID: loads successfully, if you need to hold the ad object yourself, you need to check for null, that is, when getting ATNativeAdOffer *offer or ATNativeADView *nativeADView, you need to determine whether it is empty, and only when it is not empty can you normally hold and use it.\n[ ] Self-rendering: Each material in SelfRenderView needs to be bound for rendering, pay attention to whether didShowNativeAdInAdView is triggered normally\n[ ] Resource release: When using NativeAd instance globally, release resources when the application exits; when bound to the controller, call destroyNative of the ATNativeADView instance object in dealloc, and self-rendering also needs to correctly release the ATNativeAdOffer object\n[ ] Different platforms have different rendering requirements, and it is necessary to ensure that all advertising platforms can normally fill, display and trigger the didShowNativeAdInAdView callback\n\n\n7. SDK Debug Log\n\nSuggestion: For the waterfall configuration of each ad placement, test that the ad sources of each third-party advertising platform can be normally filled and displayed before launching the application\n\n\n[ ] Log TAG filtering: ATAdLog\n\n[ ] Check and confirm through logs that all ad sources configured on each aggregation platform can be filled, and their loading, filling, display, and click callbacks can be triggered normally","is_draft":"0","editor_type":"2","file_path":"","add_time":"1753681804","update_time":"1754885235"},"pure_content":"Please refer to the following testing points during testing to ensure that all functions and experiences meet expectations\n1. Initialize SDK when the application starts\n\n[ ] If you want to launch and"},{"id":"579316","string_id":"b2rigvjc","status":"1","parent_id":"68445","slug":"b2rigvjc","order":"5","name":"Resources","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u51cc\u5929\u5b50","add_time":"1753781219","update_time":"1753783521","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","file_type":"","auth_id":"[\"-1\"]","pure_content":""}],"content":{"icon":"","desc":"","content_id":"68445","add_time":"1707205652","update_time":"1718099402","content":"","is_traffic_less":"0","file_type":""},"hot_list":[],"user_read_num":"0","is_auth":"0"},"msg":"Success","code":200}