{"data":{"id":"115971","string_id":"GRlOmB","status":"1","parent_id":"68373","slug":"GRlOmB","order":"10","name":"AD Formats","type":"1","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"","published_time":"1720593238","add_time":"1719306114","update_time":"1767611145","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":"115980","string_id":"VDkCMJ","status":"1","parent_id":"115971","slug":"Rewarded-video-ads","order":"0","name":"Rewarded Video Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1720593265","add_time":"1719306294","update_time":"1753937750","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"115980","content":"## 1. Integration Recommendations\n\n### 1.1 Showing Rewarded Video Ads\n\n- It is recommended to check if the ad is ready before showing, and proceed with the display operation only after it is ready\n- If you need to show ads in the ad placement loading success callback (**didFinishLoadingADWithPlacementID**), you must first check (**UIApplicationState==UIApplicationStateActive**) before executing the show method, otherwise it may cause the ad to not display properly and affect revenue.\n\n### 1.2 Ad Preloading\n\n- You can call the loading method to request ads in advance of the display scenario (for example, start loading ads when **UIApplicationState==UIApplicationStateActive** after the app starts), so that when you reach the scenario where you need to show ads, you can display them quickly\n\n### 1.3 Server Callback\n\n- Rewarded video supports server callback reward distribution mechanism, and also supports server callback functions of various ad platforms. Please refer to [Server-side Rewards](\/docs\/Serverside-incentives)\n\n### 1.4 Sample Code\n\n- For detailed rewarded video ad sample code, please refer to: `RewardedVC.m` in [Demo](https:\/\/github.com\/toponteam\/TopOn-iOS-Pod-Demo)\n\n## 2. Load Rewarded Video Ad\n> The extra dictionary in this step supports passing in relevant parameters for configuring ads and your custom parameters. You can view more information about [extra parameters](\/docs\/Extra-Parameters) here.\n\n```objc\n\/\/Import header file\n#import \n\n@interface RewardedVC () \n\n@property (nonatomic, assign) NSInteger retryAttempt; \/\/ Retry attempt counter\n\n@end\n\n@implementation RewardedVC\n\n\/\/Ad placement ID\n#define RewardedPlacementID @\"b67f4ab93eb3a7\"\n\n\/\/Scene ID, optional, can be generated in the backend. If not available, pass an empty string\n#define RewardedSceneID @\"\"\n\n#pragma mark - Load Ad\n- (void)loadAd {\n\n NSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];\n \/\/ Optional integration, the following key parameters are applicable to server-side reward verification of ad platforms and will be passed through\n [loadConfigDict setValue:@\"media_val_RewardedVC\" forKey:kATAdLoadingExtraMediaExtraKey];\n [loadConfigDict setValue:@\"rv_test_user_id\" forKey:kATAdLoadingExtraUserIDKey];\n [loadConfigDict setValue:@\"reward_Name\" forKey:kATAdLoadingExtraRewardNameKey];\n [loadConfigDict setValue:@3 forKey:kATAdLoadingExtraRewardAmountKey];\n \n \/\/ Start ad loading\n [[ATAdManager sharedManager] loadADWithPlacementID:RewardedPlacementID extra:loadConfigDict delegate:self];\n}\n\n\/\/\/ Ad placement loading completed\n\/\/\/ - Parameter placementID: Ad placement ID\n- (void)didFinishLoadingADWithPlacementID:(NSString *)placementID {\n \/\/ Reset retry attempts\n self.retryAttempt = 0;\n}\n \n\/\/\/ Ad placement loading failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - error: Error information\n- (void)didFailToLoadADWithPlacementID:(NSString *)placementID error:(NSError *)error { \n if (self.retryAttempt >= 3) {\n return;\n }\n self.retryAttempt++;\n \n \/\/ Calculate delay time: power of 2, maximum 8 seconds\n NSInteger delaySec = pow(2, MIN(3, self.retryAttempt));\n\n \/\/ Delayed retry loading ad\n dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delaySec * NSEC_PER_SEC), dispatch_get_main_queue(), ^{\n [self loadAd];\n });\n}\n```\n\n## 3. Show Rewarded Video Ad\n\n> - The showCustomExt field of ATShowConfig in the show method also supports server callbacks. You need to add &ilrd={ilrd} to the reward callback address configured in the backend, and then the server can parse the show_custom_ext field. When you use showCustomExt as server-side rewards, the extra parameters when loading ads must include parameters for server callbacks (please refer to the example in the loading ads section above), otherwise the server will not receive callbacks.\n> - [**Statistics scene arrival rate**](\/docs\/Scenario-advertising-scene), displayed in the backend's Data Reports -> Funnel Analysis Report -> Arrival at Ad Scene, called before showing ads.\n\n```objc\n#pragma mark - Show Ad\n\/\/\/ Show ad\n- (void)showAd {\n \n \/\/Scene statistics function, displayed in the backend's Data Reports -> Funnel Analysis Report -> Arrival at Ad Scene, called before showing ads. Optional integration\n [[ATAdManager sharedManager] entryRewardedVideoScenarioWithPlacementID:RewardedPlacementID scene:RewardedSceneID];\n\n \/\/Check if ready\n if (![[ATAdManager sharedManager] rewardedVideoReadyForPlacementID:RewardedPlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/Show configuration, Scene passes in the backend scene ID, if not available pass an empty string, showCustomExt parameter can pass in custom parameter string\n ATShowConfig *config = [[ATShowConfig alloc] initWithScene:RewardedSceneID showCustomExt:@\"testShowCustomExt\"];\n \n \/\/Show ad\n [[ATAdManager sharedManager] showRewardedVideoWithPlacementID:RewardedPlacementID config:config inViewController:self delegate:self];\n}\n\n#pragma mark - ATRewardedVideoDelegate\n\/\/\/ Reward success\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)rewardedVideoDidRewardSuccessForPlacemenID:(NSString *)placementID extra:(NSDictionary *)extra {}\n\n\/\/\/ Rewarded ad video started playing\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)rewardedVideoDidStartPlayingForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {}\n \n\/\/\/ Rewarded ad video finished playing\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)rewardedVideoDidEndPlayingForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {}\n\n\/\/\/ Rewarded ad video failed to play\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - error: Error information\n\/\/\/ - extra: Extra information dictionary\n- (void)rewardedVideoDidFailToPlayForPlacementID:(NSString*)placementID error:(NSError *)error extra:(NSDictionary *)extra {\n \/\/ Preload\n [self loadAd];\n}\n\n\/\/\/ Rewarded ad closed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - rewarded: Whether reward was successful, YES means reward success callback has been triggered\n\/\/\/ - extra: Extra information dictionary\n- (void)rewardedVideoDidCloseForPlacementID:(NSString *)placementID rewarded:(BOOL)rewarded extra:(NSDictionary *)extra {\n \/\/ Preload\n [self loadAd];\n}\n \n\/\/\/ Rewarded ad was clicked\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)rewardedVideoDidClickForPlacementID:(NSString*)placementID extra:(NSDictionary *)extra {}\n\n\/\/\/ Rewarded ad opened or jumped to deep link page\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Ad placement ID\n\/\/\/ - success: Whether successful\n- (void)rewardedVideoDidDeepLinkOrJumpForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra result:(BOOL)success {}\n```\n\n## 4. Reward Distribution\n\nThrough registering the following delegate method in ATRewardedVideoDelegate\n```objc\n\/\/\/ Reward distribution\n- (void)rewardedVideoDidRewardSuccessForPlacemenID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n```\n\n## 5. Advanced\n\n[Fully automatic loading](\/docs\/Fully-automatic-loading-m9JA) : TopOn has launched a one-stop solution that intelligently determines the timing for preloading and caching the next ad based on the user's usage status and the progress of ad consumption.","pure_content":"1. Integration Recommendations\n1.1 Showing Rewarded Video Ads\n\nIt is recommended to check if the ad is ready before showing, and proceed with the display operation only after it is ready\nIf you need to show ads in the ad placement loading success callback (didFinishLoadingADWithPlacementID), you must first check (UIApplicationState==UIApplicationStateActive) before executing the show method, otherwise it may cause the ad to not display properly and affect revenue.\n\n1.2 Ad Preloading\n\nYou can call the loading method to request ads in advance of the display scenario (for example, start loading ads when UIApplicationState==UIApplicationStateActive after the app starts), so that when you reach the scenario where you need to show ads, you can display them quickly\n\n1.3 Server Callback\n\nRewarded video supports server callback reward distribution mechanism, and also supports server callback functions of various ad platforms. Please refer to Server-side Rewards\n\n\n1.4 Sample Code\n\nFor detailed rewarded video ad sample code, please refer to: RewardedVC.m in Demo\n\n\n2. Load Rewarded Video Ad\n\nThe extra dictionary in this step supports passing in relevant parameters for configuring ads and your custom parameters. You can view more information about extra parameters here.\n\n\/\/Import header file\n#import \n\n@interface RewardedVC () \n\n@property (nonatomic, assign) NSInteger retryAttempt; \/\/ Retry attempt counter\n\n@end\n\n@implementation RewardedVC\n\n\/\/Ad placement ID\n#define RewardedPlacementID @\"b67f4ab93eb3a7\"\n\n\/\/Scene ID, optional, can be generated in the backend. If not available, pass an empty string\n#define RewardedSceneID @\"\"\n\n#pragma mark - Load Ad\n- (void)loadAd {\n\n NSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];\n \/\/ Optional integration, the following key parameters are applicable to server-side reward verification of ad platforms and will be passed through\n [loadConfigDict setValue:@\"media_val_RewardedVC\" forKey:kATAdLoadingExtraMediaExtraKey];\n [loadConfigDict setValue:@\"rv_test_user_id\" forKey:kATAdLoadingExtraUserIDKey];\n [loadConfigDict setValue:@\"reward_Name\" forKey:kATAdLoadingExtraRewardNameKey];\n [loadConfigDict setValue:@3 forKey:kATAdLoadingExtraRewardAmountKey];\n \n \/\/ Start ad loading\n [[ATAdManager sharedManager] loadADWithPlacementID:RewardedPlacementID extra:loadConfigDict delegate:self];\n}\n\n\/\/\/ Ad placement loading completed\n\/\/\/ - Parameter placementID: Ad placement ID\n- (void)didFinishLoadingADWithPlacementID:(NSString *)placementID {\n \/\/ Reset retry attempts\n self.retryAttempt = 0;\n}\n \n\/\/\/ Ad placement loading failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - error: Error information\n- (void)didFailToLoadADWithPlacementID:(NSString *)placementID error:(NSError *)error { \n if (self.retryAttempt >= 3) {\n return;\n }\n self.retryAttempt++;\n \n \/\/ Calculate delay time: power of 2, maximum 8 seconds\n NSInteger delaySec = pow(2, MIN(3, self.retryAttempt));\n\n \/\/ Delayed retry loading ad\n dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delaySec * NSEC_PER_SEC), dispatch_get_main_queue(), ^{\n [self loadAd];\n });\n}\n\n3. Show Rewarded Video Ad\n\n\nThe showCustomExt field of ATShowConfig in the show method also supports server callbacks. You need to add &ilrd={ilrd} to the reward callback address configured in the backend, and then the server can parse the show_custom_ext field. When you use showCustomExt as server-side rewards, the extra parameters when loading ads must include parameters for server callbacks (please refer to the example in the loading ads section above), otherwise the server will not receive callbacks.\n\nStatistics scene arrival rate, displayed in the backend's Data Reports -> Funnel Analysis Report -> Arrival at Ad Scene, called before showing ads.\n\n\n#pragma mark - Show Ad\n\/\/\/ Show ad\n- (void)showAd {\n \n \/\/Scene statistics function, displayed in the backend's Data Reports -> Funnel Analysis Report -> Arrival at Ad Scene, called before showing ads. Optional integration\n [[ATAdManager sharedManager] entryRewardedVideoScenarioWithPlacementID:RewardedPlacementID scene:RewardedSceneID];\n\n \/\/Check if ready\n if (![[ATAdManager sharedManager] rewardedVideoReadyForPlacementID:RewardedPlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/Show configuration, Scene passes in the backend scene ID, if not available pass an empty string, showCustomExt parameter can pass in custom parameter string\n ATShowConfig *config = [[ATShowConfig alloc] initWithScene:RewardedSceneID showCustomExt:@\"testShowCustomExt\"];\n \n \/\/Show ad\n [[ATAdManager sharedManager] showRewardedVideoWithPlacementID:RewardedPlacementID config:config inViewController:self delegate:self];\n}\n\n#pragma mark - ATRewardedVideoDelegate\n\/\/\/ Reward success\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)rewardedVideoDidRewardSuccessForPlacemenID:(NSString *)placementID extra:(NSDictionary *)extra {}\n\n\/\/\/ Rewarded ad video started playing\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)rewardedVideoDidStartPlayingForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {}\n \n\/\/\/ Rewarded ad video finished playing\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)rewardedVideoDidEndPlayingForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {}\n\n\/\/\/ Rewarded ad video failed to play\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - error: Error information\n\/\/\/ - extra: Extra information dictionary\n- (void)rewardedVideoDidFailToPlayForPlacementID:(NSString*)placementID error:(NSError *)error extra:(NSDictionary *)extra {\n \/\/ Preload\n [self loadAd];\n}\n\n\/\/\/ Rewarded ad closed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - rewarded: Whether reward was successful, YES means reward success callback has been triggered\n\/\/\/ - extra: Extra information dictionary\n- (void)rewardedVideoDidCloseForPlacementID:(NSString *)placementID rewarded:(BOOL)rewarded extra:(NSDictionary *)extra {\n \/\/ Preload\n [self loadAd];\n}\n \n\/\/\/ Rewarded ad was clicked\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)rewardedVideoDidClickForPlacementID:(NSString*)placementID extra:(NSDictionary *)extra {}\n\n\/\/\/ Rewarded ad opened or jumped to deep link page\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Ad placement ID\n\/\/\/ - success: Whether successful\n- (void)rewardedVideoDidDeepLinkOrJumpForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra result:(BOOL)success {}\n\n4. Reward Distribution\nThrough registering the following delegate method in ATRewardedVideoDelegate\n\/\/\/ Reward distribution\n- (void)rewardedVideoDidRewardSuccessForPlacemenID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\n5. Advanced\nFully automatic loading : TopOn has launched a one-stop solution that intelligently determines the timing for preloading and caching the next ad based on the user's usage status and the progress of ad consumption.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1719306294","update_time":"1753937750"},"pure_content":"1. Integration Recommendations\n1.1 Showing Rewarded Video Ads\n\nIt is recommended to check if the ad is ready before showing, and proceed with the display operation only after it is ready\nIf you need t"},{"id":"117877","string_id":"FsAWio","status":"1","parent_id":"115971","slug":"Interstitial-Ads-srKk","order":"0","name":"Interstitial Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1719803774","add_time":"1719802780","update_time":"1753937761","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"117877","content":"## 1. Integration Recommendations\n\n### 1.1 Displaying Interstitial Ads\n\n- It is recommended to check if the ad is ready before displaying, and only proceed with the display operation after it's ready\n- If you need to display ads in the ad placement loading success callback (**didFinishLoadingADWithPlacementID:**), you must first check (**UIApplicationState==UIApplicationStateActive**) before executing the display method, otherwise it may cause ads to fail to display properly and affect revenue\n- Please try to avoid **Present**ing other controllers to prevent third-party ad platform SDKs from failing when initiating **Present**, which could cause ad display failures and affect ad revenue\n\n### 1.2 Ad Preloading\n\n- You can call the loading method to request ads in advance of the display scenario (for example, start loading ads when **UIApplicationState==UIApplicationStateActive** after app launch), so that when you reach the scenario where ads need to be displayed, they can be shown quickly\n\n### 1.3 Sample Code\n\n- For detailed sample code, please refer to: `InterstitialVC.m` in [Demo](https:\/\/github.com\/toponteam\/TopOn-iOS-Pod-Demo)\n\n## 2. Loading Interstitial Ads\n\n> The extra dictionary in this step supports passing in relevant parameters for configuring ads and your custom parameters. You can view more information about [extra parameters](\/docs\/Extra-Parameters) here.\n\n```objc\n\/\/ Import header file\n#import \n@interface InterstitialVC () \n\n@property (nonatomic, assign) NSInteger retryAttempt; \/\/ Retry attempt counter\n\n@end\n\n@implementation InterstitialVC\n \n\/\/ Placement ID\n#define InterstitialPlacementID @\"b680a1e0ae7a43\"\n\n\/\/ Scene ID, optional, can be generated in the backend. Pass empty string if not available\n#define InterstitialSceneID @\"\"\n\n#pragma mark - Load Ad\n\/\/\/ Load ad button clicked\n- (void)loadAd { \n NSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];\n \n \/\/ Optional integration, set loading pass-through parameters\n [loadConfigDict setValue:@\"media_val_InterstitialVC\" forKey:kATAdLoadingExtraMediaExtraKey]; \n\n [[ATAdManager sharedManager] loadADWithPlacementID:InterstitialPlacementID extra:loadConfigDict delegate:self];\n}\n\n\/\/\/ Ad placement loading completed\n\/\/\/ - Parameter placementID: Placement ID\n- (void)didFinishLoadingADWithPlacementID:(NSString *)placementID { \n \/\/ Reset retry count\n self.retryAttempt = 0;\n}\n \n\/\/\/ Ad placement loading failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - error: Error information\n- (void)didFailToLoadADWithPlacementID:(NSString *)placementID error:(NSError *)error { \n if (self.retryAttempt >= 3) {\n return;\n }\n self.retryAttempt++;\n \n \/\/ Calculate delay time: power of 2, maximum 8 seconds\n NSInteger delaySec = pow(2, MIN(3, self.retryAttempt));\n\n \/\/ Delayed retry loading ad\n dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delaySec * NSEC_PER_SEC), dispatch_get_main_queue(), ^{\n [self loadAd];\n });\n}\n```\n\n## 3. Displaying Interstitial Ads\n\n> - If you need to display ads in the loading success callback (**didFinishLoadingADWithPlacementID:**), to avoid ads not displaying properly, please ensure the current app is in the foreground before calling the display method.\n> - [**Scene reach rate statistics**](\/docs\/Scenario-advertising-scene), displayed in the backend's Data Reports -> Funnel Analysis Report -> Reach Ad Scene, called before displaying ads.\n\n```objc\n#pragma mark - Show Ad\n\/\/\/ Display ad\n- (void)showAd {\n \n \/\/ Scene statistics function, displayed in the backend's Data Reports -> Funnel Analysis Report -> Reach Ad Scene, called before displaying ads. Optional integration\n [[ATAdManager sharedManager] entryInterstitialScenarioWithPlacementID:InterstitialPlacementID scene:InterstitialSceneID];\n\n \/\/ Check if ready\n if (![[ATAdManager sharedManager] interstitialReadyForPlacementID:InterstitialPlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/ Display configuration, Scene passes in the backend scene ID, pass empty string if not available, showCustomExt parameter can pass in custom parameter string\n ATShowConfig *config = [[ATShowConfig alloc] initWithScene:InterstitialSceneID showCustomExt:@\"testShowCustomExt\"];\n \n \/\/ Display ad\n \/\/ For fullscreen interstitials, inViewController can pass in the root controller, such as tabbarController or navigationController, to let the ad cover the tabbar or navigationBar\n [[ATAdManager sharedManager] showInterstitialWithPlacementID:InterstitialPlacementID\n showConfig:config\n inViewController:self\n delegate:self\n nativeMixViewBlock:nil];\n}\n\n\/\/\/ Got display revenue\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didRevenueForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Ad has been displayed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialDidShowForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Ad display failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - error: Error information\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialFailedToShowForPlacementID:(NSString *)placementID error:(NSError *)error extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Video playback failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - error: Error information\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialDidFailToPlayVideoForPlacementID:(NSString *)placementID error:(NSError *)error extra:(NSDictionary *)extra { \n \/\/ Preload next ad\n [self loadAd];\n}\n\n\/\/\/ Video started playing\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialDidStartPlayingVideoForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Video finished playing\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialDidEndPlayingVideoForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Ad has been closed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialDidCloseForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n \/\/ Preload next ad\n [self loadAd];\n}\n\n\/\/\/ Ad has been clicked (redirected)\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialDidClickForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n```\n\n## 4. Advanced\n\n[Fully automatic loading](\/docs\/Fully-automatic-loading-m9JA) : TopOn has launched a one-stop solution that intelligently determines the timing for preloading and caching the next ad based on the user's usage status and the progress of ad consumption.","pure_content":"1. Integration Recommendations\n1.1 Displaying Interstitial Ads\n\nIt is recommended to check if the ad is ready before displaying, and only proceed with the display operation after it's ready\nIf you need to display ads in the ad placement loading success callback (didFinishLoadingADWithPlacementID:), you must first check (UIApplicationState==UIApplicationStateActive) before executing the display method, otherwise it may cause ads to fail to display properly and affect revenue\nPlease try to avoid Presenting other controllers to prevent third-party ad platform SDKs from failing when initiating Present, which could cause ad display failures and affect ad revenue\n\n1.2 Ad Preloading\n\nYou can call the loading method to request ads in advance of the display scenario (for example, start loading ads when UIApplicationState==UIApplicationStateActive after app launch), so that when you reach the scenario where ads need to be displayed, they can be shown quickly\n\n1.3 Sample Code\n\nFor detailed sample code, please refer to: InterstitialVC.m in Demo\n\n\n2. Loading Interstitial Ads\n\nThe extra dictionary in this step supports passing in relevant parameters for configuring ads and your custom parameters. You can view more information about extra parameters here.\n\n\/\/ Import header file\n#import \n@interface InterstitialVC () \n\n@property (nonatomic, assign) NSInteger retryAttempt; \/\/ Retry attempt counter\n\n@end\n\n@implementation InterstitialVC\n \n\/\/ Placement ID\n#define InterstitialPlacementID @\"b680a1e0ae7a43\"\n\n\/\/ Scene ID, optional, can be generated in the backend. Pass empty string if not available\n#define InterstitialSceneID @\"\"\n\n#pragma mark - Load Ad\n\/\/\/ Load ad button clicked\n- (void)loadAd { \n NSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];\n \n \/\/ Optional integration, set loading pass-through parameters\n [loadConfigDict setValue:@\"media_val_InterstitialVC\" forKey:kATAdLoadingExtraMediaExtraKey]; \n\n [[ATAdManager sharedManager] loadADWithPlacementID:InterstitialPlacementID extra:loadConfigDict delegate:self];\n}\n\n\/\/\/ Ad placement loading completed\n\/\/\/ - Parameter placementID: Placement ID\n- (void)didFinishLoadingADWithPlacementID:(NSString *)placementID { \n \/\/ Reset retry count\n self.retryAttempt = 0;\n}\n \n\/\/\/ Ad placement loading failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - error: Error information\n- (void)didFailToLoadADWithPlacementID:(NSString *)placementID error:(NSError *)error { \n if (self.retryAttempt >= 3) {\n return;\n }\n self.retryAttempt++;\n \n \/\/ Calculate delay time: power of 2, maximum 8 seconds\n NSInteger delaySec = pow(2, MIN(3, self.retryAttempt));\n\n \/\/ Delayed retry loading ad\n dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delaySec * NSEC_PER_SEC), dispatch_get_main_queue(), ^{\n [self loadAd];\n });\n}\n\n3. Displaying Interstitial Ads\n\n\nIf you need to display ads in the loading success callback (didFinishLoadingADWithPlacementID:), to avoid ads not displaying properly, please ensure the current app is in the foreground before calling the display method.\n\nScene reach rate statistics, displayed in the backend's Data Reports -> Funnel Analysis Report -> Reach Ad Scene, called before displaying ads.\n\n\n#pragma mark - Show Ad\n\/\/\/ Display ad\n- (void)showAd {\n \n \/\/ Scene statistics function, displayed in the backend's Data Reports -> Funnel Analysis Report -> Reach Ad Scene, called before displaying ads. Optional integration\n [[ATAdManager sharedManager] entryInterstitialScenarioWithPlacementID:InterstitialPlacementID scene:InterstitialSceneID];\n\n \/\/ Check if ready\n if (![[ATAdManager sharedManager] interstitialReadyForPlacementID:InterstitialPlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/ Display configuration, Scene passes in the backend scene ID, pass empty string if not available, showCustomExt parameter can pass in custom parameter string\n ATShowConfig *config = [[ATShowConfig alloc] initWithScene:InterstitialSceneID showCustomExt:@\"testShowCustomExt\"];\n \n \/\/ Display ad\n \/\/ For fullscreen interstitials, inViewController can pass in the root controller, such as tabbarController or navigationController, to let the ad cover the tabbar or navigationBar\n [[ATAdManager sharedManager] showInterstitialWithPlacementID:InterstitialPlacementID\n showConfig:config\n inViewController:self\n delegate:self\n nativeMixViewBlock:nil];\n}\n\n\/\/\/ Got display revenue\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didRevenueForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Ad has been displayed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialDidShowForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Ad display failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - error: Error information\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialFailedToShowForPlacementID:(NSString *)placementID error:(NSError *)error extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Video playback failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - error: Error information\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialDidFailToPlayVideoForPlacementID:(NSString *)placementID error:(NSError *)error extra:(NSDictionary *)extra { \n \/\/ Preload next ad\n [self loadAd];\n}\n\n\/\/\/ Video started playing\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialDidStartPlayingVideoForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Video finished playing\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialDidEndPlayingVideoForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Ad has been closed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialDidCloseForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n \/\/ Preload next ad\n [self loadAd];\n}\n\n\/\/\/ Ad has been clicked (redirected)\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)interstitialDidClickForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n4. Advanced\nFully automatic loading : TopOn has launched a one-stop solution that intelligently determines the timing for preloading and caching the next ad based on the user's usage status and the progress of ad consumption.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1719802781","update_time":"1753937761"},"pure_content":"1. Integration Recommendations\n1.1 Displaying Interstitial Ads\n\nIt is recommended to check if the ad is ready before displaying, and only proceed with the display operation after it's ready\nIf you nee"},{"id":"118594","string_id":"U66meY","status":"1","parent_id":"115971","slug":"Splash-screen-ads","order":"0","name":"Splash Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1720593273","add_time":"1719977317","update_time":"1753682323","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"118594","content":"## 1. Integration Recommendations\n\n- To improve the loading efficiency of your splash ads, please refer to section 4 at end of this doc.\n- You can pass in the desired **splash ad loading timeout** according to your actual business needs. It is recommended to pass in 6s - 10s\n- For detailed sample code, please refer to: `SplashVC.m` in [Demo](https:\/\/github.com\/toponteam\/TopOn-iOS-Pod-Demo)\n- For first cold start splash ads, please refer to `AppDelegate.m` and `AdSDKManager.m`\n\n## 2. Loading Splash Ads\n\n> - Only some ad platforms support the setting of containerView.\n> - The extra dictionary in this step supports passing in relevant parameters for configuring ads and your custom parameters. You can view more information about [extra parameters](\/docs\/Extra-Parameters) here.\n\n```objc\n\/\/Import header file\n#import \n\n@interface SplashVC () \n\n@end\n \n@implementation SplashVC\n\n\/\/Ad placement ID\n#define SplashPlacementID @\"b67f4ab43d2fe1\"\n\n\/\/Scene ID, optional, can be generated in the backend. Pass empty string if not available\n#define SplashSceneID @\"\"\n\n#pragma mark - Load Ad\n\n\/\/\/ Load ad\n- (void)loadAd {\n \n NSMutableDictionary *loadConfigDict = [NSMutableDictionary dictionary];\n \n \/\/Splash timeout duration\n [loadConfigDict setValue:@(8) forKey:kATSplashExtraTolerateTimeoutKey];\n \/\/Custom load parameters\n [loadConfigDict setValue:@\"media_val_SplashVC\" forKey:kATAdLoadingExtraMediaExtraKey];\n \n [[ATAdManager sharedManager] loadADWithPlacementID:SplashPlacementID\n extra:loadConfigDict\n delegate:self\n containerView:[self footLogoView]];\n}\n\n\/\/\/ Optional splash bottom LogoView integration\n- (UIView *)footLogoView {\n \n \/\/Width is screen width, height <= 25% of screen height (depending on ad platform requirements)\n UIView * footerCtrView = [[UIView alloc] initWithFrame:CGRectMake(0, 0, kOrientationScreenWidth, 120)];\n footerCtrView.backgroundColor = UIColor.whiteColor;\n \n \/\/Add image\n UIImageView * logoImageView = [UIImageView new];\n logoImageView.image = [UIImage imageNamed:@\"logo\"];\n logoImageView.contentMode = UIViewContentModeCenter;\n logoImageView.frame = footerCtrView.frame;\n [footerCtrView addSubview:logoImageView];\n \n \/\/Add click event\n UITapGestureRecognizer * tap = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(footerImgClick:)];\n logoImageView.userInteractionEnabled = YES;\n [logoImageView addGestureRecognizer:tap];\n \n return footerCtrView;\n}\n \n\/\/\/ Footer click event\n- (void)footerImgClick:(UITapGestureRecognizer *)tap {\n ATDemoLog(@\"footer click !!\");\n}\n\n\/\/\/ Splash ad loading completed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - isTimeout: Whether timeout occurred\n- (void)didFinishLoadingSplashADWithPlacementID:(NSString *)placementID isTimeout:(BOOL)isTimeout {\n if (!isTimeout) {\n \/\/Loading successful, no timeout\n\n }else {\n \/\/Loading successful, but timeout occurred\n\n }\n}\n \n\/\/\/ Ad placement loading failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - error: Error information\n- (void)didFailToLoadADWithPlacementID:(NSString*)placementID error:(NSError*)error {\n\n}\n \n\/\/\/ Splash ad loading timeout\n\/\/\/ - Parameter placementID: Ad placement ID\n- (void)didTimeoutLoadingSplashADWithPlacementID:(NSString *)placementID {\n}\n```\n\n## 3. Showing Splash Ads\n\n> - If you need to show ads in the loading success callback (**didFinishLoadingADWithPlacementID:**), to avoid ads not displaying properly, please ensure: the current app **UIApplicationState==UIApplicationStateActive**\n> - If a container containerView was created and set during loading, it needs to be added to the layout and be in a visible state\n> - [**Statistics for scene reach rate**](\/docs\/Scenario-advertising-scene), displayed in the backend's Data Reports -> Funnel Analysis Report -> Reach Ad Scene, call before showing ads\n\n```objc\n#pragma mark - Show Ad\n- (void)showSplash {\n \n \/\/Scene statistics function, displayed in the backend's Data Reports -> Funnel Analysis Report -> Reach Ad Scene, call before showing ads. Optional integration\n [[ATAdManager sharedManager] entrySplashScenarioWithPlacementID:SplashPlacementID scene:SplashSceneID];\n \n \/\/Check if ready\n if (![[ATAdManager sharedManager] splashReadyForPlacementID:SplashPlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/Show configuration, pass in backend scene ID for Scene, pass empty string if not available, showCustomExt parameter can pass custom parameter string\n ATShowConfig *config = [[ATShowConfig alloc] initWithScene:SplashSceneID showCustomExt:@\"testShowCustomExt\"];\n \n \/\/Splash related parameter configuration\n NSMutableDictionary *configDict = [NSMutableDictionary dictionary];\n\n \/\/Show ad, display in app's original window\n [[ATAdManager sharedManager] showSplashWithPlacementID:SplashPlacementID config:config window:[UIApplication sharedApplication].keyWindow inViewController:self.tabBarController extra:configDict delegate:self];\n}\n\n\/\/\/ Get display revenue\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didRevenueForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n \n\/\/\/ Splash ad has been shown\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashDidShowForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Splash ad has been closed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashDidCloseForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {\n \/\/ Hot start preloading (optional)\n \/\/ [self loadAd];\n}\n\n\/\/\/ Splash ad has been clicked\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashDidClickForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Splash ad show failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - error: Error information\n\/\/\/ - extra: Extra information\n- (void)splashDidShowFailedForPlacementID:(NSString*)placementID error:(NSError *)error extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Splash ad has opened or jumped to deep link page\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n\/\/\/ - success: Whether successful\n- (void)splashDeepLinkOrJumpForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra result:(BOOL)success {\n}\n \n\/\/\/ Splash ad detail page has been closed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashDetailDidClosedForPlacementID:(NSString*)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Splash ad close countdown\n\/\/\/ - Parameters:\n\/\/\/ - countdown: Remaining seconds\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashCountdownTime:(NSInteger)countdown forPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Splash ad zoomout view has been clicked, only supported by Pangle, Tencent GDT, V+\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashZoomOutViewDidClickForPlacementID:(NSString*)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Splash ad zoomout view has been closed, only supported by Pangle, Tencent GDT, V+\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashZoomOutViewDidCloseForPlacementID:(NSString*)placementID extra:(NSDictionary *)extra {\n}\n```\n\n## 4. First-time installation screen loading efficiency improvement solution\nFirst time during application installation To load open-screen ads, Taku needs to first pull the configured ad placement information from the background and cache it locally, and then request ads from the advertising platform. This process involves two network requests (serial), which affects the loading efficiency of open-screen ads.\n\n \n[Preset Strategy](\/docs\/SDK-preset-strategy): Can improve the ad loading effect of the first cold start by configuring preset strategies.): Can improve the ad loading effect of the first cold start by configuring preset strategies.","pure_content":"1. Integration Recommendations\n\nTo improve the loading efficiency of your splash ads, please refer to section 4 at end of this doc.\nYou can pass in the desired splash ad loading timeout according to your actual business needs. It is recommended to pass in 6s - 10s\nFor detailed sample code, please refer to: SplashVC.m in Demo\n\nFor first cold start splash ads, please refer to AppDelegate.m and AdSDKManager.m\n\n\n2. Loading Splash Ads\n\n\nOnly some ad platforms support the setting of containerView.\nThe extra dictionary in this step supports passing in relevant parameters for configuring ads and your custom parameters. You can view more information about extra parameters here.\n\n\n\/\/Import header file\n#import \n\n@interface SplashVC () \n\n@end\n \n@implementation SplashVC\n\n\/\/Ad placement ID\n#define SplashPlacementID @\"b67f4ab43d2fe1\"\n\n\/\/Scene ID, optional, can be generated in the backend. Pass empty string if not available\n#define SplashSceneID @\"\"\n\n#pragma mark - Load Ad\n\n\/\/\/ Load ad\n- (void)loadAd {\n \n NSMutableDictionary *loadConfigDict = [NSMutableDictionary dictionary];\n \n \/\/Splash timeout duration\n [loadConfigDict setValue:@(8) forKey:kATSplashExtraTolerateTimeoutKey];\n \/\/Custom load parameters\n [loadConfigDict setValue:@\"media_val_SplashVC\" forKey:kATAdLoadingExtraMediaExtraKey];\n \n [[ATAdManager sharedManager] loadADWithPlacementID:SplashPlacementID\n extra:loadConfigDict\n delegate:self\n containerView:[self footLogoView]];\n}\n\n\/\/\/ Optional splash bottom LogoView integration\n- (UIView *)footLogoView {\n \n \/\/Width is screen width, height <= 25% of screen height (depending on ad platform requirements)\n UIView * footerCtrView = [[UIView alloc] initWithFrame:CGRectMake(0, 0, kOrientationScreenWidth, 120)];\n footerCtrView.backgroundColor = UIColor.whiteColor;\n \n \/\/Add image\n UIImageView * logoImageView = [UIImageView new];\n logoImageView.image = [UIImage imageNamed:@\"logo\"];\n logoImageView.contentMode = UIViewContentModeCenter;\n logoImageView.frame = footerCtrView.frame;\n [footerCtrView addSubview:logoImageView];\n \n \/\/Add click event\n UITapGestureRecognizer * tap = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(footerImgClick:)];\n logoImageView.userInteractionEnabled = YES;\n [logoImageView addGestureRecognizer:tap];\n \n return footerCtrView;\n}\n \n\/\/\/ Footer click event\n- (void)footerImgClick:(UITapGestureRecognizer *)tap {\n ATDemoLog(@\"footer click !!\");\n}\n\n\/\/\/ Splash ad loading completed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - isTimeout: Whether timeout occurred\n- (void)didFinishLoadingSplashADWithPlacementID:(NSString *)placementID isTimeout:(BOOL)isTimeout {\n if (!isTimeout) {\n \/\/Loading successful, no timeout\n\n }else {\n \/\/Loading successful, but timeout occurred\n\n }\n}\n \n\/\/\/ Ad placement loading failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - error: Error information\n- (void)didFailToLoadADWithPlacementID:(NSString*)placementID error:(NSError*)error {\n\n}\n \n\/\/\/ Splash ad loading timeout\n\/\/\/ - Parameter placementID: Ad placement ID\n- (void)didTimeoutLoadingSplashADWithPlacementID:(NSString *)placementID {\n}\n\n3. Showing Splash Ads\n\n\nIf you need to show ads in the loading success callback (didFinishLoadingADWithPlacementID:), to avoid ads not displaying properly, please ensure: the current app UIApplicationState==UIApplicationStateActive\n\nIf a container containerView was created and set during loading, it needs to be added to the layout and be in a visible state\n\nStatistics for scene reach rate, displayed in the backend's Data Reports -> Funnel Analysis Report -> Reach Ad Scene, call before showing ads\n\n\n#pragma mark - Show Ad\n- (void)showSplash {\n \n \/\/Scene statistics function, displayed in the backend's Data Reports -> Funnel Analysis Report -> Reach Ad Scene, call before showing ads. Optional integration\n [[ATAdManager sharedManager] entrySplashScenarioWithPlacementID:SplashPlacementID scene:SplashSceneID];\n \n \/\/Check if ready\n if (![[ATAdManager sharedManager] splashReadyForPlacementID:SplashPlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/Show configuration, pass in backend scene ID for Scene, pass empty string if not available, showCustomExt parameter can pass custom parameter string\n ATShowConfig *config = [[ATShowConfig alloc] initWithScene:SplashSceneID showCustomExt:@\"testShowCustomExt\"];\n \n \/\/Splash related parameter configuration\n NSMutableDictionary *configDict = [NSMutableDictionary dictionary];\n\n \/\/Show ad, display in app's original window\n [[ATAdManager sharedManager] showSplashWithPlacementID:SplashPlacementID config:config window:[UIApplication sharedApplication].keyWindow inViewController:self.tabBarController extra:configDict delegate:self];\n}\n\n\/\/\/ Get display revenue\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didRevenueForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n \n\/\/\/ Splash ad has been shown\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashDidShowForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Splash ad has been closed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashDidCloseForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {\n \/\/ Hot start preloading (optional)\n \/\/ [self loadAd];\n}\n\n\/\/\/ Splash ad has been clicked\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashDidClickForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Splash ad show failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - error: Error information\n\/\/\/ - extra: Extra information\n- (void)splashDidShowFailedForPlacementID:(NSString*)placementID error:(NSError *)error extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Splash ad has opened or jumped to deep link page\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n\/\/\/ - success: Whether successful\n- (void)splashDeepLinkOrJumpForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra result:(BOOL)success {\n}\n \n\/\/\/ Splash ad detail page has been closed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashDetailDidClosedForPlacementID:(NSString*)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Splash ad close countdown\n\/\/\/ - Parameters:\n\/\/\/ - countdown: Remaining seconds\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashCountdownTime:(NSInteger)countdown forPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Splash ad zoomout view has been clicked, only supported by Pangle, Tencent GDT, V+\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashZoomOutViewDidClickForPlacementID:(NSString*)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Splash ad zoomout view has been closed, only supported by Pangle, Tencent GDT, V+\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n- (void)splashZoomOutViewDidCloseForPlacementID:(NSString*)placementID extra:(NSDictionary *)extra {\n}\n\n4. First-time installation screen loading efficiency improvement solution\nFirst time during application installation To load open-screen ads, Taku needs to first pull the configured ad placement information from the background and cache it locally, and then request ads from the advertising platform. This process involves two network requests (serial), which affects the loading efficiency of open-screen ads.\nPreset Strategy: Can improve the ad loading effect of the first cold start by configuring preset strategies.): Can improve the ad loading effect of the first cold start by configuring preset strategies.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1719977317","update_time":"1753682322"},"pure_content":"1. Integration Recommendations\n\nTo improve the loading efficiency of your splash ads, please refer to section 4 at end of this doc.\nYou can pass in the desired splash ad loading timeout according to y"},{"id":"118802","string_id":"xASxOK","status":"1","parent_id":"115971","slug":"Banner-Ads-A93Q","order":"0","name":"Banner Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1720593281","add_time":"1720003503","update_time":"1753682390","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"118802","content":"## 1. Integration Recommendations\n\n### 1.1 Width and Height Settings\n\n- The width and height settings need to be consistent with the aspect ratio configured in the Taku backend and adjusted according to actual effects.\n\n### 1.2 Auto Refresh\n\n- Auto refresh is not enabled by default. You can configure the refresh time to enable or disable refresh in the advanced settings of the ad placement in the Taku backend.\n- The Banner ad View must be added to the window and be visible to trigger auto refresh.\n- If the ad platform provides auto refresh functionality, it is recommended to disable the ad platform's auto refresh and only use the auto refresh provided by Taku to avoid unpredictable issues caused by conflicts.\n- After enabling the auto refresh feature, add ATBannerView to the layout and ensure it is in a visible state, then call the `loadADWithPlacementID:` method once. Subsequent displays and refreshes will be automatically executed by the SDK.\n\n### 1.4 Sample Code\n\n- For detailed sample code, please refer to: `BannerVC.m` in [Demo](https:\/\/github.com\/toponteam\/TopOn-iOS-Pod-Demo)\n\n### 1.5 \u26a0\ufe0f Version Update Notes\n\n> Version V6.4.39 and above (including V6.4.39) supports passing in a controller object when loading ads to adapt to the requirement of some ad platforms that the loading controller and display controller must match. If you cannot adapt to passing in a controller object for some reasons, it may cause the problem of invalid clicks after these ad platforms are displayed. If you need to adapt, please use the following APIs **together** and pass in the same controller object:\n>\n> ```objc\n> \/\/\/ Load banner ad\n> \/\/\/ @param placementID Ad placement ID\n> \/\/\/ @param extra Extra parameters\n> \/\/\/ @param viewController Target controller, for example, the popup window after Banner click will use this controller, you need to reference it, SDK internally uses weak reference\n> \/\/\/ @param delegate Delegate object\n> - (void)loadADWithPlacementID:(NSString *)placementID\n> extra:(NSDictionary *)extra\n> viewController:(UIViewController *)viewController\n> delegate:(id)delegate;\n> \n> \/\/\/ Check if banner ad is ready\n> \/\/\/ @param placementID Ad placement ID\n> \/\/\/ @param showViewController Pass in the same object as the controller in the loading method -[ATAdManager loadADWithPlacementID:extra:viewController:delegate:]\n> - (BOOL)bannerAdReadyForPlacementID:(NSString *)placementID showViewController:(UIViewController *)showViewController;\n> \n> \/\/\/ Get BannerView object for display\n> \/\/\/ @param placementID Ad placement ID\n> \/\/\/ @param ATShowConfig config Configuration object, if viewController was passed in loadADWithPlacementID, then the same object needs to be passed here\n> \/\/\/ @param nativeMixBannerViewBlock For custom banner ads, returns components for custom layout\n> - (nullable ATBannerView *)retrieveBannerViewForPlacementID:(NSString *)placementID\n> config:(ATShowConfig *)config\n> nativeMixBannerViewBlock:(nullable NativeMixBannerViewBlock)nativeMixBannerViewBlock;\n> ```\n\n## 2. Load Ad\n\n> Banner ads on different platforms have certain rule restrictions:\n> \n> 1. Proportional scaling rule: For example, if the banner ad size configured in the backend is 640*100, to fill the screen width, calculate height H = (screen width * 100)\/640; then the filled size is: CGSizeMake(screen width, H);\n> 2. Fixed size rule: Select a fixed size in the backend configuration, and also set the same fixed size in the code\n> 3. Adaptive rule: Only supported by some ad platforms, and you need to select a non-fixed size style in the backend. For code details, see the method example in Demo - `[AdLoadConfigTool banner_loadExtraConfigAppendAdmob:loadConfigDict]`\n> \n> - The extra dictionary in this step supports passing in relevant parameters for configuring ads and your custom parameters. You can view more information about [extra parameters](\/docs\/Extra-Parameters) here.\n\n```objc\n\/\/Import header file\n#import \n\n@interface BannerVC () \n\n@property (nonatomic, strong) ATBannerView *bannerView;\n@property (nonatomic, assign) BOOL hasLoaded; \/\/ Ad loading status identifier\n\n@end\n\n@implementation BannerVC\n\n\/\/Ad placement ID\n#define BannerPlacementID @\"b680a1e7874fce\"\n\n\/\/Scene ID, optional, can be generated in the backend. If not available, pass an empty string\n#define BannerSceneID @\"\"\n\n\/\/Please note that banner size needs to be consistent with the ratio configured in the backend\n#define BannerSize CGSizeMake(320, 50)\n\n#pragma mark - Load Ad\n\/\/\/ Load ad\n- (void)loadAd {\n \n [self showLog:kLocalizeStr(@\"Clicked load ad\")];\n \n NSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];\n \n \/*\n Note that banner ads on different platforms have certain restrictions. For example, the configured banner ad is 640*100. In order to fill the screen width, the height H = (screen width *100)\/640 is calculated. Then the extra size of the load is (screen width: H).\n \n Note that banner ads on different platforms have certain restrictions. For example, the configured banner AD is 640*100. In order to fill the screen width, the height H = (screen width *100)\/640 is calculated. Then the extra size of the load is (screen width: H).\n *\/\n [loadConfigDict setValue:[NSValue valueWithCGSize:BannerSize] forKey:kATAdLoadingExtraBannerAdSizeKey];\n \n \/\/Set custom parameters\n [loadConfigDict setValue:@\"media_val_BannerVC\" forKey:kATAdLoadingExtraMediaExtraKey];\n \n \/\/Start loading\n [[ATAdManager sharedManager] loadADWithPlacementID:BannerPlacementID extra:loadConfigDict delegate:self];\n}\n\n#pragma mark - Ad placement delegate callbacks\n\/\/\/ Ad placement loading completed\n\/\/\/ - Parameter placementID: Ad placement ID\n- (void)didFinishLoadingADWithPlacementID:(NSString *)placementID {\n self.hasLoaded = YES;\n }\n \n\/\/\/ Ad placement loading failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - error: Error information\n- (void)didFailToLoadADWithPlacementID:(NSString *)placementID error:(NSError *)error { \n self.hasLoaded = NO;\n}\n```\n\n## 3. Show Ad\n\n> [Statistics scene arrival rate](\/docs\/Scenario-advertising-scene), displayed in the backend's Data Reports -> Funnel Analysis Report -> Arrival at Ad Scene, called before showing ads.\n\n```objc\n#pragma mark - Show Ad\n\/\/\/ Show ad\n- (void)showAd {\n \n \/\/Scene statistics function, displayed in the backend's Data Reports -> Funnel Analysis Report -> Arrival at Ad Scene, called before showing ads. Optional integration\n [[ATAdManager sharedManager] entryBannerScenarioWithPlacementID:BannerPlacementID scene:BannerSceneID];\n\n \/\/Check if ready\n if (![[ATAdManager sharedManager] bannerAdReadyForPlacementID:BannerPlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/Show configuration, Scene passes in the backend scene ID, if not available pass an empty string, showCustomExt parameter can pass in custom parameter string\n ATShowConfig *config = [[ATShowConfig alloc] initWithScene:BannerSceneID showCustomExt:@\"testShowCustomExt\"];\n \n \/\/Show ad\n ATBannerView *bannerView = [[ATAdManager sharedManager] retrieveBannerViewForPlacementID:BannerPlacementID config:config];\n if (bannerView != nil) {\n \/\/Assignment\n bannerView.delegate = self;\n bannerView.presentingViewController = self;\n bannerView.translatesAutoresizingMaskIntoConstraints = NO;\n [self.view addSubview:bannerView];\n self.bannerView = bannerView;\n \n \/\/Layout\n [self.bannerView mas_makeConstraints:^(MASConstraintMaker *make) {\n make.centerX.mas_equalTo(self.view);\n make.height.equalTo(@(BannerSize.height));\n make.width.equalTo(@(BannerSize.width));\n make.top.equalTo(self.textView.mas_bottom).offset(5);\n }];\n }\n}\n\n\/\/\/ Get display revenue\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didRevenueForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n \n\/\/\/ Close button clicked (when user clicks the close button on the banner)\n\/\/\/ - Parameters:\n\/\/\/ - bannerView: Banner ad view object\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)bannerView:(ATBannerView *)bannerView didTapCloseButtonWithPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n \/\/ Received close button click callback, remove bannerView\n [self removeAd];\n}\n\n\/\/\/ Banner ad has been shown\n\/\/\/ - Parameters:\n\/\/\/ - bannerView: Banner ad view object\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)bannerView:(ATBannerView *)bannerView didShowAdWithPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Banner ad was clicked\n\/\/\/ - Parameters:\n\/\/\/ - bannerView: Banner ad view object\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)bannerView:(ATBannerView *)bannerView didClickWithPlacementID:(NSString *)placementID extra:(NSDictionary *)extra{ \n}\n\n\/\/\/ Banner ad has auto refreshed\n\/\/\/ - Parameters:\n\/\/\/ - bannerView: Banner ad view object\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)bannerView:(ATBannerView *)bannerView didAutoRefreshWithPlacement:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Banner ad auto refresh failed\n\/\/\/ - Parameters:\n\/\/\/ - bannerView: Banner ad view object\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - error: Error information\n- (void)bannerView:(ATBannerView *)bannerView failedToAutoRefreshWithPlacementID:(NSString *)placementID error:(NSError *)error { \n}\n \n\/\/\/ Banner ad has opened or jumped to deep link page\n\/\/\/ - Parameters:\n\/\/\/ - bannerView: Banner ad view object\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n\/\/\/ - success: Whether successful\n- (void)bannerView:(ATBannerView *)bannerView didDeepLinkOrJumpForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra result:(BOOL)success { \n}\n```\n\n## 4. Destroy Ad\n\n```objc\n#pragma mark - Destroy Ad\n- (void)removeAd { \n [self.bannerView destroyBanner];\n [self.bannerView removeFromSuperview];\n self.bannerView = nil;\n self.hasLoaded = NO;\n}\n```","pure_content":"1. Integration Recommendations\n1.1 Width and Height Settings\n\nThe width and height settings need to be consistent with the aspect ratio configured in the Taku backend and adjusted according to actual effects.\n\n1.2 Auto Refresh\n\nAuto refresh is not enabled by default. You can configure the refresh time to enable or disable refresh in the advanced settings of the ad placement in the Taku backend.\nThe Banner ad View must be added to the window and be visible to trigger auto refresh.\nIf the ad platform provides auto refresh functionality, it is recommended to disable the ad platform's auto refresh and only use the auto refresh provided by Taku to avoid unpredictable issues caused by conflicts.\nAfter enabling the auto refresh feature, add ATBannerView to the layout and ensure it is in a visible state, then call the loadADWithPlacementID: method once. Subsequent displays and refreshes will be automatically executed by the SDK.\n\n1.4 Sample Code\n\nFor detailed sample code, please refer to: BannerVC.m in Demo\n\n\n1.5 \u26a0\ufe0f Version Update Notes\n\nVersion V6.4.39 and above (including V6.4.39) supports passing in a controller object when loading ads to adapt to the requirement of some ad platforms that the loading controller and display controller must match. If you cannot adapt to passing in a controller object for some reasons, it may cause the problem of invalid clicks after these ad platforms are displayed. If you need to adapt, please use the following APIs together and pass in the same controller object:\n\/\/\/ Load banner ad\n\/\/\/ @param placementID Ad placement ID\n\/\/\/ @param extra Extra parameters\n\/\/\/ @param viewController Target controller, for example, the popup window after Banner click will use this controller, you need to reference it, SDK internally uses weak reference\n\/\/\/ @param delegate Delegate object\n- (void)loadADWithPlacementID:(NSString *)placementID\n extra:(NSDictionary *)extra\n viewController:(UIViewController *)viewController\n delegate:(id)delegate;\n\n\/\/\/ Check if banner ad is ready\n\/\/\/ @param placementID Ad placement ID\n\/\/\/ @param showViewController Pass in the same object as the controller in the loading method -[ATAdManager loadADWithPlacementID:extra:viewController:delegate:]\n- (BOOL)bannerAdReadyForPlacementID:(NSString *)placementID showViewController:(UIViewController *)showViewController;\n\n\/\/\/ Get BannerView object for display\n\/\/\/ @param placementID Ad placement ID\n\/\/\/ @param ATShowConfig config Configuration object, if viewController was passed in loadADWithPlacementID, then the same object needs to be passed here\n\/\/\/ @param nativeMixBannerViewBlock For custom banner ads, returns components for custom layout\n- (nullable ATBannerView *)retrieveBannerViewForPlacementID:(NSString *)placementID\n config:(ATShowConfig *)config\n nativeMixBannerViewBlock:(nullable NativeMixBannerViewBlock)nativeMixBannerViewBlock;\n\n\n2. Load Ad\n\nBanner ads on different platforms have certain rule restrictions:\n\nProportional scaling rule: For example, if the banner ad size configured in the backend is 640*100, to fill the screen width, calculate height H = (screen width * 100)\/640; then the filled size is: CGSizeMake(screen width, H);\nFixed size rule: Select a fixed size in the backend configuration, and also set the same fixed size in the code\nAdaptive rule: Only supported by some ad platforms, and you need to select a non-fixed size style in the backend. For code details, see the method example in Demo - [AdLoadConfigTool banner_loadExtraConfigAppendAdmob:loadConfigDict]\n\n\n\nThe extra dictionary in this step supports passing in relevant parameters for configuring ads and your custom parameters. You can view more information about extra parameters here.\n\n\n\/\/Import header file\n#import \n\n@interface BannerVC () \n\n@property (nonatomic, strong) ATBannerView *bannerView;\n@property (nonatomic, assign) BOOL hasLoaded; \/\/ Ad loading status identifier\n\n@end\n\n@implementation BannerVC\n\n\/\/Ad placement ID\n#define BannerPlacementID @\"b680a1e7874fce\"\n\n\/\/Scene ID, optional, can be generated in the backend. If not available, pass an empty string\n#define BannerSceneID @\"\"\n\n\/\/Please note that banner size needs to be consistent with the ratio configured in the backend\n#define BannerSize CGSizeMake(320, 50)\n\n#pragma mark - Load Ad\n\/\/\/ Load ad\n- (void)loadAd {\n \n [self showLog:kLocalizeStr(@\"Clicked load ad\")];\n \n NSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];\n \n \/*\n Note that banner ads on different platforms have certain restrictions. For example, the configured banner ad is 640*100. In order to fill the screen width, the height H = (screen width *100)\/640 is calculated. Then the extra size of the load is (screen width: H).\n \n Note that banner ads on different platforms have certain restrictions. For example, the configured banner AD is 640*100. In order to fill the screen width, the height H = (screen width *100)\/640 is calculated. Then the extra size of the load is (screen width: H).\n *\/\n [loadConfigDict setValue:[NSValue valueWithCGSize:BannerSize] forKey:kATAdLoadingExtraBannerAdSizeKey];\n \n \/\/Set custom parameters\n [loadConfigDict setValue:@\"media_val_BannerVC\" forKey:kATAdLoadingExtraMediaExtraKey];\n \n \/\/Start loading\n [[ATAdManager sharedManager] loadADWithPlacementID:BannerPlacementID extra:loadConfigDict delegate:self];\n}\n\n#pragma mark - Ad placement delegate callbacks\n\/\/\/ Ad placement loading completed\n\/\/\/ - Parameter placementID: Ad placement ID\n- (void)didFinishLoadingADWithPlacementID:(NSString *)placementID {\n self.hasLoaded = YES;\n }\n \n\/\/\/ Ad placement loading failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - error: Error information\n- (void)didFailToLoadADWithPlacementID:(NSString *)placementID error:(NSError *)error { \n self.hasLoaded = NO;\n}\n\n3. Show Ad\n\nStatistics scene arrival rate, displayed in the backend's Data Reports -> Funnel Analysis Report -> Arrival at Ad Scene, called before showing ads.\n\n#pragma mark - Show Ad\n\/\/\/ Show ad\n- (void)showAd {\n \n \/\/Scene statistics function, displayed in the backend's Data Reports -> Funnel Analysis Report -> Arrival at Ad Scene, called before showing ads. Optional integration\n [[ATAdManager sharedManager] entryBannerScenarioWithPlacementID:BannerPlacementID scene:BannerSceneID];\n\n \/\/Check if ready\n if (![[ATAdManager sharedManager] bannerAdReadyForPlacementID:BannerPlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/Show configuration, Scene passes in the backend scene ID, if not available pass an empty string, showCustomExt parameter can pass in custom parameter string\n ATShowConfig *config = [[ATShowConfig alloc] initWithScene:BannerSceneID showCustomExt:@\"testShowCustomExt\"];\n \n \/\/Show ad\n ATBannerView *bannerView = [[ATAdManager sharedManager] retrieveBannerViewForPlacementID:BannerPlacementID config:config];\n if (bannerView != nil) {\n \/\/Assignment\n bannerView.delegate = self;\n bannerView.presentingViewController = self;\n bannerView.translatesAutoresizingMaskIntoConstraints = NO;\n [self.view addSubview:bannerView];\n self.bannerView = bannerView;\n \n \/\/Layout\n [self.bannerView mas_makeConstraints:^(MASConstraintMaker *make) {\n make.centerX.mas_equalTo(self.view);\n make.height.equalTo(@(BannerSize.height));\n make.width.equalTo(@(BannerSize.width));\n make.top.equalTo(self.textView.mas_bottom).offset(5);\n }];\n }\n}\n\n\/\/\/ Get display revenue\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didRevenueForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n \n\/\/\/ Close button clicked (when user clicks the close button on the banner)\n\/\/\/ - Parameters:\n\/\/\/ - bannerView: Banner ad view object\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)bannerView:(ATBannerView *)bannerView didTapCloseButtonWithPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n \/\/ Received close button click callback, remove bannerView\n [self removeAd];\n}\n\n\/\/\/ Banner ad has been shown\n\/\/\/ - Parameters:\n\/\/\/ - bannerView: Banner ad view object\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)bannerView:(ATBannerView *)bannerView didShowAdWithPlacementID:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Banner ad was clicked\n\/\/\/ - Parameters:\n\/\/\/ - bannerView: Banner ad view object\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)bannerView:(ATBannerView *)bannerView didClickWithPlacementID:(NSString *)placementID extra:(NSDictionary *)extra{ \n}\n\n\/\/\/ Banner ad has auto refreshed\n\/\/\/ - Parameters:\n\/\/\/ - bannerView: Banner ad view object\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)bannerView:(ATBannerView *)bannerView didAutoRefreshWithPlacement:(NSString *)placementID extra:(NSDictionary *)extra { \n}\n\n\/\/\/ Banner ad auto refresh failed\n\/\/\/ - Parameters:\n\/\/\/ - bannerView: Banner ad view object\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - error: Error information\n- (void)bannerView:(ATBannerView *)bannerView failedToAutoRefreshWithPlacementID:(NSString *)placementID error:(NSError *)error { \n}\n \n\/\/\/ Banner ad has opened or jumped to deep link page\n\/\/\/ - Parameters:\n\/\/\/ - bannerView: Banner ad view object\n\/\/\/ - placementID: Ad placement ID\n\/\/\/ - extra: Extra information\n\/\/\/ - success: Whether successful\n- (void)bannerView:(ATBannerView *)bannerView didDeepLinkOrJumpForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra result:(BOOL)success { \n}\n\n4. Destroy Ad\n#pragma mark - Destroy Ad\n- (void)removeAd { \n [self.bannerView destroyBanner];\n [self.bannerView removeFromSuperview];\n self.bannerView = nil;\n self.hasLoaded = NO;\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1720003503","update_time":"1753682390"},"pure_content":"1. Integration Recommendations\n1.1 Width and Height Settings\n\nThe width and height settings need to be consistent with the aspect ratio configured in the Taku backend and adjusted according to actual"},{"id":"119430","string_id":"EU8S7H","status":"1","parent_id":"115971","slug":"Native-Advertising","order":"0","name":"Native Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1720593286","add_time":"1720163517","update_time":"1753937770","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"119430","content":"## 1. Integration Recommendations\n\n| Type | Description | Notes | [Demo](https:\/\/github.com\/toponteam\/TopOn-iOS-Pod-Demo) Sample Code Location |\n|------|-------------|-------|------------------------------------------------------------------------|\n| Self-Render | Ad materials returned by third-party ad platforms are assembled by developers. The type selection in the third-party ad platform backend must be consistent with the Taku backend, otherwise it will cause errors. | [Self-Rendering Ad Integration Notes](\/docs\/SelfRendering-Ad-Integration-Notes) | \u2022 Single Self-Render: `SelfRenderVC.m`
\u2022 Feed Stream List: `FeedSelfRenderVC.m` |\n| Template Render | Third-party ad platforms return rendered views that you can directly add to a container for display. | \u2022 Template ads from different ad platforms have their own ad aspect ratios, which you can view in these ad platform backends.
\u2022 Please **try to select templates with the same or similar aspect ratios in the ad platform backend**, and pass in the corresponding aspect ratio dimensions in the code to load and display ads for the best display effect. | \u2022 Single Template Render: `ExpressVC.m`
\u2022 Feed Stream List: `FeedTemplateVC.m` |\n\n## 2. Loading Ads\n\n> The extra dictionary in this step supports passing in relevant parameters for configuring ads and your custom parameters. You can view more information about [extra parameters](\/docs\/Extra-Parameters) here.\n\n```objc\n\/\/ Import header file\n#import \n\n\/\/Add protocol \n\n@interface SelfRenderVC () \n\n@property (strong, nonatomic) ATNativeADView * adView;\n@property (strong, nonatomic) SelfRenderView * selfRenderView;\n@property (nonatomic, strong) ATNativeAdOffer * nativeAdOffer;\n\/\/ Retry attempt counter\n@property (nonatomic, assign) NSInteger retryAttempt;\n@end\n\n@implementation SelfRenderVC\n\n\/\/Placement ID\n#define Native_SelfRender_PlacementID @\"b680af2c216f73\"\n\n\/\/Scene ID, optional, can be generated in the backend. Pass empty string if not available\n#define Native_SelfRender_SceneID @\"\"\n \n#pragma mark - Load Ad\n\/\/\/ Load ad\n- (void)loadAd {\n\n NSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];\n \n \/\/Set the size for requesting ads\n [loadConfigDict setValue:[NSValue valueWithCGSize:CGSizeMake(SelfRenderViewWidth, SelfRenderViewHeight)] forKey:kATExtraInfoNativeAdSizeKey];\n\n [[ATAdManager sharedManager] loadADWithPlacementID:Native_SelfRender_PlacementID extra:loadConfigDict delegate:self];\n}\n\n#pragma mark - Placement Delegate Callbacks\n\/\/\/ Placement loading completed\n\/\/\/ - Parameter placementID: Placement ID\n- (void)didFinishLoadingADWithPlacementID:(NSString *)placementID { \n \/\/ Reset retry attempts\n self.retryAttempt = 0;\n}\n \n\/\/\/ Placement loading failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - error: Error information\n- (void)didFailToLoadADWithPlacementID:(NSString *)placementID error:(NSError *)error { \n if (self.retryAttempt >= 3) {\n return;\n }\n self.retryAttempt++;\n \n \/\/ Calculate delay time: power of 2, maximum 8 seconds\n NSInteger delaySec = pow(2, MIN(3, self.retryAttempt));\n\n \/\/ Delayed retry loading ad\n dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delaySec * NSEC_PER_SEC), dispatch_get_main_queue(), ^{\n [self loadAd];\n });\n}\n\n\/\/\/ Received display revenue\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didRevenueForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Native ad has been displayed\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information\n- (void)didShowNativeAdInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Native ad close button was tapped\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information\n- (void)didTapCloseButtonInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n \/\/ Destroy ad\n [self removeAd];\n \/\/ Preload next ad\n [self loadAd];\n}\n\n\/\/\/ Native ad started playing video\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didStartPlayingVideoInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Native ad video playback ended\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didEndPlayingVideoInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Native ad was clicked by user\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didClickNativeAdInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n \n\/\/\/ Native ad opened or jumped to deep link page\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information\n\/\/\/ - success: Whether successful\n- (void)didDeepLinkOrJumpInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra result:(BOOL)success {\n}\n \n\/\/\/ Native ad entered full-screen video playback, usually automatically jumps to a playback landing page after clicking video mediaView\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information\n- (void)didEnterFullScreenVideoInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra{\n}\n\n\/\/\/ Native ad exited full-screen video playback\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information\n- (void)didExitFullScreenVideoInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n \n\/\/\/ Native ad exited detail page\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information\n- (void)didCloseDetailInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n```\n\n## 3. Displaying Ads\n\n> - Note: Before displaying ads, it is recommended to first understand [Self-Rendering Ad Integration Notes](\/docs\/SelfRendering-Ad-Integration-Notes) to avoid display and click anomalies.\n> - [**Scene reach rate statistics**](\/docs\/Scenario-advertising-scene), displayed in the backend's Data Reports -> Funnel Analysis Report -> Reach Ad Scene, called before displaying ads.\n\n| Render Type | Implementation Steps |\n|-------------|----------------------|\n| Self-Render | 1. Assign values to the self-render view based on the obtained **nativeAd**, create **ATNativeADView** object, check if there is **mediaView**, and register click events.
2. Call the **loadPrepareInfo** method of **ATNativePrepareInfo** to bind self-render controls, bind controls that need to be displayed, others that don't need to be displayed don't need to be bound.
3. Call the **rendererWithConfiguration: selfRenderView: nativeADView:** method of **ATNativeAdOffer** to complete the rendering steps. |\n| Template Render | 1. Create **ATNativeADView** object based on the obtained **offer** and newly created **ATNativeADConfiguration** object configuration
2. Call the **rendererWithConfiguration: selfRenderView: nativeADView:** method of **ATNativeAdOffer** to complete the rendering steps, pass **nil** for **selfRenderView**. |\n\n### 3.1 Self-Render Ad Display\n\n```objc\n \/\/Scene statistics function, optional integration\n [[ATAdManager sharedManager] entryNativeScenarioWithPlacementID:Native_SelfRender_PlacementID scene:Native_SelfRender_SceneID];\n\n \/\/Check if ready\n if (![[ATAdManager sharedManager] nativeAdReadyForPlacementID:Native_SelfRender_PlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/ Initialize config configuration\n ATNativeADConfiguration *config = [[ATNativeADConfiguration alloc] init];\n \/\/ Pre-layout for native ads\n config.ADFrame = CGRectMake(0, 0, SelfRenderViewWidth, SelfRenderViewHeight);\n \/\/ Pre-layout for video player, recommend to layout again after adding to custom view\n config.mediaViewFrame = CGRectMake(0, 0, SelfRenderViewMediaViewWidth, SelfRenderViewMediaViewHeight);\n \/\/Set delegate\n config.delegate = self;\n config.rootViewController = self;\n \/\/Make ad View container fit the ad\n config.sizeToFit = YES;\n\n \/\/[Manual Layout Method] Precisely set logo size and position, choose one implementation with the [Masonry Method] below\n config.logoViewFrame = CGRectMake(kScreenW-50-10, SelfRenderViewHeight-50-10, 50, 50);\n \n \/\/Set ad platform logo position preference (some ad platforms cannot be precisely set, then set through the code below, recommend to match the logoViewFrame position above as much as possible)\n [ATAPI sharedInstance].preferredAdLogoPosition = ATAdLogoPositionBottomRightCorner;\n \n \/\/ Get offer ad object, consumes one ad cache after retrieval\n ATNativeAdOffer *offer = [[ATAdManager sharedManager] getNativeAdOfferWithPlacementID:Native_SelfRender_PlacementID scene:Native_SelfRender_SceneID];\n NSDictionary *offerInfoDict = [Tools getOfferInfo:offer];\n self.nativeAdOffer = offer;\n \n \/\/ Create self-render view, and assign values based on offer information content\n SelfRenderView *selfRenderView = [[SelfRenderView alloc] initWithOffer:offer];\n \n \/\/ Create ad nativeADView\n \/\/ Get native ad display container view\n ATNativeADView *nativeADView = [[ATNativeADView alloc] initWithConfiguration:config currentOffer:offer placementID:Native_SelfRender_PlacementID];\n \n \/\/Create container array for clickable components\n NSMutableArray *clickableViewArray = [NSMutableArray array];\n \n \/\/ Get mediaView, need to add to self-render view manually, must call\n UIView *mediaView = [nativeADView getMediaView];\n if (mediaView) {\n \/\/ Assign and layout, the set method here includes layout\n selfRenderView.mediaView = mediaView;\n }\n \n \/\/ Set UI controls that need to register click events, it's best not to add the entire parent view of the feed to click events, otherwise clicking the close button might also trigger the feed click event.\n \/\/ Close button (dislikeButton) does not need to register click events\n [clickableViewArray addObjectsFromArray:@[selfRenderView.iconImageView,\n selfRenderView.titleLabel,\n selfRenderView.textLabel,\n selfRenderView.ctaLabel,\n selfRenderView.mainImageView]];\n \n \/\/ Register click events for UI controls\n [nativeADView registerClickableViewArray:clickableViewArray];\n \n \/\/Bind components\n ATNativePrepareInfo *info = [ATNativePrepareInfo loadPrepareInfo:^(ATNativePrepareInfo * prepareInfo) {\n prepareInfo.textLabel = selfRenderView.textLabel;\n prepareInfo.advertiserLabel = selfRenderView.advertiserLabel;\n prepareInfo.titleLabel = selfRenderView.titleLabel;\n prepareInfo.ratingLabel = selfRenderView.ratingLabel;\n prepareInfo.iconImageView = selfRenderView.iconImageView;\n prepareInfo.mainImageView = selfRenderView.mainImageView;\n prepareInfo.logoImageView = selfRenderView.logoImageView;\n prepareInfo.ctaLabel = selfRenderView.ctaLabel;\n prepareInfo.dislikeButton = selfRenderView.dislikeButton;\n prepareInfo.mediaView = selfRenderView.mediaView;\n }];\n [nativeADView prepareWithNativePrepareInfo:info];\n \n \/\/Render ad\n [offer rendererWithConfiguration:config selfRenderView:selfRenderView nativeADView:nativeADView];\n\n self.adView = nativeADView;\n \n \/\/Display ad\n AdDisplayVC *showVc = [[AdDisplayVC alloc] initWithAdView:nativeADView offer:offer adViewSize:CGSizeMake(SelfRenderViewWidth, SelfRenderViewHeight)];\n [self.navigationController pushViewController:showVc animated:YES];\n```\n\n### 3.2 Template Ad Display\n\n```objc\n \/\/Scene statistics function, optional integration\n [[ATAdManager sharedManager] entryNativeScenarioWithPlacementID:Native_Express_PlacementID scene:Native_Express_SceneID];\n\n \/\/Check if ready\n if (![[ATAdManager sharedManager] nativeAdReadyForPlacementID:Native_Express_PlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/ Initialize config configuration\n ATNativeADConfiguration *config = [[ATNativeADConfiguration alloc] init];\n \/\/ Set size for template ad nativeADView, usually the size set when requesting ads\n config.ADFrame = CGRectMake(0, 0, ExpressAdWidth, ExpressAdHeight);\n \/\/Set delegate\n config.delegate = self;\n \/\/Set display root controller\n config.rootViewController = self;\n \/\/ Enable template ad adaptive height, when the actual returned ad size is inconsistent with the size set when requesting ads, the SDK will automatically adjust the nativeADView size to the actual returned ad size.\n config.sizeToFit = YES;\n\n \/\/ Get offer ad object, consumes one ad cache after retrieval\n ATNativeAdOffer *offer = [[ATAdManager sharedManager] getNativeAdOfferWithPlacementID:Native_Express_PlacementID scene:Native_Express_SceneID];\n \n \/\/ Create ad nativeADView\n ATNativeADView *nativeADView = [[ATNativeADView alloc] initWithConfiguration:config currentOffer:offer placementID:Native_Express_PlacementID];\n\n \/\/Render ad\n [offer rendererWithConfiguration:config selfRenderView:nil nativeADView:nativeADView];\n \n self.adView = nativeADView;\n \n \/\/Display ad\n AdDisplayVC *showVc = [[AdDisplayVC alloc] initWithAdView:nativeADView offer:offer adViewSize:CGSizeMake(ExpressAdWidth, ExpressAdHeight)];\n [self.navigationController pushViewController:showVc animated:YES];\n```\n\n## 4. Destroying Ads\n\n```objc\n- (void)removeAd {\n if (self.adView && self.adView.superview) {\n [self.adView removeFromSuperview];\n }\n [self.adView destroyNative];\n self.adView = nil;\n \/\/ Destroy offer timely for self-render\n [self.selfRenderView destory];\n self.selfRenderView = nil;\n}\n```","pure_content":"1. Integration Recommendations\n\n\n\n Type\n Description\n Notes\n Demo Sample Code Location\n\n\n\n\n Self-Render\n Ad materials returned by third-party ad platforms are assembled by developers. The type selection in the third-party ad platform backend must be consistent with the Taku backend, otherwise it will cause errors.\n Self-Rendering Ad Integration Notes\n \u2022 Single Self-Render: SelfRenderVC.m\u2022 Feed Stream List: FeedSelfRenderVC.m\n\n\n Template Render\n Third-party ad platforms return rendered views that you can directly add to a container for display.\n \u2022 Template ads from different ad platforms have their own ad aspect ratios, which you can view in these ad platform backends.\u2022 Please try to select templates with the same or similar aspect ratios in the ad platform backend, and pass in the corresponding aspect ratio dimensions in the code to load and display ads for the best display effect.\n \u2022 Single Template Render: ExpressVC.m\u2022 Feed Stream List: FeedTemplateVC.m\n\n\n\n2. Loading Ads\n\nThe extra dictionary in this step supports passing in relevant parameters for configuring ads and your custom parameters. You can view more information about extra parameters here.\n\n\/\/ Import header file\n#import \n\n\/\/Add protocol \n\n@interface SelfRenderVC () \n\n@property (strong, nonatomic) ATNativeADView * adView;\n@property (strong, nonatomic) SelfRenderView * selfRenderView;\n@property (nonatomic, strong) ATNativeAdOffer * nativeAdOffer;\n\/\/ Retry attempt counter\n@property (nonatomic, assign) NSInteger retryAttempt;\n@end\n\n@implementation SelfRenderVC\n\n\/\/Placement ID\n#define Native_SelfRender_PlacementID @\"b680af2c216f73\"\n\n\/\/Scene ID, optional, can be generated in the backend. Pass empty string if not available\n#define Native_SelfRender_SceneID @\"\"\n \n#pragma mark - Load Ad\n\/\/\/ Load ad\n- (void)loadAd {\n\n NSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];\n \n \/\/Set the size for requesting ads\n [loadConfigDict setValue:[NSValue valueWithCGSize:CGSizeMake(SelfRenderViewWidth, SelfRenderViewHeight)] forKey:kATExtraInfoNativeAdSizeKey];\n\n [[ATAdManager sharedManager] loadADWithPlacementID:Native_SelfRender_PlacementID extra:loadConfigDict delegate:self];\n}\n\n#pragma mark - Placement Delegate Callbacks\n\/\/\/ Placement loading completed\n\/\/\/ - Parameter placementID: Placement ID\n- (void)didFinishLoadingADWithPlacementID:(NSString *)placementID { \n \/\/ Reset retry attempts\n self.retryAttempt = 0;\n}\n \n\/\/\/ Placement loading failed\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - error: Error information\n- (void)didFailToLoadADWithPlacementID:(NSString *)placementID error:(NSError *)error { \n if (self.retryAttempt >= 3) {\n return;\n }\n self.retryAttempt++;\n \n \/\/ Calculate delay time: power of 2, maximum 8 seconds\n NSInteger delaySec = pow(2, MIN(3, self.retryAttempt));\n\n \/\/ Delayed retry loading ad\n dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delaySec * NSEC_PER_SEC), dispatch_get_main_queue(), ^{\n [self loadAd];\n });\n}\n\n\/\/\/ Received display revenue\n\/\/\/ - Parameters:\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didRevenueForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Native ad has been displayed\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information\n- (void)didShowNativeAdInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Native ad close button was tapped\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information\n- (void)didTapCloseButtonInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n \/\/ Destroy ad\n [self removeAd];\n \/\/ Preload next ad\n [self loadAd];\n}\n\n\/\/\/ Native ad started playing video\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didStartPlayingVideoInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Native ad video playback ended\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didEndPlayingVideoInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n\/\/\/ Native ad was clicked by user\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information dictionary\n- (void)didClickNativeAdInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n \n\/\/\/ Native ad opened or jumped to deep link page\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information\n\/\/\/ - success: Whether successful\n- (void)didDeepLinkOrJumpInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra result:(BOOL)success {\n}\n \n\/\/\/ Native ad entered full-screen video playback, usually automatically jumps to a playback landing page after clicking video mediaView\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information\n- (void)didEnterFullScreenVideoInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra{\n}\n\n\/\/\/ Native ad exited full-screen video playback\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information\n- (void)didExitFullScreenVideoInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n \n\/\/\/ Native ad exited detail page\n\/\/\/ - Parameters:\n\/\/\/ - adView: Ad view object\n\/\/\/ - placementID: Placement ID\n\/\/\/ - extra: Extra information\n- (void)didCloseDetailInAdView:(ATNativeADView *)adView placementID:(NSString *)placementID extra:(NSDictionary *)extra {\n}\n\n3. Displaying Ads\n\n\nNote: Before displaying ads, it is recommended to first understand Self-Rendering Ad Integration Notes to avoid display and click anomalies.\n\nScene reach rate statistics, displayed in the backend's Data Reports -> Funnel Analysis Report -> Reach Ad Scene, called before displaying ads.\n\n\n\n\n\n Render Type\n Implementation Steps\n\n\n\n\n Self-Render\n 1. Assign values to the self-render view based on the obtained nativeAd, create ATNativeADView object, check if there is mediaView, and register click events.2. Call the loadPrepareInfo method of ATNativePrepareInfo to bind self-render controls, bind controls that need to be displayed, others that don't need to be displayed don't need to be bound.3. Call the rendererWithConfiguration: selfRenderView: nativeADView: method of ATNativeAdOffer to complete the rendering steps.\n\n\n Template Render\n 1. Create ATNativeADView object based on the obtained offer and newly created ATNativeADConfiguration object configuration2. Call the rendererWithConfiguration: selfRenderView: nativeADView: method of ATNativeAdOffer to complete the rendering steps, pass nil for selfRenderView.\n\n\n\n3.1 Self-Render Ad Display\n \/\/Scene statistics function, optional integration\n [[ATAdManager sharedManager] entryNativeScenarioWithPlacementID:Native_SelfRender_PlacementID scene:Native_SelfRender_SceneID];\n\n \/\/Check if ready\n if (![[ATAdManager sharedManager] nativeAdReadyForPlacementID:Native_SelfRender_PlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/ Initialize config configuration\n ATNativeADConfiguration *config = [[ATNativeADConfiguration alloc] init];\n \/\/ Pre-layout for native ads\n config.ADFrame = CGRectMake(0, 0, SelfRenderViewWidth, SelfRenderViewHeight);\n \/\/ Pre-layout for video player, recommend to layout again after adding to custom view\n config.mediaViewFrame = CGRectMake(0, 0, SelfRenderViewMediaViewWidth, SelfRenderViewMediaViewHeight);\n \/\/Set delegate\n config.delegate = self;\n config.rootViewController = self;\n \/\/Make ad View container fit the ad\n config.sizeToFit = YES;\n\n \/\/[Manual Layout Method] Precisely set logo size and position, choose one implementation with the [Masonry Method] below\n config.logoViewFrame = CGRectMake(kScreenW-50-10, SelfRenderViewHeight-50-10, 50, 50);\n \n \/\/Set ad platform logo position preference (some ad platforms cannot be precisely set, then set through the code below, recommend to match the logoViewFrame position above as much as possible)\n [ATAPI sharedInstance].preferredAdLogoPosition = ATAdLogoPositionBottomRightCorner;\n \n \/\/ Get offer ad object, consumes one ad cache after retrieval\n ATNativeAdOffer *offer = [[ATAdManager sharedManager] getNativeAdOfferWithPlacementID:Native_SelfRender_PlacementID scene:Native_SelfRender_SceneID];\n NSDictionary *offerInfoDict = [Tools getOfferInfo:offer];\n self.nativeAdOffer = offer;\n \n \/\/ Create self-render view, and assign values based on offer information content\n SelfRenderView *selfRenderView = [[SelfRenderView alloc] initWithOffer:offer];\n \n \/\/ Create ad nativeADView\n \/\/ Get native ad display container view\n ATNativeADView *nativeADView = [[ATNativeADView alloc] initWithConfiguration:config currentOffer:offer placementID:Native_SelfRender_PlacementID];\n \n \/\/Create container array for clickable components\n NSMutableArray *clickableViewArray = [NSMutableArray array];\n \n \/\/ Get mediaView, need to add to self-render view manually, must call\n UIView *mediaView = [nativeADView getMediaView];\n if (mediaView) {\n \/\/ Assign and layout, the set method here includes layout\n selfRenderView.mediaView = mediaView;\n }\n \n \/\/ Set UI controls that need to register click events, it's best not to add the entire parent view of the feed to click events, otherwise clicking the close button might also trigger the feed click event.\n \/\/ Close button (dislikeButton) does not need to register click events\n [clickableViewArray addObjectsFromArray:@[selfRenderView.iconImageView,\n selfRenderView.titleLabel,\n selfRenderView.textLabel,\n selfRenderView.ctaLabel,\n selfRenderView.mainImageView]];\n \n \/\/ Register click events for UI controls\n [nativeADView registerClickableViewArray:clickableViewArray];\n \n \/\/Bind components\n ATNativePrepareInfo *info = [ATNativePrepareInfo loadPrepareInfo:^(ATNativePrepareInfo * prepareInfo) {\n prepareInfo.textLabel = selfRenderView.textLabel;\n prepareInfo.advertiserLabel = selfRenderView.advertiserLabel;\n prepareInfo.titleLabel = selfRenderView.titleLabel;\n prepareInfo.ratingLabel = selfRenderView.ratingLabel;\n prepareInfo.iconImageView = selfRenderView.iconImageView;\n prepareInfo.mainImageView = selfRenderView.mainImageView;\n prepareInfo.logoImageView = selfRenderView.logoImageView;\n prepareInfo.ctaLabel = selfRenderView.ctaLabel;\n prepareInfo.dislikeButton = selfRenderView.dislikeButton;\n prepareInfo.mediaView = selfRenderView.mediaView;\n }];\n [nativeADView prepareWithNativePrepareInfo:info];\n \n \/\/Render ad\n [offer rendererWithConfiguration:config selfRenderView:selfRenderView nativeADView:nativeADView];\n\n self.adView = nativeADView;\n \n \/\/Display ad\n AdDisplayVC *showVc = [[AdDisplayVC alloc] initWithAdView:nativeADView offer:offer adViewSize:CGSizeMake(SelfRenderViewWidth, SelfRenderViewHeight)];\n [self.navigationController pushViewController:showVc animated:YES];\n\n3.2 Template Ad Display\n \/\/Scene statistics function, optional integration\n [[ATAdManager sharedManager] entryNativeScenarioWithPlacementID:Native_Express_PlacementID scene:Native_Express_SceneID];\n\n \/\/Check if ready\n if (![[ATAdManager sharedManager] nativeAdReadyForPlacementID:Native_Express_PlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/ Initialize config configuration\n ATNativeADConfiguration *config = [[ATNativeADConfiguration alloc] init];\n \/\/ Set size for template ad nativeADView, usually the size set when requesting ads\n config.ADFrame = CGRectMake(0, 0, ExpressAdWidth, ExpressAdHeight);\n \/\/Set delegate\n config.delegate = self;\n \/\/Set display root controller\n config.rootViewController = self;\n \/\/ Enable template ad adaptive height, when the actual returned ad size is inconsistent with the size set when requesting ads, the SDK will automatically adjust the nativeADView size to the actual returned ad size.\n config.sizeToFit = YES;\n\n \/\/ Get offer ad object, consumes one ad cache after retrieval\n ATNativeAdOffer *offer = [[ATAdManager sharedManager] getNativeAdOfferWithPlacementID:Native_Express_PlacementID scene:Native_Express_SceneID];\n \n \/\/ Create ad nativeADView\n ATNativeADView *nativeADView = [[ATNativeADView alloc] initWithConfiguration:config currentOffer:offer placementID:Native_Express_PlacementID];\n\n \/\/Render ad\n [offer rendererWithConfiguration:config selfRenderView:nil nativeADView:nativeADView];\n \n self.adView = nativeADView;\n \n \/\/Display ad\n AdDisplayVC *showVc = [[AdDisplayVC alloc] initWithAdView:nativeADView offer:offer adViewSize:CGSizeMake(ExpressAdWidth, ExpressAdHeight)];\n [self.navigationController pushViewController:showVc animated:YES];\n\n4. Destroying Ads\n- (void)removeAd {\n if (self.adView && self.adView.superview) {\n [self.adView removeFromSuperview];\n }\n [self.adView destroyNative];\n self.adView = nil;\n \/\/ Destroy offer timely for self-render\n [self.selfRenderView destory];\n self.selfRenderView = nil;\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1720163517","update_time":"1753937769"},"pure_content":"1. Integration Recommendations\n\n\n\n Type\n Description\n Notes\n Demo Sample Code Location\n\n\n\n\n Self-Render\n Ad materials returned by third-party ad platforms are assembled by developers. The type selecti"}],"content":{"icon":"","desc":"","content_id":"115971","add_time":"1719306114","update_time":"1720593238","content":"","is_traffic_less":"0","file_type":""},"hot_list":[],"user_read_num":"0","is_auth":"0"},"msg":"Success","code":200}