{"data":{"id":"76295","string_id":"s61d6r","status":"1","parent_id":"76196","slug":"bR8N2L","order":"19","name":"Advanced","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"","published_time":"1709722552","add_time":"1709721558","update_time":"1783479466","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","tags":[],"parent_name":"SDK Access Guide","parent_type":"1","parent_slug":"cUkkAX","child":[{"id":"687146","string_id":"QcF51TjB","status":"1","parent_id":"76295","slug":"QcF51TjB","order":"15","name":"Custom Ad Platform","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u51cc\u5929\u5b50","published_time":"1766733426","add_time":"1766733373","update_time":"1783479479","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","file_type":"","auth_id":"[\"-1\"]","pure_content":""},{"id":"863432","string_id":"GiKhslTm","status":"1","parent_id":"76295","slug":"GiKhslTm","order":"14","name":"Auto Load","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783490913","add_time":"1783478698","update_time":"1783490913","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"863432","content":"About Auto Load\n-------\n\nThe Auto Load mode is a one-stop request maintenance solution launched by Taku that intelligently determines the preloading and caching timing for the next ad across multiple nodes based on user usage status and ad consumption progress. On top of satisfying your operational strategy, it avoids the risk of real-time ad loading failures and wasted impression opportunities, reducing negative user sentiment caused by ads not loading or loading poorly. With the Auto Load solution, you can avoid the repetitive and cumbersome manual intervention in request schemes, achieving immediate efficiency improvements!\n\nSupported ad formats include: [**Rewarded Video Ad**](https:\/\/help.takuad.com\/en\/docs\/dQP9W1Qz) and [**Interstitial Ad**](https:\/\/help.takuad.com\/en\/docs\/fUF8AJzd).","pure_content":"About Auto Load\nThe Auto Load mode is a one-stop request maintenance solution launched by Taku that intelligently determines the preloading and caching timing for the next ad across multiple nodes based on user usage status and ad consumption progress. On top of satisfying your operational strategy, it avoids the risk of real-time ad loading failures and wasted impression opportunities, reducing negative user sentiment caused by ads not loading or loading poorly. With the Auto Load solution, you can avoid the repetitive and cumbersome manual intervention in request schemes, achieving immediate efficiency improvements!\nSupported ad formats include: Rewarded Video Ad and Interstitial Ad.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783478698","update_time":"1783490913"},"pure_content":"About Auto Load\nThe Auto Load mode is a one-stop request maintenance solution launched by Taku that intelligently determines the preloading and caching timing for the next ad across multiple nodes bas"},{"id":"580064","string_id":"rNukd2Uo","status":"1","parent_id":"76295","slug":"rNukd2Uo","order":"13","name":"Third-party revenue feedback(SDK v6.4.12 or above)","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u51cc\u5929\u5b50","published_time":"1753865970","add_time":"1753865273","update_time":"1783479479","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"3","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"580064","content":"

1. Introduction<\/span><\/span><\/span><\/h2>\n

You can obtain advertising-related data through the proxy callback of TopOn SDK and report it to the third-party data platform.<\/span><\/span><\/span><\/p>\n

Get the corresponding value through the proxy callback extra of each ad type. For details, see<\/span><\/span><\/span> the callback information description<\/span><\/span><\/span><\/a> .<\/p>\n

\n<\/colgroup>\n\n\n\n\n\n\n\n\n

property<\/td>\n	illustrate<\/td>\n<\/tr>\n
extra[@\"network_firm_id\"]<\/td>\n	Corresponding ids of third-party advertising platforms, refer to<\/span><\/span><\/span> the Network Firm ID table<\/span><\/span><\/span><\/a><\/td>\n<\/tr>\n
extra[@\"publisher_revenue\"]<\/td>\n	Get the revenue brought by this display. The unit can be obtained through currency and the accuracy can be obtained through precision.<\/td>\n<\/tr>\n
extra[@\"country\"]<\/td>\n	Get the country code, for example: \"CN\"<\/td>\n<\/tr>\n
extra[@\"currency\"]<\/td>\n	Get the currency unit, for example: \"USD\"<\/td>\n<\/tr>\n
extra[@\"network_placement_id\"]<\/td>\n	Advertising ID of third-party advertising platform<\/td>\n<\/tr>\n
extra[@\"adunit_id\"]<\/td>\n	Get the TopOn ad slot ID<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n 2. Timing of reporting<\/span><\/span><\/span><\/h2>\n If you have authorized the monetization revenue data of other advertising platforms in the reporting background, and the data reported now includes this advertising platform, please be sure to first disable the authorization of these platforms in the reporting background, and then use the reported revenue data to connect, otherwise duplicate data will be generated.<\/span><\/span><\/span><\/p>\n We recommend<\/span><\/span><\/span> reporting revenue data in the proxy of ad display revenue callback<\/span><\/strong><\/span><\/span> :<\/span><\/span><\/span><\/p>\n \n - (void)didRevenueForPlacementID:(NSString )placementID extra:(NSDictionary )extra<\/code><\/pre>\n<\/div>\n <\/div>\n3. Platform docking<\/span><\/span><\/span><\/h2>\n3.1 Appsflyer<\/span><\/span><\/span><\/h3>\nIt is recommended to use a tool class to<\/span><\/span><\/span> write Appsflyer<\/span><\/span><\/span><\/a> -related code, and then call it where reporting is required.<\/span><\/span><\/span><\/p>\n - (void)didRevenueForPlacementID:(NSString )placementID extra:(NSDictionary )extra {\n NSString unitId = extra[@\"network_placement_id\"];\n \/\/ convert\n double price = [extra[@\"publisher_revenue\"] doubleValue];\n NSString currency = extra[@\"currency\"];\n NSString country = extra[@\"country\"];\n\n [[AppsFlyerLib shared] logEvent: AFEventPurchase\n withValues:@{\n AFEventParamContentId:unitId,\n AFEventParamRevenue: @(price),\n AFEventParamCurrency:currency,\n AFEventParamCountry:country\n }];\n}<\/code><\/pre>\n<\/pre>\n<\/pre>\n<\/span><\/p>\n <\/h3>\n3.2 Adjust<\/span><\/span><\/span><\/h3>\nIt is recommended to use a tool class to<\/span><\/span><\/span> write Adjust-<\/span><\/span><\/span><\/a> related codes, and then call it where reporting is required.<\/span><\/span><\/span><\/p>\n - (void)didRevenueForPlacementID:(NSString )placementID extra:(NSDictionary )extra {\n double price = [extra[@\"publisher_revenue\"] doubleValue]; \n NSString currency = extra[@\"currency\"];\n \n ADJAdRevenue adRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceTopOn];\n \/\/ pass revenue and currency values\n [adRevenue setRevenue:price currency:currency];\n \n \/\/ track ad revenue\n [Adjust trackAdRevenue:adRevenue];\n}<\/code><\/pre>\n3.3 Firebase<\/span><\/span><\/span><\/h3>\nIt is recommended to use a tool class to<\/span><\/span><\/span> write Firebase-<\/span><\/span><\/span><\/a> related codes, and then call them where reporting is required.<\/span><\/span><\/span><\/p>\n - (void)didRevenueForPlacementID:(NSString )placementID extra:(NSDictionary )extra {\n \/\/#import <FirebaseAnalytics\/FirebaseAnalytics.h>\n\n NSInteger network_firm_id = [[extra valueForKey:@\"network_firm_id\"] integerValue];\n\n BOOL adsource_isheaderbidding = [[extra valueForKey:@\"adsource_isheaderbidding\"] boolValue];\n \n if (network_firm_id == 2 && adsource_isheaderbidding == 0) return;\n\n double price = [extra[@\"publisher_revenue\"] doubleValue];\n NSString currency = extra[@\"currency\"];\n\n NSDictionary params = @{\n kFIRParameterValue: @(price),\n kFIRParameterCurrency: currency,\n kFIRParameterAdPlatform: @\"TopOn\",\n kFIRParameterAdFormat: [extra valueForKey:@\"adunit_format\"],\n kFIRParameterAdUnitName : [extra valueForKey:@\"adunit_id\"],\n kFIRParameterAdSource : [extra valueForKey:@\"network_name\"],\/\/Custom adapter not supported\n };\n\n [FIRAnalytics logEventWithName:kFIREventAdImpression parameters:params];\n}<\/code><\/pre>\n<\/p>","pure_content":"1. Introduction\nYou can obtain advertising-related data through the proxy callback of TopOn SDK and report it to the third-party data platform.\nGet the corresponding value through the proxy callback extra of each ad type. For details, see the callback information description .\n\n\n\n\n property\n illustrate\n\n\n extra[@\"network_firm_id\"]\n Corresponding ids of third-party advertising platforms, refer to the Network Firm ID table\n\n\n extra[@\"publisher_revenue\"]\n Get the revenue brought by this display. The unit can be obtained through currency and the accuracy can be obtained through precision.\n\n\n extra[@\"country\"]\n Get the country code, for example: \"CN\"\n\n\n extra[@\"currency\"]\n Get the currency unit, for example: \"USD\"\n\n\n extra[@\"network_placement_id\"]\n Advertising ID of third-party advertising platform\n\n\n extra[@\"adunit_id\"]\n Get the TopOn ad slot ID\n\n\n\n\n2. Timing of reporting\nIf you have authorized the monetization revenue data of other advertising platforms in the reporting background, and the data reported now includes this advertising platform, please be sure to first disable the authorization of these platforms in the reporting background, and then use the reported revenue data to connect, otherwise duplicate data will be generated.\nWe recommend reporting revenue data in the proxy of ad display revenue callback :\n\n- (void)didRevenueForPlacementID:(NSString )placementID extra:(NSDictionary )extra\n\n\u00a0\n3. Platform docking\n3.1 Appsflyer\nIt is recommended to use a tool class to write Appsflyer -related code, and then call it where reporting is required.\n- (void)didRevenueForPlacementID:(NSString )placementID extra:(NSDictionary )extra {\n NSString unitId = extra[@\"network_placement_id\"];\n \/\/ convert\n double price = [extra[@\"publisher_revenue\"] doubleValue];\n NSString currency = extra[@\"currency\"];\n NSString country = extra[@\"country\"];\n\n [[AppsFlyerLib shared] logEvent: AFEventPurchase\n withValues:@{\n AFEventParamContentId:unitId,\n AFEventParamRevenue: @(price),\n AFEventParamCurrency:currency,\n AFEventParamCountry:country\n }];\n}\n\n\n\n\u00a0\n3.2 Adjust\nIt is recommended to use a tool class to write Adjust- related codes, and then call it where reporting is required.\n- (void)didRevenueForPlacementID:(NSString )placementID extra:(NSDictionary )extra {\n double price = [extra[@\"publisher_revenue\"] doubleValue]; \n NSString currency = extra[@\"currency\"];\n \n ADJAdRevenue adRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceTopOn];\n \/\/ pass revenue and currency values\n [adRevenue setRevenue:price currency:currency];\n \n \/\/ track ad revenue\n [Adjust trackAdRevenue:adRevenue];\n}\n3.3 Firebase\nIt is recommended to use a tool class to write Firebase- related codes, and then call them where reporting is required.\n- (void)didRevenueForPlacementID:(NSString )placementID extra:(NSDictionary )extra {\n \/\/#import \n\n NSInteger network_firm_id = [[extra valueForKey:@\"network_firm_id\"] integerValue];\n\n BOOL adsource_isheaderbidding = [[extra valueForKey:@\"adsource_isheaderbidding\"] boolValue];\n \n if (network_firm_id == 2 && adsource_isheaderbidding == 0) return;\n\n double price = [extra[@\"publisher_revenue\"] doubleValue];\n NSString currency = extra[@\"currency\"];\n\n NSDictionary params = @{\n kFIRParameterValue: @(price),\n kFIRParameterCurrency: currency,\n kFIRParameterAdPlatform: @\"TopOn\",\n kFIRParameterAdFormat: [extra valueForKey:@\"adunit_format\"],\n kFIRParameterAdUnitName : [extra valueForKey:@\"adunit_id\"],\n kFIRParameterAdSource : [extra valueForKey:@\"network_name\"],\/\/Custom adapter not supported\n };\n\n [FIRAnalytics logEventWithName:kFIREventAdImpression parameters:params];\n}","is_draft":"0","editor_type":"3","file_path":"","add_time":"1753865273","update_time":"1753866281"},"pure_content":"1. Introduction\nYou can obtain advertising-related data through the proxy callback of TopOn SDK and report it to the third-party data platform.\nGet the corresponding value through the proxy callback e"},{"id":"76308","string_id":"UMzudE","status":"1","parent_id":"76295","slug":"WeChat-mini-program-support-gkLU","order":"12","name":"WeChat mini program support","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722557","add_time":"1709721583","update_time":"1783479479","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76308","content":" Introduction<\/h2>WeChat ecological link advertising refers to the type of advertising in which after users click on the advertisement, they will jump to WeChat to open WeChat mini programs\/mini games\/official accounts\/enterprise WeChat and other scenarios, and subsequent behavioral transformation will occur within WeChat.<\/p> After connecting to WeChat ecological link ads according to the following process, the ad fill rate and eCPM can be effectively improved.<\/p> Overall Access Process<\/h2>1. Create an application on the WeChat Open Platform and obtain the WeChat Open Platform AppID<\/p> 2. Embed WeChat OpenSDK in the application.<\/p> 3. Associate the WeChat Open Platform App ID with the current application.The difference between iOS and Android applications is that universal_link needs to be filled in additionally.<\/p> Detailed Steps<\/h2>1. Create an application on the WeChat open platform<\/strong><\/h3>\u2460 The developer registers on the WeChat open platform<\/a> and creates a main account and application (if the history has already been created, it can be ignored)<\/p> \u2461 In the WeChat Open Platform<\/a> Management Center, obtain the WeChat Open Platform AppID corresponding to the application<\/p> <\/p> 2. Embed WeChat OpenSDK in the application<\/h3>Developers need to access WeChat's Open SDK and confirm that the OpenSDK version is iOS 1.8.6 or above.<\/p>pod 'WechatOpenSDK-XCFramework'<\/code><\/pre>For detailed methods and resources of embedding OpenSDK, please refer to iOS Access Guide\|WeChat Open Document<\/a><\/p> 3. The application is associated with the WeChat open platform App ID<\/h3>\u2460 You can set the WeChat Open Platform App ID of each<\/strong> advertising platform through TopOn.<\/p> \u2461 For some advertising platforms, you need to go to the corresponding backend to make the association.<\/p>3.1 TopOn unified setting instructions<\/h4>For TopOn SDK version >=6.3.50<\/strong><\/p>Under the [App] module of the TopOn developer platform<\/a>, find the application that needs to be associated with the App ID and click Edit to bind the App ID of the WeChat Open Platform to the specified application.<\/p> The specific operations are shown in the figure below:<\/p> <\/p> <\/p> Note: If the WeChat applet APPID has been set through the API of TopOn SDK, the APPID set by the API will take precedence.<\/em><\/span><\/p> For 6.1.50 <=TopOn SDK version <6.3.50<\/strong><\/p> Before initializing the SDK, you need to call the following API to set the WeChat applet APPID and Universal Link.<\/p> [[ATAPI sharedInstance] setWeChatAppID:@\"appid\" universalLink:@\"https:\/\/test.com\/sdkSample\/\"];<\/code><\/pre>3.2 Configuration instructions for each network<\/h4>Support landing page to launch WeChat mini program.<\/p> Network<\/th> network platform supported version (Supported by versions equal to or higher than the following)<\/th> Other instructions <\/th><\/tr> Kuaishou<\/td> 3.3.26<\/td> You need to give the APPID of the WeChat applet to Kuaishou's operations or business personnel for configuration. <\/td><\/tr> Mintegral<\/td> 7.1.8<\/td> WeChat applet AppID can be set uniformly<\/strong> through TopOn<\/td><\/tr> Pangolin<\/td> Historical versions are already supported<\/td> You need to pass in the WeChat AppID in the Pangolin background. Support WeChat mini program\/mini game jump access solution<\/a><\/td><\/tr> Excellent quantity Hui<\/td> Historical version has been supported<\/td> You need to fill in the WeChat AppIDAPPID in the Tencent backend.iOS supports WeChat ecological budget advertising jump access solution<\/a><\/td><\/tr> Sigmob<\/td> 4.5.0<\/td> Need to associate WeChat AppID in Sigmob background<\/td><\/tr> Baidu<\/td> 4.892<\/td> WeChat applet AppID can be set uniformly<\/strong> through TopOn<\/td><\/tr> ADX<\/td> 6.1.50<\/td> WeChat applet AppID can be set uniformly<\/strong> through TopOn<\/td><\/tr><\/tbody><\/table> <\/p>","pure_content":"IntroductionWeChat ecological link advertising refers to the type of advertising in which after users click on the advertisement, they will jump to WeChat to open WeChat mini programs\/mini games\/official accounts\/enterprise WeChat and other scenarios, and subsequent behavioral transformation will occur within WeChat.After connecting to WeChat ecological link ads according to the following process, the ad fill rate and eCPM can be effectively improved.Overall Access Process1. Create an application on the WeChat Open Platform and obtain the WeChat Open Platform AppID2. Embed WeChat OpenSDK in the application.3. Associate the WeChat Open Platform App ID with the current application.The difference between iOS and Android applications is that universal_link needs to be filled in additionally.Detailed Steps1. Create an application on the WeChat open platform\u2460 The developer registers on the WeChat open platform and creates a main account and application (if the history has already been created, it can be ignored)\u2461 In the WeChat Open Platform Management Center, obtain the WeChat Open Platform AppID corresponding to the application 2. Embed WeChat OpenSDK in the applicationDevelopers need to access WeChat's Open SDK and confirm that the OpenSDK version is iOS 1.8.6 or above.pod 'WechatOpenSDK-XCFramework'For detailed methods and resources of embedding OpenSDK, please refer to iOS Access Guide\|WeChat Open Document3. The application is associated with the WeChat open platform App ID\u2460 You can set the WeChat Open Platform App ID of each advertising platform through TopOn.\u2461 For some advertising platforms, you need to go to the corresponding backend to make the association.3.1 TopOn unified setting instructionsFor TopOn SDK version >=6.3.50Under the [App] module of the TopOn developer platform, find the application that needs to be associated with the App ID and click Edit to bind the App ID of the WeChat Open Platform to the specified application.The specific operations are shown in the figure below:Note: If the WeChat applet APPID has been set through the API of TopOn SDK, the APPID set by the API will take precedence.For 6.1.50 <=TopOn SDK version <6.3.50Before initializing the SDK, you need to call the following API to set the WeChat applet APPID and Universal Link.[[ATAPI sharedInstance] setWeChatAppID:@\"appid\" universalLink:@\"https:\/\/test.com\/sdkSample\/\"];3.2 Configuration instructions for each networkSupport landing page to launch WeChat mini program. Network network platform supported version(Supported by versions equal to or higher than the following) Other instructions Kuaishou 3.3.26 You need to give the APPID of the WeChat applet to Kuaishou's operations or business personnel for configuration. Mintegral 7.1.8 WeChat applet AppID can be set uniformly through TopOn Pangolin Historical versions are already supported You need to pass in the WeChat AppID in the Pangolin background. Support WeChat mini program\/mini game jump access solution Excellent quantity Hui Historical version has been supported You need to fill in the WeChat AppIDAPPID in the Tencent backend.iOS supports WeChat ecological budget advertising jump access solution Sigmob 4.5.0 Need to associate WeChat AppID in Sigmob background Baidu 4.892 WeChat applet AppID can be set uniformly through TopOn ADX 6.1.50 WeChat applet AppID can be set uniformly through TopOn","is_draft":"0","editor_type":"1","file_path":"","add_time":"1709721585","update_time":"1748605239"},"pure_content":"IntroductionWeChat ecological link advertising refers to the type of advertising in which after users click on the advertisement, they will jump to WeChat to open WeChat mini programs\/mini games\/offic"},{"id":"863433","string_id":"JB4sXAIb","status":"1","parent_id":"76295","slug":"JB4sXAIb","order":"11","name":"Admob Content Mapping","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783479075","add_time":"1783478699","update_time":"1783479479","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"863433","content":"1. Admob Content Mapping Description\n--------------\n\nWith app content mapping, you can serve content-relevant ads to users and ensure that the ads are placed near content that is appropriate for your advertisers. For details, please refer to the [Admob Reference Documentation](https:\/\/support.google.com\/admob\/answer\/11050896?hl=zh-Hans&visit_id=638180095957216940-1250837351&rd=1)\n\n> By default, only 1 URL can be passed. By applying to Admob, you can enable support for up to 4 content URLs (multi-content URL).\n\n- Supported ad types: All ad formats\n- Supported starting from version: v6.2.65\n\n2. Sample Code\n-------\n\n### 2.1 Add Content Mapping URLs\n\n```\n\/\/ Supports passing 1-4 URLs\nNSMutableDictionary mutableDict = [NSMutableDictionary dictionary];\nmutableDict[kATAdLoadingExtraAdmobContentURLStringsKey] = @[@\"https:\/\/www.example1.com\", @\"https:\/\/www.example2.com\"];\n[[ATAdManager sharedManager] loadADWithPlacementID:@\"Your ad placement\" extra:mutableDict delegate:self containerView:nil];\n```\n\n> Note: The passed content mapping URLs will remain in effect. You do not need to pass the same URLs each time you make a request. If you need to change them, simply pass the new content again.\n\n### 2.2 Cancel Content Mapping URLs\n\nParameters need to be passed each time for it to take effect. If not passed, it means content mapping is not used.","pure_content":"1. Admob Content Mapping Description\nWith app content mapping, you can serve content-relevant ads to users and ensure that the ads are placed near content that is appropriate for your advertisers. For details, please refer to the Admob Reference Documentation\n\nBy default, only 1 URL can be passed. By applying to Admob, you can enable support for up to 4 content URLs (multi-content URL).\n\n\nSupported ad types: All ad formats\nSupported starting from version: v6.2.65\n\n2. Sample Code\n2.1 Add Content Mapping URLs\n\/\/ Supports passing 1-4 URLs\nNSMutableDictionary mutableDict = [NSMutableDictionary dictionary];\nmutableDict[kATAdLoadingExtraAdmobContentURLStringsKey] = @[@\"https:\/\/www.example1.com\", @\"https:\/\/www.example2.com\"];\n[[ATAdManager sharedManager] loadADWithPlacementID:@\"Your ad placement\" extra:mutableDict delegate:self containerView:nil];\n\n\nNote: The passed content mapping URLs will remain in effect. You do not need to pass the same URLs each time you make a request. If you need to change them, simply pass the new content again.\n\n2.2 Cancel Content Mapping URLs\nParameters need to be passed each time for it to take effect. If not passed, it means content mapping is not used.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783478699","update_time":"1783479075"},"pure_content":"1. Admob Content Mapping Description\nWith app content mapping, you can serve content-relevant ads to users and ensure that the ads are placed near content that is appropriate for your advertisers. For"},{"id":"863434","string_id":"SJsDHDIj","status":"1","parent_id":"76295","slug":"SJsDHDIj","order":"10","name":"Filter Cross-Promotion","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783479399","add_time":"1783478700","update_time":"1783479479","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"863434","content":"For cross-promotion, set a list of excluded installed App IDs. Products corresponding to excluded App IDs will no longer be promoted. Sample code:\n\n```\n[[ATAPI sharedInstance] setExludeAppleIdArray:@[@\"id529479190\"]];\n\n```\n\n> The AppleId passed above must be consistent with the cross-promotion product's App Store ID configured in the dashboard for the filtering exclusion to be successful. Please refer to the image below.\n\n![](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/I3k4gZye\/6720ba5c630a6.png)","pure_content":"For cross-promotion, set a list of excluded installed App IDs. Products corresponding to excluded App IDs will no longer be promoted. Sample code:\n[[ATAPI sharedInstance] setExludeAppleIdArray:@[@\"id529479190\"]];\n\n\n\nThe AppleId passed above must be consistent with the cross-promotion product's App Store ID configured in the dashboard for the filtering exclusion to be successful. Please refer to the image below.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783478700","update_time":"1783479399"},"pure_content":"For cross-promotion, set a list of excluded installed App IDs. Products corresponding to excluded App IDs will no longer be promoted. Sample code:\n[[ATAPI sharedInstance] setExludeAppleIdArray:@[@\"id5"},{"id":"863435","string_id":"M4bsKxyL","status":"1","parent_id":"76295","slug":"M4bsKxyL","order":"9","name":"Filter Ad Sources","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783479401","add_time":"1783478701","update_time":"1783479479","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"863435","content":"You can pass the list of Ad Sources to be filtered for this request via the API before calling the ad placement's Load method. During ad loading, the Ad Sources in this list will be filtered. The specific configuration is as follows:\n\n```\n\/\/ Filter the loading of a specific Ad Source within a placementId\n[[ATAdManager sharedManager] setExludePlacementid:@\"you placement id\" unitIDArray:@[@\"3628\" ]];\n\n\/\/ Filter the loading of ads from specific platforms within a placementId\n[[ATAdManager sharedManager] setExludePlacementid:@\"you placement id\" networkFirmIDArray:@[@(ATNetworkFirmIDTypeFacebook),\n @(ATNetworkFirmIDTypeAdmob),\n @(ATNetworkFirmIDTypeCSJ)]];\n```\n\nFriendly Reminder:\n\n1. unitID is your Ad Source ID in the Taku dashboard, as shown in the image: ![Article Image](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/RmWQnBse\/6720ba6ea9bd7.png)\n2. networkFirmID is defined in the `ATAPI` header file. Please go to the `ATNetworkFirmIDType` enum in `ATAPI.h` to check the mapping. For Swift projects, first `import AnyThinkSDK`, then click into `import AnyThinkSDK.ATAPI` to view the enum definition.\n \n > For Custom Adapter, you need to go to Dashboard -> Left Menu - Ad Platforms to check the Ad Platform ID (i.e., networkFirmID).\n \n ![](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/RmWQnBse\/68b698656d2ba.png)","pure_content":"You can pass the list of Ad Sources to be filtered for this request via the API before calling the ad placement's Load method. During ad loading, the Ad Sources in this list will be filtered. The specific configuration is as follows:\n\/\/ Filter the loading of a specific Ad Source within a placementId\n[[ATAdManager sharedManager] setExludePlacementid:@\"you placement id\" unitIDArray:@[@\"3628\" ]];\n\n\/\/ Filter the loading of ads from specific platforms within a placementId\n[[ATAdManager sharedManager] setExludePlacementid:@\"you placement id\" networkFirmIDArray:@[@(ATNetworkFirmIDTypeFacebook),\n @(ATNetworkFirmIDTypeAdmob),\n @(ATNetworkFirmIDTypeCSJ)]];\n\nFriendly Reminder:\n\n\nunitID is your Ad Source ID in the Taku dashboard, as shown in the image: \n\n\nnetworkFirmID is defined in the ATAPI header file. Please go to the ATNetworkFirmIDType enum in ATAPI.h to check the mapping. For Swift projects, first import AnyThinkSDK, then click into import AnyThinkSDK.ATAPI to view the enum definition.\n\nFor Custom Adapter, you need to go to Dashboard -> Left Menu - Ad Platforms to check the Ad Platform ID (i.e., networkFirmID).","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783478701","update_time":"1783479401"},"pure_content":"You can pass the list of Ad Sources to be filtered for this request via the API before calling the ad placement's Load method. During ad loading, the Ad Sources in this list will be filtered. The spec"},{"id":"580256","string_id":"rPosZC2J","status":"1","parent_id":"76295","slug":"rPosZC2J","order":"8","name":"One-Click Mute","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u51cc\u5929\u5b50","published_time":"1753867754","add_time":"1753867742","update_time":"1783479479","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"580256","content":"## 1. One-Click Mute Feature Description\n\nYou can set one-click to turn off the volume of third-party ad SDKs through code. This interface takes effect in real time. You can set it during initialization or before loading the ad placement you want to mute.\n\n> This feature is supported in SDK v6.4.89 and above.\n\n## 2. Support Scope\n\n\| Supported Ad Platforms \| Supported Ad Formats \|\n\|:---:\|:---:\|\n\| AdMob \| All ad formats \|\n\| Inmobi \| All ad formats \|\n\| AppLovin \| All ad formats \|\n\| Mintegral \| Native, Interstitial, Rewarded Video \|\n\| Fyber \| Interstitial \|\n\| Tencent Ad \| Interstitial, Rewarded, Native \|\n\| Kuaishou \| Interstitial, Rewarded, Native (draw type only) \|\n\| iQIYI \| Rewarded, Banner, Native \|\n\| Meishu \| Interstitial, Rewarded, Native \|\n\| Tanx \| Rewarded, Native \|\n\n## 3. Sample Code\n\n```objc\n\/\/#import \n[[ATSDKGlobalSetting sharedManager] setIsMute:YES];\n```\n\n> ### Notes\n> - If the setIsMute API is called, the API takes precedence. Setting it to YES will mute, setting it to NO will not mute\n> - If the setIsMute API is not called and Taku dashboard has been configured, then Taku dashboard configuration takes precedence\n> - For Admob, regardless of setting YES or NO through API, or enabling or disabling through Taku dashboard, it will be muted","pure_content":"1. One-Click Mute Feature Description\nYou can set one-click to turn off the volume of third-party ad SDKs through code. This interface takes effect in real time. You can set it during initialization or before loading the ad placement you want to mute.\n\nThis feature is supported in SDK v6.4.89 and above.\n\n2. Support Scope\n\n\n\n Supported Ad Platforms\n Supported Ad Formats\n\n\n\n\n AdMob\n All ad formats\n\n\n Inmobi\n All ad formats\n\n\n AppLovin\n All ad formats\n\n\n Mintegral\n Native, Interstitial, Rewarded Video\n\n\n Fyber\n Interstitial\n\n\n Tencent Ad\n Interstitial, Rewarded, Native\n\n\n Kuaishou\n Interstitial, Rewarded, Native (draw type only)\n\n\n iQIYI\n Rewarded, Banner, Native\n\n\n Meishu\n Interstitial, Rewarded, Native\n\n\n Tanx\n Rewarded, Native\n\n\n\n3. Sample Code\n\/\/#import \n[[ATSDKGlobalSetting sharedManager] setIsMute:YES];\n\n\nNotes\n\nIf the setIsMute API is called, the API takes precedence. Setting it to YES will mute, setting it to NO will not mute\nIf the setIsMute API is not called and Taku dashboard has been configured, then Taku dashboard configuration takes precedence\nFor Admob, regardless of setting YES or NO through API, or enabling or disabling through Taku dashboard, it will be muted","is_draft":"0","editor_type":"2","file_path":"","add_time":"1753867742","update_time":"1753867754"},"pure_content":"1. One-Click Mute Feature Description\nYou can set one-click to turn off the volume of third-party ad SDKs through code. This interface takes effect in real time. You can set it during initialization o"},{"id":"586156","string_id":"lwX2f4Je","status":"1","parent_id":"76295","slug":"lwX2f4Je","order":"7","name":"Shake Configuration","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u51cc\u5929\u5b50","published_time":"1754544694","add_time":"1754544671","update_time":"1783479479","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"586156","content":"## 1. Shake Configuration Feature Description\nYou can configure the shake and twist functionality for certain ad networks through code.\n\n> SDK version >= v6.4.90 supports this feature\n\n\n## 2. Support Scope\n\n\| Supported Ad Networks \| Supported Ad Formats \| NetworkFirmID \| Default Status \|\n\|:---:\|:---:\|:---:\|:---:\|\n\| CSJ \| All \| 15 \| Enabled \|\n\| Tencent Ad (GDT) \| All \| 8 \| Enabled \|\n\| Kuaishou \| Splash, Native \| 28 \| Enabled \|\n\| Tanx \| All \| 82 \| Disabled \|\n\| Qumeng \| All \| 74 \| Enabled \|\n\| Sigmob \| All \| 29 \| Enabled \|\n\| Meishu \| All \| 93 \| Enabled \|\n\| Taku ADX \| All \| 66 \| Enabled \|\n\| Cross Promotion \| All \| 35 \| Enabled \|\n\| Direct Ad \| All \| 67 \| Enabled \|\n\n> Note: Custom ad networks do not support this feature\n\n## 3. Usage Steps\n1. Import header file `#import `\n2. Call `[[ATSDKGlobalSetting sharedManager] setNetworkSensorType: networkSensorList:];` after SDK initialization\n3. If you don't call `[[ATSDKGlobalSetting sharedManager] setNetworkSensorType: networkSensorList:];`, the default values of ad networks will be used\n\n\n## 4. Sample Code\n> Note: The following code operations only take effect for ad sources within the supported scope\n### 4.1 Disable All\n```objc\n[[ATSDKGlobalSetting sharedManager] setNetworkSensorType:ATNetworkSensorTypeForbidAll networkSensorList:nil];\n```\n\n### 4.2 Enable All\n```objc\n[[ATSDKGlobalSetting sharedManager] setNetworkSensorType:ATNetworkSensorTypeAllowAll networkSensorList:nil];\n```\n\n### 4.3 Enable Some, Disable Others\n> - For NetworkFirmID passed in the networkSensorList parameter, please refer to the table above. Those passed in represent enabled, while those not passed in are disabled\n> - This example represents enabling only Pangle (NetworkFirmID==15) and Tencent Ad GDT (NetworkFirmID==8), while disabling other platforms\n```objc\n[[ATSDKGlobalSetting sharedManager] setNetworkSensorType:ATNetworkSensorTypeAllowNetwork networkSensorList:@[@(15),@(8)]];\n```\n\n### 4.4 Use Ad Network Default Values\n> For default values, please check the table above\n```objc\n[[ATSDKGlobalSetting sharedManager] setNetworkSensorType:ATNetworkSensorTypeDefaultNetwork networkSensorList:nil];\n```","pure_content":"1. Shake Configuration Feature Description\nYou can configure the shake and twist functionality for certain ad networks through code.\n\nSDK version >= v6.4.90 supports this feature\n\n2. Support Scope\n\n\n\n Supported Ad Networks\n Supported Ad Formats\n NetworkFirmID\n Default Status\n\n\n\n\n CSJ\n All\n 15\n Enabled\n\n\n Tencent Ad (GDT)\n All\n 8\n Enabled\n\n\n Kuaishou\n Splash, Native\n 28\n Enabled\n\n\n Tanx\n All\n 82\n Disabled\n\n\n Qumeng\n All\n 74\n Enabled\n\n\n Sigmob\n All\n 29\n Enabled\n\n\n Meishu\n All\n 93\n Enabled\n\n\n Taku ADX\n All\n 66\n Enabled\n\n\n Cross Promotion\n All\n 35\n Enabled\n\n\n Direct Ad\n All\n 67\n Enabled\n\n\n\n\nNote: Custom ad networks do not support this feature\n\n3. Usage Steps\n\nImport header file #import \n\nCall [[ATSDKGlobalSetting sharedManager] setNetworkSensorType: networkSensorList:]; after SDK initialization\n\nIf you don't call [[ATSDKGlobalSetting sharedManager] setNetworkSensorType: networkSensorList:];, the default values of ad networks will be used\n\n4. Sample Code\n\nNote: The following code operations only take effect for ad sources within the supported scope\n\n4.1 Disable All\n[[ATSDKGlobalSetting sharedManager] setNetworkSensorType:ATNetworkSensorTypeForbidAll networkSensorList:nil];\n\n4.2 Enable All\n[[ATSDKGlobalSetting sharedManager] setNetworkSensorType:ATNetworkSensorTypeAllowAll networkSensorList:nil];\n\n4.3 Enable Some, Disable Others\n\n\nFor NetworkFirmID passed in the networkSensorList parameter, please refer to the table above. Those passed in represent enabled, while those not passed in are disabled\nThis example represents enabling only Pangle (NetworkFirmID==15) and Tencent Ad GDT (NetworkFirmID==8), while disabling other platforms\n\n\n[[ATSDKGlobalSetting sharedManager] setNetworkSensorType:ATNetworkSensorTypeAllowNetwork networkSensorList:@[@(15),@(8)]];\n\n4.4 Use Ad Network Default Values\n\nFor default values, please check the table above\n\n[[ATSDKGlobalSetting sharedManager] setNetworkSensorType:ATNetworkSensorTypeDefaultNetwork networkSensorList:nil];","is_draft":"0","editor_type":"2","file_path":"","add_time":"1754544671","update_time":"1754544694"},"pure_content":"1. Shake Configuration Feature Description\nYou can configure the shake and twist functionality for certain ad networks through code.\n\nSDK version >= v6.4.90 supports this feature\n\n2. Support Scope"},{"id":"721288","string_id":"FVKfc313","status":"1","parent_id":"76295","slug":"FVKfc313","order":"6","name":"Baidu Two-Stage Reward","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"\u51cc\u5929\u5b50","published_time":"1770634698","add_time":"1770631909","update_time":"1783479479","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"721288","content":"## 1. Baidu Two-Stage Reward Feature Overview\n\nTwo-stage reward advertising: In rewarded video scenarios, through conversion tasks, by doubling or inflating the original reward, extra rewards are used to stimulate users to further convert.\n\n## 2. Prerequisites\n\n> - SDK version >= v6.4.94\n> - (CocoaPods integration) AnyThinkMediationBaiduAdapter >= 10.032.1\n> - For manual integration, please visit the SDK download center to re-select and download the Baidu Union SDK version 10.032.1 and its Adapter\n> - Baidu ad source must be of Rewarded Video type\n\n## 3. Integration Steps\n\n### 3.1 Import Required Headers\n\n```objc\n#import \n```\n\n### 3.2 Configure Two-Stage Reward Parameters\n\nAdd the two-stage reward parameters when loading rewarded video ads to enable this feature.\n\n## 4. Sample Code\n\n### 4.1 Complete Implementation Example\n\n```objc\n\/\/\n\/\/ RewardedVC.m\n\/\/ iOSDemo\n\/\/\n\n#import \"RewardedVC.h\"\n#import \n#import \"AdLoadConfigTool.h\"\n\n@interface RewardedVC () \n\n@property (nonatomic, assign) NSInteger retryAttempt;\n\n@end\n\n@implementation RewardedVC\n\n\/\/ Placement ID\n#define RewardedPlacementID @\"b67f4ab93eb3a7\"\n\n\/\/ Scene ID (optional, can be generated in dashboard. Use empty string if none)\n#define RewardedSceneID @\"\"\n\n#pragma mark - Load Ad\n\/\/\/ Load advertisement\n- (void)loadAd {\n NSMutableDictionary loadConfigDict = [NSMutableDictionary dictionary];\n \n \/\/ ============ Two-Stage Reward Configuration Start ============\n \/\/ Reward type: 1 corresponds to inflated reward, 2 corresponds to multiplied reward\n [loadConfigDict setValue:@\"1\" forKey:kATBaiduRewardedVideoRewardType];\n \n \/\/ Inflated reward amount\n [loadConfigDict setValue:@\"100\" forKey:kATBaiduRewardedVideoBasicReward];\n \n \/\/ Inflated reward unit (e.g., Yuan, Coin, Diamond, etc.)\n [loadConfigDict setValue:@\"Yuan\" forKey:kATBaiduRewardedVideoBasicUnit];\n \n \/\/ Multiplied reward amount\n [loadConfigDict setValue:@\"200\" forKey:kATBaiduRewardedVideoAdvancedReward];\n \n \/\/ Multiplied reward unit\n [loadConfigDict setValue:@\"Yuan\" forKey:kATBaiduRewardedVideoAdvancedUnit];\n \n \/\/ Multiple for reward, recommended 2x or above\n [loadConfigDict setValue:@\"2\" forKey:kATBaiduRewardedVideoMultiple];\n \/\/ ============ Two-Stage Reward Configuration End ============\n \n \/\/ Server-side reward verification parameters (optional)\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 \/\/ Load ad\n [[ATAdManager sharedManager] loadADWithPlacementID:RewardedPlacementID extra:loadConfigDict delegate:self];\n}\n\n#pragma mark - Show Ad\n\/\/\/ Display advertisement\n- (void)showAd {\n \/\/ Scene statistics (optional)\n [[ATAdManager sharedManager] entryRewardedVideoScenarioWithPlacementID:RewardedPlacementID scene:RewardedSceneID];\n \n \/\/ Check if ad is ready\n if (![[ATAdManager sharedManager] rewardedVideoReadyForPlacementID:RewardedPlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/ Show configuration\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 - ATAdLoadingDelegate\n\/\/\/ Ad loading success callback\n- (void)didFinishLoadingADWithPlacementID:(NSString )placementID {\n NSLog(@\"Ad loaded successfully: %@\", placementID);\n \/\/ Reset retry attempts\n self.retryAttempt = 0;\n}\n\n\/\/\/ Ad loading failure callback\n- (void)didFailToLoadADWithPlacementID:(NSString )placementID error:(NSError )error {\n NSLog(@\"Ad loading failed: %@ Error code: %ld\", placementID, error.code);\n \n \/\/ Stop retrying after 3 attempts\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\n dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delaySec NSEC_PER_SEC), dispatch_get_main_queue(), ^{\n [self loadAd];\n });\n}\n\n#pragma mark - ATRewardedVideoDelegate\n\/\/\/ Reward success callback (Important: Get reward type)\n- (void)rewardedVideoDidRewardSuccessForPlacemenID:(NSString )placementID extra:(NSDictionary )extra {\n NSLog(@\"Reward success: %@ Extra info: %@\", placementID, extra);\n \n \/\/ Get reward type from extra dictionary\n NSString rewardType = extra[@\"reward_type\"];\n \n if ([rewardType isEqualToString:@\"1\"]) {\n \/\/ User received inflated reward\n NSLog(@\"User received inflated reward\");\n \/\/ Grant inflated reward to user here\n \n } else if ([rewardType isEqualToString:@\"2\"]) {\n \/\/ User received multiplied reward\n NSLog(@\"User received multiplied reward\");\n \/\/ Grant multiplied reward to user here\n }\n}\n\n\/\/\/ Rewarded video started playing\n- (void)rewardedVideoDidStartPlayingForPlacementID:(NSString )placementID extra:(NSDictionary )extra {\n NSLog(@\"Rewarded video started playing: %@\", placementID);\n}\n\n\/\/\/ Rewarded video finished playing\n- (void)rewardedVideoDidEndPlayingForPlacementID:(NSString )placementID extra:(NSDictionary )extra {\n NSLog(@\"Rewarded video finished playing: %@\", placementID);\n}\n\n\/\/\/ Rewarded video playback failed\n- (void)rewardedVideoDidFailToPlayForPlacementID:(NSString)placementID error:(NSError )error extra:(NSDictionary )extra {\n NSLog(@\"Rewarded video playback failed: %@ Error code: %ld\", placementID, (long)error.code);\n \/\/ Preload next ad\n [self loadAd];\n}\n\n\/\/\/ Rewarded video closed\n- (void)rewardedVideoDidCloseForPlacementID:(NSString )placementID rewarded:(BOOL)rewarded extra:(NSDictionary )extra {\n NSLog(@\"Rewarded video closed: %@, Is rewarded: %@\", placementID, rewarded ? @\"Yes\" : @\"No\");\n \/\/ Preload next ad\n [self loadAd];\n}\n\n\/\/\/ Rewarded video clicked\n- (void)rewardedVideoDidClickForPlacementID:(NSString)placementID extra:(NSDictionary )extra {\n NSLog(@\"Rewarded video clicked: %@\", placementID);\n}\n\n@end\n```\n\n## 5. Parameter Details\n\n### 5.1 Two-Stage Reward Configuration Parameters\n\n\| Parameter Key \| Type \| Description \| Example Value \|\n\|:---\|:---:\|:---\|:---\|\n\| kATBaiduRewardedVideoRewardType \| NSString \| Reward type 1 = Inflated reward 2 = Multiplied reward \| @\"2\" \|\n\| kATBaiduRewardedVideoBasicReward \| NSString \| Inflated reward amount \| @\"100\" \|\n\| kATBaiduRewardedVideoBasicUnit \| NSString \| Inflated reward unit Customizable: Yuan, Coin, Diamond, etc. \| @\"Yuan\" \|\n\| kATBaiduRewardedVideoAdvancedReward \| NSString \| Multiplied reward amount \| @\"200\" \|\n\| kATBaiduRewardedVideoAdvancedUnit \| NSString \| Multiplied reward unit \| @\"Yuan\" \|\n\| kATBaiduRewardedVideoMultiple \| NSString \| Reward multiple, recommended 2x or above \| @\"2\" \|\n\n### 5.2 Reward Type Detection\n\nIn the `rewardedVideoDidRewardSuccessForPlacemenID:extra:` callback, determine the reward type received by the user through the `reward_type` field in the `extra` dictionary:\n\n\| reward_type Value \| Data Type \| Description \| \n\|:---\|:---\|:---\|\n\| @\"1\" \| NSString \| Inflated reward \| \n\| @\"2\" \| NSString \| Multiplied reward \|\n\n## 6. Important Notes\n \n- All two-stage reward parameters are configured when loading the ad, not when showing it\n- Please strictly follow the parameter type requirements for both setting and retrieving values\n- Must determine reward type based on the `reward_type` field in the `rewardedVideoDidRewardSuccessForPlacemenID:extra:` callback\n \n## 7. FAQ\n\n### Q1: How to verify if the two-stage reward feature is working?\nA: Print the `extra` dictionary in the `rewardedVideoDidRewardSuccessForPlacemenID:extra:` callback. If it contains the `reward_type` field, the two-stage reward feature is active.\n\n### Q2: Will users always receive the multiplied reward?\nA: Not necessarily. Users receive the basic reward after watching the video, but only receive the multiplied reward when they complete additional interactions (such as clicking on the ad). The specific interaction method is controlled by the Baidu ad platform.\n \n### Q3: How to test the two-stage reward feature?\nA: \n1. Ensure SDK versions meet requirements\n2. Correctly configure two-stage reward parameters\n3. Load and show the ad\n4. Watch the complete video and try clicking on the ad\n5. Print the `extra` dictionary in the reward callback to check the `reward_type` value","pure_content":"1. Baidu Two-Stage Reward Feature Overview\nTwo-stage reward advertising: In rewarded video scenarios, through conversion tasks, by doubling or inflating the original reward, extra rewards are used to stimulate users to further convert.\n2. Prerequisites\n\n\nSDK version >= v6.4.94\n\n(CocoaPods integration) AnyThinkMediationBaiduAdapter >= 10.032.1\nFor manual integration, please visit the SDK download center to re-select and download the Baidu Union SDK version 10.032.1 and its Adapter\nBaidu ad source must be of Rewarded Video type\n\n\n3. Integration Steps\n3.1 Import Required Headers\n#import \n\n3.2 Configure Two-Stage Reward Parameters\nAdd the two-stage reward parameters when loading rewarded video ads to enable this feature.\n4. Sample Code\n4.1 Complete Implementation Example\n\/\/\n\/\/ RewardedVC.m\n\/\/ iOSDemo\n\/\/\n\n#import \"RewardedVC.h\"\n#import \n#import \"AdLoadConfigTool.h\"\n\n@interface RewardedVC () \n\n@property (nonatomic, assign) NSInteger retryAttempt;\n\n@end\n\n@implementation RewardedVC\n\n\/\/ Placement ID\n#define RewardedPlacementID @\"b67f4ab93eb3a7\"\n\n\/\/ Scene ID (optional, can be generated in dashboard. Use empty string if none)\n#define RewardedSceneID @\"\"\n\n#pragma mark - Load Ad\n\/\/\/ Load advertisement\n- (void)loadAd {\n NSMutableDictionary loadConfigDict = [NSMutableDictionary dictionary];\n \n \/\/ ============ Two-Stage Reward Configuration Start ============\n \/\/ Reward type: 1 corresponds to inflated reward, 2 corresponds to multiplied reward\n [loadConfigDict setValue:@\"1\" forKey:kATBaiduRewardedVideoRewardType];\n \n \/\/ Inflated reward amount\n [loadConfigDict setValue:@\"100\" forKey:kATBaiduRewardedVideoBasicReward];\n \n \/\/ Inflated reward unit (e.g., Yuan, Coin, Diamond, etc.)\n [loadConfigDict setValue:@\"Yuan\" forKey:kATBaiduRewardedVideoBasicUnit];\n \n \/\/ Multiplied reward amount\n [loadConfigDict setValue:@\"200\" forKey:kATBaiduRewardedVideoAdvancedReward];\n \n \/\/ Multiplied reward unit\n [loadConfigDict setValue:@\"Yuan\" forKey:kATBaiduRewardedVideoAdvancedUnit];\n \n \/\/ Multiple for reward, recommended 2x or above\n [loadConfigDict setValue:@\"2\" forKey:kATBaiduRewardedVideoMultiple];\n \/\/ ============ Two-Stage Reward Configuration End ============\n \n \/\/ Server-side reward verification parameters (optional)\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 \/\/ Load ad\n [[ATAdManager sharedManager] loadADWithPlacementID:RewardedPlacementID extra:loadConfigDict delegate:self];\n}\n\n#pragma mark - Show Ad\n\/\/\/ Display advertisement\n- (void)showAd {\n \/\/ Scene statistics (optional)\n [[ATAdManager sharedManager] entryRewardedVideoScenarioWithPlacementID:RewardedPlacementID scene:RewardedSceneID];\n \n \/\/ Check if ad is ready\n if (![[ATAdManager sharedManager] rewardedVideoReadyForPlacementID:RewardedPlacementID]) {\n [self loadAd];\n return;\n }\n \n \/\/ Show configuration\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 - ATAdLoadingDelegate\n\/\/\/ Ad loading success callback\n- (void)didFinishLoadingADWithPlacementID:(NSString )placementID {\n NSLog(@\"Ad loaded successfully: %@\", placementID);\n \/\/ Reset retry attempts\n self.retryAttempt = 0;\n}\n\n\/\/\/ Ad loading failure callback\n- (void)didFailToLoadADWithPlacementID:(NSString )placementID error:(NSError )error {\n NSLog(@\"Ad loading failed: %@ Error code: %ld\", placementID, error.code);\n \n \/\/ Stop retrying after 3 attempts\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\n dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delaySec NSEC_PER_SEC), dispatch_get_main_queue(), ^{\n [self loadAd];\n });\n}\n\n#pragma mark - ATRewardedVideoDelegate\n\/\/\/ Reward success callback (Important: Get reward type)\n- (void)rewardedVideoDidRewardSuccessForPlacemenID:(NSString )placementID extra:(NSDictionary )extra {\n NSLog(@\"Reward success: %@ Extra info: %@\", placementID, extra);\n \n \/\/ Get reward type from extra dictionary\n NSString rewardType = extra[@\"reward_type\"];\n \n if ([rewardType isEqualToString:@\"1\"]) {\n \/\/ User received inflated reward\n NSLog(@\"User received inflated reward\");\n \/\/ Grant inflated reward to user here\n \n } else if ([rewardType isEqualToString:@\"2\"]) {\n \/\/ User received multiplied reward\n NSLog(@\"User received multiplied reward\");\n \/\/ Grant multiplied reward to user here\n }\n}\n\n\/\/\/ Rewarded video started playing\n- (void)rewardedVideoDidStartPlayingForPlacementID:(NSString )placementID extra:(NSDictionary )extra {\n NSLog(@\"Rewarded video started playing: %@\", placementID);\n}\n\n\/\/\/ Rewarded video finished playing\n- (void)rewardedVideoDidEndPlayingForPlacementID:(NSString )placementID extra:(NSDictionary )extra {\n NSLog(@\"Rewarded video finished playing: %@\", placementID);\n}\n\n\/\/\/ Rewarded video playback failed\n- (void)rewardedVideoDidFailToPlayForPlacementID:(NSString)placementID error:(NSError )error extra:(NSDictionary )extra {\n NSLog(@\"Rewarded video playback failed: %@ Error code: %ld\", placementID, (long)error.code);\n \/\/ Preload next ad\n [self loadAd];\n}\n\n\/\/\/ Rewarded video closed\n- (void)rewardedVideoDidCloseForPlacementID:(NSString )placementID rewarded:(BOOL)rewarded extra:(NSDictionary )extra {\n NSLog(@\"Rewarded video closed: %@, Is rewarded: %@\", placementID, rewarded ? @\"Yes\" : @\"No\");\n \/\/ Preload next ad\n [self loadAd];\n}\n\n\/\/\/ Rewarded video clicked\n- (void)rewardedVideoDidClickForPlacementID:(NSString)placementID extra:(NSDictionary )extra {\n NSLog(@\"Rewarded video clicked: %@\", placementID);\n}\n\n@end\n\n5. Parameter Details\n5.1 Two-Stage Reward Configuration Parameters\n\n\n\n Parameter Key\n Type\n Description\n Example Value\n\n\n\n\n kATBaiduRewardedVideoRewardType\n NSString\n Reward type1 = Inflated reward2 = Multiplied reward\n @\"2\"\n\n\n kATBaiduRewardedVideoBasicReward\n NSString\n Inflated reward amount\n @\"100\"\n\n\n kATBaiduRewardedVideoBasicUnit\n NSString\n Inflated reward unitCustomizable: Yuan, Coin, Diamond, etc.\n @\"Yuan\"\n\n\n kATBaiduRewardedVideoAdvancedReward\n NSString\n Multiplied reward amount\n @\"200\"\n\n\n kATBaiduRewardedVideoAdvancedUnit\n NSString\n Multiplied reward unit\n @\"Yuan\"\n\n\n kATBaiduRewardedVideoMultiple\n NSString\n Reward multiple, recommended 2x or above\n @\"2\"\n\n\n\n5.2 Reward Type Detection\nIn the rewardedVideoDidRewardSuccessForPlacemenID:extra: callback, determine the reward type received by the user through the reward_type field in the extra dictionary:\n\n\n\n reward_type Value\n Data Type\n Description\n\n\n\n\n @\"1\"\n NSString\n Inflated reward\n\n\n @\"2\"\n NSString\n Multiplied reward\n\n\n\n6. Important Notes\n\nAll two-stage reward parameters are configured when loading the ad, not when showing it\nPlease strictly follow the parameter type requirements for both setting and retrieving values\nMust determine reward type based on the reward_type field in the rewardedVideoDidRewardSuccessForPlacemenID:extra: callback\n\n7. FAQ\nQ1: How to verify if the two-stage reward feature is working?\nA: Print the extra dictionary in the rewardedVideoDidRewardSuccessForPlacemenID:extra: callback. If it contains the reward_type field, the two-stage reward feature is active.\nQ2: Will users always receive the multiplied reward?\nA: Not necessarily. Users receive the basic reward after watching the video, but only receive the multiplied reward when they complete additional interactions (such as clicking on the ad). The specific interaction method is controlled by the Baidu ad platform.\nQ3: How to test the two-stage reward feature?\nA:\n\nEnsure SDK versions meet requirements\nCorrectly configure two-stage reward parameters\nLoad and show the ad\nWatch the complete video and try clicking on the ad\nPrint the extra dictionary in the reward callback to check the reward_type value","is_draft":"0","editor_type":"2","file_path":"","add_time":"1770631909","update_time":"1770634698"},"pure_content":"1. Baidu Two-Stage Reward Feature Overview\nTwo-stage reward advertising: In rewarded video scenarios, through conversion tasks, by doubling or inflating the original reward, extra rewards are used to"},{"id":"863436","string_id":"sq8Yipbm","status":"1","parent_id":"76295","slug":"sq8Yipbm","order":"5","name":"Shared Placement Params","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783479404","add_time":"1783478706","update_time":"1783479479","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"863436","content":"## Rewarded Video \u2014 Server-Side Reward\n\nIf your Rewarded Ad Placement is configured with a shared ad placement, you can refer to the following code to set the server-side reward parameters when loading:\n```objc\nNSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];\n\/\/ kATAdLoadingExtraMediaExtraKey is valid for both shared ad placements and regular ad placements. Use this single key to pass all the parameters you need.\n[loadConfigDict setValue:@\"{\\\"userID\\\":\\\"xxx\\\"}\" \n\/\/ Initiate ad loading\n[[ATAdManager sharedManager] loadADWithPlacementID:RewardedPlacementID extra:loadConfigDict delegate:self];\n```\n\nIf you need to set parameters specifically for a shared ad placement, please refer to:\n\n```objc\nNSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];\n\/\/ Optional integration. The following key parameters are used for ad platform server-side reward verification and will be forwarded through to the third-party ad platform SDK.\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\/\/ Based on your actual needs, decide whether to create a new ATSharePlacementConfig object each time.\nif (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];\n}\n\/\/ Set for shared ad placement\n[ATSDKGlobalSetting sharedManager].sharePlacementConfig.rewardedVideoLoadExtra = loadConfigDict;\n \n\/\/ Initiate ad loading\n[[ATAdManager sharedManager] loadADWithPlacementID:RewardedPlacementID extra:loadConfigDict delegate:self];\n \n```\n\n## Other Scenarios\n\n> Setting shared ad placement parameters is generally done before the ad placement load.\n\n```objc \n#pragma mark - Shared Ad Placement\n\/\/\/ Set shared ad placement extra parameters - Splash Ad\n\/\/\/ - Parameter extraDict: Extra parameters dictionary\n+ (void)setSplashSharePlacementConfig:(NSMutableDictionary )extraDict {\n \n if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];\n }\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig.splashLoadExtra = extraDict;\n}\n\n\/\/\/ Set shared ad placement extra parameters - Interstitial Ad\n\/\/\/ - Parameter extraDict: Extra parameters dictionary\n+ (void)setInterstitialSharePlacementConfig:(NSMutableDictionary )extraDict {\n \n if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];\n }\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig.interstitialLoadExtra = extraDict;\n}\n\n\/\/\/ Set shared ad placement extra parameters - Rewarded Video Ad\n\/\/\/ - Parameter extraDict: Extra parameters dictionary\n+ (void)setRewardedVideoSharePlacementConfig:(NSMutableDictionary )extraDict {\n \n if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];\n }\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig.rewardedVideoLoadExtra = extraDict;\n}\n\n\/\/\/ Set shared ad placement extra parameters - Banner Ad\n\/\/\/ - Parameter extraDict: Extra parameters dictionary\n+ (void)setBannerSharePlacementConfig:(NSMutableDictionary )extraDict {\n \n if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];\n }\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig.bannerLoadExtra = extraDict;\n}\n\n\/\/\/ Set shared ad placement extra parameters - Native Ad\n\/\/\/ - Parameter extraDict: Extra parameters dictionary\n+ (void)setNativeSharePlacementConfig:(NSMutableDictionary )extraDict {\n \n if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];\n }\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig.nativeLoadExtra = extraDict;\n}\n```","pure_content":"Rewarded Video \u2014 Server-Side Reward\nIf your Rewarded Ad Placement is configured with a shared ad placement, you can refer to the following code to set the server-side reward parameters when loading:\nNSMutableDictionary loadConfigDict = [NSMutableDictionary dictionary];\n\/\/ kATAdLoadingExtraMediaExtraKey is valid for both shared ad placements and regular ad placements. Use this single key to pass all the parameters you need.\n[loadConfigDict setValue:@\"{\\\"userID\\\":\\\"xxx\\\"}\" \n\/\/ Initiate ad loading\n[[ATAdManager sharedManager] loadADWithPlacementID:RewardedPlacementID extra:loadConfigDict delegate:self];\n\nIf you need to set parameters specifically for a shared ad placement, please refer to:\nNSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];\n\/\/ Optional integration. The following key parameters are used for ad platform server-side reward verification and will be forwarded through to the third-party ad platform SDK.\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\/\/ Based on your actual needs, decide whether to create a new ATSharePlacementConfig object each time.\nif (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];\n}\n\/\/ Set for shared ad placement\n[ATSDKGlobalSetting sharedManager].sharePlacementConfig.rewardedVideoLoadExtra = loadConfigDict;\n \n\/\/ Initiate ad loading\n[[ATAdManager sharedManager] loadADWithPlacementID:RewardedPlacementID extra:loadConfigDict delegate:self];\n \n\nOther Scenarios\n\nSetting shared ad placement parameters is generally done before the ad placement load.\n\n#pragma mark - Shared Ad Placement\n\/\/\/ Set shared ad placement extra parameters - Splash Ad\n\/\/\/ - Parameter extraDict: Extra parameters dictionary\n+ (void)setSplashSharePlacementConfig:(NSMutableDictionary )extraDict {\n \n if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];\n }\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig.splashLoadExtra = extraDict;\n}\n\n\/\/\/ Set shared ad placement extra parameters - Interstitial Ad\n\/\/\/ - Parameter extraDict: Extra parameters dictionary\n+ (void)setInterstitialSharePlacementConfig:(NSMutableDictionary )extraDict {\n \n if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];\n }\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig.interstitialLoadExtra = extraDict;\n}\n\n\/\/\/ Set shared ad placement extra parameters - Rewarded Video Ad\n\/\/\/ - Parameter extraDict: Extra parameters dictionary\n+ (void)setRewardedVideoSharePlacementConfig:(NSMutableDictionary )extraDict {\n \n if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];\n }\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig.rewardedVideoLoadExtra = extraDict;\n}\n\n\/\/\/ Set shared ad placement extra parameters - Banner Ad\n\/\/\/ - Parameter extraDict: Extra parameters dictionary\n+ (void)setBannerSharePlacementConfig:(NSMutableDictionary )extraDict {\n \n if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];\n }\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig.bannerLoadExtra = extraDict;\n}\n\n\/\/\/ Set shared ad placement extra parameters - Native Ad\n\/\/\/ - Parameter extraDict: Extra parameters dictionary\n+ (void)setNativeSharePlacementConfig:(NSMutableDictionary *)extraDict {\n \n if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];\n }\n [ATSDKGlobalSetting sharedManager].sharePlacementConfig.nativeLoadExtra = extraDict;\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783478706","update_time":"1783479404"},"pure_content":"Rewarded Video \u2014 Server-Side Reward\nIf your Rewarded Ad Placement is configured with a shared ad placement, you can refer to the following code to set the server-side reward parameters when loading:\nN"}],"content":{"icon":"","desc":"","content_id":"76295","add_time":"1709721558","update_time":"1709722552","content":"","is_traffic_less":"0","file_type":""},"hot_list":[],"user_read_num":"0","is_auth":"0"},"msg":"Success","code":200}

<\/h3>\n

Detailed Steps<\/h2>