图文型官网站,网站建设sem,各种软件开发定制,手工制作国庆节作品场景介绍
插屏广告是一种在应用开启、暂停或退出时以全屏或半屏的形式弹出的广告形式#xff0c;展示时机巧妙避开用户对应用的正常体验#xff0c;尺寸大#xff0c;曝光效果好。 接口说明 接口名 描述 loadAd(adParam: AdRequestParams, adOptions: AdOptions, listene…场景介绍
插屏广告是一种在应用开启、暂停或退出时以全屏或半屏的形式弹出的广告形式展示时机巧妙避开用户对应用的正常体验尺寸大曝光效果好。 接口说明 接口名 描述 loadAd(adParam: AdRequestParams, adOptions: AdOptions, listener: AdLoadListener): void 请求单广告位广告通过AdRequestParams、AdOptions进行广告请求参数设置通过AdLoadListener监听广告请求回调。 showAd(ad: Advertisement, options: AdDisplayOptions, context?: common.UIAbilityContext): void 展示广告通过AdDisplayOptions进行广告展示参数设置。
开发步骤
获取OAID。 如果想要为用户更精准的推送广告可以在请求参数AdRequestParams中添加oaid属性。 如何获取OAID参见获取OAID信息。 说明 使用以下示例中提供的测试广告位必须先获取OAID信息。 请求单广告位广告。 需要先创建一个AdLoader对象通过AdLoader的loadAd方法请求广告最后通过AdLoadListener来监听广告的加载状态。 请求广告关键参数如下所示 请求广告参数名 类型 必填 说明 adType number 是 请求广告类型插屏广告类型为12。 adId string 是 广告位ID。 如果仅调测广告可使用测试广告位IDtestb4znbuh3n2。如果要接入正式广告则需要申请正式的广告位ID。可在应用发布前进入流量变现官网点击“开始变现”登录鲸鸿动能媒体服务平台进行申请具体操作详情请参见展示位创建。 oaid string 否 开放匿名设备标识符用于精准推送广告。不填无法获取到个性化广告。 示例代码如下所示 import { advertising, identifier } from kit.AdsKit;import { common } from kit.AbilityKit;import { hilog } from kit.PerformanceAnalysisKit;import { BusinessError } from kit.BasicServicesKit;EntryComponentstruct Index {private ads: Arrayadvertising.Advertisement [];private context getContext(this) as common.UIAbilityContext;private oaid: string ;aboutToAppear() {try {// 使用Promise回调方式获取OAIDidentifier.getOAID().then((data) {this.oaid data;hilog.info(0x0000, testTag, %{public}s, Succeeded in getting adsIdentifierInfo by promise);}).catch((error: BusinessError) {hilog.error(0x0000, testTag, %{public}s, Failed to get adsIdentifierInfo, message: ${error.message});})} catch (error) {hilog.error(0x0000, testTag, %{public}s, Catch err, code: ${error.code}, message: ${error.message});}}build() {Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {Row() {Button(requestAd).onClick(() {let load: advertising.AdLoader new advertising.AdLoader(this.context);this.requestAd(load);}).width(45%)}}}private requestAd(adLoader: advertising.AdLoader): void {const adRequestParam: advertising.AdRequestParams {// 广告类型插屏广告adType: 12,// testb4znbuh3n2为测试专用的广告位IDApp正式发布时需要改为正式的广告位IDadId: testb4znbuh3n2,// 开放匿名设备标识符oaid: this.oaid};const adOption: advertising.AdOptions {// 设置是否请求非个性化广告nonPersonalizedAd: 0,// 是否允许流量下载0不允许1允许不设置以广告主设置为准allowMobileTraffic: 0,// 是否希望根据 COPPA 的规定将您的内容视为面向儿童的内容: -1默认值不确定 0不希望 1希望tagForChildProtection: -1,// 是否希望按适合未达到法定承诺年龄的欧洲经济区 (EEA) 用户的方式处理该广告请求 -1默认值不确定 0不希望 1希望tagForUnderAgeOfPromise: -1,// 设置广告内容分级上限: W: 3,所有受众 PI: 7,家长指导 J:12,青少年 A: 16/18成人受众adContentClassification: A};const adLoaderListener: advertising.AdLoadListener {onAdLoadFailure: (errorCode: number, errorMsg: string) {hilog.error(0x0000, testTag, %{public}s,Failed to request ad, message: ${errorMsg}, error code: ${errorCode});},onAdLoadSuccess: (ads: Arrayadvertising.Advertisement) {hilog.info(0x0000, testTag, %{public}s, Succeeded in requesting ad!);this.ads [];this.ads.push(...ads);},};adLoader.loadAd(adRequestParam, adOption, adLoaderListener);}} 事件订阅。 开发者需要在App中订阅com.huawei.hms.pps.action.PPS_INTERSTITIAL_STATUS_CHANGED事件来监听插屏广告页面变化并接收插屏信息。示例代码中的订阅方法registerPPSReceiver()需要在每次展示广告前调用 。 在订阅到公共事件后可以从CommonEventData的parameters参数中使用interstitial_ad_status作为key值获取插屏广告页面变化状态。 示例代码如下所示 import { commonEventManager, BusinessError } from kit.BasicServicesKit;import { hilog } from kit.PerformanceAnalysisKit;const KEY_INTERSTITIAL_STATUS interstitial_ad_status;export class InterstitialAdStatusHandler {// 用于保存创建成功的订阅者对象后续使用其完成订阅及退订的动作private subscriber: commonEventManager.CommonEventSubscriber | null null;// 订阅方法需要在每次展示广告前调用public registerPPSReceiver(): void {if (this.subscriber) {this.unRegisterPPSReceiver();}// 订阅者信息const subscribeInfo: commonEventManager.CommonEventSubscribeInfo {events: [com.huawei.hms.pps.action.PPS_INTERSTITIAL_STATUS_CHANGED],publisherBundleName: com.huawei.hms.adsservice};// 创建订阅者回调commonEventManager.createSubscriber(subscribeInfo,(err: BusinessError, commonEventSubscriber: commonEventManager.CommonEventSubscriber) {if (err) {hilog.error(0x0000, testTag, %{public}s, CreateSubscriber error, ${err.code}, message: ${err.message}});return;}hilog.info(0x0000, testTag, %{public}s, Succeeded in creating subscriber);this.subscriber commonEventSubscriber;// 订阅公共事件回调if (!this.subscriber) {hilog.warn(0x0000, testTag, %{public}s, Need to create subscriber);return;}commonEventManager.subscribe(this.subscriber,(err: BusinessError, commonEventData: commonEventManager.CommonEventData) {if (err) {hilog.error(0x0000, testTag, %{public}s, Subscribe error, ${err.code}, message: ${err.message});} else {// 订阅者成功接收到公共事件hilog.info(0x0000, testTag, %{public}s, Succeeded subscribing data);// 获取插屏广告页面变化状态const status: string commonEventData?.parameters?.[KEY_INTERSTITIAL_STATUS];switch (status) {case AdStatus.AD_OPEN:hilog.info(0x0000, testTag, %{public}s, onAdOpen);break;case AdStatus.AD_CLICKED:hilog.info(0x0000, testTag, %{public}s, onAdClick);break;case AdStatus.AD_CLOSED:hilog.info(0x0000, testTag, %{public}s, onAdClose);this.unRegisterPPSReceiver();break;case AdStatus.AD_VIDEO_START:hilog.info(0x0000, testTag, %{public}s, onAdVideoStart);break;case AdStatus.AD_COMPLETED:hilog.info(0x0000, testTag, %{public}s, onAdCompleted);break;default:break;}}});});}// 取消订阅public unRegisterPPSReceiver(): void {commonEventManager.unsubscribe(this.subscriber, (err: BusinessError) {if (err) {hilog.error(0x0000, testTag, %{public}s, Unsubscribe error, ${err.code}, message: ${err.message}});} else {hilog.info(0x0000, testTag, %{public}s, Succeeded in unsubscribing);this.subscriber null;}});}}enum AdStatus {AD_OPEN onAdOpen,AD_CLICKED onAdClick,AD_CLOSED onAdClose,AD_VIDEO_START onVideoPlayBegin,AD_COMPLETED onVideoPlayEnd} 展示广告。 ads为步骤2请求到的广告信息调用showAd方法来展示广告。示例代码如下所示 import { advertising } from kit.AdsKit;import { common } from kit.AbilityKit;EntryComponentstruct Index {private context: common.UIAbilityContext getContext(this) as common.UIAbilityContext;// 步骤2中请求到的广告内容private ads: Arrayadvertising.Advertisement [];private displayOptions: advertising.AdDisplayOptions {// 插屏广告视频播放是否静音mute: true};build() {Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {Row() {Button(showAd).onClick(() {this.showAd();}).width(45%)}}}private showAd() {// 请在此处自行增加步骤3中的注册插屏广告状态监听器// ...// 此处ads[0]表示请求到的第一个广告用户根据实际情况选择advertising.showAd(this.ads[0], this.displayOptions, this.context);}}
