原生广告

1. 加载广告

const atNativeAd = new ATNativeAd("your placement id");
atNativeAd.setAdListener({
  onAdLoaded: (): void => { },
  onAdLoadFailed: (adError: ATAdError): void => { }
  onAdOtherStatus: (adInfo?: ATAdInfo | undefined): void => { }
});
atNativeAd.loadAd({
  context: getContext(),
  uiContext: this.getUIContext()
});

2. 展示广告

（1）先通过ATNative#getNativeAd()获取广告对象NativeAd

const nativeAd = atNativeAd.getNativeAd();
if (!nativeAd) {
  this.adMsg = "ad is not ready";
  return;
}
nativeAd?.setNativeAdEventListener({
  onAdShow: (adInfo: ATAdInfo): void => { },
  onAdClose: (adInfo: ATAdInfo): void => { },
  onAdClick: (adInfo: ATAdInfo): void => { },
  onAdDislikeClick: (adInfo: ATAdInfo): void => { },
  onAdVideoResume: (adInfo: ATAdInfo): void => { },
  onAdVideoPause: (adInfo: ATAdInfo): void => { },
  onAdVideoPlayStart: (adInfo: ATAdInfo): void => { },
  onAdVideoPlayEnd: (adInfo: ATAdInfo): void => { },
  onAdVideoPlayFailed: (adError: ATAdError, adInfo?: ATAdInfo | undefined): void => { }
})

（2）再通过NativeAd的isNativeExpress方法判断是自渲染还是模板渲染

if (nativeAd?.isNativeExpress()) {
  // 模板渲染
  ...
} else {
  // 自渲染
  ...
}

● 模板渲染

@Component
struct NativeAdPage {

  build() {
    ... 
    BuildATNativeAdExpressView(nativeAd);
    ...
  }

}

● 自渲染

3. API说明

● ATNativeAd

原生广告的操作类，负责广告加载、监听、显示等。

● ATNativeAdLoadListener

广告位层级的广告事件回调

● NativeAd

原生广告对象，用于展示广告

● ATNativeAdEventListener

广告展示相关的事件监听回调

● ATNativeAdMaterial

自渲染广告返回的广告素材对象

注意事项

● 快手

如果有集成快手平台，需要调用以下广告曝光和广告点击的api。

广告曝光

// 添加可⻅区域监听，SDK内部处理曝光逻辑
.onVisibleAreaChange(this.itemInfo.nativeAd?.getVisibleAreaRatios(), 
this.itemInfo.nativeAd?.getVisibleAreaChangeListener())

广告点击

.onClick((e: ClickEvent) => {
// 点击转化
this.itemInfo?.nativeAd?.getClickHandler()(getContext(this) as common.UIAbilityContext, 
e)
})