{"data":{"id":"76330","string_id":"txh59n","status":"1","parent_id":"76196","slug":"xsG93u","order":"8","name":"Integrated Basic Description","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"","published_time":"1709722563","add_time":"1709721627","update_time":"1782888053","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":"76331","string_id":"ZSqkOE","status":"1","parent_id":"76330","slug":"SDK-import-instructions","order":"19","name":"SDK import instructions","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722563","add_time":"1709721628","update_time":"1783492326","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76331","content":"Unity3D SDK Integration Guide\n================\n\n**1.** Overview\n-----\n\nThis document describes the integration methods for the Unity3D version of the SDK, covering account registration, app ID, ad placement ID, and SDK integration, to ensure developers can smoothly integrate the SDK for monetization. The ad formats currently supported on the Unity 3D platform of Taku SDK are as follows:\n\n| Ad Format | Description |\n|---|---|\n| Native | Native ad, no UI |\n| Video | Video ad, with UI |\n| Interstitial | Interstitial ad, with UI |\n| Banner | Banner ad, with UI |\n\nDevelopers can choose the appropriate ad format based on the app's characteristics. See the specific integration methods below.\n\n**2.** Account and Related ID Preparation\n------------\n\nYou can follow the [Taku Account and Related ID Preparation](https:\/\/help.takuad.com\/en\/docs\/Application) guide for account registration and login instructions.\n\n**3.** SDK Import Instructions\n----------\n\n[Android & iOS Import Instructions](https:\/\/help.takuad.com\/en\/docs\/TopOn-Unity3D-plugin-2-import-instructions)\n\nDownload Instructions: Log in to the dashboard -> SDK Download -> Unity\n\nTaku iOS SDK requires version **v6.4.93 or lower**\n\n**4.** Start the SDK\n--------\n\nAfter completing the import above, you can begin SDK code integration: [SDK Initialization Integration](https:\/\/help.takuad.com\/en\/docs\/Unity-SDK-initialization)\n\n**5.** Common Build Issue Solutions\n------------\n\nPlease refer to [here](https:\/\/help.takuad.com\/en\/docs\/TopOn-Unity3D-plugin-2-import-instructions).","pure_content":"Unity3D SDK Integration Guide\n1. Overview\nThis document describes the integration methods for the Unity3D version of the SDK, covering account registration, app ID, ad placement ID, and SDK integration, to ensure developers can smoothly integrate the SDK for monetization. The ad formats currently supported on the Unity 3D platform of Taku SDK are as follows:\n\n\n\n Ad Format\n Description\n\n\n\n\n Native\n Native ad, no UI\n\n\n Video\n Video ad, with UI\n\n\n Interstitial\n Interstitial ad, with UI\n\n\n Banner\n Banner ad, with UI\n\n\n\nDevelopers can choose the appropriate ad format based on the app's characteristics. See the specific integration methods below.\n2. Account and Related ID Preparation\nYou can follow the Taku Account and Related ID Preparation guide for account registration and login instructions.\n3. SDK Import Instructions\nAndroid & iOS Import Instructions\nDownload Instructions: Log in to the dashboard -> SDK Download -> Unity\nTaku iOS SDK requires version v6.4.93 or lower\n4. Start the SDK\nAfter completing the import above, you can begin SDK code integration: SDK Initialization Integration\n5. Common Build Issue Solutions\nPlease refer to here.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1709721629","update_time":"1782973739"},"pure_content":"Unity3D SDK Integration Guide\n1. Overview\nThis document describes the integration methods for the Unity3D version of the SDK, covering account registration, app ID, ad placement ID, and SDK integratio"},{"id":"76333","string_id":"bU4Icy","status":"1","parent_id":"76330","slug":"Unity-SDK-initialization","order":"18","name":"Unity SDK initialization","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722564","add_time":"1709721632","update_time":"1783492326","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76333","content":"**1.** API Description\n--------\n\n| API | Parameters | Description |\n|---|---|---|\n| initSDK | string appid, string appkey | Initialize the SDK. The appId and appKey need to be obtained after creating an app in the Taku dashboard. [How to get App Key?](https:\/\/help.takuad.com\/en\/docs\/Application) |\n| setLogDebug | bool isDebug | Whether to enable SDK Debug log. **Strongly recommended to enable during the testing phase for easier troubleshooting** |\n| setChannel | string channel | Set channel information for distinguishing ad data in the Taku dashboard. Only characters matching the rule are allowed: **\\[A-Za-z0-9\\_\\]** **Note: If using the initCustomMap() method, this method must be called after initCustomMap()** |\n| setSubChannel | string subChannel | Set sub-channel information. Only characters matching the rule are allowed: **\\[A-Za-z0-9\\_\\]** **Note: If using the initCustomMap() method, this method must be called after initCustomMap()** |\n| initCustomMap | Dictionary | Custom key-value pairs, used at the App level to match the ad list delivered by the backend. **App-level custom rules are global settings and apply to all Placements**. Developers can set corresponding custom rules in the traffic groups section of the Taku dashboard. See [Traffic Group Usage Instructions](https:\/\/help.takuad.com\/en\/docs\/WfbYYEzV) for details. **Note: Calling this method will clear the settings made by setChannel() and setSubChannel(). If you have set these, please re-set them after calling this method** |\n| setCustomDataForPlacementID | Dictionary | Custom key-value pairs, used at the Placement level to match the ad list delivered by the backend. **Effective only for the current Placement**. You can add Placement-specific custom rules on top of the **App-level custom rules**. Developers can set corresponding custom rules in the traffic groups section of the Taku dashboard. See [Traffic Group Usage Instructions](https:\/\/help.takuad.com\/en\/docs\/WfbYYEzV) for details. |\n| getUserLocation | ATGetUserLocationListener listener | Determine whether the current network is in the EU region |\n| getGDPRLevel | - | Get the reporting level of the current privacy data |\n| showGDPRAuth | - | Show the GDPR authorization page. **Note**: Deprecated starting from v6.2.87, please use showGDPRConsentDialog instead |\n| showGDPRConsentDialog | | **(Added in v6.2.87)** Show the Google UMP GDPR consent dialog |\n\n**2.** Sample Code\n-------\n\nYour App needs to establish a **Privacy Policy**, and display the **Privacy Policy** and obtain user consent when the user launches the App for the first time. For the App's **Privacy Policy**, please refer to the [Privacy Compliance Guide](https:\/\/www.takuad.com\/privacy-policy). **Be sure to initialize the Taku SDK only after the user has agreed to the App's Privacy Policy.**\n\nYou can initialize **AnyThinkSDK** using the following code. See the [demo project](https:\/\/github.com\/TakuMediation\/Taku_Unity_Demo) for details:\n\n```java\n\/\/ (Optional) Set custom Map information, which can match the ad provider order list configured in the dashboard (App level)\n\/\/ Note: Calling this method will clear the settings made by setChannel() and setSubChannel(). If you have set these, please re-set them after calling this method\nATSDKAPI.initCustomMap(new Dictionary { { \"unity3d_data\", \"test_data\" } }); \n\n\/\/ (Optional) Set custom Map information, which can match the ad provider order list configured in the dashboard (Placement level)\nATSDKAPI.setCustomDataForPlacementID(new Dictionary { { \"unity3d_data_pl\", \"test_data_pl\" } } ,placementId);\n\n\/\/ (Optional) Set channel information. Developers can use this channel information in the dashboard to distinguish ad data for each channel\n\/\/ Note: If using the initCustomMap() method, this method must be called after initCustomMap()\nATSDKAPI.setChannel(\"unity3d_test_channel\"); \n\n\/\/ (Optional) Set sub-channel information. Developers can use this channel information in the dashboard to distinguish sub-channel ad data for each channel\n\/\/ Note: If using the initCustomMap() method, this method must be called after initCustomMap()\nATSDKAPI.setSubChannel(\"unity3d_test_subchannel\"); \n\n\/\/ Enable Debug log (strongly recommended to enable during the testing phase for easier troubleshooting)\nATSDKAPI.setLogDebug(true);\n\n\/\/ (Required) SDK Initialization\nATSDKAPI.initSDK(\"a5c4ad280995c9\", \"7b4e37f819dbee652ef79c4506e14288\");\/\/Use your own app_id & app_key here\n\n```\n\n**3.** Integration of Different Ad Formats\n------------\n\n**After Initialization is complete, you can start integrating each ad format:**\n\n[Rewarded Video Ad Integration](https:\/\/help.takuad.com\/en\/docs\/Rewarded-video-ad-integration-instructions) \n[Interstitial Ad Integration](https:\/\/help.takuad.com\/en\/docs\/Interstitial-Ad-Integration-Instructions) \n[Banner Ad Integration](https:\/\/help.takuad.com\/en\/docs\/Banner-advertising-integration-instructions) \n[Native Ad Integration](https:\/\/help.takuad.com\/en\/docs\/Native-Ads-Integration-Instructions) \n[Splash Ad Integration](https:\/\/help.takuad.com\/en\/docs\/Open-screen-advertising-access)","pure_content":"1. API Description\n\n\n\n API\n Parameters\n Description\n\n\n\n\n initSDK\n string appid, string appkey\n Initialize the SDK. The appId and appKey need to be obtained after creating an app in the Taku dashboard. How to get App Key?\n\n\n setLogDebug\n bool isDebug\n Whether to enable SDK Debug log. Strongly recommended to enable during the testing phase for easier troubleshooting\n\n\n setChannel\n string channel\n Set channel information for distinguishing ad data in the Taku dashboard. Only characters matching the rule are allowed: [A-Za-z0-9_] Note: If using the initCustomMap() method, this method must be called after initCustomMap()\n\n\n setSubChannel\n string subChannel\n Set sub-channel information. Only characters matching the rule are allowed: [A-Za-z0-9_] Note: If using the initCustomMap() method, this method must be called after initCustomMap()\n\n\n initCustomMap\n Dictionary\n Custom key-value pairs, used at the App level to match the ad list delivered by the backend. App-level custom rules are global settings and apply to all Placements. Developers can set corresponding custom rules in the traffic groups section of the Taku dashboard. See Traffic Group Usage Instructions for details. Note: Calling this method will clear the settings made by setChannel() and setSubChannel(). If you have set these, please re-set them after calling this method\n\n\n setCustomDataForPlacementID\n Dictionary\n Custom key-value pairs, used at the Placement level to match the ad list delivered by the backend. Effective only for the current Placement. You can add Placement-specific custom rules on top of the App-level custom rules. Developers can set corresponding custom rules in the traffic groups section of the Taku dashboard. See Traffic Group Usage Instructions for details.\n\n\n getUserLocation\n ATGetUserLocationListener listener\n Determine whether the current network is in the EU region\n\n\n getGDPRLevel\n -\n Get the reporting level of the current privacy data\n\n\n showGDPRAuth\n -\n Show the GDPR authorization page. Note: Deprecated starting from v6.2.87, please use showGDPRConsentDialog instead\n\n\n showGDPRConsentDialog\n \n (Added in v6.2.87) Show the Google UMP GDPR consent dialog\n\n\n\n2. Sample Code\nYour App needs to establish a Privacy Policy, and display the Privacy Policy and obtain user consent when the user launches the App for the first time. For the App's Privacy Policy, please refer to the Privacy Compliance Guide. Be sure to initialize the Taku SDK only after the user has agreed to the App's Privacy Policy.\nYou can initialize AnyThinkSDK using the following code. See the demo project for details:\n\/\/ (Optional) Set custom Map information, which can match the ad provider order list configured in the dashboard (App level)\n\/\/ Note: Calling this method will clear the settings made by setChannel() and setSubChannel(). If you have set these, please re-set them after calling this method\nATSDKAPI.initCustomMap(new Dictionary { { \"unity3d_data\", \"test_data\" } }); \n\n\/\/ (Optional) Set custom Map information, which can match the ad provider order list configured in the dashboard (Placement level)\nATSDKAPI.setCustomDataForPlacementID(new Dictionary { { \"unity3d_data_pl\", \"test_data_pl\" } } ,placementId);\n\n\/\/ (Optional) Set channel information. Developers can use this channel information in the dashboard to distinguish ad data for each channel\n\/\/ Note: If using the initCustomMap() method, this method must be called after initCustomMap()\nATSDKAPI.setChannel(\"unity3d_test_channel\"); \n\n\/\/ (Optional) Set sub-channel information. Developers can use this channel information in the dashboard to distinguish sub-channel ad data for each channel\n\/\/ Note: If using the initCustomMap() method, this method must be called after initCustomMap()\nATSDKAPI.setSubChannel(\"unity3d_test_subchannel\"); \n\n\/\/ Enable Debug log (strongly recommended to enable during the testing phase for easier troubleshooting)\nATSDKAPI.setLogDebug(true);\n\n\/\/ (Required) SDK Initialization\nATSDKAPI.initSDK(\"a5c4ad280995c9\", \"7b4e37f819dbee652ef79c4506e14288\");\/\/Use your own app_id & app_key here\n\n\n3. Integration of Different Ad Formats\nAfter Initialization is complete, you can start integrating each ad format:\nRewarded Video Ad Integration\nInterstitial Ad Integration\nBanner Ad Integration\nNative Ad Integration\nSplash Ad Integration","is_draft":"0","editor_type":"2","file_path":"","add_time":"1709721633","update_time":"1782963279"},"pure_content":"1. API Description\n\n\n\n API\n Parameters\n Description\n\n\n\n\n initSDK\n string appid, string appkey\n Initialize the SDK. The appId and appKey need to be obtained after creating an app in the Taku dashboard."},{"id":"76334","string_id":"j3EJbo","status":"1","parent_id":"76330","slug":"Rewarded-video-ad-integration-instructions","order":"17","name":"Rewarded Video Ad","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722564","add_time":"1709721634","update_time":"1783492326","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76334","content":"**1.** Rewarded Video Ad Introduction\n-----------\n\nRewarded video ads aggregate rewarded video ads from other third-party ad platforms. You can use the ATRewardedVideo API to load and display ads. Two integration modes are currently supported, as described below:\n\n| Mode (Choose One) | Description |\n|---|---|\n| Manual Request Mode | You call the ad load API yourself at the appropriate timing. See the integration suggestions below for details. |\n| Auto Load Mode | A one-stop request maintenance solution launched by Taku that automatically determines the preloading and caching timing for the next ad based on user usage status and ad consumption progress, achieving better loading results. See: [Rewarded Video Ad Auto Load Mode](https:\/\/help.takuad.com\/en\/docs\/Fully-automatic-loading-of-incentive-videos) for details. |\n\n**2.** Integration Process Suggestions\n---------\n\n1. Call ATRewardedVideo#loadVideoAd to load an ad when the app starts\n2. Use ATRewardedVideo#hasAdReady to check if an ad can be displayed at the location where you want to show it\n3. Ad Preloading:\n4. If you need to use [ad scenarios](https:\/\/help.takuad.com\/en\/docs\/zUl0fvpD) to distinguish data for different business scenarios, see the sample code for details\n\n**3.** API Description\n--------\n\nATRewardedVideo:\n\n| API | Parameters | Description |\n|---|---|---|\n| loadVideoAd | string placementid, Dictionary | Load an ad |\n| setListener | ATRewardedVideoListener listener | Set the listener callback interface. **(Deprecated after version 5.9.51)** For how to set listeners, see: [Rewarded Video Ad Event Settings](https:\/\/help.takuad.com\/en\/docs\/Rewarded-video-ad-integration-instructions#7.%20Implement%20Multiple%20Listeners%20for%20Rewarded%20Ads%20(Note:%20Only%20supported%20on%20V5.9.51%20and%20above)) |\n| hasAdReady | string placementid | Check if there is a cached ad |\n| checkAdStatus | string placementid | **(Added in v5.7.03)** Get the current ad placement status (JSON string): 1. isLoading: Whether it is loading 2. isReady: Whether there is a cached ad (same as hasAdReady) 3. AdInfo: The highest-priority cached ad info (see [ATCallbackInfo Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)) |\n| getValidAdCaches | string placementid | **(Added in v5.7.54)** Get all successfully loaded cached ad info (JSON string) (see [ATCallbackInfo Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)) |\n| showAd | string placementid | Display an ad |\n| showAd | string placementid, Dictionary | Use the scenario feature to display an ad |\n| entryScenarioWithPlacementID | string placementid, string scenarioID | Set entry into a displayable ad scenario |\n\n**4.** Load Rewarded Video\n---------\n\nUse the following code to load a rewarded video ad:\n\n```java\npublic void loadVideo()\n{\n ATRewardedVideo.Instance.client.onAdLoadEvent += onAdLoad; \n ATRewardedVideo.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n ATRewardedVideo.Instance.client.onAdVideoStartEvent += onAdVideoStartEvent;\n ATRewardedVideo.Instance.client.onAdVideoEndEvent += onAdVideoEndEvent;\n ATRewardedVideo.Instance.client.onAdVideoFailureEvent += onAdVideoPlayFail;\n ATRewardedVideo.Instance.client.onAdClickEvent += onAdClick;\n ATRewardedVideo.Instance.client.onRewardEvent += onReward;\n ATRewardedVideo.Instance.client.onAdVideoCloseEvent += onAdVideoClosedEvent;\n\n Dictionary jsonmap = new Dictionary();\n \/\/If you need to distribute rewards through the developer's server (some ad platforms support this server-side reward), you need to pass the following two keys\n \/\/ATConst.USERID_KEY is required and used to identify each user; ATConst.USER_EXTRA_DATA is optional and will be passed through to the developer's server\n jsonmap.Add(ATConst.USERID_KEY, \"test_user_id\");\n jsonmap.Add(ATConst.USER_EXTRA_DATA, \"test_user_extra_data\");\n\n ATRewardedVideo.Instance.loadVideoAd(mPlacementId_rewardvideo_all,jsonmap);\n}\n```\n\n**Note:** See below for how to get notified about rewarded video ad events (load success\/failure, impression, click, video start\/end, and reward).\n\n**5.** Check If There Is a Cached Ad\n------------\n\n```java\nATRewardedVideo.Instance.hasAdReady(mPlacementId_rewardvideo_all);\n```\n\n**6.** Display Rewarded Video\n---------\n\nCompared to displaying native ads, displaying rewarded video ads is much simpler. Just call the show API and pass the ad placement ID as a parameter:\n\n```java\npublic void showVideo()\n{ \n Debug.Log (\"Developer show video....\");\n ATRewardedVideo.Instance.showAd(mPlacementId_rewardvideo_all);\n}\n```\n\nWhen using the **scenario** feature:\n\n```java\npublic void showVideo()\n{\n Debug.Log (\"Developer show video....\");\n Dictionary jsonmap = new Dictionary();\n jsonmap.Add(AnyThinkAds.Api.ATConst.SCENARIO, showingScenarioID);\n \/\/ Plugin 2.1.8 added pass-through custom parameters on display\n jsonmap.Add(AnyThinkAds.Api.ATConst.ShowConfig.SHOW_CUSTOM_EXT, showCustomExt);\n ATRewardedVideo.Instance.showAd(mPlacementId_rewardvideo_all, jsonmap); \n}\n```\n\n**7. Implement Multiple Listeners for Rewarded Ads (Note: Only supported on V5.9.51 and above)**\n----------------------------------------\n\nFor callback info details, see: [Callback Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)\n\nUse the following code to implement multiple listeners:\n\n```java\n \/\/ Ad loaded successfully\n ATRewardedVideo.Instance.client.onAdLoadEvent += onAdLoad; \n \/\/ Ad load failed\n ATRewardedVideo.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n \/\/ Ad impression callback (can rely on this callback for impression statistics)\n ATRewardedVideo.Instance.client.onAdVideoStartEvent += onAdVideoStartEvent;\n \/\/ Ad playback ended\n ATRewardedVideo.Instance.client.onAdVideoEndEvent += onAdVideoEndEvent;\n \/\/ Video ad playback failed\n ATRewardedVideo.Instance.client.onAdVideoFailureEvent += onAdVideoPlayFail;\n \/\/ Ad clicked\n ATRewardedVideo.Instance.client.onAdClickEvent += onAdClick;\n \/\/ Ad reward callback (can rely on this listener to distribute in-game rewards)\n ATRewardedVideo.Instance.client.onRewardEvent += onReward;\n \/\/ Ad closed\n ATRewardedVideo.Instance.client.onAdVideoCloseEvent += onAdVideoClosedEvent;\n\n```\n\nAdvanced listener settings:\n\n```java\n \/\/ Ad Source initiated request\n ATRewardedVideo.Instance.client.onAdSourceAttemptEvent += startLoadingADSource;\n \/\/ Ad Source loaded successfully\n ATRewardedVideo.Instance.client.onAdSourceFilledEvent += finishLoadingADSource;\n \/\/ Ad Source load failed\n ATRewardedVideo.Instance.client.onAdSourceLoadFailureEvent += failToLoadADSource;\n \/\/ Ad Source Bidding started\n ATRewardedVideo.Instance.client.onAdSourceBiddingAttemptEvent += startBiddingADSource;\n \/\/ Ad Source Bidding succeeded\n ATRewardedVideo.Instance.client.onAdSourceBiddingFilledEvent += finishBiddingADSource;\n \/\/ Ad Source Bidding failed\n ATRewardedVideo.Instance.client.onAdSourceBiddingFailureEvent += failBiddingADSource;\n```\n\nThe method definition parameters are as follows **(Note: You can refer to the code below for method names or use custom method names, but the parameters must be consistent)**:\n\n```java\n \/\/ Ad loaded successfully\n public void onAdLoad(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdLoad :\" + erg.placementId);\n }\n \/\/ Ad load failed\n public void onAdLoadFail(object sender,ATAdErrorEventArgs erg )\n {\n Debug.Log(\"Developer callback onAdLoadFail :\" + erg.placementId + \"--erg.code:\" + code + \"--msg:\" + erg.message);\n }\n\n public void onAdVideoStartEvent(object sender, ATAdEventArgs erg) {\n Debug.Log(\"Developer onAdVideoStartEvent------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n } \n\n public void onAdVideoEndEvent(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdVideoEndEvent------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n }\n\n\n public void onAdVideoPlayFail(object sender, ATAdErrorEventArgs erg)\n {\n Debug.Log(\"Developer onAdVideoClosedEvent------\" + \"->\" + JsonMapper.ToJson(erg.errorMessage));\n }\n\n\n \/\/sender is the ad type object, erg is the returned info\n \/\/ Ad clicked\n public void onAdClick(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdClick :\" + erg.placementId);\n }\n\n public void onReward(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onReward------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n }\n\n\n public void onAdVideoClosedEvent(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdVideoClosedEvent------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n }\n\n\n public void startLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startLoadingADSource------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toAdsourceDictionary()));\n\n }\n\n public void finishLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishLoadingADSource------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toAdsourceDictionary()));\n\n }\n\n public void failToLoadADSource(object sender,ATAdErrorEventArgs erg ){\n Debug.Log(\"Developer failToLoadADSource------erg.errorCode:\" + erg.errorCode + \"---erg.errorMessage:\" + erg.errorMessage+ \"->\" + JsonMapper.ToJson(erg.callbackInfo.toAdsourceDictionary()));\n\n }\n\n public void startBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startBiddingADSource------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toAdsourceDictionary()));\n\n }\n\n public void finishBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishBiddingADSource------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toAdsourceDictionary()));\n\n }\n\n public void failBiddingADSource(object sender,ATAdErrorEventArgs erg ){\n Debug.Log(\"Developer failBiddingADSource------erg.errorCode:\" + erg.errorCode + \"---erg.errorMessage:\" + erg.errorMessage+ \"->\" + JsonMapper.ToJson(erg.callbackInfo.toAdsourceDictionary()));\n\n }\n\n```\n\n**Watch Another Ad**: Only **Pangle** supports the Watch Another Ad callback\n\n```java\n\/\/ Rewarded video watch another ad - video playback started\nATRewardedVideo.Instance.client.onPlayAgainStart += onRewardedVideoAdAgainPlayStart;\n\/\/ Rewarded video watch another ad - video playback failed\nATRewardedVideo.Instance.client.onPlayAgainFailure += onRewardedVideoAdAgainPlayFail;\n\/\/ Rewarded video watch another ad - video playback ended\nATRewardedVideo.Instance.client.onPlayAgainEnd += onRewardedVideoAdAgainPlayEnd;\n\/\/ Rewarded video watch another ad - video clicked\nATRewardedVideo.Instance.client.onPlayAgainClick += onRewardedVideoAdAgainPlayClicked;\n\/\/ Rewarded video watch another ad - reward granted\nATRewardedVideo.Instance.client.onPlayAgainReward += onAgainReward;\n\npublic void onRewardedVideoAdAgainPlayStart(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayStart------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n}\n\npublic void onRewardedVideoAdAgainPlayEnd(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayEnd------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n}\n\npublic void onRewardedVideoAdAgainPlayFail(object sender,ATAdErrorEventArgs erg){\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayFail------code:\" + erg.errorCode + \"---message:\" + erg.errorMessage);\n}\n\npublic void onRewardedVideoAdAgainPlayClicked(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayClicked------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n}\n\npublic void onAgainReward(object sender, ATAdEventArgs erg){\n Debug.Log(\"Developer onAgainReward------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n}\n```\n\n**8. Legacy Rewarded Video Listener Implementation (Note: Only for use below V5.9.51, deprecated in new versions)**\n-----------------------------------------------\n\nYou can implement a class that implements the **ATRewardedVideo Listener** interface to get notified about rewarded video ad events, xxxxx: **(Note: For Android, all callback methods are not on the Unity main thread)**\n\n```java\nclass ATCallbackListener : ATRewardedVideoListener {\n \/\/ Ad loaded successfully\n public void onRewardedVideoAdLoaded(string placementId){\n Debug.Log(\"Developer onRewardedVideoAdLoaded------\");\n }\n \/\/ Ad load failed\n public void onRewardedVideoAdLoadFail(string placementId, string code, string message){\n Debug.Log(\"Developer onRewardedVideoAdLoadFail------:code\" + code + \"--message:\" + message);\n }\n \/\/ Ad playback started\n public void onRewardedVideoAdPlayStart(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer onRewardedVideoAdPlayStart------\");\n }\n \/\/ Ad playback ended\n public void onRewardedVideoAdPlayEnd(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer onRewardedVideoAdPlayEnd------\");\n }\n \/\/ Ad playback failed\n public void onRewardedVideoAdPlayFail(string placementId, string code, string message){\n Debug.Log(\"Developer onRewardedVideoAdPlayFail------code:\" + code + \"---message:\" + message);\n }\n \/\/ Ad closed, where isReward only indicates whether the onReward() method was called back when onRewardedVideoAdPlayClosed was called back\n public void onRewardedVideoAdPlayClosed(string placementId, bool isReward, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer onRewardedVideoAdPlayClosed------isReward:\" + isReward);\n }\n \/\/ Ad clicked\n public void onRewardedVideoAdPlayClicked(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer onRewardVideoAdPlayClicked------\");\n }\n \/\/ Reward granted. Developers can distribute rewards in this callback. It generally precedes the onRewardedVideoAdPlayClosed callback, but this is not guaranteed for server-side rewards\n public void onReward(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer onReward------\");\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failBiddingADSource------\");\n }\n}\n```\n\nCreate an instance of this class and pass it to the listener parameter in the load API, [see here](https:\/\/help.takuad.com\/en\/docs\/Rewarded-video-ad-integration-instructions#7.%20Implement%20Multiple%20Listeners%20for%20Rewarded%20Ads%20(Note:%20Only%20supported%20on%20V5.9.51%20and%20above))\n\nNote: **V5.7.82** and above, only **Pangle** supports the **Watch Another Ad callback**\n\n```java\nclass ATCallbackListener : ATRewardedVideoExListener {\n \/\/ Rewarded video watch another ad - video playback started\n public void onRewardedVideoAdAgainPlayStart(string placementId, ATCallbackInfo callbackInfo) {\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayStart------\");\n }\n \/\/ Rewarded video watch another ad - video playback ended\n public void onRewardedVideoAdAgainPlayEnd(string placementId, ATCallbackInfo callbackInfo) {\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayEnd------\");\n }\n \/\/ Rewarded video watch another ad - video playback failed\n public void onRewardedVideoAdAgainPlayFail(string placementId, string code, string message) {\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayFail------\");\n }\n \/\/ Rewarded video watch another ad - video clicked\n public void onRewardedVideoAdAgainPlayClicked(string placementId, ATCallbackInfo callbackInfo) {\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayClicked------\");\n }\n \/\/ Rewarded video watch another ad - reward granted\n public void onAgainReward(string placementId, ATCallbackInfo callbackInfo) {\n Debug.Log(\"Developer onAgainReward------\");\n }\n}\n```\n\n**Note:** The code snippets in this section are from the **videoScenes.cs** [demo project](https:\/\/github.com\/TakuMediation\/Taku_Unity_Demo) in our Demo.","pure_content":"1. Rewarded Video Ad Introduction\nRewarded video ads aggregate rewarded video ads from other third-party ad platforms. You can use the ATRewardedVideo API to load and display ads. Two integration modes are currently supported, as described below:\n\n\n\n Mode (Choose One)\n Description\n\n\n\n\n Manual Request Mode\n You call the ad load API yourself at the appropriate timing. See the integration suggestions below for details.\n\n\n Auto Load Mode\n A one-stop request maintenance solution launched by Taku that automatically determines the preloading and caching timing for the next ad based on user usage status and ad consumption progress, achieving better loading results. See: Rewarded Video Ad Auto Load Mode for details.\n\n\n\n2. Integration Process Suggestions\n\nCall ATRewardedVideo#loadVideoAd to load an ad when the app starts\nUse ATRewardedVideo#hasAdReady to check if an ad can be displayed at the location where you want to show it\nAd Preloading:\nIf you need to use ad scenarios to distinguish data for different business scenarios, see the sample code for details\n\n3. API Description\nATRewardedVideo:\n\n\n\n API\n Parameters\n Description\n\n\n\n\n loadVideoAd\n string placementid, Dictionary\n Load an ad\n\n\n setListener\n ATRewardedVideoListener listener\n Set the listener callback interface. (Deprecated after version 5.9.51) For how to set listeners, see: Rewarded Video Ad Event Settings\n\n\n hasAdReady\n string placementid\n Check if there is a cached ad\n\n\n checkAdStatus\n string placementid\n (Added in v5.7.03) Get the current ad placement status (JSON string): 1. isLoading: Whether it is loading 2. isReady: Whether there is a cached ad (same as hasAdReady) 3. AdInfo: The highest-priority cached ad info (see ATCallbackInfo Description)\n\n\n getValidAdCaches\n string placementid\n (Added in v5.7.54) Get all successfully loaded cached ad info (JSON string) (see ATCallbackInfo Description)\n\n\n showAd\n string placementid\n Display an ad\n\n\n showAd\n string placementid, Dictionary\n Use the scenario feature to display an ad\n\n\n entryScenarioWithPlacementID\n string placementid, string scenarioID\n Set entry into a displayable ad scenario\n\n\n\n4. Load Rewarded Video\nUse the following code to load a rewarded video ad:\npublic void loadVideo()\n{\n ATRewardedVideo.Instance.client.onAdLoadEvent += onAdLoad; \n ATRewardedVideo.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n ATRewardedVideo.Instance.client.onAdVideoStartEvent += onAdVideoStartEvent;\n ATRewardedVideo.Instance.client.onAdVideoEndEvent += onAdVideoEndEvent;\n ATRewardedVideo.Instance.client.onAdVideoFailureEvent += onAdVideoPlayFail;\n ATRewardedVideo.Instance.client.onAdClickEvent += onAdClick;\n ATRewardedVideo.Instance.client.onRewardEvent += onReward;\n ATRewardedVideo.Instance.client.onAdVideoCloseEvent += onAdVideoClosedEvent;\n\n Dictionary jsonmap = new Dictionary();\n \/\/If you need to distribute rewards through the developer's server (some ad platforms support this server-side reward), you need to pass the following two keys\n \/\/ATConst.USERID_KEY is required and used to identify each user; ATConst.USER_EXTRA_DATA is optional and will be passed through to the developer's server\n jsonmap.Add(ATConst.USERID_KEY, \"test_user_id\");\n jsonmap.Add(ATConst.USER_EXTRA_DATA, \"test_user_extra_data\");\n\n ATRewardedVideo.Instance.loadVideoAd(mPlacementId_rewardvideo_all,jsonmap);\n}\n\nNote: See below for how to get notified about rewarded video ad events (load success\/failure, impression, click, video start\/end, and reward).\n5. Check If There Is a Cached Ad\nATRewardedVideo.Instance.hasAdReady(mPlacementId_rewardvideo_all);\n\n6. Display Rewarded Video\nCompared to displaying native ads, displaying rewarded video ads is much simpler. Just call the show API and pass the ad placement ID as a parameter:\npublic void showVideo()\n{ \n Debug.Log (\"Developer show video....\");\n ATRewardedVideo.Instance.showAd(mPlacementId_rewardvideo_all);\n}\n\nWhen using the scenario feature:\npublic void showVideo()\n{\n Debug.Log (\"Developer show video....\");\n Dictionary jsonmap = new Dictionary();\n jsonmap.Add(AnyThinkAds.Api.ATConst.SCENARIO, showingScenarioID);\n \/\/ Plugin 2.1.8 added pass-through custom parameters on display\n jsonmap.Add(AnyThinkAds.Api.ATConst.ShowConfig.SHOW_CUSTOM_EXT, showCustomExt);\n ATRewardedVideo.Instance.showAd(mPlacementId_rewardvideo_all, jsonmap); \n}\n\n7. Implement Multiple Listeners for Rewarded Ads (Note: Only supported on V5.9.51 and above)\nFor callback info details, see: Callback Info Description\nUse the following code to implement multiple listeners:\n \/\/ Ad loaded successfully\n ATRewardedVideo.Instance.client.onAdLoadEvent += onAdLoad; \n \/\/ Ad load failed\n ATRewardedVideo.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n \/\/ Ad impression callback (can rely on this callback for impression statistics)\n ATRewardedVideo.Instance.client.onAdVideoStartEvent += onAdVideoStartEvent;\n \/\/ Ad playback ended\n ATRewardedVideo.Instance.client.onAdVideoEndEvent += onAdVideoEndEvent;\n \/\/ Video ad playback failed\n ATRewardedVideo.Instance.client.onAdVideoFailureEvent += onAdVideoPlayFail;\n \/\/ Ad clicked\n ATRewardedVideo.Instance.client.onAdClickEvent += onAdClick;\n \/\/ Ad reward callback (can rely on this listener to distribute in-game rewards)\n ATRewardedVideo.Instance.client.onRewardEvent += onReward;\n \/\/ Ad closed\n ATRewardedVideo.Instance.client.onAdVideoCloseEvent += onAdVideoClosedEvent;\n\n\nAdvanced listener settings:\n \/\/ Ad Source initiated request\n ATRewardedVideo.Instance.client.onAdSourceAttemptEvent += startLoadingADSource;\n \/\/ Ad Source loaded successfully\n ATRewardedVideo.Instance.client.onAdSourceFilledEvent += finishLoadingADSource;\n \/\/ Ad Source load failed\n ATRewardedVideo.Instance.client.onAdSourceLoadFailureEvent += failToLoadADSource;\n \/\/ Ad Source Bidding started\n ATRewardedVideo.Instance.client.onAdSourceBiddingAttemptEvent += startBiddingADSource;\n \/\/ Ad Source Bidding succeeded\n ATRewardedVideo.Instance.client.onAdSourceBiddingFilledEvent += finishBiddingADSource;\n \/\/ Ad Source Bidding failed\n ATRewardedVideo.Instance.client.onAdSourceBiddingFailureEvent += failBiddingADSource;\n\nThe method definition parameters are as follows (Note: You can refer to the code below for method names or use custom method names, but the parameters must be consistent):\n \/\/ Ad loaded successfully\n public void onAdLoad(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdLoad :\" + erg.placementId);\n }\n \/\/ Ad load failed\n public void onAdLoadFail(object sender,ATAdErrorEventArgs erg )\n {\n Debug.Log(\"Developer callback onAdLoadFail :\" + erg.placementId + \"--erg.code:\" + code + \"--msg:\" + erg.message);\n }\n\n public void onAdVideoStartEvent(object sender, ATAdEventArgs erg) {\n Debug.Log(\"Developer onAdVideoStartEvent------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n } \n\n public void onAdVideoEndEvent(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdVideoEndEvent------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n }\n\n\n public void onAdVideoPlayFail(object sender, ATAdErrorEventArgs erg)\n {\n Debug.Log(\"Developer onAdVideoClosedEvent------\" + \"->\" + JsonMapper.ToJson(erg.errorMessage));\n }\n\n\n \/\/sender is the ad type object, erg is the returned info\n \/\/ Ad clicked\n public void onAdClick(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdClick :\" + erg.placementId);\n }\n\n public void onReward(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onReward------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n }\n\n\n public void onAdVideoClosedEvent(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdVideoClosedEvent------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n }\n\n\n public void startLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startLoadingADSource------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toAdsourceDictionary()));\n\n }\n\n public void finishLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishLoadingADSource------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toAdsourceDictionary()));\n\n }\n\n public void failToLoadADSource(object sender,ATAdErrorEventArgs erg ){\n Debug.Log(\"Developer failToLoadADSource------erg.errorCode:\" + erg.errorCode + \"---erg.errorMessage:\" + erg.errorMessage+ \"->\" + JsonMapper.ToJson(erg.callbackInfo.toAdsourceDictionary()));\n\n }\n\n public void startBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startBiddingADSource------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toAdsourceDictionary()));\n\n }\n\n public void finishBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishBiddingADSource------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toAdsourceDictionary()));\n\n }\n\n public void failBiddingADSource(object sender,ATAdErrorEventArgs erg ){\n Debug.Log(\"Developer failBiddingADSource------erg.errorCode:\" + erg.errorCode + \"---erg.errorMessage:\" + erg.errorMessage+ \"->\" + JsonMapper.ToJson(erg.callbackInfo.toAdsourceDictionary()));\n\n }\n\n\nWatch Another Ad: Only Pangle supports the Watch Another Ad callback\n\/\/ Rewarded video watch another ad - video playback started\nATRewardedVideo.Instance.client.onPlayAgainStart += onRewardedVideoAdAgainPlayStart;\n\/\/ Rewarded video watch another ad - video playback failed\nATRewardedVideo.Instance.client.onPlayAgainFailure += onRewardedVideoAdAgainPlayFail;\n\/\/ Rewarded video watch another ad - video playback ended\nATRewardedVideo.Instance.client.onPlayAgainEnd += onRewardedVideoAdAgainPlayEnd;\n\/\/ Rewarded video watch another ad - video clicked\nATRewardedVideo.Instance.client.onPlayAgainClick += onRewardedVideoAdAgainPlayClicked;\n\/\/ Rewarded video watch another ad - reward granted\nATRewardedVideo.Instance.client.onPlayAgainReward += onAgainReward;\n\npublic void onRewardedVideoAdAgainPlayStart(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayStart------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n}\n\npublic void onRewardedVideoAdAgainPlayEnd(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayEnd------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n}\n\npublic void onRewardedVideoAdAgainPlayFail(object sender,ATAdErrorEventArgs erg){\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayFail------code:\" + erg.errorCode + \"---message:\" + erg.errorMessage);\n}\n\npublic void onRewardedVideoAdAgainPlayClicked(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayClicked------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n}\n\npublic void onAgainReward(object sender, ATAdEventArgs erg){\n Debug.Log(\"Developer onAgainReward------\" + \"->\" + JsonMapper.ToJson(erg.callbackInfo.toDictionary()));\n}\n\n8. Legacy Rewarded Video Listener Implementation (Note: Only for use below V5.9.51, deprecated in new versions)\nYou can implement a class that implements the ATRewardedVideo Listener interface to get notified about rewarded video ad events, xxxxx: (Note: For Android, all callback methods are not on the Unity main thread)\nclass ATCallbackListener : ATRewardedVideoListener {\n \/\/ Ad loaded successfully\n public void onRewardedVideoAdLoaded(string placementId){\n Debug.Log(\"Developer onRewardedVideoAdLoaded------\");\n }\n \/\/ Ad load failed\n public void onRewardedVideoAdLoadFail(string placementId, string code, string message){\n Debug.Log(\"Developer onRewardedVideoAdLoadFail------:code\" + code + \"--message:\" + message);\n }\n \/\/ Ad playback started\n public void onRewardedVideoAdPlayStart(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer onRewardedVideoAdPlayStart------\");\n }\n \/\/ Ad playback ended\n public void onRewardedVideoAdPlayEnd(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer onRewardedVideoAdPlayEnd------\");\n }\n \/\/ Ad playback failed\n public void onRewardedVideoAdPlayFail(string placementId, string code, string message){\n Debug.Log(\"Developer onRewardedVideoAdPlayFail------code:\" + code + \"---message:\" + message);\n }\n \/\/ Ad closed, where isReward only indicates whether the onReward() method was called back when onRewardedVideoAdPlayClosed was called back\n public void onRewardedVideoAdPlayClosed(string placementId, bool isReward, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer onRewardedVideoAdPlayClosed------isReward:\" + isReward);\n }\n \/\/ Ad clicked\n public void onRewardedVideoAdPlayClicked(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer onRewardVideoAdPlayClicked------\");\n }\n \/\/ Reward granted. Developers can distribute rewards in this callback. It generally precedes the onRewardedVideoAdPlayClosed callback, but this is not guaranteed for server-side rewards\n public void onReward(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer onReward------\");\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failBiddingADSource------\");\n }\n}\n\nCreate an instance of this class and pass it to the listener parameter in the load API, see here\nNote: V5.7.82 and above, only Pangle supports the Watch Another Ad callback\nclass ATCallbackListener : ATRewardedVideoExListener {\n \/\/ Rewarded video watch another ad - video playback started\n public void onRewardedVideoAdAgainPlayStart(string placementId, ATCallbackInfo callbackInfo) {\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayStart------\");\n }\n \/\/ Rewarded video watch another ad - video playback ended\n public void onRewardedVideoAdAgainPlayEnd(string placementId, ATCallbackInfo callbackInfo) {\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayEnd------\");\n }\n \/\/ Rewarded video watch another ad - video playback failed\n public void onRewardedVideoAdAgainPlayFail(string placementId, string code, string message) {\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayFail------\");\n }\n \/\/ Rewarded video watch another ad - video clicked\n public void onRewardedVideoAdAgainPlayClicked(string placementId, ATCallbackInfo callbackInfo) {\n Debug.Log(\"Developer onRewardedVideoAdAgainPlayClicked------\");\n }\n \/\/ Rewarded video watch another ad - reward granted\n public void onAgainReward(string placementId, ATCallbackInfo callbackInfo) {\n Debug.Log(\"Developer onAgainReward------\");\n }\n}\n\nNote: The code snippets in this section are from the videoScenes.cs demo project in our Demo.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1709721635","update_time":"1782964161"},"pure_content":"1. Rewarded Video Ad Introduction\nRewarded video ads aggregate rewarded video ads from other third-party ad platforms. You can use the ATRewardedVideo API to load and display ads. Two integration mode"},{"id":"76336","string_id":"y24NKD","status":"1","parent_id":"76330","slug":"Interstitial-Ad-Integration-Instructions","order":"16","name":"Interstitial ad","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722565","add_time":"1709721636","update_time":"1783492326","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76336","content":"**1**. Interstitial Ad Introduction\n---------\n\nInterstitial ads aggregate image interstitial ads and video interstitial ads from other third-party ad platforms. Both ad types can be loaded and displayed using the ATAdManager API. Two integration modes are currently supported, as described below:\n\n| Mode (Choose One) | Description |\n|---|---|\n| Manual Request Mode | You call the ad load API yourself at the appropriate timing. See the integration suggestions below for details. |\n| Auto Load Mode | A one-stop request maintenance solution launched by Taku that automatically determines the preloading and caching timing for the next ad based on user usage status and ad consumption progress, achieving better loading results. See: [Interstitial Ad Auto Load Mode](https:\/\/help.takuad.com\/en\/docs\/Fully-automatic-loading-of-interstitial-ads) for details. |\n\n**2**. Integration Process Suggestions\n---------\n\n1. Call ATInterstitialAd#loadInterstitialAd to load an ad when the app starts\n2. Use ATInterstitialAd#hasInterstitialAdReady to check if an ad can be displayed at the location where you want to show it\n\nfalse: Call ATInterstitialAd#loadInterstitialAd again to load an ad\n\ntrue: Call ATInterstitialAd#showInterstitialAd to display the ad. In the onInterstitialAdClose callback, call ATInterstitialAd#loadInterstitialAd again to preload the next ad (in the onInterstitialAdClose callback, you can call loadInterstitialAd directly without checking hasInterstitialAdReady first, which helps increase the impression volume of higher-priority Ad Sources.)\n\n3. Ad Preloading:\n\nAfter the interstitial ad is displayed, in the onInterstitialAdShow (v5.8.10 and later) or onInterstitialAdClose (before v5.8.10) callback, call ATInterstitialAd#loadInterstitialAd directly for preloading without checking ATInterstitialAd#hasInterstitialAdReady (this helps increase the impression volume of higher-priority Ad Sources).\n\nYou can refer to Auto Request Ads and enable Auto Request Ads (not needed if the above post-display preloading is already implemented).\n\n4. If you need to use ad scenarios to distinguish data for different business scenarios, see the sample code for details.\n\n**3**. API Description\n--------\n\nATInterstitialAd:\n\n| API | Parameters | Description |\n|---|---|---|\n| loadInterstitialAd | string placementid, Dictionary | Load an ad |\n| setListener | ATInterstitialAdListener listener | Set the listener callback interface. **(Deprecated after version 5.9.51)** For how to set listeners, see: [Interstitial Ad Event Settings](https:\/\/help.takuad.com\/en\/docs\/Interstitial-Ad-Integration-Instructions#7.%20Implement%20Interstitial%20Ad%20Event%20Listeners%20(Note:%20Only%20supported%20on%20V5.951%20and%20above)) |\n| hasInterstitialAdReady | string placementid | Check if there is a cached ad |\n| checkAdStatus | string placementid | **(Added in v5.7.03)** Get the current ad placement status (JSON string): 1. isLoading: Whether it is loading 2. isReady: Whether there is a cached ad (same as hasInterstitialAdReady) 3. AdInfo: The highest-priority cached ad info (see [ATCallbackInfo Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)) |\n| getValidAdCaches | string placementid | **(Added in v5.7.54)** Get all successfully loaded cached ad info (JSON string) (see [ATCallbackInfo Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)) |\n| showInterstitialAd | string placementid, Dictionary | Display an ad |\n| entryScenarioWithPlacementID | string placementId, string scenarioID | Set entry into a displayable ad scenario |\n\n**4.** Load Interstitial Ad\n---------\n\nUse the following code to load an interstitial ad:\n\n```java\npublic void loadInterstitialAd() \n{\n\n ATInterstitialAd.Instance.client.onAdLoadEvent += onAdLoad; \n ATInterstitialAd.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n ATInterstitialAd.Instance.client.onAdShowEvent += onShow;\n ATInterstitialAd.Instance.client.onAdClickEvent += onAdClick;\n ATInterstitialAd.Instance.client.onAdCloseEvent += onAdClose;\n ATInterstitialAd.Instance.client.onAdShowFailureEvent += onAdShowFail; \n ATInterstitialAd.Instance.client.onAdVideoStartEvent += startVideoPlayback;\n ATInterstitialAd.Instance.client.onAdVideoEndEvent += endVideoPlayback;\n ATInterstitialAd.Instance.client.onAdVideoFailureEvent += failVideoPlayback;\n\n Dictionary jsonmap = new Dictionary();\n\n ATInterstitialAd.Instance.loadInterstitialAd(mPlacementId_interstitial_all, jsonmap);\n}\n```\n\n**Note:** See below for how to get notified about interstitial ad events (load success\/failure, impression, click, video start\/end).\n\n**5.** Check If There Is a Cached Ad\n------------\n\n```java\nATInterstitialAd.Instance.hasInterstitialAdReady(mPlacementId_interstitial_all);\n```\n\n**6.** Display Interstitial Ad\n---------\n\nSame as rewarded video, to display an interstitial ad, simply call the show API and pass the ad placement ID as a parameter:\n\n```java\npublic void showInterstitialAd() \n{\n ATInterstitialAd.Instance.showInterstitialAd(mPlacementId_interstitial_all);\n}\n```\n\nWhen using the **scenario** feature:\n\n```java\npublic void showInterstitialAd()\n{\n Dictionary jsonmap = new Dictionary();\n jsonmap.Add(AnyThinkAds.Api.ATConst.SCENARIO, showingScenarioID);\n ATInterstitialAd.Instance.showInterstitialAd(mPlacementId_interstitial_all, jsonmap);\n}\n```\n\n**7. Implement Interstitial Ad Event Listeners (Note: Only supported on V5.951 and above)**\n---------------------------------------\n\nFor callback info details, see: [Callback Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)\n\nUse the following code to implement multiple listeners:\n\n```java\n \/\/ Ad loaded successfully\n ATInterstitialAd.Instance.client.onAdLoadEvent += onAdLoad; \n \/\/ Ad load failed\n ATInterstitialAd.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n \/\/ Ad displayed (can rely on this callback for impression statistics)\n ATInterstitialAd.Instance.client.onAdShowEvent += onShow;\n \/\/ Ad clicked\n ATInterstitialAd.Instance.client.onAdClickEvent += onAdClick;\n \/\/ Ad closed\n ATInterstitialAd.Instance.client.onAdCloseEvent += onAdClose;\n \/\/ Ad display failed\n ATInterstitialAd.Instance.client.onAdShowFailureEvent += onAdShowFail; \n \/\/ Video ad playback started\n ATInterstitialAd.Instance.client.onAdVideoStartEvent += startVideoPlayback;\n \/\/ Video ad playback ended\n ATInterstitialAd.Instance.client.onAdVideoEndEvent += endVideoPlayback;\n \/\/ Video ad playback failed\n ATInterstitialAd.Instance.client.onAdVideoFailureEvent += failVideoPlayback;\n```\n\nAdvanced listener settings:\n\n```java\n \/\/ Ad Source initiated request\n ATInterstitialAd.Instance.client.onAdSourceAttemptEvent += startLoadingADSource;\n \/\/ Ad Source loaded successfully\n ATInterstitialAd.Instance.client.onAdSourceFilledEvent += finishLoadingADSource;\n \/\/ Ad Source load failed\n ATInterstitialAd.Instance.client.onAdSourceLoadFailureEvent += failToLoadADSource;\n \/\/ Ad Source Bidding started\n ATInterstitialAd.Instance.client.onAdSourceBiddingAttemptEvent += startBiddingADSource;\n \/\/ Ad Source Bidding succeeded\n ATInterstitialAd.Instance.client.onAdSourceBiddingFilledEvent += finishBiddingADSource;\n \/\/ Ad Source Bidding failed\n ATInterstitialAd.Instance.client.onAdSourceBiddingFailureEvent += failBiddingADSource;\n```\n\nThe method definition parameters are as follows **(Note: You can refer to the code below for method names or use custom method names, but the parameters must be consistent)**:\n\n```java\n \/\/sender is the ad type object, erg is the returned info\n \/\/ Ad clicked\n public void onAdClick(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdClick :\" + erg.placementId);\n }\n \/\/ Ad closed\n public void onAdClose(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdClose :\" + erg.placementId);\n }\n \/\/ Video ad playback ended, some ad platforms have this callback\n public void endVideoPlayback(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdEndPlayingVideo :\" + erg.placementId);\n }\n \/\/ Video ad playback failed, some ad platforms have this callback\n public void failVideoPlayback(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdFailedToPlayVideo :\" + erg.placementId + \"--code:\" + erg.code + \"--msg:\" + erg.message);\n }\n \/\/ Ad loaded successfully\n public void onAdLoad(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdLoad :\" + erg.placementId);\n }\n \/\/ Ad load failed\n public void onAdLoadFail(object sender,ATAdErrorEventArgs erg )\n {\n Debug.Log(\"Developer callback onInterstitialAdLoadFail :\" + erg.placementId + \"--erg.code:\" + code + \"--msg:\" + erg.message);\n }\n \/\/ Ad displayed successfully\n public void onShow(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdShow :\" +erg. placementId);\n }\n \/\/ Video ad playback started, some ad platforms have this callback\n public void startVideoPlayback(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdStartPlayingVideo :\" + erg.placementId);\n }\n \/\/ Ad display failed\n public void failVideoPlayback(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdFailedToShow :\" + erg.placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer failBiddingADSource------\");\n } \n```\n\n**8. Legacy Interstitial Listener Implementation (Note: Only for use below V5.9.51, deprecated in new versions)**\n---------------------------------------------\n\nYou can implement a class that implements the **ATInterstitialAdListener** interface to get notified about interstitial ad events: **(Note: For Android, all callback methods are not on the Unity main thread)**\n\n```java\nclass InterstitalCallback : ATInterstitialAdListener\n{\n \/\/ Ad clicked\n public void onInterstitialAdClick(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onInterstitialAdClick :\" + placementId);\n }\n \/\/ Ad closed\n public void onInterstitialAdClose(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onInterstitialAdClose :\" + placementId);\n }\n \/\/ Video ad playback ended, some ad platforms have this callback\n public void onInterstitialAdEndPlayingVideo(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onInterstitialAdEndPlayingVideo :\" + placementId);\n }\n \/\/ Video ad playback failed, some ad platforms have this callback\n public void onInterstitialAdFailedToPlayVideo(string placementId, string code, string message)\n {\n Debug.Log(\"Developer callback onInterstitialAdFailedToPlayVideo :\" + placementId + \"--code:\" + code + \"--msg:\" + message);\n }\n \/\/ Ad loaded successfully\n public void onInterstitialAdLoad(string placementId)\n {\n Debug.Log(\"Developer callback onInterstitialAdLoad :\" + placementId);\n }\n \/\/ Ad load failed\n public void onInterstitialAdLoadFail(string placementId, string code, string message)\n {\n Debug.Log(\"Developer callback onInterstitialAdLoadFail :\" + placementId + \"--code:\" + code + \"--msg:\" + message);\n }\n \/\/ Ad displayed successfully\n public void onInterstitialAdShow(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onInterstitialAdShow :\" + placementId);\n }\n \/\/ Video ad playback started, some ad platforms have this callback\n public void onInterstitialAdStartPlayingVideo(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onInterstitialAdStartPlayingVideo :\" + placementId);\n }\n \/\/ Ad display failed\n public void onInterstitialAdFailedToShow(string placementId)\n {\n Debug.Log(\"Developer callback onInterstitialAdFailedToShow :\" + placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failBiddingADSource------\");\n }\n}\n```\n\n**Note:** The code snippets you see in this section are from the **interstitialScenes.cs** [demo project](https:\/\/github.com\/TakuMediation\/Taku_Unity_Demo) in our Demo.","pure_content":"1. Interstitial Ad Introduction\nInterstitial ads aggregate image interstitial ads and video interstitial ads from other third-party ad platforms. Both ad types can be loaded and displayed using the ATAdManager API. Two integration modes are currently supported, as described below:\n\n\n\n Mode (Choose One)\n Description\n\n\n\n\n Manual Request Mode\n You call the ad load API yourself at the appropriate timing. See the integration suggestions below for details.\n\n\n Auto Load Mode\n A one-stop request maintenance solution launched by Taku that automatically determines the preloading and caching timing for the next ad based on user usage status and ad consumption progress, achieving better loading results. See: Interstitial Ad Auto Load Mode for details.\n\n\n\n2. Integration Process Suggestions\n\nCall ATInterstitialAd#loadInterstitialAd to load an ad when the app starts\nUse ATInterstitialAd#hasInterstitialAdReady to check if an ad can be displayed at the location where you want to show it\n\nfalse: Call ATInterstitialAd#loadInterstitialAd again to load an ad\ntrue: Call ATInterstitialAd#showInterstitialAd to display the ad. In the onInterstitialAdClose callback, call ATInterstitialAd#loadInterstitialAd again to preload the next ad (in the onInterstitialAdClose callback, you can call loadInterstitialAd directly without checking hasInterstitialAdReady first, which helps increase the impression volume of higher-priority Ad Sources.)\n\nAd Preloading:\n\nAfter the interstitial ad is displayed, in the onInterstitialAdShow (v5.8.10 and later) or onInterstitialAdClose (before v5.8.10) callback, call ATInterstitialAd#loadInterstitialAd directly for preloading without checking ATInterstitialAd#hasInterstitialAdReady (this helps increase the impression volume of higher-priority Ad Sources).\nYou can refer to Auto Request Ads and enable Auto Request Ads (not needed if the above post-display preloading is already implemented).\n\nIf you need to use ad scenarios to distinguish data for different business scenarios, see the sample code for details.\n\n3. API Description\nATInterstitialAd:\n\n\n\n API\n Parameters\n Description\n\n\n\n\n loadInterstitialAd\n string placementid, Dictionary\n Load an ad\n\n\n setListener\n ATInterstitialAdListener listener\n Set the listener callback interface. (Deprecated after version 5.9.51) For how to set listeners, see: Interstitial Ad Event Settings\n\n\n hasInterstitialAdReady\n string placementid\n Check if there is a cached ad\n\n\n checkAdStatus\n string placementid\n (Added in v5.7.03) Get the current ad placement status (JSON string): 1. isLoading: Whether it is loading 2. isReady: Whether there is a cached ad (same as hasInterstitialAdReady) 3. AdInfo: The highest-priority cached ad info (see ATCallbackInfo Description)\n\n\n getValidAdCaches\n string placementid\n (Added in v5.7.54) Get all successfully loaded cached ad info (JSON string) (see ATCallbackInfo Description)\n\n\n showInterstitialAd\n string placementid, Dictionary\n Display an ad\n\n\n entryScenarioWithPlacementID\n string placementId, string scenarioID\n Set entry into a displayable ad scenario\n\n\n\n4. Load Interstitial Ad\nUse the following code to load an interstitial ad:\npublic void loadInterstitialAd() \n{\n\n ATInterstitialAd.Instance.client.onAdLoadEvent += onAdLoad; \n ATInterstitialAd.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n ATInterstitialAd.Instance.client.onAdShowEvent += onShow;\n ATInterstitialAd.Instance.client.onAdClickEvent += onAdClick;\n ATInterstitialAd.Instance.client.onAdCloseEvent += onAdClose;\n ATInterstitialAd.Instance.client.onAdShowFailureEvent += onAdShowFail; \n ATInterstitialAd.Instance.client.onAdVideoStartEvent += startVideoPlayback;\n ATInterstitialAd.Instance.client.onAdVideoEndEvent += endVideoPlayback;\n ATInterstitialAd.Instance.client.onAdVideoFailureEvent += failVideoPlayback;\n\n Dictionary jsonmap = new Dictionary();\n\n ATInterstitialAd.Instance.loadInterstitialAd(mPlacementId_interstitial_all, jsonmap);\n}\n\nNote: See below for how to get notified about interstitial ad events (load success\/failure, impression, click, video start\/end).\n5. Check If There Is a Cached Ad\nATInterstitialAd.Instance.hasInterstitialAdReady(mPlacementId_interstitial_all);\n\n6. Display Interstitial Ad\nSame as rewarded video, to display an interstitial ad, simply call the show API and pass the ad placement ID as a parameter:\npublic void showInterstitialAd() \n{\n ATInterstitialAd.Instance.showInterstitialAd(mPlacementId_interstitial_all);\n}\n\nWhen using the scenario feature:\npublic void showInterstitialAd()\n{\n Dictionary jsonmap = new Dictionary();\n jsonmap.Add(AnyThinkAds.Api.ATConst.SCENARIO, showingScenarioID);\n ATInterstitialAd.Instance.showInterstitialAd(mPlacementId_interstitial_all, jsonmap);\n}\n\n7. Implement Interstitial Ad Event Listeners (Note: Only supported on V5.951 and above)\nFor callback info details, see: Callback Info Description\nUse the following code to implement multiple listeners:\n \/\/ Ad loaded successfully\n ATInterstitialAd.Instance.client.onAdLoadEvent += onAdLoad; \n \/\/ Ad load failed\n ATInterstitialAd.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n \/\/ Ad displayed (can rely on this callback for impression statistics)\n ATInterstitialAd.Instance.client.onAdShowEvent += onShow;\n \/\/ Ad clicked\n ATInterstitialAd.Instance.client.onAdClickEvent += onAdClick;\n \/\/ Ad closed\n ATInterstitialAd.Instance.client.onAdCloseEvent += onAdClose;\n \/\/ Ad display failed\n ATInterstitialAd.Instance.client.onAdShowFailureEvent += onAdShowFail; \n \/\/ Video ad playback started\n ATInterstitialAd.Instance.client.onAdVideoStartEvent += startVideoPlayback;\n \/\/ Video ad playback ended\n ATInterstitialAd.Instance.client.onAdVideoEndEvent += endVideoPlayback;\n \/\/ Video ad playback failed\n ATInterstitialAd.Instance.client.onAdVideoFailureEvent += failVideoPlayback;\n\nAdvanced listener settings:\n \/\/ Ad Source initiated request\n ATInterstitialAd.Instance.client.onAdSourceAttemptEvent += startLoadingADSource;\n \/\/ Ad Source loaded successfully\n ATInterstitialAd.Instance.client.onAdSourceFilledEvent += finishLoadingADSource;\n \/\/ Ad Source load failed\n ATInterstitialAd.Instance.client.onAdSourceLoadFailureEvent += failToLoadADSource;\n \/\/ Ad Source Bidding started\n ATInterstitialAd.Instance.client.onAdSourceBiddingAttemptEvent += startBiddingADSource;\n \/\/ Ad Source Bidding succeeded\n ATInterstitialAd.Instance.client.onAdSourceBiddingFilledEvent += finishBiddingADSource;\n \/\/ Ad Source Bidding failed\n ATInterstitialAd.Instance.client.onAdSourceBiddingFailureEvent += failBiddingADSource;\n\nThe method definition parameters are as follows (Note: You can refer to the code below for method names or use custom method names, but the parameters must be consistent):\n \/\/sender is the ad type object, erg is the returned info\n \/\/ Ad clicked\n public void onAdClick(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdClick :\" + erg.placementId);\n }\n \/\/ Ad closed\n public void onAdClose(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdClose :\" + erg.placementId);\n }\n \/\/ Video ad playback ended, some ad platforms have this callback\n public void endVideoPlayback(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdEndPlayingVideo :\" + erg.placementId);\n }\n \/\/ Video ad playback failed, some ad platforms have this callback\n public void failVideoPlayback(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdFailedToPlayVideo :\" + erg.placementId + \"--code:\" + erg.code + \"--msg:\" + erg.message);\n }\n \/\/ Ad loaded successfully\n public void onAdLoad(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdLoad :\" + erg.placementId);\n }\n \/\/ Ad load failed\n public void onAdLoadFail(object sender,ATAdErrorEventArgs erg )\n {\n Debug.Log(\"Developer callback onInterstitialAdLoadFail :\" + erg.placementId + \"--erg.code:\" + code + \"--msg:\" + erg.message);\n }\n \/\/ Ad displayed successfully\n public void onShow(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdShow :\" +erg. placementId);\n }\n \/\/ Video ad playback started, some ad platforms have this callback\n public void startVideoPlayback(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdStartPlayingVideo :\" + erg.placementId);\n }\n \/\/ Ad display failed\n public void failVideoPlayback(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onInterstitialAdFailedToShow :\" + erg.placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer failBiddingADSource------\");\n } \n\n8. Legacy Interstitial Listener Implementation (Note: Only for use below V5.9.51, deprecated in new versions)\nYou can implement a class that implements the ATInterstitialAdListener interface to get notified about interstitial ad events: (Note: For Android, all callback methods are not on the Unity main thread)\nclass InterstitalCallback : ATInterstitialAdListener\n{\n \/\/ Ad clicked\n public void onInterstitialAdClick(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onInterstitialAdClick :\" + placementId);\n }\n \/\/ Ad closed\n public void onInterstitialAdClose(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onInterstitialAdClose :\" + placementId);\n }\n \/\/ Video ad playback ended, some ad platforms have this callback\n public void onInterstitialAdEndPlayingVideo(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onInterstitialAdEndPlayingVideo :\" + placementId);\n }\n \/\/ Video ad playback failed, some ad platforms have this callback\n public void onInterstitialAdFailedToPlayVideo(string placementId, string code, string message)\n {\n Debug.Log(\"Developer callback onInterstitialAdFailedToPlayVideo :\" + placementId + \"--code:\" + code + \"--msg:\" + message);\n }\n \/\/ Ad loaded successfully\n public void onInterstitialAdLoad(string placementId)\n {\n Debug.Log(\"Developer callback onInterstitialAdLoad :\" + placementId);\n }\n \/\/ Ad load failed\n public void onInterstitialAdLoadFail(string placementId, string code, string message)\n {\n Debug.Log(\"Developer callback onInterstitialAdLoadFail :\" + placementId + \"--code:\" + code + \"--msg:\" + message);\n }\n \/\/ Ad displayed successfully\n public void onInterstitialAdShow(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onInterstitialAdShow :\" + placementId);\n }\n \/\/ Video ad playback started, some ad platforms have this callback\n public void onInterstitialAdStartPlayingVideo(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onInterstitialAdStartPlayingVideo :\" + placementId);\n }\n \/\/ Ad display failed\n public void onInterstitialAdFailedToShow(string placementId)\n {\n Debug.Log(\"Developer callback onInterstitialAdFailedToShow :\" + placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failBiddingADSource------\");\n }\n}\n\nNote: The code snippets you see in this section are from the interstitialScenes.cs demo project in our Demo.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1709721638","update_time":"1782971343"},"pure_content":"1. Interstitial Ad Introduction\nInterstitial ads aggregate image interstitial ads and video interstitial ads from other third-party ad platforms. Both ad types can be loaded and displayed using the AT"},{"id":"76338","string_id":"n4LnrS","status":"1","parent_id":"76330","slug":"Banner-advertising-integration-instructions","order":"15","name":"Banner Ad","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722565","add_time":"1709721639","update_time":"1783492326","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76338","content":"**1**. Integration Process Suggestions\n---------\n\n1. Call ATBannerAd#loadBannerAd to load an ad when the app starts\n2. When the ad loads successfully and is displayed for the first time, call ATBannerAd#showBannerAd(string placementid, string position) to display the ad\n3. If you need to hide the ad, call ATBannerAd#hideBannerAd; to re-display after hiding, call ATBannerAd#showBannerAd(string placementid)\n4. You can configure the refresh interval in the Taku dashboard under Ad Placement > Advanced Settings to enable the auto-refresh feature\n\n**2.** API Description\n--------\n\nATBannerAd:\n\n| API | Parameters | Description |\n|---|---|---|\n| loadBannerAd | string placementid, Dictionary | Load an ad |\n| setListener | ATBannerAdListener listener | Set the listener callback interface. **(Deprecated after version 5.9.51)** For how to set listeners, see: [Banner Ad Event Settings](https:\/\/help.takuad.com\/en\/docs\/Banner-advertising-integration-instructions#5.%20Implement%20Banner%20Event%20Listeners%20(Note:%20Only%20supported%20on%20V5.951%20and%20above)) |\n| showBannerAd | string placementid, string position | Display ad for the first time position: ATBannerAdLoadingExtra.kATBannerAdShowingPisitionTop (display at the top of the screen) ATBannerAdLoadingExtra.kATBannerAdShowingPisitionBottom (display at the bottom of the screen) |\n| checkAdStatus | string placementid | **(Added in v5.7.22)** Get the current ad placement status (JSON string): 1. isLoading: Whether it is loading 2. isReady: Whether there is a cached ad (same as hasAdReady) 3. AdInfo: The highest-priority cached ad info (see [ATCallbackInfo Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)) |\n| getValidAdCaches | string placementid | **(Added in v5.7.54)** Get all successfully loaded cached ad info (JSON string) (see [ATCallbackInfo Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)) |\n| hideBannerAd | string placementid | Hide the ad |\n| showBannerAd | string placementid | Display a previously hidden ad |\n| cleanBannerAd | string placementid | Remove the ad |\n\n**3**. Load Banner Ad\n-------------\n\nUse the following code to load a Banner ad:\n\n```java\npublic void loadBannerAd()\n{\n ATBannerAd.Instance.client.onAdLoadEvent += onAdLoad; ATBannerAd.Instance.client.onAdLoadFailureEvent +=onAdLoadFail;\n ATBannerAd.Instance.client.onAdImpressEvent += onAdImpress;\n ATBannerAd.Instance.client.onAdAutoRefreshEvent += onAdAutoRefresh;\n ATBannerAd.Instance.client.onAdAutoRefreshFailureEvent += onAdAutoRefreshFail;\n ATBannerAd.Instance.client.onAdClickEvent += onAdClick;\n ATBannerAd.Instance.client.onAdCloseEvent += onAdCloseButtonTapped; \n\n Dictionary jsonmap = new Dictionary();\n \/\/Configure the width, height, and whether to use pixel units for Banner display (only valid for iOS; Android uses pixel units). Note that banner ads on different platforms have certain restrictions. For example, if the configured Pangle banner ad is 640*100, to fill the screen width, calculate height H = (screen width *100)\/640; then the size in the load extra would be (screen width: H).\n ATSize bannerSize = new ATSize(this.screenWidth, 100, true);\n jsonmap.Add(ATBannerAdLoadingExtra.kATBannerAdLoadingExtraBannerAdSizeStruct, bannerSize);\n\n \/\/ Added in v5.6.5, only for Admob adaptive Banner\n jsonmap.Add(ATBannerAdLoadingExtra.kATBannerAdLoadingExtraInlineAdaptiveWidth, bannerSize.width);\n jsonmap.Add(ATBannerAdLoadingExtra.kATBannerAdLoadingExtraInlineAdaptiveOrientation, ATBannerAdLoadingExtra.kATBannerAdLoadingExtraInlineAdaptiveOrientationCurrent);\n\n ATBannerAd.Instance.loadBannerAd(mPlacementId_native_all, jsonmap);\n}\n```\n\nPlease continue reading to learn how to get notified about Banner ad events, such as load success\/failure, impression, and click.\n\n**4.** Display Banner Ad\n-------------\n\nThere are currently two methods to display banner ads.\n\n### 4.1 Display Banner Ads at Predefined Positions\n\n1) Display the banner at the top of the screen\n\n```java\nATBannerAd.Instance.showBannerAd(mPlacementId_native_all, ATBannerAdLoadingExtra.kATBannerAdShowingPisitionTop);\n```\n\n2) Display the banner at the bottom of the screen\n\n```java\nATBannerAd.Instance.showBannerAd(mPlacementId_native_all, ATBannerAdLoadingExtra.kATBannerAdShowingPisitionBottom);\n```\n\nWhen using predefined positions to display banner ads, AnyThinkSDK has already accounted for Safe Area-related blank areas such as the notch.\n\n### 4.2 Display Banner Ads with ATRect\n\n```java\npublic void showBannerAd() \n{\n \/\/ Please keep the width and height consistent with the size passed during ad loading, and set the x and y coordinates as needed.\n ATRect arpuRect = new ATRect(0,70, screenWidth, 100, true);\n ATBannerAd.Instance.showBannerAd(mPlacementId_native_all, arpuRect);\n}\n```\n\nThe trailing parameter passed to the constructor of the ATRect class indicates whether to use pixel units **(only valid for iOS)**. For example, on iPhone 6, if you pass 30, 120, 300, 450 for x, y, width, and height respectively, the actual values passed to the Objective-C code on iPhone 7 will be 15, 60, 150, 225, and on another device, these values will be 10, 40, 100, 150. In other words, the final values will be determined by the screen scale of the target device.\n\nWhen using the **scenario** feature:\n\n```java\npublic void showBannerAd()\n{\n Dictionary jsonmap = new Dictionary();\n jsonmap.Add(AnyThinkAds.Api.ATConst.SCENARIO, showingScenarioID);\n ATBannerAd.Instance.showBannerAd(mPlacementId_banner_all, ATBannerAdLoadingExtra.kATBannerAdShowingPisitionBottom, jsonmap);\n \/\/ATBannerAd.Instance.showBannerAd(mPlacementId_native_all, arpuRect, jsonmap);\n}\n```\n\nIf needed, use the following code to **remove** the Banner from the screen:\n\n```java\npublic void removeBannerAd() \n{\n ATBannerAd.Instance.cleanBannerAd(mPlacementId_native_all);\n}\n```\n\nIf you only want to **temporarily hide** the Banner (rather than **remove it from the screen**), use the code here:\n\n```java\npublic void hideBannerAd() \n{\n ATBannerAd.Instance.hideBannerAd(mPlacementId_native_all);\n}\n```\n\nAfter hiding the Banner, you can re-display it using the following code:\n\n```java\npublic void reshowBannerAd()\n{\n ATBannerAd.Instance.showBannerAd(mPlacementId_native_all);\n}\n```\n\n**Note:** Please note that the showBannerAd method here does not accept a rect parameter, unlike when you first display the Banner ad.\n\nThe difference between removing a Banner ad and hiding a Banner ad is that removing the Banner ad from the screen also destroys it (meaning you will need to load the Banner ad again before displaying it), while hiding the Banner only requires calling the showBannerAd method to re-display the previously hidden Banner ad **without passing the ATRect parameter**.\n\n**5. Implement Banner Event Listeners (Note: Only supported on V5.951 and above)**\n---------------------------------------\n\nFor callback info details, see: [Callback Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)\n\nUse the following code to implement multiple listeners:\n\n```java\n \/\/ Ad loaded successfully\n ATBannerAd.Instance.client.onAdLoadEvent += onAdLoad;\n \/\/ Ad load failed\n ATBannerAd.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n \/\/ Ad displayed successfully\n ATBannerAd.Instance.client.onAdImpressEvent += onAdImpress;\n \/\/ Ad auto-refresh succeeded\n ATBannerAd.Instance.client.onAdAutoRefreshEvent += onAdAutoRefresh;\n \/\/ Ad auto-refresh failed\n ATBannerAd.Instance.client.onAdAutoRefreshFailureEvent += onAdAutoRefreshFail;\n \/\/ Ad clicked\n ATBannerAd.Instance.client.onAdClickEvent += onAdClick;\n \/\/ Ad closed\n ATBannerAd.Instance.client.onAdCloseEvent += onAdCloseButtonTapped; \n\n```\n\nAdvanced listener settings:\n\n```java\n \/\/ Ad Source started loading\n ATBannerAd.Instance.client.onAdSourceAttemptEvent += startLoadingADSource;\n \/\/ Ad Source loading completed\n ATBannerAd.Instance.client.onAdSourceFilledEvent += finishLoadingADSource;\n \/\/ Ad Source load failed\n ATBannerAd.Instance.client.onAdSourceLoadFailureEvent += failToLoadADSource;\n \/\/ Ad Source started bidding\n ATBannerAd.Instance.client.onAdSourceBiddingAttemptEvent += startBiddingADSource;\n \/\/ Ad Source bidding succeeded\n ATBannerAd.Instance.client.onAdSourceBiddingFilledEvent += finishBiddingADSource;\n \/\/ Ad Source bidding failed\n ATBannerAd.Instance.client.onAdSourceBiddingFailureEvent += failBiddingADSource;\n```\n\nThe method definition parameters are as follows **(Note: You can refer to the code below for method names or use custom method names, but the parameters must be consistent)**:\n\n```java\n \/\/sender is the ad type object, erg is the returned info\n \/\/ Load ad\n \/\/ Ad auto-refresh succeeded\n public void onAdAutoRefresh(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdAutoRefresh :\" + erg.placementId );\n }\n \/\/ Ad auto-refresh failed\n public void onAdAutoRefreshFail(object sender,ATAdErrorEventArgs erg )\n {\n Debug.Log(\"Developer callback onAdAutoRefreshFail : \"+ erg.placementId );\n }\n \/\/ Ad clicked\n public void onAdClick(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdClick :\" + erg.placementId);\n }\n\n \/\/ Ad displayed successfully\n public void onAdImpress(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdImpress :\" + erg.placementId);\n }\n \/\/ Ad loaded successfully\n public void onAdLoad(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdLoad :\" + erg.placementId);\n }\n \/\/ Ad load failed\n public void onAdLoadFail(object sender,ATAdErrorEventArgs erg )\n {\n Debug.Log(\"Developer callback onAdLoadFail : : \" + erg.placementId + \"--code:\" + erg.code + \"--msg:\" + erg.message);\n }\n \/\/ Ad close button tapped\n public void onAdCloseButtonTapped(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdCloseButtonTapped :\" + erg.placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer failBiddingADSource------\");\n }\n```\n\n**6. Legacy Banner Listener Implementation (Note: Only for use below V5.9.51, deprecated in new versions)**\n-------------------------------------------------\n\nTo get notified about various Banner ad events (load success\/failure, impression, and click), simply define an implementation class of the **ATBannerAdListener** interface: **(Note: For Android, all callback methods are not on the Unity main thread)**\n\n```java\nclass BannerCallback : ATBannerAdListener\n{\n \/\/ Ad auto-refresh succeeded\n public void onAdAutoRefresh(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onAdAutoRefresh :\" + placementId);\n }\n \/\/ Ad auto-refresh failed\n public void onAdAutoRefreshFail(string placementId, string code, string message)\n {\n Debug.Log(\"Developer callback onAdAutoRefreshFail : \"+ placementId + \"--code:\" + code + \"--msg:\" + message);\n }\n \/\/ Ad clicked\n public void onAdClick(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onAdClick :\" + placementId);\n }\n\n \/\/ This callback is no longer executed after v5.5.3; it has been moved to the onAdCloseButtonTapped method callback\n public void onAdClose(string placementId)\n {\n Debug.Log(\"Developer callback onAdClose :\" + placementId);\n }\n \/\/ Ad displayed successfully\n public void onAdImpress(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onAdImpress :\" + placementId);\n }\n \/\/ Ad loaded successfully\n public void onAdLoad(string placementId)\n {\n Debug.Log(\"Developer callback onAdLoad :\" + placementId);\n }\n \/\/ Ad load failed\n public void onAdLoadFail(string placementId, string code, string message)\n {\n Debug.Log(\"Developer callback onAdLoadFail : : \" + placementId + \"--code:\" + code + \"--msg:\" + message);\n }\n \/\/ Ad close button tapped\n public void onAdCloseButtonTapped(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onAdCloseButtonTapped :\" + placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failBiddingADSource------\");\n }\n}\n```\n\n**Note:** The code snippets you see in this section are from the **bannerScene.cs** [demo project](https:\/\/github.com\/TakuMediation\/Taku_Unity_Demo) in our Demo.","pure_content":"1. Integration Process Suggestions\n\nCall ATBannerAd#loadBannerAd to load an ad when the app starts\nWhen the ad loads successfully and is displayed for the first time, call ATBannerAd#showBannerAd(string placementid, string position) to display the ad\nIf you need to hide the ad, call ATBannerAd#hideBannerAd; to re-display after hiding, call ATBannerAd#showBannerAd(string placementid)\nYou can configure the refresh interval in the Taku dashboard under Ad Placement > Advanced Settings to enable the auto-refresh feature\n\n2. API Description\nATBannerAd:\n\n\n\n API\n Parameters\n Description\n\n\n\n\n loadBannerAd\n string placementid, Dictionary\n Load an ad\n\n\n setListener\n ATBannerAdListener listener\n Set the listener callback interface. (Deprecated after version 5.9.51) For how to set listeners, see: Banner Ad Event Settings\n\n\n showBannerAd\n string placementid, string position\n Display ad for the first time position: ATBannerAdLoadingExtra.kATBannerAdShowingPisitionTop (display at the top of the screen) ATBannerAdLoadingExtra.kATBannerAdShowingPisitionBottom (display at the bottom of the screen)\n\n\n checkAdStatus\n string placementid\n (Added in v5.7.22) Get the current ad placement status (JSON string): 1. isLoading: Whether it is loading 2. isReady: Whether there is a cached ad (same as hasAdReady) 3. AdInfo: The highest-priority cached ad info (see ATCallbackInfo Description)\n\n\n getValidAdCaches\n string placementid\n (Added in v5.7.54) Get all successfully loaded cached ad info (JSON string) (see ATCallbackInfo Description)\n\n\n hideBannerAd\n string placementid\n Hide the ad\n\n\n showBannerAd\n string placementid\n Display a previously hidden ad\n\n\n cleanBannerAd\n string placementid\n Remove the ad\n\n\n\n3. Load Banner Ad\nUse the following code to load a Banner ad:\npublic void loadBannerAd()\n{\n ATBannerAd.Instance.client.onAdLoadEvent += onAdLoad; ATBannerAd.Instance.client.onAdLoadFailureEvent +=onAdLoadFail;\n ATBannerAd.Instance.client.onAdImpressEvent += onAdImpress;\n ATBannerAd.Instance.client.onAdAutoRefreshEvent += onAdAutoRefresh;\n ATBannerAd.Instance.client.onAdAutoRefreshFailureEvent += onAdAutoRefreshFail;\n ATBannerAd.Instance.client.onAdClickEvent += onAdClick;\n ATBannerAd.Instance.client.onAdCloseEvent += onAdCloseButtonTapped; \n\n Dictionary jsonmap = new Dictionary();\n \/\/Configure the width, height, and whether to use pixel units for Banner display (only valid for iOS; Android uses pixel units). Note that banner ads on different platforms have certain restrictions. For example, if the configured Pangle banner ad is 640*100, to fill the screen width, calculate height H = (screen width *100)\/640; then the size in the load extra would be (screen width: H).\n ATSize bannerSize = new ATSize(this.screenWidth, 100, true);\n jsonmap.Add(ATBannerAdLoadingExtra.kATBannerAdLoadingExtraBannerAdSizeStruct, bannerSize);\n\n \/\/ Added in v5.6.5, only for Admob adaptive Banner\n jsonmap.Add(ATBannerAdLoadingExtra.kATBannerAdLoadingExtraInlineAdaptiveWidth, bannerSize.width);\n jsonmap.Add(ATBannerAdLoadingExtra.kATBannerAdLoadingExtraInlineAdaptiveOrientation, ATBannerAdLoadingExtra.kATBannerAdLoadingExtraInlineAdaptiveOrientationCurrent);\n\n ATBannerAd.Instance.loadBannerAd(mPlacementId_native_all, jsonmap);\n}\n\nPlease continue reading to learn how to get notified about Banner ad events, such as load success\/failure, impression, and click.\n4. Display Banner Ad\nThere are currently two methods to display banner ads.\n4.1 Display Banner Ads at Predefined Positions\n\nDisplay the banner at the top of the screen\n\nATBannerAd.Instance.showBannerAd(mPlacementId_native_all, ATBannerAdLoadingExtra.kATBannerAdShowingPisitionTop);\n\n\nDisplay the banner at the bottom of the screen\n\nATBannerAd.Instance.showBannerAd(mPlacementId_native_all, ATBannerAdLoadingExtra.kATBannerAdShowingPisitionBottom);\n\nWhen using predefined positions to display banner ads, AnyThinkSDK has already accounted for Safe Area-related blank areas such as the notch.\n4.2 Display Banner Ads with ATRect\npublic void showBannerAd() \n{\n \/\/ Please keep the width and height consistent with the size passed during ad loading, and set the x and y coordinates as needed.\n ATRect arpuRect = new ATRect(0,70, screenWidth, 100, true);\n ATBannerAd.Instance.showBannerAd(mPlacementId_native_all, arpuRect);\n}\n\nThe trailing parameter passed to the constructor of the ATRect class indicates whether to use pixel units (only valid for iOS). For example, on iPhone 6, if you pass 30, 120, 300, 450 for x, y, width, and height respectively, the actual values passed to the Objective-C code on iPhone 7 will be 15, 60, 150, 225, and on another device, these values will be 10, 40, 100, 150. In other words, the final values will be determined by the screen scale of the target device.\nWhen using the scenario feature:\npublic void showBannerAd()\n{\n Dictionary jsonmap = new Dictionary();\n jsonmap.Add(AnyThinkAds.Api.ATConst.SCENARIO, showingScenarioID);\n ATBannerAd.Instance.showBannerAd(mPlacementId_banner_all, ATBannerAdLoadingExtra.kATBannerAdShowingPisitionBottom, jsonmap);\n \/\/ATBannerAd.Instance.showBannerAd(mPlacementId_native_all, arpuRect, jsonmap);\n}\n\nIf needed, use the following code to remove the Banner from the screen:\npublic void removeBannerAd() \n{\n ATBannerAd.Instance.cleanBannerAd(mPlacementId_native_all);\n}\n\nIf you only want to temporarily hide the Banner (rather than remove it from the screen), use the code here:\npublic void hideBannerAd() \n{\n ATBannerAd.Instance.hideBannerAd(mPlacementId_native_all);\n}\n\nAfter hiding the Banner, you can re-display it using the following code:\npublic void reshowBannerAd()\n{\n ATBannerAd.Instance.showBannerAd(mPlacementId_native_all);\n}\n\nNote: Please note that the showBannerAd method here does not accept a rect parameter, unlike when you first display the Banner ad.\nThe difference between removing a Banner ad and hiding a Banner ad is that removing the Banner ad from the screen also destroys it (meaning you will need to load the Banner ad again before displaying it), while hiding the Banner only requires calling the showBannerAd method to re-display the previously hidden Banner ad without passing the ATRect parameter.\n5. Implement Banner Event Listeners (Note: Only supported on V5.951 and above)\nFor callback info details, see: Callback Info Description\nUse the following code to implement multiple listeners:\n \/\/ Ad loaded successfully\n ATBannerAd.Instance.client.onAdLoadEvent += onAdLoad;\n \/\/ Ad load failed\n ATBannerAd.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n \/\/ Ad displayed successfully\n ATBannerAd.Instance.client.onAdImpressEvent += onAdImpress;\n \/\/ Ad auto-refresh succeeded\n ATBannerAd.Instance.client.onAdAutoRefreshEvent += onAdAutoRefresh;\n \/\/ Ad auto-refresh failed\n ATBannerAd.Instance.client.onAdAutoRefreshFailureEvent += onAdAutoRefreshFail;\n \/\/ Ad clicked\n ATBannerAd.Instance.client.onAdClickEvent += onAdClick;\n \/\/ Ad closed\n ATBannerAd.Instance.client.onAdCloseEvent += onAdCloseButtonTapped; \n\n\nAdvanced listener settings:\n \/\/ Ad Source started loading\n ATBannerAd.Instance.client.onAdSourceAttemptEvent += startLoadingADSource;\n \/\/ Ad Source loading completed\n ATBannerAd.Instance.client.onAdSourceFilledEvent += finishLoadingADSource;\n \/\/ Ad Source load failed\n ATBannerAd.Instance.client.onAdSourceLoadFailureEvent += failToLoadADSource;\n \/\/ Ad Source started bidding\n ATBannerAd.Instance.client.onAdSourceBiddingAttemptEvent += startBiddingADSource;\n \/\/ Ad Source bidding succeeded\n ATBannerAd.Instance.client.onAdSourceBiddingFilledEvent += finishBiddingADSource;\n \/\/ Ad Source bidding failed\n ATBannerAd.Instance.client.onAdSourceBiddingFailureEvent += failBiddingADSource;\n\nThe method definition parameters are as follows (Note: You can refer to the code below for method names or use custom method names, but the parameters must be consistent):\n \/\/sender is the ad type object, erg is the returned info\n \/\/ Load ad\n \/\/ Ad auto-refresh succeeded\n public void onAdAutoRefresh(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdAutoRefresh :\" + erg.placementId );\n }\n \/\/ Ad auto-refresh failed\n public void onAdAutoRefreshFail(object sender,ATAdErrorEventArgs erg )\n {\n Debug.Log(\"Developer callback onAdAutoRefreshFail : \"+ erg.placementId );\n }\n \/\/ Ad clicked\n public void onAdClick(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdClick :\" + erg.placementId);\n }\n\n \/\/ Ad displayed successfully\n public void onAdImpress(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdImpress :\" + erg.placementId);\n }\n \/\/ Ad loaded successfully\n public void onAdLoad(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdLoad :\" + erg.placementId);\n }\n \/\/ Ad load failed\n public void onAdLoadFail(object sender,ATAdErrorEventArgs erg )\n {\n Debug.Log(\"Developer callback onAdLoadFail : : \" + erg.placementId + \"--code:\" + erg.code + \"--msg:\" + erg.message);\n }\n \/\/ Ad close button tapped\n public void onAdCloseButtonTapped(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer callback onAdCloseButtonTapped :\" + erg.placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer failBiddingADSource------\");\n }\n\n6. Legacy Banner Listener Implementation (Note: Only for use below V5.9.51, deprecated in new versions)\nTo get notified about various Banner ad events (load success\/failure, impression, and click), simply define an implementation class of the ATBannerAdListener interface: (Note: For Android, all callback methods are not on the Unity main thread)\nclass BannerCallback : ATBannerAdListener\n{\n \/\/ Ad auto-refresh succeeded\n public void onAdAutoRefresh(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onAdAutoRefresh :\" + placementId);\n }\n \/\/ Ad auto-refresh failed\n public void onAdAutoRefreshFail(string placementId, string code, string message)\n {\n Debug.Log(\"Developer callback onAdAutoRefreshFail : \"+ placementId + \"--code:\" + code + \"--msg:\" + message);\n }\n \/\/ Ad clicked\n public void onAdClick(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onAdClick :\" + placementId);\n }\n\n \/\/ This callback is no longer executed after v5.5.3; it has been moved to the onAdCloseButtonTapped method callback\n public void onAdClose(string placementId)\n {\n Debug.Log(\"Developer callback onAdClose :\" + placementId);\n }\n \/\/ Ad displayed successfully\n public void onAdImpress(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onAdImpress :\" + placementId);\n }\n \/\/ Ad loaded successfully\n public void onAdLoad(string placementId)\n {\n Debug.Log(\"Developer callback onAdLoad :\" + placementId);\n }\n \/\/ Ad load failed\n public void onAdLoadFail(string placementId, string code, string message)\n {\n Debug.Log(\"Developer callback onAdLoadFail : : \" + placementId + \"--code:\" + code + \"--msg:\" + message);\n }\n \/\/ Ad close button tapped\n public void onAdCloseButtonTapped(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer callback onAdCloseButtonTapped :\" + placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failBiddingADSource------\");\n }\n}\n\nNote: The code snippets you see in this section are from the bannerScene.cs demo project in our Demo.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1709721640","update_time":"1782971840"},"pure_content":"1. Integration Process Suggestions\n\nCall ATBannerAd#loadBannerAd to load an ad when the app starts\nWhen the ad loads successfully and is displayed for the first time, call ATBannerAd#showBannerAd(stri"},{"id":"76339","string_id":"UxNGx8","status":"1","parent_id":"76330","slug":"Native-Ads-Integration-Instructions","order":"14","name":"Native","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722566","add_time":"1709721641","update_time":"1783492326","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76339","content":"**Note for Android:** \nCurrently, using Unity to directly build an Android APK cannot display native video ads, because Unity's default APK packaging disables hardware acceleration for the game Activity, making it impossible to display videos. If you need to display native ad videos, you must use the export project method, as follows:\n\n**(1) Select Export Project mode to export the Android project** ![](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/apanR8\/65e8433f6e777.)\n\n**(2) Modify the property in AndroidManifest, setting the hardwareAccelerated property as shown in the image to true** ![](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/apanR8\/65e8433fccc1c.)\n\n**After completing the above steps, use the current Android project for packaging.**\n\n**1**. Integration Process Suggestions\n---------\n\n1. Call ATNativeAd#loadNativeAd to load an ad when the app starts\n2. Use ATNativeAd#hasAdReady to check if an ad can be displayed at the location where you want to show it\n3. If you need to use [ad scenarios](https:\/\/help.takuad.com\/en\/docs\/zUl0fvpD) to distinguish data for different business scenarios, see the sample code for details\n\n**2**. API Description\n--------\n\nATNativeAd:\n\n| API | Parameters | Description |\n|---|---|---|\n| loadNativeAd | string placementid, Dictionary<string,string> extra | Load an ad **(Starting from v5.6.8, for Pangle template rendering, Mintegral auto-rendering ads, etc., you must pass width and height via the extra parameter, otherwise the ad size may display abnormally)** |\n| setListener | ATNativeAdListener listener | Set the listener callback interface. **(Deprecated after version 5.9.51)** For how to set listeners, see: [Native Ad Event Settings](https:\/\/help.takuad.com\/en\/docs\/Native-Ads-Integration-Instructions#6.%20Implement%20Native%20Ad%20Listeners%20(Note:%20Only%20supported%20on%20V5.9.51%20and%20above)) |\n| hasAdReady | string placementid | Check if there is a cached ad |\n| checkAdStatus | string placementid | **(Added in v5.7.22)** Get the current ad placement status (JSON string): 1. isLoading: Whether it is loading 2. isReady: Whether there is a cached ad (same as hasAdReady) 3. AdInfo: The highest-priority cached ad info (see [ATCallbackInfo Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)) |\n| getValidAdCaches | string placementid | **(Added in v5.7.54)** Get all successfully loaded cached ad info (JSON string) (see [ATCallbackInfo Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)) |\n| renderAdToScene | string placementid, ATNativeAdView anyThinkNativeAdView | Display an ad |\n| entryScenarioWithPlacementID | string placementId, string scenarioID | Set entry into a displayable ad scenario |\n\n**3**. Load Native Ad\n---------\n\nYou can use the following code to load a native ad:\n\n```java\npublic void loadNative() \n{\n Debug.Log (\"Developer load native, unit id = \" + mPlacementId_native_all);\n ATNativeAd.Instance.client.onAdLoadEvent += onAdLoad;\n ATNativeAd.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n ATNativeAd.Instance.client.onAdImpressEvent += onAdImpressed;\n ATNativeAd.Instance.client.onAdClickEvent += onAdClick;\n ATNativeAd.Instance.client.onAdCloseEvent += onAdClose;\n ATNativeAd.Instance.client.onAdVideoStartEvent += onAdVideoStart;\n ATNativeAd.Instance.client.onAdVideoEndEvent += onAdVideoEnd;\n ATNativeAd.Instance.client.onAdVideoProgressEvent += onAdVideoProgress;\n\n \/\/----- v5.6.8 and above -----\n Dictionary jsonmap = new Dictionary();\n\n #if UNITY_ANDROID\n ATSize nativeSize = new ATSize(width, height);\n jsonmap.Add(ATNativeAdLoadingExtra.kATNativeAdLoadingExtraNativeAdSizeStruct, nativeSize);\n #elif UNITY_IOS || UNITY_IPHONE\n ATSize nativeSize = new ATSize(width, height, false);\n jsonmap.Add(ATNativeAdLoadingExtra.kATNativeAdLoadingExtraNativeAdSizeStruct, nativeSize);\n\n ATNativeAd.Instance.loadNativeAd(mPlacementId_native_all, jsonmap);\n}\n```\n\n**Note:** Please continue reading to learn how to get notified on load success\/failure events.\n\n**4.** Check If There Is a Cached Ad\n------------\n\n```java\nATNativeAd.Instance.hasAdReady(mPlacementId_native_all);\n```\n\n[5. Display Native Ad](https:\/\/docs.toponad.com\/#\/zh-cn\/unity\/unity_doc\/unity_access_native_doc?id=_5-%e5%b1%95%e7%a4%ba%e5%8e%9f%e7%94%9f%e5%b9%bf%e5%91%8a)\n--------------------------------------------------------------------------------------------------------------------------------------------------\n\nYou can use the following code to display a native ad:\n\n```java\npublic void showNative()\n{\n Debug.Log (\"Developer show native....\");\n ATNativeConfig conifg = new ATNativeConfig ();\n\n string bgcolor = \"#ffffff\";\n string textcolor = \"#000000\";\n int rootbasex = 100, rootbasey = 100;\n\n int x = rootbasex,y = rootbasey,width = 300*3,height = 200*3,textsize = 17;\n conifg.parentProperty = new ATNativeItemProperty(x,y,width,height,bgcolor,textcolor,textsize, true);\n\n \/\/adlogo \n x = 0*3;y = 0*3;width = 30*3;height = 20*3;textsize = 17;\n conifg.adLogoProperty = new ATNativeItemProperty(x,y,width,height,bgcolor,textcolor,textsize, true);\n\n \/\/adicon\n x = 0*3;y = 50*3-50;width = 60*3;height = 50*3;textsize = 17;\n conifg.appIconProperty = new ATNativeItemProperty(x,y,width,height,bgcolor,textcolor,textsize, true);\n\n \/\/ad cta \n x = 0*3;y = 150*3;width = 300*3;height = 50*3;textsize = 17;\n conifg.ctaButtonProperty = new ATNativeItemProperty(x,y,width,height,\"#ff21bcab\",\"#ffffff\",textsize, true);\n\n \/\/ad desc\n x = 60*3;y = 100*3;width = 240*3-20;height = 50*3-10;textsize = 10;\n conifg.descProperty = new ATNativeItemProperty(x,y,width,height,bgcolor,\"#777777\",textsize, true);\n\n \/\/ad image\n x = 60*3;y = 0*3+20;width = 240*3-20;height = 100*3-10;textsize = 17;\n conifg.mainImageProperty = new ATNativeItemProperty(x,y,width,height,bgcolor,textcolor,textsize, true);\n\n \/\/ad title \n x = 0*3;y = 100*3;width = 60*3;height = 50*3;textsize = 12;\n conifg.titleProperty = new ATNativeItemProperty(x,y,width,height,bgcolor,textcolor,textsize, true);\n\n \/\/ (Added in v5.7.21) ad dislike button (close button)\n x = 300*3 - 75;y = 0;width = 75;height = 75;\n conifg.dislikeButtonProperty = new ATNativeItemProperty(x,y,width,height,\"#00000000\",textcolor,textsize, true);\n\n ATNativeAdView anyThinkNativeAdView = new ATNativeAdView(conifg);\n AnyThinkAds.Demo.ATManager.anyThinkNativeAdView = anyThinkNativeAdView;\n Debug.Log(\"Developer renderAdToScene--->\");\n ATNativeAd.Instance.renderAdToScene(mPlacementId_native_all, anyThinkNativeAdView);\n}\n```\n\nWhen using the **scenario** feature:\n\n```java\npublic void showNative()\n{\n ...\n Dictionary jsonmap = new Dictionary();\n jsonmap.Add(AnyThinkAds.Api.ATConst.SCENARIO, showingScenarioID);\n ATNativeAd.Instance.renderAdToScene(mPlacementId_native_all, anyThinkNativeAdView, jsonmap);\n}\n```\n\nThe trailing parameter passed to the constructor of the ATNativeItemProperty class indicates whether to use pixel units **(only valid for iOS)**. For example, on iPhone 6, if you pass 30, 120, 300, 450 for x, y, width, and height respectively, the actual values passed to the Objective-C code on iPhone 7 will be 15, 60, 150, 225, and on another device, these values will be 10, 40, 100, 150. In other words, the final values will be determined by the screen scale of the target device.\n\nAs you can see above, we have defined an ATNativeConfig class for you to configure various properties of native assets (bgColor, textColor, textSize, position, etc.), such as the CTA button, app icon, title text, description text, cover image, and so on. Feel free to modify the properties in the config object and see what happens based on your modifications.\n\n#### [Detailed Description of ATNativeConfig & ATNativeItemProperty](https:\/\/docs.toponad.com\/#\/zh-cn\/unity\/unity_doc\/unity_access_native_doc?id=%e5%85%b3%e4%ba%8eatnativeconfigampatnativeitemproperty%e8%af%a6%e7%bb%86%e8%af%b4%e6%98%8e)\n\n**ATNativeConfig** contains multiple **ATNativeItemProperty** objects used to control the style of the Native ad. **ATNativeItemProperty** controls the position and style of a single Native ad element. Some elements may not support certain properties in **ATNativeItemProperty**. For example, image elements (icon, main image) only support x, y, width, height, usesPixel, but do not support background color, font size, and font color, while text elements (such as title, cta, desc) support all properties. In iOS games, if you want to specify \"transparent\", use \"clearColor\". For example, if you want the background of the ad area to be transparent, assign \"clearColor\" to the backgroundColor of parentProperty. \n**Note:** 1) Only iOS supports clearColor. On Android, if you need to specify a transparent background, simply set the alpha component in rgba to 0.\n\n2) iOS does not support alpha, so color values should be passed as something like #5aef00 (a six-digit RGB value), while Android can support alpha, with colors containing 8 hexadecimal digits, such as 5a2b3c00.\n\n**parentProperty**\n\nparentProperty controls the overall size of the Native ad, as shown in the red-circled area below.\n\n![](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/apanR8\/65e843402b79d.png)\n\nNative ad element descriptions:\n\n- **appIconProperty**: The appIconProperty controls the ad's icon property, as shown in **Figure 1** below:\n- **mainImageProperty**: mainImageProperty controls the ad's cover image, as shown in **Figure 2** below:\n- **titleProperty**: titleProperty controls the ad title, as shown in **Figure 3** below:\n- **descProperty**: descProperty controls the ad description text, as shown in **Figure 4** below\n- **adLogoProperty**: adLogoProperty controls the ad logo property, as shown in **Figure 5** below. **Note:** Some platforms have a fixed ad logo position internally and do not support developer-specified positioning, such as Admob.\n- **ctaButtonProperty**: ctaButtonProperty controls the click button, as shown in **Figure 6** below\n- **dislikeButtonProperty**: **(Added in v5.7.21)** dislikeButtonProperty controls the close button (can be left unset if you don't want to display the close button)\n\n**Note: All of the above Native ad elements must be rendered when returned**\n\n![](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/apanR8\/65e84340b6a0c.png)\n\nIf you want to remove the native ad from the screen, use the following code:\n\n```java\npublic void cleanView()\n{\n Debug.Log (\"Developer cleanView native....\");\n ATNativeAd.Instance.cleanAdView(mPlacementId_native_all,AnyThinkAds.Demo.ATManager.anyThinkNativeAdView);\n}\n```\n\n#### About Template Rendering Ad Description\n\n- Only parentProperty can be used to control template rendering ads. Adjusting other properties (appIcon, title, desc, adLogo, ctaButton, mainImage, etc.) is invalid. Among them, parentProperty and mainImageProperty must be set, and mainImageProperty parameters can be consistent with parentProperty.\n- The width and height of parentProperty must be consistent with the width and height passed during loading, otherwise the ad may display incompletely or too large.\n- Template ads have their own aspect ratio, which can be viewed in the ad platform dashboard. Try to select templates with the same or similar aspect ratio in the ad platform dashboard, and pass the width and height in the code with that aspect ratio to load and display ads for the best display effect.\n- Adaptive height for template rendering ads: Developers can implement adaptive height through the following steps (adaptive height during loading is only for Pangle and GDT platforms on Android). Note:\n- When using adaptive height, taller template ads may appear. Developers can check the desired aspect ratio templates in the ad platform dashboard based on actual needs and remove templates that do not meet expectations.\n- Adaptive height is not controlled by the height of parentProperty.\n- 1) (This point is only for Android) Enable adaptive height during loading (Key must be passed: ADAPTIVE\\_HEIGHT)\n\n```java\nDictionary jsonmap = new Dictionary();\n\n#if UNITY_ANDROID\n ATSize nativeSize = new ATSize(width, height);\n jsonmap.Add(ATNativeAdLoadingExtra.kATNativeAdLoadingExtraNativeAdSizeStruct, nativeSize);\n jsonmap.Add(AnyThinkAds.Api.ATConst.ADAPTIVE_HEIGHT, AnyThinkAds.Api.ATConst.ADAPTIVE_HEIGHT_YES); \n...\nATNativeAd.Instance.loadNativeAd(mPlacementId_native_all, jsonmap);\n\n```\n\n- 2) Enable adaptive height during display (Key must be passed: Key: ADAPTIVE\\_HEIGHT)\n\n```java\n...\nDictionary jsonmap = new Dictionary();\njsonmap.Add(AnyThinkAds.Api.ATConst.ADAPTIVE_HEIGHT, AnyThinkAds.Api.ATConst.ADAPTIVE_HEIGHT_YES);\n\nATNativeAd.Instance.renderAdToScene(mPlacementId_native_all, anyThinkNativeAdView, jsonmap);\n\n```\n\n- 3) During display, the ad can be controlled to be centered at the top or bottom of the screen\n\n```java\n...\nDictionary jsonmap = new Dictionary();\njsonmap.Add(AnyThinkAds.Api.ATConst.POSITION, AnyThinkAds.Api.ATConst.POSITION_BOTTOM);\/\/ Centered at bottom of screen\n\/\/jsonmap.Add(AnyThinkAds.Api.ATConst.POSITION, AnyThinkAds.Api.ATConst.POSITION_TOP);\/\/ Centered at top of screen\n\nATNativeAd.Instance.renderAdToScene(mPlacementId_native_all, anyThinkNativeAdView, jsonmap);\n\n```\n\n**6. Implement Native Ad Listeners (Note: Only supported on V5.9.51 and above)**\n-------------------------------------\n\nFor callback info details, see: [Callback Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)\n\nUse the following code to implement multiple listeners:\n\n```java\n \/\/ Ad loaded successfully\n ATNativeAd.Instance.client.onAdLoadEvent += onAdLoad;\n \/\/ Ad load failed\n ATNativeAd.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n \/\/ Ad displayed successfully\n ATNativeAd.Instance.client.onAdImpressEvent += onAdImpressed;\n \/\/ Ad clicked\n ATNativeAd.Instance.client.onAdClickEvent += onAdClick;\n \/\/ Ad close button clicked, some ad platforms have this callback\n ATNativeAd.Instance.client.onAdCloseEvent += onAdClose;\n \/\/ Ad video playback started, some ad platforms have this callback\n ATNativeAd.Instance.client.onAdVideoStartEvent += onAdVideoStart;\n \/\/ Ad video playback ended, some ad platforms have this callback\n ATNativeAd.Instance.client.onAdVideoEndEvent += onAdVideoEnd;\n \/\/ Ad video playback progress, some ad platforms have this callback\n ATNativeAd.Instance.client.onAdVideoProgressEvent += onAdVideoProgress;\n\n```\n\nAdvanced listener settings:\n\n```java\n \/\/ Ad Source started loading\n ATNativeAd.Instance.client.onAdSourceAttemptEvent += startLoadingADSource;\n \/\/ Ad Source loading completed\n ATNativeAd.Instance.client.onAdSourceFilledEvent += finishLoadingADSource;\n \/\/ Ad Source failed\n ATNativeAd.Instance.client.onAdSourceLoadFailureEvent += failToLoadADSource;\n \/\/ Ad Source started bidding\n ATNativeAd.Instance.client.onAdSourceBiddingAttemptEvent += startBiddingADSource;\n \/\/ Ad Source bidding succeeded\n ATNativeAd.Instance.client.onAdSourceBiddingFilledEvent += finishBiddingADSource;\n \/\/ Ad Source bidding failed\n ATNativeAd.Instance.client.onAdSourceBiddingFailureEvent += failBiddingADSource; \n```\n\nThe method definition parameters are as follows **(Note: You can refer to the code below for method names or use custom method names, but the parameters must be consistent)**:\n\n```java\n \/\/sender is the ad type object, erg is the returned info\n \/\/ Ad loaded successfully\n public void onAdLoad(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdLoaded------:\" + erg.placementId);\n }\n \/\/ Ad load failed\n public void onAdLoadFail(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdLoadFail------:\" + erg.placementId + \"--code:\" + erg.code + \"--msg:\" + erg.message);\n }\n \/\/ Ad displayed successfully\n public void onAdImpressed(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdImpressed------:\" + erg.placementId);\n }\n \/\/ Ad clicked\n public void onAdClicked(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdClicked------:\" + erg.placementId);\n }\n \/\/ Ad video playback started, some ad platforms have this callback\n public void onAdVideoStart(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdVideoStart------:\" + erg.placementId);\n }\n \/\/ Ad video playback ended, some ad platforms have this callback\n public void onAdVideoEnd(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdVideoEnd------:\" + erg.placementId);\n }\n \/\/ Ad video playback progress, some ad platforms have this callback\n public void onAdVideoProgress(object sender, ATAdProgressEventArgs erg)\n {\n Debug.Log(\"Developer onAdVideoProgress------:\" + erg.placementId);\n }\n \/\/ Ad close button clicked, some ad platforms have this callback\n public void onAdCloseButtonClicked(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdCloseButtonClicked------:\" + erg.placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(object sender, ATAdEventArgs erg){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(object sender, ATAdEventArgs erg){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(object sender, ATAdEventArgs erg){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(object sender, ATAdEventArgs erg){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(object sender, ATAdEventArgs erg){\n Debug.Log(\"Developer failBiddingADSource------\");\n }\n```\n\n**7. Legacy Native Ad Listener Implementation (Note: Only for use below V5.9.51, deprecated in new versions)**\n-----------------------------------------------\n\nTo get notified about various native ad events (load success\/failure, impression, click, etc.), you can define an implementation class of **ATNativeAdListener**. Below is an example: **(Note: For Android, all callback methods are not on the Unity main thread)**\n\n```java\nclass ATNativeCallbackListener : ATNativeAdListener\n{\n \/\/ Ad loaded successfully\n public void onAdLoaded(string placementId)\n {\n Debug.Log(\"Developer onAdLoaded------:\" + placementId);\n }\n \/\/ Ad load failed\n public void onAdLoadFail(string placementId, string code, string message)\n {\n Debug.Log(\"Developer onAdLoadFail------:\" + placementId + \"--code:\" + code + \"--msg:\" + message);\n }\n \/\/ Ad displayed successfully\n public void onAdImpressed(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer onAdImpressed------:\" + placementId);\n }\n \/\/ Ad clicked\n public void onAdClicked(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer onAdClicked------:\" + placementId);\n }\n \/\/ Ad video playback started, some ad platforms have this callback\n public void onAdVideoStart(string placementId)\n {\n Debug.Log(\"Developer onAdVideoStart------:\" + placementId);\n }\n \/\/ Ad video playback ended, some ad platforms have this callback\n public void onAdVideoEnd(string placementId)\n {\n Debug.Log(\"Developer onAdVideoEnd------:\" + placementId);\n }\n \/\/ Ad video playback progress, some ad platforms have this callback\n public void onAdVideoProgress(string placementId, int progress)\n {\n Debug.Log(\"Developer onAdVideoProgress------:\" + placementId);\n }\n \/\/ Ad close button clicked, some ad platforms have this callback\n public void onAdCloseButtonClicked(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer onAdCloseButtonClicked------:\" + placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failBiddingADSource------\");\n }\n}\n```\n\n**Note:** The code snippets you see in this section are from the **nativeScene.cs** [demo project](https:\/\/github.com\/TakuMediation\/Taku_Unity_Demo) in our Demo.","pure_content":"Note for Android:\nCurrently, using Unity to directly build an Android APK cannot display native video ads, because Unity's default APK packaging disables hardware acceleration for the game Activity, making it impossible to display videos. If you need to display native ad videos, you must use the export project method, as follows:\n(1) Select Export Project mode to export the Android project \n(2) Modify the property in AndroidManifest, setting the hardwareAccelerated property as shown in the image to true \nAfter completing the above steps, use the current Android project for packaging.\n1. Integration Process Suggestions\n\nCall ATNativeAd#loadNativeAd to load an ad when the app starts\nUse ATNativeAd#hasAdReady to check if an ad can be displayed at the location where you want to show it\nIf you need to use ad scenarios to distinguish data for different business scenarios, see the sample code for details\n\n2. API Description\nATNativeAd:\n\n\n\n API\n Parameters\n Description\n\n\n\n\n loadNativeAd\n string placementid, Dictionary extra\n Load an ad (Starting from v5.6.8, for Pangle template rendering, Mintegral auto-rendering ads, etc., you must pass width and height via the extra parameter, otherwise the ad size may display abnormally)\n\n\n setListener\n ATNativeAdListener listener\n Set the listener callback interface. (Deprecated after version 5.9.51) For how to set listeners, see: Native Ad Event Settings\n\n\n hasAdReady\n string placementid\n Check if there is a cached ad\n\n\n checkAdStatus\n string placementid\n (Added in v5.7.22) Get the current ad placement status (JSON string): 1. isLoading: Whether it is loading 2. isReady: Whether there is a cached ad (same as hasAdReady) 3. AdInfo: The highest-priority cached ad info (see ATCallbackInfo Description)\n\n\n getValidAdCaches\n string placementid\n (Added in v5.7.54) Get all successfully loaded cached ad info (JSON string) (see ATCallbackInfo Description)\n\n\n renderAdToScene\n string placementid, ATNativeAdView anyThinkNativeAdView\n Display an ad\n\n\n entryScenarioWithPlacementID\n string placementId, string scenarioID\n Set entry into a displayable ad scenario\n\n\n\n3. Load Native Ad\nYou can use the following code to load a native ad:\npublic void loadNative() \n{\n Debug.Log (\"Developer load native, unit id = \" + mPlacementId_native_all);\n ATNativeAd.Instance.client.onAdLoadEvent += onAdLoad;\n ATNativeAd.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n ATNativeAd.Instance.client.onAdImpressEvent += onAdImpressed;\n ATNativeAd.Instance.client.onAdClickEvent += onAdClick;\n ATNativeAd.Instance.client.onAdCloseEvent += onAdClose;\n ATNativeAd.Instance.client.onAdVideoStartEvent += onAdVideoStart;\n ATNativeAd.Instance.client.onAdVideoEndEvent += onAdVideoEnd;\n ATNativeAd.Instance.client.onAdVideoProgressEvent += onAdVideoProgress;\n\n \/\/----- v5.6.8 and above -----\n Dictionary jsonmap = new Dictionary();\n\n #if UNITY_ANDROID\n ATSize nativeSize = new ATSize(width, height);\n jsonmap.Add(ATNativeAdLoadingExtra.kATNativeAdLoadingExtraNativeAdSizeStruct, nativeSize);\n #elif UNITY_IOS || UNITY_IPHONE\n ATSize nativeSize = new ATSize(width, height, false);\n jsonmap.Add(ATNativeAdLoadingExtra.kATNativeAdLoadingExtraNativeAdSizeStruct, nativeSize);\n\n ATNativeAd.Instance.loadNativeAd(mPlacementId_native_all, jsonmap);\n}\n\nNote: Please continue reading to learn how to get notified on load success\/failure events.\n4. Check If There Is a Cached Ad\nATNativeAd.Instance.hasAdReady(mPlacementId_native_all);\n\n5. Display Native Ad\nYou can use the following code to display a native ad:\npublic void showNative()\n{\n Debug.Log (\"Developer show native....\");\n ATNativeConfig conifg = new ATNativeConfig ();\n\n string bgcolor = \"#ffffff\";\n string textcolor = \"#000000\";\n int rootbasex = 100, rootbasey = 100;\n\n int x = rootbasex,y = rootbasey,width = 300*3,height = 200*3,textsize = 17;\n conifg.parentProperty = new ATNativeItemProperty(x,y,width,height,bgcolor,textcolor,textsize, true);\n\n \/\/adlogo \n x = 0*3;y = 0*3;width = 30*3;height = 20*3;textsize = 17;\n conifg.adLogoProperty = new ATNativeItemProperty(x,y,width,height,bgcolor,textcolor,textsize, true);\n\n \/\/adicon\n x = 0*3;y = 50*3-50;width = 60*3;height = 50*3;textsize = 17;\n conifg.appIconProperty = new ATNativeItemProperty(x,y,width,height,bgcolor,textcolor,textsize, true);\n\n \/\/ad cta \n x = 0*3;y = 150*3;width = 300*3;height = 50*3;textsize = 17;\n conifg.ctaButtonProperty = new ATNativeItemProperty(x,y,width,height,\"#ff21bcab\",\"#ffffff\",textsize, true);\n\n \/\/ad desc\n x = 60*3;y = 100*3;width = 240*3-20;height = 50*3-10;textsize = 10;\n conifg.descProperty = new ATNativeItemProperty(x,y,width,height,bgcolor,\"#777777\",textsize, true);\n\n \/\/ad image\n x = 60*3;y = 0*3+20;width = 240*3-20;height = 100*3-10;textsize = 17;\n conifg.mainImageProperty = new ATNativeItemProperty(x,y,width,height,bgcolor,textcolor,textsize, true);\n\n \/\/ad title \n x = 0*3;y = 100*3;width = 60*3;height = 50*3;textsize = 12;\n conifg.titleProperty = new ATNativeItemProperty(x,y,width,height,bgcolor,textcolor,textsize, true);\n\n \/\/ (Added in v5.7.21) ad dislike button (close button)\n x = 300*3 - 75;y = 0;width = 75;height = 75;\n conifg.dislikeButtonProperty = new ATNativeItemProperty(x,y,width,height,\"#00000000\",textcolor,textsize, true);\n\n ATNativeAdView anyThinkNativeAdView = new ATNativeAdView(conifg);\n AnyThinkAds.Demo.ATManager.anyThinkNativeAdView = anyThinkNativeAdView;\n Debug.Log(\"Developer renderAdToScene--->\");\n ATNativeAd.Instance.renderAdToScene(mPlacementId_native_all, anyThinkNativeAdView);\n}\n\nWhen using the scenario feature:\npublic void showNative()\n{\n ...\n Dictionary jsonmap = new Dictionary();\n jsonmap.Add(AnyThinkAds.Api.ATConst.SCENARIO, showingScenarioID);\n ATNativeAd.Instance.renderAdToScene(mPlacementId_native_all, anyThinkNativeAdView, jsonmap);\n}\n\nThe trailing parameter passed to the constructor of the ATNativeItemProperty class indicates whether to use pixel units (only valid for iOS). For example, on iPhone 6, if you pass 30, 120, 300, 450 for x, y, width, and height respectively, the actual values passed to the Objective-C code on iPhone 7 will be 15, 60, 150, 225, and on another device, these values will be 10, 40, 100, 150. In other words, the final values will be determined by the screen scale of the target device.\nAs you can see above, we have defined an ATNativeConfig class for you to configure various properties of native assets (bgColor, textColor, textSize, position, etc.), such as the CTA button, app icon, title text, description text, cover image, and so on. Feel free to modify the properties in the config object and see what happens based on your modifications.\nDetailed Description of ATNativeConfig & ATNativeItemProperty\nATNativeConfig contains multiple ATNativeItemProperty objects used to control the style of the Native ad. ATNativeItemProperty controls the position and style of a single Native ad element. Some elements may not support certain properties in ATNativeItemProperty. For example, image elements (icon, main image) only support x, y, width, height, usesPixel, but do not support background color, font size, and font color, while text elements (such as title, cta, desc) support all properties. In iOS games, if you want to specify \"transparent\", use \"clearColor\". For example, if you want the background of the ad area to be transparent, assign \"clearColor\" to the backgroundColor of parentProperty.\nNote: 1) Only iOS supports clearColor. On Android, if you need to specify a transparent background, simply set the alpha component in rgba to 0.\n\niOS does not support alpha, so color values should be passed as something like #5aef00 (a six-digit RGB value), while Android can support alpha, with colors containing 8 hexadecimal digits, such as 5a2b3c00.\n\nparentProperty\nparentProperty controls the overall size of the Native ad, as shown in the red-circled area below.\n\nNative ad element descriptions:\n\n\nappIconProperty: The appIconProperty controls the ad's icon property, as shown in Figure 1 below:\n\nmainImageProperty: mainImageProperty controls the ad's cover image, as shown in Figure 2 below:\n\ntitleProperty: titleProperty controls the ad title, as shown in Figure 3 below:\n\ndescProperty: descProperty controls the ad description text, as shown in Figure 4 below\n\nadLogoProperty: adLogoProperty controls the ad logo property, as shown in Figure 5 below. Note: Some platforms have a fixed ad logo position internally and do not support developer-specified positioning, such as Admob.\n\nctaButtonProperty: ctaButtonProperty controls the click button, as shown in Figure 6 below\n\ndislikeButtonProperty: (Added in v5.7.21) dislikeButtonProperty controls the close button (can be left unset if you don't want to display the close button)\n\nNote: All of the above Native ad elements must be rendered when returned\n\nIf you want to remove the native ad from the screen, use the following code:\npublic void cleanView()\n{\n Debug.Log (\"Developer cleanView native....\");\n ATNativeAd.Instance.cleanAdView(mPlacementId_native_all,AnyThinkAds.Demo.ATManager.anyThinkNativeAdView);\n}\n\nAbout Template Rendering Ad Description\n\nOnly parentProperty can be used to control template rendering ads. Adjusting other properties (appIcon, title, desc, adLogo, ctaButton, mainImage, etc.) is invalid. Among them, parentProperty and mainImageProperty must be set, and mainImageProperty parameters can be consistent with parentProperty.\nThe width and height of parentProperty must be consistent with the width and height passed during loading, otherwise the ad may display incompletely or too large.\nTemplate ads have their own aspect ratio, which can be viewed in the ad platform dashboard. Try to select templates with the same or similar aspect ratio in the ad platform dashboard, and pass the width and height in the code with that aspect ratio to load and display ads for the best display effect.\nAdaptive height for template rendering ads: Developers can implement adaptive height through the following steps (adaptive height during loading is only for Pangle and GDT platforms on Android). Note:\nWhen using adaptive height, taller template ads may appear. Developers can check the desired aspect ratio templates in the ad platform dashboard based on actual needs and remove templates that do not meet expectations.\nAdaptive height is not controlled by the height of parentProperty.\n\n\n(This point is only for Android) Enable adaptive height during loading (Key must be passed: ADAPTIVE_HEIGHT)\n\n\n\nDictionary jsonmap = new Dictionary();\n\n#if UNITY_ANDROID\n ATSize nativeSize = new ATSize(width, height);\n jsonmap.Add(ATNativeAdLoadingExtra.kATNativeAdLoadingExtraNativeAdSizeStruct, nativeSize);\n jsonmap.Add(AnyThinkAds.Api.ATConst.ADAPTIVE_HEIGHT, AnyThinkAds.Api.ATConst.ADAPTIVE_HEIGHT_YES); \n...\nATNativeAd.Instance.loadNativeAd(mPlacementId_native_all, jsonmap);\n\n\n\n\n\nEnable adaptive height during display (Key must be passed: Key: ADAPTIVE_HEIGHT)\n\n\n\n...\nDictionary jsonmap = new Dictionary();\njsonmap.Add(AnyThinkAds.Api.ATConst.ADAPTIVE_HEIGHT, AnyThinkAds.Api.ATConst.ADAPTIVE_HEIGHT_YES);\n\nATNativeAd.Instance.renderAdToScene(mPlacementId_native_all, anyThinkNativeAdView, jsonmap);\n\n\n\n\n\nDuring display, the ad can be controlled to be centered at the top or bottom of the screen\n\n\n\n...\nDictionary jsonmap = new Dictionary();\njsonmap.Add(AnyThinkAds.Api.ATConst.POSITION, AnyThinkAds.Api.ATConst.POSITION_BOTTOM);\/\/ Centered at bottom of screen\n\/\/jsonmap.Add(AnyThinkAds.Api.ATConst.POSITION, AnyThinkAds.Api.ATConst.POSITION_TOP);\/\/ Centered at top of screen\n\nATNativeAd.Instance.renderAdToScene(mPlacementId_native_all, anyThinkNativeAdView, jsonmap);\n\n\n6. Implement Native Ad Listeners (Note: Only supported on V5.9.51 and above)\nFor callback info details, see: Callback Info Description\nUse the following code to implement multiple listeners:\n \/\/ Ad loaded successfully\n ATNativeAd.Instance.client.onAdLoadEvent += onAdLoad;\n \/\/ Ad load failed\n ATNativeAd.Instance.client.onAdLoadFailureEvent += onAdLoadFail;\n \/\/ Ad displayed successfully\n ATNativeAd.Instance.client.onAdImpressEvent += onAdImpressed;\n \/\/ Ad clicked\n ATNativeAd.Instance.client.onAdClickEvent += onAdClick;\n \/\/ Ad close button clicked, some ad platforms have this callback\n ATNativeAd.Instance.client.onAdCloseEvent += onAdClose;\n \/\/ Ad video playback started, some ad platforms have this callback\n ATNativeAd.Instance.client.onAdVideoStartEvent += onAdVideoStart;\n \/\/ Ad video playback ended, some ad platforms have this callback\n ATNativeAd.Instance.client.onAdVideoEndEvent += onAdVideoEnd;\n \/\/ Ad video playback progress, some ad platforms have this callback\n ATNativeAd.Instance.client.onAdVideoProgressEvent += onAdVideoProgress;\n\n\nAdvanced listener settings:\n \/\/ Ad Source started loading\n ATNativeAd.Instance.client.onAdSourceAttemptEvent += startLoadingADSource;\n \/\/ Ad Source loading completed\n ATNativeAd.Instance.client.onAdSourceFilledEvent += finishLoadingADSource;\n \/\/ Ad Source failed\n ATNativeAd.Instance.client.onAdSourceLoadFailureEvent += failToLoadADSource;\n \/\/ Ad Source started bidding\n ATNativeAd.Instance.client.onAdSourceBiddingAttemptEvent += startBiddingADSource;\n \/\/ Ad Source bidding succeeded\n ATNativeAd.Instance.client.onAdSourceBiddingFilledEvent += finishBiddingADSource;\n \/\/ Ad Source bidding failed\n ATNativeAd.Instance.client.onAdSourceBiddingFailureEvent += failBiddingADSource; \n\nThe method definition parameters are as follows (Note: You can refer to the code below for method names or use custom method names, but the parameters must be consistent):\n \/\/sender is the ad type object, erg is the returned info\n \/\/ Ad loaded successfully\n public void onAdLoad(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdLoaded------:\" + erg.placementId);\n }\n \/\/ Ad load failed\n public void onAdLoadFail(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdLoadFail------:\" + erg.placementId + \"--code:\" + erg.code + \"--msg:\" + erg.message);\n }\n \/\/ Ad displayed successfully\n public void onAdImpressed(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdImpressed------:\" + erg.placementId);\n }\n \/\/ Ad clicked\n public void onAdClicked(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdClicked------:\" + erg.placementId);\n }\n \/\/ Ad video playback started, some ad platforms have this callback\n public void onAdVideoStart(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdVideoStart------:\" + erg.placementId);\n }\n \/\/ Ad video playback ended, some ad platforms have this callback\n public void onAdVideoEnd(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdVideoEnd------:\" + erg.placementId);\n }\n \/\/ Ad video playback progress, some ad platforms have this callback\n public void onAdVideoProgress(object sender, ATAdProgressEventArgs erg)\n {\n Debug.Log(\"Developer onAdVideoProgress------:\" + erg.placementId);\n }\n \/\/ Ad close button clicked, some ad platforms have this callback\n public void onAdCloseButtonClicked(object sender, ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdCloseButtonClicked------:\" + erg.placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(object sender, ATAdEventArgs erg){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(object sender, ATAdEventArgs erg){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(object sender, ATAdEventArgs erg){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(object sender, ATAdEventArgs erg){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(object sender, ATAdEventArgs erg){\n Debug.Log(\"Developer failBiddingADSource------\");\n }\n\n7. Legacy Native Ad Listener Implementation (Note: Only for use below V5.9.51, deprecated in new versions)\nTo get notified about various native ad events (load success\/failure, impression, click, etc.), you can define an implementation class of ATNativeAdListener. Below is an example: (Note: For Android, all callback methods are not on the Unity main thread)\nclass ATNativeCallbackListener : ATNativeAdListener\n{\n \/\/ Ad loaded successfully\n public void onAdLoaded(string placementId)\n {\n Debug.Log(\"Developer onAdLoaded------:\" + placementId);\n }\n \/\/ Ad load failed\n public void onAdLoadFail(string placementId, string code, string message)\n {\n Debug.Log(\"Developer onAdLoadFail------:\" + placementId + \"--code:\" + code + \"--msg:\" + message);\n }\n \/\/ Ad displayed successfully\n public void onAdImpressed(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer onAdImpressed------:\" + placementId);\n }\n \/\/ Ad clicked\n public void onAdClicked(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer onAdClicked------:\" + placementId);\n }\n \/\/ Ad video playback started, some ad platforms have this callback\n public void onAdVideoStart(string placementId)\n {\n Debug.Log(\"Developer onAdVideoStart------:\" + placementId);\n }\n \/\/ Ad video playback ended, some ad platforms have this callback\n public void onAdVideoEnd(string placementId)\n {\n Debug.Log(\"Developer onAdVideoEnd------:\" + placementId);\n }\n \/\/ Ad video playback progress, some ad platforms have this callback\n public void onAdVideoProgress(string placementId, int progress)\n {\n Debug.Log(\"Developer onAdVideoProgress------:\" + placementId);\n }\n \/\/ Ad close button clicked, some ad platforms have this callback\n public void onAdCloseButtonClicked(string placementId, ATCallbackInfo callbackInfo)\n {\n Debug.Log(\"Developer onAdCloseButtonClicked------:\" + placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(string placementId, ATCallbackInfo callbackInfo){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(string placementId,ATCallbackInfo callbackInfo,string code, string message){\n Debug.Log(\"Developer failBiddingADSource------\");\n }\n}\n\nNote: The code snippets you see in this section are from the nativeScene.cs demo project in our Demo.","is_draft":"0","editor_type":"2","file_path":"","add_time":"1709721644","update_time":"1782972120"},"pure_content":"Note for Android:\nCurrently, using Unity to directly build an Android APK cannot display native video ads, because Unity's default APK packaging disables hardware acceleration for the game Activity, m"},{"id":"76340","string_id":"DeiQRL","status":"1","parent_id":"76330","slug":"Open-screen-advertising-access","order":"13","name":"Splash ad","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722566","add_time":"1709721644","update_time":"1783492326","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76340","content":"**1.** Ad Introduction\n-------\n\n[Taku Unity Plugin 2.0.0](https:\/\/help.takuad.com\/en\/docs\/TopOn-Unity3D-plugin-2-import-instructions) supports accessing Splash Ads via C# API. Splash ads are similar to interstitial ads, but are generally displayed when the app is cold-started or hot-started.\n\n**2.** Integration Suggestions\n-------\n\n1. Cold Start (when the app process does not exist, the app's first launch)\n\nThe preferred method for handling cold starts is to create a new scene as the launch page. Load the ad in the Start() method of this scene. If loading times out, do not display the ad. See the sample code for details.\n\nAfter launching the app or game, call ATSplashAd.Instance.loadSplashAd() to load a splash ad.\n\nMove the preloading logic for other ad formats and other network-resource-consuming requests to after the splash ad is displayed, to reduce splash load timeout situations.\n\nIf the ad load times out (onAdLoadTimeoutEvent(object sender, ATAdEventArgs erg)), do not continue waiting for ad fill and directly enter the main interface. This splash ad is still loading; if it loads successfully, it will trigger the\n\nonAdLoadEvent(object sender, ATAdEventArgs erg) onAdLoadEvent(object sender, ATAdEventArgs erg) callback. When triggered, if loading has not timed out (when ATAdEventArgs.isTimeout is false), call ATSplashAd.Instance.showSplashAd() to display the ad.\n\n2. Hot Start (when the app is temporarily sent to the background via the home button, and the app process still exists, returning to the app)\n\nWhen the app returns to the foreground, call ATSplashAd.Instance.hasSplashAdReady() to check if there is a cached ad. If true, call ATSplashAd.Instance.showSplashAd() to display the ad. If false, call ATSplashAd.Instance.loadSplashAd() to preload an ad.\n\n3. It is recommended to call ATSplashAd.Instance.entryScenarioWithPlacementID() after entering a displayable ad scenario to track the cache status of the current ad placement. For specific tracking instructions, see the ad scenario data for distinguishing different business scenarios.\n\n4. Ad Preloading: After the splash ad is displayed, call load for preloading in the onAdLoadEvent or onAdCloseEvent callback.\n\nIf you need to display a splash ad during a hot start, it is recommended to call ATSplashAd.Instance.hasSplashAdReady() when the app goes to the background to check if there is a cached ad. If true, call ATSplashAd.Instance.showSplashAd() to display the ad. If false, call ATSplashAd.Instance.loadSplashAd() to preload an ad.\n\n5. Configure a fallback splash Ad Source in the dashboard to reduce load timeout situations. See Fallback Splash Ad for the configuration method.\n\n6. In Unity, listen for app foreground events:\n\nTo receive notifications of app foreground events, it is recommended that you listen to the OnApplicationPause event. By overriding the OnApplicationPause method, your app will receive alerts for app launch and foreground events and will be able to display ads.\n\n**Note:** \n\n1. You must call load to load an ad only after the Taku SDK Initialization has succeeded.\n2. Only full-screen splash ads are supported.\n\n**3.** API Description\n--------\n\nATSplashAd:\n\n| API | Parameters | Description |\n|---|---|---|\n| loadSplashAd | string placementId, Dictionary | Load an ad |\n| hasSplashAdReady | string placementId | Check if there is a cached ad |\n| checkAdStatus | string placementid | Get the current ad placement status (JSON string): 1. isLoading: Whether it is loading 2. isReady: Whether there is a cached ad (same as hasSplashAdReady) 3. AdInfo: The highest-priority cached ad info (see [ATCallbackInfo Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)) |\n| getValidAdCaches | string placementid | Get all successfully loaded cached ad info (JSON string) (see [ATCallbackInfo Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)) |\n| showSplashAd | string placementid, Dictionary | Display an ad |\n| entryScenarioWithPlacementID | string placementId, string scenarioID | Set entry into a displayable ad scenario |\n\n**4.** Implement Ad Event Listeners\n-------------\n\nFor callback info details, see: [Callback Info Description](https:\/\/help.takuad.com\/en\/docs\/Callback-information-description-dOjB)\n\nUse the following code to implement multiple listeners:\n\n```java\n var client = ATSplashAd.Instance.client;\n \/\/ Ad loaded successfully\n client.onAdLoadEvent += onAdLoad;\n \/\/ Ad load failed\n client.onAdLoadFailureEvent += onAdLoadFailed;\n \/\/ Ad load timed out\n client.onAdLoadTimeoutEvent += onAdLoadTimeout;\n \/\/ Ad displayed successfully\n client.onAdShowEvent += onAdShow;\n \/\/ Ad closed\n client.onAdCloseEvent += onAdClose;\n \/\/ Ad clicked\n client.onAdClickEvent += onAdClick;\n```\n\nAdvanced listener settings:\n\n```java\n var client = ATSplashAd.Instance.client;\n \/\/ Ad Source initiated request\n client.onAdSourceAttemptEvent += startLoadingADSource;\n \/\/ Ad Source loaded successfully\n client.onAdSourceFilledEvent += finishLoadingADSource;\n \/\/ Ad Source load failed\n client.onAdSourceLoadFailureEvent += failToLoadADSource;\n \/\/ Ad Source Bidding started\n client.onAdSourceBiddingAttemptEvent += startBiddingADSource;\n \/\/ Ad Source Bidding succeeded\n client.onAdSourceBiddingFilledEvent += finishBiddingADSource;\n \/\/ Ad Source Bidding failed\n client.onAdSourceBiddingFailureEvent += failBiddingADSource;\n```\n\nThe method definition parameters are as follows: **(Note: You can refer to the code below for method names or use custom method names, but the parameters must be consistent)**\n\n```java\n \/\/ Ad loaded successfully\n public void onAdLoad(object sender,ATAdEventArgs erg)\n {\n if (!erg.isTimeout) \/\/ Not timed out\n {\n Debug.Log(\"Developer onAdLoad------\" + erg.placementId);\n }\n else \/\/ Timed out\n {\n Debug.Log(\"Developer onAdLoad timeout ------\" + erg.placementId);\n }\n }\n \/\/ Ad load failed\n public void onAdLoadFailed(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdLoadFailed------\" + erg.placementId);\n }\n \/\/ Ad load timed out\n public void onAdLoadTimeout(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdLoadTimeout------\" + erg.placementId);\n }\n \/\/ Ad displayed\n public void onAdShow(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdShow------\" + erg.placementId);\n }\n \/\/ Ad closed\n public void onAdClose(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdClose------\" + erg.placementId);\n }\n \/\/ Ad clicked\n public void onAdClick(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdClick------\" + erg.placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer failBiddingADSource------\");\n } \n```\n\n[5. Sample Code](https:\/\/docs.toponad.com\/#\/zh-cn\/unity\/unity_doc\/unity_access_splash_doc_new?id=_5-%e7%a4%ba%e4%be%8b%e4%bb%a3%e7%a0%81)\n----------------------------------------------------------------------------------------------------------------------------------\n\n```java\npublic class ExampleHomeScreen : MonoBehaviour, ATSDKInitListener\n{ \n void Start()\n {\n #if UNITY_ANDROID\n ATSDKAPI.initSDK(\"Your Android AppId\", \"Your Android AppKey\", this);\n#elif UNITY_IOS || UNITY_IPHONE\n ATSDKAPI.initSDK(\"Your iOS AppId\", \"Your iOS AppKey\", this);\n#endif\n }\n\n void OnDestroy()\n {\n ATSplashAd.Instance.client.onAdLoadEvent -= onAdLoad;\n ATSplashAd.Instance.client.onAdLoadTimeoutEvent -= onAdLoadTimeout;\n ATSplashAd.Instance.client.onAdLoadFailureEvent -= onAdLoadFailed;\n ATSplashAd.Instance.client.onAdCloseEvent -= onAdClose;\n }\n\n \/\/ SDK Initialization succeeded\n public void initSuccess()\n {\n ATSplashAd.Instance.client.onAdLoadEvent += onAdLoad;\n ATSplashAd.Instance.client.onAdLoadTimeoutEvent += onAdLoadTimeout;\n ATSplashAd.Instance.client.onAdLoadFailureEvent += onAdLoadFailed;\n ATSplashAd.Instance.client.onAdCloseEvent += onAdClose;\n ATSplashManager.Instance.ShowAdIfReady();\n }\n\n public void initFail(string msg)\n {\n Debug.Log(\"Developer callback SDK initFail:\" + msg);\n }\n \/\/ Ad loaded successfully, display it directly\n public void onAdLoad(object sender, ATAdEventArgs erg)\n {\n if (!erg.isTimeout)\n {\n ATSplashManager.Instance.ShowAdIfReady();\n }\n else \n {\n \/\/ Load timed out, do not call show to display the ad\n }\n } \n \/\/ Ad load timed out, no need to continue waiting for ad fill, go directly to the home screen\n public void onAdLoadTimeout(object sender, ATAdEventArgs erg)\n {\n\n }\n \/\/ Ad load failed\n public void onAdLoadFailed(object sender, ATAdErrorEventArgs args)\n {\n\n }\n \/\/ Ad closed, go to the home screen\n public void onAdClose(object sender, ATAdEventArgs erg)\n {\n\n }\n \/\/ Listen for app foreground events\n private void OnApplicationPause(bool pauseStatus)\n {\n if (!pauseStatus) \/\/ Returned from background to foreground\n {\n ATSplashManager.Instance.ShowAdIfReady();\n }\n }\n}\n\npublic class ATSplashManager\n {\n#if UNITY_ANDROID\n private const string SPLASH_PLACEMENT_ID = \"Your PlacementId\";\n#elif UNITY_IOS || UNITY_IPHONE\n private static string SPLASH_PLACEMENT_ID = \"Your PlacementId\";\n#endif\n\n private static ATSplashManager instance = new ATSplashManager();\n\n public static ATSplashManager Instance\n {\n get\n {\n return instance;\n }\n }\n\n public void ShowAdIfReady()\n {\n var splashAd = ATSplashAd.Instance;\n if (splashAd.hasSplashAdReady(SPLASH_PLACEMENT_ID))\n {\n splashAd.showSplashAd(SPLASH_PLACEMENT_ID, new Dictionary());\n }\n else\n {\n splashAd.loadSplashAd(SPLASH_PLACEMENT_ID, new Dictionary());\n }\n }\n }\n```","pure_content":"1. Ad Introduction\nTaku Unity Plugin 2.0.0 supports accessing Splash Ads via C# API. Splash ads are similar to interstitial ads, but are generally displayed when the app is cold-started or hot-started.\n2. Integration Suggestions\n\nCold Start (when the app process does not exist, the app's first launch)\n\nThe preferred method for handling cold starts is to create a new scene as the launch page. Load the ad in the Start() method of this scene. If loading times out, do not display the ad. See the sample code for details.\nAfter launching the app or game, call ATSplashAd.Instance.loadSplashAd() to load a splash ad.\nMove the preloading logic for other ad formats and other network-resource-consuming requests to after the splash ad is displayed, to reduce splash load timeout situations.\nIf the ad load times out (onAdLoadTimeoutEvent(object sender, ATAdEventArgs erg)), do not continue waiting for ad fill and directly enter the main interface. This splash ad is still loading; if it loads successfully, it will trigger the\nonAdLoadEvent(object sender, ATAdEventArgs erg) onAdLoadEvent(object sender, ATAdEventArgs erg) callback. When triggered, if loading has not timed out (when ATAdEventArgs.isTimeout is false), call ATSplashAd.Instance.showSplashAd() to display the ad.\n\nHot Start (when the app is temporarily sent to the background via the home button, and the app process still exists, returning to the app)\n\nWhen the app returns to the foreground, call ATSplashAd.Instance.hasSplashAdReady() to check if there is a cached ad. If true, call ATSplashAd.Instance.showSplashAd() to display the ad. If false, call ATSplashAd.Instance.loadSplashAd() to preload an ad.\n\n\nIt is recommended to call ATSplashAd.Instance.entryScenarioWithPlacementID() after entering a displayable ad scenario to track the cache status of the current ad placement. For specific tracking instructions, see the ad scenario data for distinguishing different business scenarios.\n\n\nAd Preloading: After the splash ad is displayed, call load for preloading in the onAdLoadEvent or onAdCloseEvent callback.\n\n\nIf you need to display a splash ad during a hot start, it is recommended to call ATSplashAd.Instance.hasSplashAdReady() when the app goes to the background to check if there is a cached ad. If true, call ATSplashAd.Instance.showSplashAd() to display the ad. If false, call ATSplashAd.Instance.loadSplashAd() to preload an ad.\n\n\nConfigure a fallback splash Ad Source in the dashboard to reduce load timeout situations. See Fallback Splash Ad for the configuration method.\n\n\nIn Unity, listen for app foreground events:\n\n\nTo receive notifications of app foreground events, it is recommended that you listen to the OnApplicationPause event. By overriding the OnApplicationPause method, your app will receive alerts for app launch and foreground events and will be able to display ads.\nNote:\n\nYou must call load to load an ad only after the Taku SDK Initialization has succeeded.\nOnly full-screen splash ads are supported.\n\n3. API Description\nATSplashAd:\n\n\n\n API\n Parameters\n Description\n\n\n\n\n loadSplashAd\n string placementId, Dictionary\n Load an ad\n\n\n hasSplashAdReady\n string placementId\n Check if there is a cached ad\n\n\n checkAdStatus\n string placementid\n Get the current ad placement status (JSON string): 1. isLoading: Whether it is loading 2. isReady: Whether there is a cached ad (same as hasSplashAdReady) 3. AdInfo: The highest-priority cached ad info (see ATCallbackInfo Description)\n\n\n getValidAdCaches\n string placementid\n Get all successfully loaded cached ad info (JSON string) (see ATCallbackInfo Description)\n\n\n showSplashAd\n string placementid, Dictionary\n Display an ad\n\n\n entryScenarioWithPlacementID\n string placementId, string scenarioID\n Set entry into a displayable ad scenario\n\n\n\n4. Implement Ad Event Listeners\nFor callback info details, see: Callback Info Description\nUse the following code to implement multiple listeners:\n var client = ATSplashAd.Instance.client;\n \/\/ Ad loaded successfully\n client.onAdLoadEvent += onAdLoad;\n \/\/ Ad load failed\n client.onAdLoadFailureEvent += onAdLoadFailed;\n \/\/ Ad load timed out\n client.onAdLoadTimeoutEvent += onAdLoadTimeout;\n \/\/ Ad displayed successfully\n client.onAdShowEvent += onAdShow;\n \/\/ Ad closed\n client.onAdCloseEvent += onAdClose;\n \/\/ Ad clicked\n client.onAdClickEvent += onAdClick;\n\nAdvanced listener settings:\n var client = ATSplashAd.Instance.client;\n \/\/ Ad Source initiated request\n client.onAdSourceAttemptEvent += startLoadingADSource;\n \/\/ Ad Source loaded successfully\n client.onAdSourceFilledEvent += finishLoadingADSource;\n \/\/ Ad Source load failed\n client.onAdSourceLoadFailureEvent += failToLoadADSource;\n \/\/ Ad Source Bidding started\n client.onAdSourceBiddingAttemptEvent += startBiddingADSource;\n \/\/ Ad Source Bidding succeeded\n client.onAdSourceBiddingFilledEvent += finishBiddingADSource;\n \/\/ Ad Source Bidding failed\n client.onAdSourceBiddingFailureEvent += failBiddingADSource;\n\nThe method definition parameters are as follows: (Note: You can refer to the code below for method names or use custom method names, but the parameters must be consistent)\n \/\/ Ad loaded successfully\n public void onAdLoad(object sender,ATAdEventArgs erg)\n {\n if (!erg.isTimeout) \/\/ Not timed out\n {\n Debug.Log(\"Developer onAdLoad------\" + erg.placementId);\n }\n else \/\/ Timed out\n {\n Debug.Log(\"Developer onAdLoad timeout ------\" + erg.placementId);\n }\n }\n \/\/ Ad load failed\n public void onAdLoadFailed(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdLoadFailed------\" + erg.placementId);\n }\n \/\/ Ad load timed out\n public void onAdLoadTimeout(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdLoadTimeout------\" + erg.placementId);\n }\n \/\/ Ad displayed\n public void onAdShow(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdShow------\" + erg.placementId);\n }\n \/\/ Ad closed\n public void onAdClose(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdClose------\" + erg.placementId);\n }\n \/\/ Ad clicked\n public void onAdClick(object sender,ATAdEventArgs erg)\n {\n Debug.Log(\"Developer onAdClick------\" + erg.placementId);\n }\n\n \/\/ v5.8.10 added Ad Source-level callbacks\n \/\/ Ad Source started loading\n public void startLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startLoadingADSource------\");\n }\n \/\/ Ad Source loading completed\n public void finishLoadingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishLoadingADSource------\");\n }\n \/\/ Ad Source failed\n public void failToLoadADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer failToLoadADSource------\");\n }\n \/\/ Ad Source started bidding\n public void startBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer startBiddingADSource------\");\n }\n \/\/ Ad Source bidding succeeded\n public void finishBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer finishBiddingADSource------\");\n }\n \/\/ Ad Source bidding failed\n public void failBiddingADSource(object sender,ATAdEventArgs erg){\n Debug.Log(\"Developer failBiddingADSource------\");\n } \n\n5. Sample Code\npublic class ExampleHomeScreen : MonoBehaviour, ATSDKInitListener\n{ \n void Start()\n {\n #if UNITY_ANDROID\n ATSDKAPI.initSDK(\"Your Android AppId\", \"Your Android AppKey\", this);\n#elif UNITY_IOS || UNITY_IPHONE\n ATSDKAPI.initSDK(\"Your iOS AppId\", \"Your iOS AppKey\", this);\n#endif\n }\n\n void OnDestroy()\n {\n ATSplashAd.Instance.client.onAdLoadEvent -= onAdLoad;\n ATSplashAd.Instance.client.onAdLoadTimeoutEvent -= onAdLoadTimeout;\n ATSplashAd.Instance.client.onAdLoadFailureEvent -= onAdLoadFailed;\n ATSplashAd.Instance.client.onAdCloseEvent -= onAdClose;\n }\n\n \/\/ SDK Initialization succeeded\n public void initSuccess()\n {\n ATSplashAd.Instance.client.onAdLoadEvent += onAdLoad;\n ATSplashAd.Instance.client.onAdLoadTimeoutEvent += onAdLoadTimeout;\n ATSplashAd.Instance.client.onAdLoadFailureEvent += onAdLoadFailed;\n ATSplashAd.Instance.client.onAdCloseEvent += onAdClose;\n ATSplashManager.Instance.ShowAdIfReady();\n }\n\n public void initFail(string msg)\n {\n Debug.Log(\"Developer callback SDK initFail:\" + msg);\n }\n \/\/ Ad loaded successfully, display it directly\n public void onAdLoad(object sender, ATAdEventArgs erg)\n {\n if (!erg.isTimeout)\n {\n ATSplashManager.Instance.ShowAdIfReady();\n }\n else \n {\n \/\/ Load timed out, do not call show to display the ad\n }\n } \n \/\/ Ad load timed out, no need to continue waiting for ad fill, go directly to the home screen\n public void onAdLoadTimeout(object sender, ATAdEventArgs erg)\n {\n\n }\n \/\/ Ad load failed\n public void onAdLoadFailed(object sender, ATAdErrorEventArgs args)\n {\n\n }\n \/\/ Ad closed, go to the home screen\n public void onAdClose(object sender, ATAdEventArgs erg)\n {\n\n }\n \/\/ Listen for app foreground events\n private void OnApplicationPause(bool pauseStatus)\n {\n if (!pauseStatus) \/\/ Returned from background to foreground\n {\n ATSplashManager.Instance.ShowAdIfReady();\n }\n }\n}\n\npublic class ATSplashManager\n {\n#if UNITY_ANDROID\n private const string SPLASH_PLACEMENT_ID = \"Your PlacementId\";\n#elif UNITY_IOS || UNITY_IPHONE\n private static string SPLASH_PLACEMENT_ID = \"Your PlacementId\";\n#endif\n\n private static ATSplashManager instance = new ATSplashManager();\n\n public static ATSplashManager Instance\n {\n get\n {\n return instance;\n }\n }\n\n public void ShowAdIfReady()\n {\n var splashAd = ATSplashAd.Instance;\n if (splashAd.hasSplashAdReady(SPLASH_PLACEMENT_ID))\n {\n splashAd.showSplashAd(SPLASH_PLACEMENT_ID, new Dictionary());\n }\n else\n {\n splashAd.loadSplashAd(SPLASH_PLACEMENT_ID, new Dictionary());\n }\n }\n }","is_draft":"0","editor_type":"2","file_path":"","add_time":"1709721645","update_time":"1782972252"},"pure_content":"1. Ad Introduction\nTaku Unity Plugin 2.0.0 supports accessing Splash Ads via C# API. Splash ads are similar to interstitial ads, but are generally displayed when the app is cold-started or hot-started"},{"id":"76341","string_id":"r6eied","status":"1","parent_id":"76330","slug":"Callback-information-description-dOjB","order":"12","name":"Callback information description","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722566","add_time":"1709721645","update_time":"1783492326","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76341","content":"ATAdEventArgs Parameter Description\n-----------------\n\n| Variable | Type | Description |\n|---|---|---|\n| placementId | String | Ad placement ID |\n| callbackInfo | ATCallbackInfo | Detailed content of the ad event **(see ATCallbackInfo description for details)** |\n| isTimeout | bool | Whether the ad load has timed out **(only applicable to Splash Ad)** |\n\nATAdErrorEventArgs Parameter Description\n----------------------\n\n| Variable | Type | Description |\n|---|---|---|\n| placementId | String | Ad placement ID |\n| callbackInfo | ATCallbackInfo | Detailed content of the ad event **(see ATCallbackInfo description for details)** |\n| errorCode | String | Error code |\n| errorMessage | String | Error content |\n\nATCallbackInfo Description\n----------------\n\n| Variable | Type | Description |\n|---|---|---|\n| network\\_firm\\_id | int | Get the ID corresponding to the ad platform, used to distinguish ad platforms |\n| adsource\\_id | string | Get the Ad Source ID. You can query specific Network information by Ad Source ID in the developer dashboard or via Taku Open API |\n| adsource\\_index | int | Get the ranking of the current Ad Source in the WaterFall **(starting from 0)** |\n| adsource\\_price | dounble | Get ECPM. The unit can be obtained via **\"currency\"** |\n| adsource\\_isheaderbidding | int | Whether it is a header bidding ad source. **1: Yes, 2: No** |\n| id | string | Get the unique ID generated each time **an ad is displayed** |\n| publisher\\_revenue | double | Get the impression revenue |\n| currency | string | Get the currency unit, e.g. \"USD\" |\n| country | string | Get the country code, e.g. \"CN\" |\n| adunit\\_id | string | Get the Taku ad placement ID |\n| adunit\\_format | string | Get the ad type, including: **\"Native\", \"RewardedVideo\", \"Banner\", \"Interstitial\", \"Splash\"** |\n| precision | string | Get the ECPM precision **\"publisher\\_defined\"**: The eCPM defined by the developer for the Ad Source in the Taku dashboard **(cross-promotion eCPM also falls under this type)** **\"estimated\":** Taku estimated eCPM (auto eCPM) **\"exact\"**: Header Bidding real-time bidding eCPM (except for Meta ad platform) **\"ecpm\\_api\"**: For Meta ad platform, historical eCPM estimated based on Meta's ReportAPI data. Supported in Taku SDK v5.9.60 and above. |\n| network\\_type | string | Get the Network type **\"Network\"**: Third-party ad platform **\"Cross\\_Promotion\"**: Cross-promotion **\"Adx\"**: Taku Adx |\n| network\\_placement\\_id | string | Get the Network's ad placement ID |\n| ecpm\\_level | int | Get the eCPM level of the Ad Source. **Header Bidding Ad Sources default to 0** |\n| segment\\_id | int | Get the traffic group ID |\n| scenario\\_id | string | Get the ad scenario ID. **Only supported for Rewarded Video & Interstitial (starting from v5.7.20, Native & Banner are also supported)** |\n| scenario\\_reward\\_name | string | Get the reward name of the ad scenario. **Only supported for Rewarded Video** |\n| scenario\\_reward\\_number | int | Get the reward amount of the ad scenario. **Only supported for Rewarded Video** |\n| sub\\_channel | string | Get the sub-channel information |\n| channel | string | Get the channel information |\n| custom\\_rule | Dictionary | Get the **JSON string** of the custom rules at **Placement+App level** |","pure_content":"ATAdEventArgs Parameter Description\n\n\n\n Variable\n Type\n Description\n\n\n\n\n placementId\n String\n Ad placement ID\n\n\n callbackInfo\n ATCallbackInfo\n Detailed content of the ad event (see ATCallbackInfo description for details)\n\n\n isTimeout\n bool\n Whether the ad load has timed out (only applicable to Splash Ad)\n\n\n\nATAdErrorEventArgs Parameter Description\n\n\n\n Variable\n Type\n Description\n\n\n\n\n placementId\n String\n Ad placement ID\n\n\n callbackInfo\n ATCallbackInfo\n Detailed content of the ad event (see ATCallbackInfo description for details)\n\n\n errorCode\n String\n Error code\n\n\n errorMessage\n String\n Error content\n\n\n\nATCallbackInfo Description\n\n\n\n Variable\n Type\n Description\n\n\n\n\n network_firm_id\n int\n Get the ID corresponding to the ad platform, used to distinguish ad platforms\n\n\n adsource_id\n string\n Get the Ad Source ID. You can query specific Network information by Ad Source ID in the developer dashboard or via Taku Open API\n\n\n adsource_index\n int\n Get the ranking of the current Ad Source in the WaterFall (starting from 0)\n\n\n adsource_price\n dounble\n Get ECPM. The unit can be obtained via \"currency\"\n\n\n adsource_isheaderbidding\n int\n Whether it is a header bidding ad source. 1: Yes, 2: No\n\n\n id\n string\n Get the unique ID generated each time an ad is displayed\n\n\n publisher_revenue\n double\n Get the impression revenue\n\n\n currency\n string\n Get the currency unit, e.g. \"USD\"\n\n\n country\n string\n Get the country code, e.g. \"CN\"\n\n\n adunit_id\n string\n Get the Taku ad placement ID\n\n\n adunit_format\n string\n Get the ad type, including: \"Native\", \"RewardedVideo\", \"Banner\", \"Interstitial\", \"Splash\"\n\n\n precision\n string\n Get the ECPM precision \"publisher_defined\": The eCPM defined by the developer for the Ad Source in the Taku dashboard (cross-promotion eCPM also falls under this type) \"estimated\": Taku estimated eCPM (auto eCPM) \"exact\": Header Bidding real-time bidding eCPM (except for Meta ad platform) \"ecpm_api\": For Meta ad platform, historical eCPM estimated based on Meta's ReportAPI data. Supported in Taku SDK v5.9.60 and above.\n\n\n network_type\n string\n Get the Network type \"Network\": Third-party ad platform \"Cross_Promotion\": Cross-promotion \"Adx\": Taku Adx\n\n\n network_placement_id\n string\n Get the Network's ad placement ID\n\n\n ecpm_level\n int\n Get the eCPM level of the Ad Source. Header Bidding Ad Sources default to 0\n\n\n segment_id\n int\n Get the traffic group ID\n\n\n scenario_id\n string\n Get the ad scenario ID. Only supported for Rewarded Video & Interstitial (starting from v5.7.20, Native & Banner are also supported)\n\n\n scenario_reward_name\n string\n Get the reward name of the ad scenario. Only supported for Rewarded Video\n\n\n scenario_reward_number\n int\n Get the reward amount of the ad scenario. Only supported for Rewarded Video\n\n\n sub_channel\n string\n Get the sub-channel information\n\n\n channel\n string\n Get the channel information\n\n\n custom_rule\n Dictionary\n Get the JSON string of the custom rules at Placement+App level","is_draft":"0","editor_type":"2","file_path":"","add_time":"1709721647","update_time":"1782972282"},"pure_content":"ATAdEventArgs Parameter Description\n\n\n\n Variable\n Type\n Description\n\n\n\n\n placementId\n String\n Ad placement ID\n\n\n callbackInfo\n ATCallbackInfo\n Detailed content of the ad event (see ATCallbackInfo desc"},{"id":"76342","string_id":"TUHAGA","status":"1","parent_id":"76330","slug":"Error-codes-and-FAQ","order":"11","name":"Error codes and FAQ","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1709722567","add_time":"1709721647","update_time":"1783492326","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"76342","content":"Error Codes & FAQ\n=======\n\nFor the Taku Unity SDK error codes and FAQ guide, please refer to:\n\n| System Platform | Description |\n|---|---|\n| Taku Android SDK | [View](https:\/\/help.takuad.com\/en\/docs\/Error-code-description-ua8l) |\n| Taku iOS SDK | [View](https:\/\/help.takuad.com\/en\/docs\/Error-code) |\n\n**Q:** Build error \"call to undeclared function 'typeof'; ISO C99 and later do not support implicit function declarations \\[-Wimplicit-function-declaration\\]\" as shown in the image below\n\n![Article Image](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/gX07bI\/65e843457ec41.png)\n\n**A:** This is caused by C++ version issues. Go to Build Settings -> Apple Clang - Language -> C Language Dialect -> change to c11, as shown in the image.\n\n![Article Image](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/gX07bI\/65e84345e22f6.png)\n\n**Q:** After exporting from Unity, the packaging encounters \"Missing signing identifier at 'xxxxxx\/Frameworks\/libswiftCore.dylib'\". How to resolve this?\n\n![Article Image](https:\/\/resource.helplook.net\/docker_production\/5expvy\/article\/gX07bI\/65e8434658865.png)\n\n**A:** Follow the steps below:\n\n1.**Select the Unity-iPhone project**\n\n2.**Select the UnityFramework Target**\n\n3.**Click Build Settings**\n\n4.**Type \"swift\" in the search box**\n\n5.**Set the \"Always Embed Swift Standard Libraries\" option to \"No\"**\n\nTip: Change the **UnityFramework** **Target**, not the **Unity-iPhone** **Target**.\n\n**Q:** Encountered error \"Invalid Bundle. The bundle at 'Marooned.app\/Frameworks\/UnityFramework.framework' contains disallowed file 'Frameworks'.\"\n\n**A:** Add a new Run Script in Build Phases and add the following code:\n\n```\ncd \"${CONFIGURATION_BUILD_DIR}\/${UNLOCALIZED_RESOURCES_FOLDER_PATH}\/Frameworks\/UnityFramework.framework\/\" \nif [[ -d \"Frameworks\" ]]; then \n```\n\n**Q:** During Interstitial Ad display, pressing the home button to go to the background and then clicking the app logo to return, the ad disappears or there is no callback\n\n**A:** Check the Manifest.xml configuration of the app's launch Activity. **launchMode must be standard**. Add the following code in the launch Activity's onCreate() method:\n\n```java\n@Override\nprotected void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n ......\n if ((getIntent().getFlags() & Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT) != 0) {\n finish();\n return;\n }\n ......\n}\n\n```\n\n> Note: You need to export the Android project for processing\n\n**Q:** Pangle and GDT have a conflict between android:allowBackup=\"true\" and android:allowBackup=\"false\"\n\n**A:** android:allowBackup=\"true\" tools:replace=\"android:allowBackup\"\n\nYou can add these two to the LauncherManifest.xml file","pure_content":"Error Codes & FAQ\nFor the Taku Unity SDK error codes and FAQ guide, please refer to:\n\n\n\n System Platform\n Description\n\n\n\n\n Taku Android SDK\n View\n\n\n Taku iOS SDK\n View\n\n\n\nQ: Build error \"call to undeclared function 'typeof'; ISO C99 and later do not support implicit function declarations [-Wimplicit-function-declaration]\" as shown in the image below\n\nA: This is caused by C++ version issues. Go to Build Settings -> Apple Clang - Language -> C Language Dialect -> change to c11, as shown in the image.\n\nQ: After exporting from Unity, the packaging encounters \"Missing signing identifier at 'xxxxxx\/Frameworks\/libswiftCore.dylib'\". How to resolve this?\n\nA: Follow the steps below:\n1.Select the Unity-iPhone project\n2.Select the UnityFramework Target\n3.Click Build Settings\n4.Type \"swift\" in the search box\n5.Set the \"Always Embed Swift Standard Libraries\" option to \"No\"\nTip: Change the UnityFramework Target, not the Unity-iPhone Target.\nQ: Encountered error \"Invalid Bundle. The bundle at 'Marooned.app\/Frameworks\/UnityFramework.framework' contains disallowed file 'Frameworks'.\"\nA: Add a new Run Script in Build Phases and add the following code:\ncd \"${CONFIGURATION_BUILD_DIR}\/${UNLOCALIZED_RESOURCES_FOLDER_PATH}\/Frameworks\/UnityFramework.framework\/\" \nif [[ -d \"Frameworks\" ]]; then \n\nQ: During Interstitial Ad display, pressing the home button to go to the background and then clicking the app logo to return, the ad disappears or there is no callback\nA: Check the Manifest.xml configuration of the app's launch Activity. launchMode must be standard. Add the following code in the launch Activity's onCreate() method:\n@Override\nprotected void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n ......\n if ((getIntent().getFlags() & Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT) != 0) {\n finish();\n return;\n }\n ......\n}\n\n\n\nNote: You need to export the Android project for processing\n\nQ: Pangle and GDT have a conflict between android:allowBackup=\"true\" and android:allowBackup=\"false\"\nA: android:allowBackup=\"true\" tools:replace=\"android:allowBackup\"\nYou can add these two to the LauncherManifest.xml file","is_draft":"0","editor_type":"2","file_path":"","add_time":"1709721649","update_time":"1782972446"},"pure_content":"Error Codes & FAQ\nFor the Taku Unity SDK error codes and FAQ guide, please refer to:\n\n\n\n System Platform\n Description\n\n\n\n\n Taku Android SDK\n View\n\n\n Taku iOS SDK\n View\n\n\n\nQ: Build error \"call to undec"},{"id":"863599","string_id":"4sRHzFFS","status":"1","parent_id":"76330","slug":"4sRHzFFS","order":"10","name":"Third-Party Revenue Callback","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1783492342","add_time":"1783492302","update_time":"1783492342","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"863599","content":"> **\ud83d\udca1Tips:**\n> \n> - Unity plugin version requirement: v2.1.8 or above\n\n```java\n\/\/NativeAd\nATNativeAd.Instance.setAdRevenueListener(mPlacementId, new DemoAdRevenueListener());\n\/\/BannerAd\nATBannerAd.Instance.setAdRevenueListener(mPlacementId, new DemoAdRevenueListener());\n\/\/InterstitialAd\nATInterstitialAd.Instance.setAdRevenueListener(mPlacementId, new DemoAdRevenueListener());\n\/\/SplashAd\nATSplashAd.Instance.setAdRevenueListener(mPlacementId, new DemoAdRevenueListener());\n\/\/RewardedVideo\nATRewardedVideo.Instance.setAdRevenueListener(mPlacementId, new DemoAdRevenueListener());\n\/\/Implement IATAdRevenueListener\nprivate sealed class DemoAdRevenueListener : IATAdRevenueListener\n {\n public void onAdRevenuePaid(string placementId, ATCallbackInfo adInfo)\n {\n \/\/adsource_price is the CPM (cost per mille), publisher_revenue is the per-impression revenue\n Debug.Log(\"::onAdRevenuePaid() >>> \" + placementId + \", adInfo=\" + (adInfo != null ? adInfo.getOriginJSONString() : \"\"));\n }\n }\n```","pure_content":"\ud83d\udca1Tips:\n\nUnity plugin version requirement: v2.1.8 or above\n\n\n\/\/NativeAd\nATNativeAd.Instance.setAdRevenueListener(mPlacementId, new DemoAdRevenueListener());\n\/\/BannerAd\nATBannerAd.Instance.setAdRevenueListener(mPlacementId, new DemoAdRevenueListener());\n\/\/InterstitialAd\nATInterstitialAd.Instance.setAdRevenueListener(mPlacementId, new DemoAdRevenueListener());\n\/\/SplashAd\nATSplashAd.Instance.setAdRevenueListener(mPlacementId, new DemoAdRevenueListener());\n\/\/RewardedVideo\nATRewardedVideo.Instance.setAdRevenueListener(mPlacementId, new DemoAdRevenueListener());\n\/\/Implement IATAdRevenueListener\nprivate sealed class DemoAdRevenueListener : IATAdRevenueListener\n {\n public void onAdRevenuePaid(string placementId, ATCallbackInfo adInfo)\n {\n \/\/adsource_price is the CPM (cost per mille), publisher_revenue is the per-impression revenue\n Debug.Log(\"::onAdRevenuePaid() >>> \" + placementId + \", adInfo=\" + (adInfo != null ? adInfo.getOriginJSONString() : \"\"));\n }\n }","is_draft":"0","editor_type":"2","file_path":"","add_time":"1783492302","update_time":"1783492342"},"pure_content":"\ud83d\udca1Tips:\n\nUnity plugin version requirement: v2.1.8 or above\n\n\n\/\/NativeAd\nATNativeAd.Instance.setAdRevenueListener(mPlacementId, new DemoAdRevenueListener());\n\/\/BannerAd\nATBannerAd.Instance.setAdRevenue"}],"content":{"icon":"","desc":"","content_id":"76330","add_time":"1709721628","update_time":"1709722563","content":"","is_traffic_less":"0","file_type":""},"hot_list":[],"user_read_num":"0","is_auth":"0"},"msg":"Success","code":200}