Search...
Menu
Native
1. Introduction to native advertising
Currently supported native advertising access methods are: Self-rendering information flow advertising , Template information flow advertisement, Draw information flow advertisement
Note: The above native ad styles use the same set of APIs for access, and developers can mix different native styles in the same waterfall flow
2. Description of different access methods
| Access method | Description |
|---|---|
| Self-rendering information flow advertisement | Developers can obtain all advertising materials through the API and customize their own UI layout for access. The access method can be viewed: Information flow self-rendering ads |
| Template information flow ads | Developers can obtain a fully rendered ad View through the API, and directly add it to the designated location for display. Enter the method to view: Information flow template advertisement |
| Draw information flow advertisement | Mainly suitable for scene access of full-screen page-turning video information flow, access method Can be viewed: Draw information flow advertising access |
3. API description
3.1 Initialization
- ATNative: Native ad loading class
| API | Parameter | Description |
|---|---|---|
| ATNative | Context context, String nativeTakuPlacementID, ATNativeNetworkListener listener | Native advertising initialization method, in which nativeTakuPlacementID is created through the Taku background Native advertising slotObtained |
- ATNativeNetworkListener: Advertisement loading listener
| Method | Parameters | |
|---|---|---|
| onNativeAdLoaded | - | Ad loaded successfully |
| onNativeAdLoadFail | (AdError error) | Ad loading failed, all error information can be obtained through AdError.getFullErrorInfo(), please refer to AdError Note: It is forbidden to execute advertisements in this callback Loading method to retry, otherwise it will cause a lot of useless requests and may cause the application to freeze |
3.2 Advertisement loading
- ATNative: Native ad loading class
3.3 Advertising display
NativeAd: Obtained through getNativeAd Ad object
| API | Parameters | Description |
|---|---|---|
| setLocalExtra | Map | Set local parameters |
| makeAdRequest | - | Initiate a Native ad request |
| getNativeAd | - | Get loaded ads(recommendation After obtaining, a non-null judgment must be made, because null may appear in some cases, and it will be null when there is no ad cache) Note: After calling this method, the SDK will remove the ad cache once. If the NativeAd obtained through this method is not null, the developer must reference it by themselves for subsequent ad display, otherwise the next time this method is called, null may be returned due to no ad cache |
| (Deprecated since v6.3.10) Get the loaded ad(It is recommended to make a non-null judgment after obtaining it, because null may appear in some cases), and set advertising scenes for subsequent ads. Please refer to Advertising scene Note: Same as above | ||
| getNativeAd | (ATShowConfig showConfig) | (v6.3.10+) Get the loaded ad(It is recommended to make a non-null judgment after obtaining it, because null may appear in some cases) showConfig: You can pass in additional parameters during display, as follows 1.ATShowConfig#showCustomExt(String showCustomExt): You can pass in custom parameters during display, and the parameters passed in will be returned through ATAdInfo#getShowCustomExt() 2.ATShowConfig#scenarioId(String scenarioId): Advertising scenarios can be passed in, the same as getNativeAd(String scenario) |
| (static) entryAdScenario | (String placementId, String scenarioId) | Enter the current business scenario Ad space cache status statistics. The scenario refers to the advertising display scene (not required, null can be passed directly). Scene parameters can be |
| checkValidAdCaches | Query the ATAdInfo object of all cached information of the current ad slot ATAdInfo: the information object of the advertisement, which can be distinguished Advertising platform, mainly includes the id information of the third-party aggregation platform See ATAdInfo information description |
| Method th> | Parameters | Description |
|---|---|---|
| isNativeExpress | - | Whether it is a template rendering type of advertisement |
| renderAdContainer | (ATNativeAdView view, View selfRenderView) | is used for ad rendering, where the view must use the ATNativeAdView we provide Note: When calling isNativeExpress() to return false (i.e. self-rendering), selfRenderView must pass in the developer's customized View. When returning true (template rendering), null can be passed |
| (ATNativeAdView view, ATNativePrepareInfo nativePrepareInfo) | is used to configure ad click events, bind the close button during self-rendering, control the placement and size of the ad logo, etc., and is called after the renderAdContainer method (By default, all views are clickable, and those with advertising logos will have default placement and size) |
3.4 Other API
| API | Parameter | Description |
|---|---|---|
| getAdInfo | - | Get the current ad cache information ATAdInfo object, which mainly includes the id information of the third-party aggregation platform. See ATAdInfo information description |
| clear | (ATNativeAdView view) | Remove the binding of the ad to the view |
| onResume | - | Called during Activity's onResume (mainly for video ads on some advertising platforms) |
| onPause | - | Called during Activity's onPause ( Mainly for video ads on some advertising platforms) |
| destory | - | Destroy the current ad object (the ad can no longer be displayed after execution) |
3.5 Event callback
- NativeAd: The advertising object obtained through getNativeAd
| method | Parameters | Description |
|---|---|---|
| setNativeEventListener | (ATNativeEventListener listener) | Set advertising event listening, where ATNativeEventListener is the interface class of advertising events |
| setDislikeCallbackListener | (ATNativeDislikeListener listener) | Set ad closing event callback(Currently only pangolin (Pangle), Guangdiantong and Kuaishou template ads are valid) |
- ATNativeDislikeListener:Advertising Dislike listening class
| Method | Parameters | Description |
|---|---|---|
| onAdCloseButtonClick | (ATNativeAdView view, ATAdInfo atAdInfo) | This method is called when the close button is clicked. If you want to remove the advertisement, the developer needs to manually call the code in this callback to remove the Native View. ATAdInfo is the information object of the advertisement, which mainly contains the id information of the third-party aggregation platformSee ATAdInfo information description |
- ATNativeEventListener: Advertising event listening interface class
| method | Parameters | Description |
|---|---|---|
| onAdImpressed | (ATNativeAdView view, ATAdInfo atAdInfo) | |
| onAdClicked | (ATNativeAdView view, ATAdInfo atAdInfo) | Advertising Click callback The meaning of parameters is the same as above |
| onAdVideoStart | (ATNativeAdView view) | Ad video playback starts (only exists on some advertising platforms) |
| onAdVideoEnd | ( ATNativeAdView view) | Advertising video playback ends (only exists on some advertising platforms) |
| onAdVideoProgress | (ATNativeAdView view, int progress) |
Previous
Banner Ad
Next
self-rendering ads
Last modified: 2025-05-30Powered by;}.cls-2{fill:%230868f7;}.cls-3{fill:url(%23未命名的渐变_44);}.cls-4{fill:%23333;}%3c/style%3e%3clinearGradient%20id='未命名的渐变_8'%20x1='33.73'%20y1='100.61'%20x2='-0.03'%20y2='-1.06'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%237ae9fb'/%3e%3cstop%20offset='0.67'%20stop-color='%232b90f8'/%3e%3cstop%20offset='1'%20stop-color='%230868f7'/%3e%3c/linearGradient%3e%3clinearGradient%20id='未命名的渐变_44'%20x1='27.86'%20y1='18.67'%20x2='68.36'%20y2='22.22'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%235ac7f2'/%3e%3cstop%20offset='1'%20stop-color='%230868f7'/%3e%3c/linearGradient%3e%3c/defs%3e%3cpath%20class='cls-1'%20d='M29,28.74V81.91l-9.51-3.68v0L8.52,74A7.17,7.17,0,0,1,4,67.32V24.54A3.76,3.76,0,0,1,9.08,21Z'/%3e%3cpath%20class='cls-2'%20d='M68.09,78.07a13.15,13.15,0,0,1-17.9,12.06L29,81.91h0V28.74L50.19,37A13.17,13.17,0,0,0,68.08,25.3h0Z'/%3e%3cpath%20class='cls-3'%20d='M68.08,25.3a13.19,13.19,0,0,1-6.73,10.87A13.09,13.09,0,0,1,50.19,37L29,28.74V6A3.76,3.76,0,0,1,34.1,2.52l25.59,9.91A13.22,13.22,0,0,1,68.08,25.3Z'/%3e%3cpath%20class='cls-4'%20d='M129.06,81.76a4.33,4.33,0,0,1-3.19-1.31,4.4,4.4,0,0,1-1.31-3.24V56.86H97.65V77.21a4.36,4.36,0,0,1-1.35,3.2A4.68,4.68,0,0,1,93,81.76a4.32,4.32,0,0,1-3.19-1.31,4.37,4.37,0,0,1-1.32-3.24V27.27A4.58,4.58,0,0,1,89.83,24a4.59,4.59,0,0,1,7.82,3.27V48.15h26.91V27.27A4.58,4.58,0,0,1,125.91,24a4.59,4.59,0,0,1,7.82,3.27V77.21a4.37,4.37,0,0,1-1.36,3.2A4.65,4.65,0,0,1,129.06,81.76Z'/%3e%3cpath%20class='cls-4'%20d='M163.77,81.66c-6.57,0-11.76-1.92-15.44-5.7s-5.54-9.07-5.54-15.74a26.76,26.76,0,0,1,2.09-10.43,17.72,17.72,0,0,1,6.67-8.06,19.15,19.15,0,0,1,10.68-2.95,19,19,0,0,1,10.46,2.8,18.7,18.7,0,0,1,6.55,7.36,22.53,22.53,0,0,1,2.36,10.28A4.51,4.51,0,0,1,177,63.77H152.23a10.8,10.8,0,0,0,3.49,6.65c2,1.68,4.88,2.52,8.66,2.52a22.25,22.25,0,0,0,7.54-1.21c.74-.3,1.55-.67,2.37-1.07a3.75,3.75,0,0,1,1.84-.4,4.09,4.09,0,0,1,3,1.15,4,4,0,0,1,1.12,3,4.38,4.38,0,0,1-2.58,3.82,32.34,32.34,0,0,1-6.36,2.61A28.67,28.67,0,0,1,163.77,81.66ZM172.4,55.9a9.72,9.72,0,0,0-1.63-4.56A9.9,9.9,0,0,0,167,48a10.38,10.38,0,0,0-4.64-1.14,12,12,0,0,0-4.77,1.06,9.54,9.54,0,0,0-4.89,5.66,11.78,11.78,0,0,0-.51,2.3Z'/%3e%3cpath%20class='cls-4'%20d='M193,81.64a4.49,4.49,0,0,1-4.51-4.55V27.28A4.58,4.58,0,0,1,189.84,24a4.48,4.48,0,0,1,3.28-1.36A4.36,4.36,0,0,1,196.35,24a4.46,4.46,0,0,1,1.31,3.31V77.09a4.34,4.34,0,0,1-1.35,3.2A4.67,4.67,0,0,1,193,81.64Z'/%3e%3cpath%20class='cls-4'%20d='M263.79,81.71a5.7,5.7,0,0,1-4.2-1.74,5.76,5.76,0,0,1-1.73-4.19V27.37a4.58,4.58,0,0,1,1.35-3.27A4.59,4.59,0,0,1,267,27.37V72.53h24a4.58,4.58,0,0,1,3.27,7.82A4.66,4.66,0,0,1,291,81.71Z'/%3e%3cpath%20class='cls-4'%20d='M424.48,81.74a4.71,4.71,0,0,1-2.71-.88,5.43,5.43,0,0,1-1-1l-.07-.09-12.41-17-5.41,5v9.44a4.31,4.31,0,0,1-1.36,3.19,4.66,4.66,0,0,1-3.3,1.36A4.29,4.29,0,0,1,395,80.42a4.36,4.36,0,0,1-1.32-3.23V27.37A4.58,4.58,0,0,1,395,24.1a4.52,4.52,0,0,1,6.58.12,4.54,4.54,0,0,1,1.24,3.15V56.31l17.72-16.38.05,0a4.8,4.8,0,0,1,2.94-1.11,4.4,4.4,0,0,1,3.27,1.2,4.57,4.57,0,0,1,1.2,3.27,4.44,4.44,0,0,1-.77,2.33,7.45,7.45,0,0,1-1.43,1.65l-11,9.64,13.34,17.68a5,5,0,0,1,1,2.71,4.12,4.12,0,0,1-1.36,3.24A4.64,4.64,0,0,1,424.48,81.74Z'/%3e%3cpath%20class='cls-4'%20d='M317.93,81.76a21.5,21.5,0,1,1,21.17-21.5A21.37,21.37,0,0,1,317.93,81.76Zm0-34.1a12.61,12.61,0,1,0,12.42,12.6A12.52,12.52,0,0,0,317.93,47.66Z'/%3e%3cpath%20class='cls-4'%20d='M212.18,101.22a4.12,4.12,0,0,1-3.05-1.26,4.17,4.17,0,0,1-1.26-3.1V43.34a4.37,4.37,0,0,1,1.3-3.14,4.26,4.26,0,0,1,3.13-1.3,4.19,4.19,0,0,1,3.1,1.26,4.32,4.32,0,0,1,1.26,3.16,20.77,20.77,0,0,1,13-4.54,21.51,21.51,0,0,1,0,43,20.51,20.51,0,0,1-13-4.57V96.86a4.15,4.15,0,0,1-1.3,3.06A4.5,4.5,0,0,1,212.18,101.22Zm17.43-53.63c-6.23,0-12.93,4.11-12.93,12.72a12.73,12.73,0,0,0,25.46,0A12.71,12.71,0,0,0,229.61,47.59Z'/%3e%3cpath%20class='cls-4'%20d='M365.76,81.76a21.5,21.5,0,1,1,21.18-21.5A21.37,21.37,0,0,1,365.76,81.76Zm0-34.1a12.61,12.61,0,1,0,12.42,12.6A12.52,12.52,0,0,0,365.76,47.66Z'/%3e%3c/svg%3e)
Outline