HarmonyOS NEXT应用开发，接入广告云云简单(避坑指南)

篮之新喜  论坛元老 | 2025-4-1 04:39:12 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题
楼主

主题 1847|帖子 1847|积分 5551

广告的使用，本该是挺简单的。只是初次打仗时，有点懵，不知道怎么用。实在记住两点就行了，一个是广告请求，可以看做是给你提供好了API接口，按照规范传参就行了。一个是广告展示，不同类型广告对应的有组件可用。最后，至于布局嘛，则跟其他平凡组件类似。记住这些就已经掌握了广告。
  本文先对广告服务就行先容 ，后续对广告接口举行一层封装，便于使用。
避坑指南：
1.模仿器中不支持广告。别纠结于为啥白屏。
2.测试广告位不稳固，别纠结于真机有时候也总返回 21800003
Failed to request ad, code is: 21800003errorMsg is: Failed to load the ad request
测试发起：先在真机跑跑demo，先看看官方的测试广告位是否正常。
广告服务（Ads Kit）先容

Ads Kit（广告服务）依托华为终端平台与数据能力为您提供流量变现服务，帮助您解决流量变现的困难；同时为广告主提供广告服务，配合华为终端平台向用户提供个性化的营销活动或贸易广告。
鲸鸿动能流量变现服务（以下简称流量变现服务）是广告服务依托华为终端强大的平台与数据能力为您提供的App流量变现服务，您通过该服务可以在自己的App中获取并向用户展示精美的、高价值的广告内容，并从中获得广告收益。
为满意App不同场景下的内容形式，流量变现服务为您提供了横幅广告、原生广告、激励广告、插屏广告、开屏广告、贴片广告六种广告形式。
Ads Kit提供广告标识符和转化跟踪能力，方便广告平台和广告主举行个性化广告投放和广告转化渠道跟踪。
开放匿名设备标识符（Open Anonymous Device Identifier, OAID，以下简称OAID）：是一种非永久性设备标识符，基于开放匿名设备标识符，可在掩护用户个人数据隐私安全的前提下，向用户提供个性化广告，同时三方监测平台也可以向广告主提供转化归因分析。

广告类型

横幅广告 

场景先容

横幅广告又名Banner广告，是在应用程序顶部、中部或底部占据一个位置的矩形图片，广告内容每隔一段时间会自动刷新。

基本使用

  1. import { advertising, AutoAdComponent, identifier } from '@kit.AdsKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. import { BusinessError } from '@kit.BasicServicesKit';
  5. @Entry
  6. @Component
  7. struct Index {
  8.   @State adParam: advertising.AdRequestParams = {
  9.     // 广告类型：横幅广告
  10.     adType: 8,
  11.     // 'testw6vs28auh3'为测试专用的广告位ID，App正式发布时需要改为正式的广告位ID
  12.     adId: 'testw6vs28auh3',
  13.     // 广告位宽
  14.     adWidth: 360,
  15.     // 广告位高
  16.     adHeight: 57,
  17.     // 开放匿名设备标识符
  18.     oaid: ''
  19.   };
  20.   private adOptions: advertising.AdOptions = {
  21.     // 是否允许流量下载0：不允许，1：允许，不设置以广告主设置为准
  22.     allowMobileTraffic: 0,
  23.     // 是否希望根据 COPPA 的规定将您的内容视为面向儿童的内容: -1默认值，不确定 0不希望 1希望
  24.     tagForChildProtection: -1,
  25.     // 是否希望按适合未达到法定承诺年龄的欧洲经济区 (EEA) 用户的方式处理该广告请求： -1默认值，不确定 0不希望 1希望
  26.     tagForUnderAgeOfPromise: -1,
  27.     // 设置广告内容分级上限: W: 3+,所有受众 PI: 7+,家长指导 J:12+,青少年 A: 16+/18+，成人受众
  28.     adContentClassification: 'A'
  29.   };
  30.   private displayOptions: advertising.AdDisplayOptions = {
  31.     // 广告轮播的时间间隔，单位ms，取值范围[30000, 120000]
  32.     refreshTime: 30000
  33.   }
  34.   private ratio: number = 1;
  35.   private adWidth: number = -1;
  36.   private adHeight: number = -1;
  37.   @State visibilityState: Visibility = Visibility.Visible;
  39.   aboutToAppear() {
  40.     try {
  41.       // 使用Promise回调方式获取OAID
  42.       identifier.getOAID().then((data) => {
  43.         this.adParam.oaid = data;
  44.         hilog.info(0x0000, 'testTag', '%{public}s', `Succeeded in getting adsIdentifierInfo by promise`);
  45.       }).catch((error: BusinessError) => {
  46.         hilog.error(0x0000, 'testTag', '%{public}s',
  47.           `Failed to get adsIdentifierInfo, code: ${error.code}, message: ${error.message}`);
  48.       })
  49.     } catch (error) {
  50.       hilog.error(0x0000, 'testTag', '%{public}s', `Catch err, code: ${error.code}, message: ${error.message}`);
  51.     }
  53.     if (this.adParam?.adWidth && typeof (this.adParam?.adWidth) === 'number' && this.adParam?.adWidth > 0) {
  54.       this.adWidth = this.adParam?.adWidth;
  55.     }
  56.     if (this.adParam?.adHeight && typeof (this.adParam?.adHeight) === 'number' && this.adParam?.adHeight > 0) {
  57.       this.adHeight = this.adParam?.adHeight;
  58.     }
  59.     if (this.adWidth > 0 && this.adHeight > 0) {
  60.       this.ratio = this.adWidth / this.adHeight;
  61.     }
  62.   }
  64.   build() {
  65.     if (this.adParam.oaid) {
  66.       Stack({ alignContent: Alignment.Bottom }) {
  67.         this.buildBannerView()
  68.       }
  69.     }
  70.   }
  72.   @Builder
  73.   buildBannerView() {
  74.     Row() {
  75.       AutoAdComponent({
  76.         adParam: this.adParam,
  77.         adOptions: this.adOptions,
  78.         displayOptions: this.displayOptions,
  79.         interactionListener: {
  80.           onStatusChanged: (status: string, ad: advertising.Advertisement, data: string) => {
  81.             hilog.info(0x0000, 'testTag', '%{public}s', `status is ${status}`);
  82.             switch (status) {
  83.               case AdStatus.AD_OPEN:
  84.                 hilog.info(0x0000, 'testTag', '%{public}s', 'Status is onAdOpen');
  85.                 break;
  86.               case AdStatus.AD_CLICKED:
  87.                 hilog.info(0x0000, 'testTag', '%{public}s', 'Status is onAdClick');
  88.                 break;
  89.               case AdStatus.AD_CLOSED:
  90.                 hilog.info(0x0000, 'testTag', '%{public}s', 'Status is onAdClose');
  91.                 this.visibilityState = Visibility.None;
  92.                 break;
  93.               case AdStatus.AD_LOAD:
  94.                 hilog.info(0x0000, 'testTag', '%{public}s', 'Status is onAdLoad');
  95.                 break;
  96.               case AdStatus.AD_FAIL:
  97.                 hilog.error(0x0000, 'testTag', '%{public}s', 'Status is onAdFail');
  98.                 this.visibilityState = Visibility.None;
  99.                 break;
  100.             }
  101.           }
  102.         }
  103.       })
  104.     }
  105.     .width('100%')
  106.     .aspectRatio(this.ratio)
  107.     .visibility(this.visibilityState)
  108.   }
  109. }
  111. enum AdStatus {
  112.   AD_LOAD = 'onAdLoad',
  113.   AD_FAIL = 'onAdFail',
  114.   AD_OPEN = 'onAdOpen',
  115.   AD_CLICKED = 'onAdClick',
  116.   AD_CLOSED = 'onAdClose',
  117.   AD_REWARDED = 'onAdReward',
  118.   AD_VIDEO_START = 'onVideoPlayBegin',
  119.   AD_COMPLETED = 'onVideoPlayEnd'
  120. }
复制代码
原生广告

场景先容

原生广告是与应用内容融于一体的广告，通过“和谐”的内容出现广告信息，在不破坏用户体验的前提下，为用户提供有价值的信息，展示形式包含图片和视频，支持您自由定制界面。

简单使用

 广告请求：
广告展示：
  1. import { advertising, identifier } from '@kit.AdsKit';
  2. import { router } from '@kit.ArkUI';
  3. import { common } from '@kit.AbilityKit';
  4. import { hilog } from '@kit.PerformanceAnalysisKit';
  5. import { BusinessError } from '@kit.BasicServicesKit';
  7. @Entry
  8. @Component
  9. export struct LoadAd {
  10.   private context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
  11.   private oaid: string = '';
  13.   aboutToAppear() {
  14.     try {
  15.       // 使用Promise回调方式获取OAID
  16.       identifier.getOAID().then((data: string) => {
  17.         this.oaid = data;
  18.         hilog.info(0x0000, 'testTag', '%{public}s', 'Succeeded in getting adsIdentifierInfo by promise');
  19.       }).catch((error: BusinessError) => {
  20.         hilog.error(0x0000, 'testTag', '%{public}s',
  21.           `Failed to get adsIdentifierInfo, error code: ${error.code}, message: ${error.message}`);
  22.       })
  23.     } catch (error) {
  24.       hilog.error(0x0000, 'testTag', '%{public}s', `Catch err, code: ${error.code}, message: ${error.message}`);
  25.     }
  26.   }
  28.   build() {
  29.     Column() {
  30.       Column() {
  31.         // 跳转到原生广告展示页面
  32.         Button("请求原生广告", { type: ButtonType.Normal, stateEffect: true }).onClick(() => {
  33.           this.requestAd();
  34.         })
  35.       }.width('100%').height('80%').justifyContent(FlexAlign.Center)
  36.     }
  37.     .width('100%')
  38.     .height('100%')
  39.   }
  41.   private requestAd(): void {
  42.     // 广告展示参数
  43.     const adDisplayOptions: advertising.AdDisplayOptions = {
  44.       // 是否静音，默认不静音
  45.       mute: false
  46.     }
  47.     // 原生广告配置
  48.     const adOptions: advertising.AdOptions = {
  49.       // 设置是否请求非个性化广告
  50.       nonPersonalizedAd: 1,
  51.       // 是否允许流量下载0：不允许，1：允许，不设置以广告主设置为准
  52.       allowMobileTraffic: 0,
  53.       // 是否希望根据 COPPA 的规定将您的内容视为面向儿童的内容: -1默认值，不确定 0不希望 1希望
  54.       tagForChildProtection: -1,
  55.       // 是否希望按适合未达到法定承诺年龄的欧洲经济区 (EEA) 用户的方式处理该广告请求： -1默认值，不确定 0不希望 1希望
  56.       tagForUnderAgeOfPromise: -1,
  57.       // 设置广告内容分级上限: W: 3+,所有受众 PI: 7+,家长指导 J:12+,青少年 A: 16+/18+，成人受众
  58.       adContentClassification: 'A'
  59.     }
  60.     // 原生广告请求参数
  61.     const nativeVideoAdReqParams: advertising.AdRequestParams = {
  62.       // 'testu7m3hc4gvm'为测试专用的广告位ID，App正式发布时需要改为正式的广告位ID
  63.       adId: 'testu7m3hc4gvm',
  64.       adType: 3,
  65.       adCount: 1,
  66.       // 原生广告自定义扩展参数。等所有广告素材下载完后再回调
  67.       enableDirectReturnVideoAd: true,
  68.       oaid: this.oaid
  69.     }
  70.     // 广告请求回调监听
  71.     const adLoaderListener: advertising.AdLoadListener = {
  72.       // 广告请求失败回调
  73.       onAdLoadFailure: (errorCode: number, errorMsg: string) => {
  74.         hilog.error(0x0000, 'testTag', '%{public}s',
  75.           `Failed to request ad, message: ${errorMsg}, error code: ${errorCode}`);
  76.       },
  77.       // 广告请求成功回调
  78.       onAdLoadSuccess: (ads: Array<advertising.Advertisement>) => {
  79.         hilog.info(0x0000, 'testTag', '%{public}s', 'Succeeded in requesting ad');
  80.         // 调用原生广告展示页面
  81.         routePage('pages/NativeAdPage', ads, adDisplayOptions);
  82.       }
  83.     };
  84.     // 创建AdLoader广告对象
  85.     const load: advertising.AdLoader = new advertising.AdLoader(this.context);
  86.     // 调用广告请求接口
  87.     load.loadAd(nativeVideoAdReqParams, adOptions, adLoaderListener);
  88.   }
  89. }
  91. async function routePage(pageUri: string, ads: Array<advertising.Advertisement | null>,
  92.   displayOptions: advertising.AdDisplayOptions) {
  93.   let options: router.RouterOptions = {
  94.     url: pageUri,
  95.     params: {
  96.       ads: ads,
  97.       displayOptions: displayOptions
  98.     }
  99.   }
  100.   try {
  101.     router.pushUrl(options);
  102.   } catch (error) {
  103.     hilog.error(0x0000, 'testTag', '%{public}s',
  104.       `Failed to routePage callback, code: ${error.code}, msg: ${error.message}`);
  105.   }
  106. }
复制代码
  1. import { advertising, AdComponent } from '@kit.AdsKit';
  2. import { Prompt, router } from '@kit.ArkUI';
  4. @Entry
  5. @Component
  6. export struct NativeAdPage {
  7.   // 广告内容
  8.   private ads: Array<advertising.Advertisement> = [];
  9.   private adDisplayOptions: advertising.AdDisplayOptions = {
  10.     // 是否静音，默认不静音
  11.     mute: false
  12.   }
  14.   aboutToAppear() {
  15.     const params: Record<string, Object> = router.getParams() as Record<string, Object>;
  16.     if (params && params.ads as Array<advertising.Advertisement> &&
  17.       params.displayOptions as advertising.AdDisplayOptions) {
  18.       this.ads = params.ads as Array<advertising.Advertisement>;
  19.       this.adDisplayOptions = params.displayOptions as advertising.AdDisplayOptions;
  20.     }
  21.   }
  23.   build() {
  24.     Column() {
  25.       List({ space: 20, initialIndex: 0 }) {
  26.         ForEach(this.ads, (ad: advertising.Advertisement) => {
  27.           ListItem() {
  28.             AdComponent({
  29.               ads: [ad],
  30.               displayOptions: this.adDisplayOptions,
  31.               interactionListener: {
  32.                 onStatusChanged: (status: string, ad: advertising.Advertisement, data: string) => {
  33.                   switch (status) {
  34.                     case 'onAdOpen':
  35.                       Prompt.showToast({
  36.                         message: 'native ad open',
  37.                         duration: 1000
  38.                       });
  39.                       break;
  40.                     case 'onAdClick':
  41.                       Prompt.showToast({
  42.                         message: 'native ad click',
  43.                         duration: 1000
  44.                       });
  45.                       break;
  46.                     case 'onAdClose':
  47.                       Prompt.showToast({
  48.                         message: 'native ad close',
  49.                         duration: 1000
  50.                       });
  51.                       break;
  52.                     default:
  53.                   }
  54.                 }
  55.               }
  56.             })
  57.               .width('100%')
  58.           }
  59.         })
  60.       }
  61.       .listDirection(Axis.Vertical)
  62.       .scrollBar(BarState.Off)
  63.       .friction(0.6)
  64.       .divider({
  65.         strokeWidth: 2,
  66.         color: Color.White,
  67.         startMargin: 20,
  68.         endMargin: 20
  69.       })
  70.       .edgeEffect(EdgeEffect.Spring)
  71.       .width('100%')
  72.       .height('100%')
  73.     }.width('100%').height('100%')
  74.   }
  75. }
复制代码
开屏广告

场景先容

开屏广告是一种在应用启动时且在应用主界面表现之前需要被展示的广告。您需要预先为App设计一伸开屏默认的Slogan图片，确保在未获得到开屏广告之前展示默认的Slogan，提供精良的用户体验。
开屏广告分为全屏开屏广告、半屏开屏广告，此中全屏开屏广告展示形式为广告铺满整个页面；半屏开屏广告展示形式会根据媒体页面自定义布局渲染广告、icon和版权信息，一般情况下发起将icon和版权信息展示在广告下方。

简单使用

先请求广告
  1. import { router, Prompt } from '@kit.ArkUI';
  2. import { advertising, identifier } from '@kit.AdsKit';
  3. import { common } from '@kit.AbilityKit';
  4. import { hilog } from '@kit.PerformanceAnalysisKit';
  5. import { BusinessError } from '@kit.BasicServicesKit';
  7. @Entry
  8. @Component
  9. export struct Index {
  10.   private context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
  11.   private oaid: string = '';
  12.   private isTimeOut: boolean = false;
  13.   // 超时时间(单位毫秒)，开发者可根据实际情况修改
  14.   private timeOutDuration: number = 1 * 1000;
  15.   // 超时index
  16.   private timeOutIndex: number = -1;
  17.   // 广告展示参数
  18.   private adDisplayOptions: advertising.AdDisplayOptions = {
  19.     // 是否静音，默认不静音
  20.     mute: false
  21.   }
  22.   // 广告配置
  23.   private adOptions: advertising.AdOptions = {
  24.     // 是否允许流量下载0：不允许，1：允许，不设置以广告主设置为准
  25.     allowMobileTraffic: 0,
  26.     // 是否希望根据 COPPA 的规定将您的内容视为面向儿童的内容: -1默认值，不确定 0不希望 1希望
  27.     tagForChildProtection: -1,
  28.     // 是否希望按适合未达到法定承诺年龄的欧洲经济区 (EEA) 用户的方式处理该广告请求： -1默认值，不确定 0不希望 1希望
  29.     tagForUnderAgeOfPromise: -1,
  30.     // 设置广告内容分级上限: W: 3+,所有受众 PI: 7+,家长指导 J:12+,青少年 A: 16+/18+，成人受众
  31.     adContentClassification: 'A'
  32.   }
  33.   // 开屏视频广告请求参数
  34.   private splashVideoAdReqParams: advertising.AdRequestParams = {
  35.     // 'testd7c5cewoj6'为测试专用的广告位ID，App正式发布时需要改为正式的广告位ID
  36.     adId: 'testd7c5cewoj6',
  37.     adType: AdType.SPLASH_AD,
  38.     adCount: 1,
  39.     oaid: this.oaid
  40.   }
  41.   // 开屏图片广告请求参数
  42.   private splashImageAdReqParams: advertising.AdRequestParams = {
  43.     // 'testq6zq98hecj'为测试专用的广告位ID，App正式发布时需要改为正式的广告位ID
  44.     adId: 'testq6zq98hecj',
  45.     adType: AdType.SPLASH_AD,
  46.     adCount: 1,
  47.     oaid: this.oaid
  48.   }
  50.   aboutToAppear() {
  51.     hilog.info(0x0000, 'testTag', '%{public}s', 'Start to aboutToAppear');
  52.     try {
  53.       // 使用Promise回调方式获取OAID
  54.       identifier.getOAID().then((data: string) => {
  55.         this.oaid = data;
  56.         hilog.info(0x0000, 'testTag', '%{public}s', 'Succeeded in getting adsIdentifierInfo by promise');
  57.       }).catch((error: BusinessError) => {
  58.         hilog.error(0x0000, 'testTag', '%{public}s',
  59.           `Failed to get adsIdentifierInfo, code: ${error.code}, message: ${error.message}`);
  60.       })
  61.     } catch (error) {
  62.       hilog.error(0x0000, 'testTag', '%{public}s', `Catch err, code: ${error.code}, message: ${error.message}`);
  63.     }
  64.   }
  66.   build() {
  67.     Column() {
  68.       Column() {
  69.         // 跳转到开屏全屏视频广告展示页面
  70.         CustomButton({
  71.           mText: 'splash full screen request', mOnClick: () => {
  72.             this.requestAd(this.splashVideoAdReqParams, this.adOptions);
  73.           }
  74.         });
  76.         // 跳转到开屏半屏图片广告展示页面
  77.         CustomButton({
  78.           mText: 'splash half screen request', mOnClick: () => {
  79.             this.requestAd(this.splashImageAdReqParams, this.adOptions);
  80.           }
  81.         });
  82.       }.width('100%').height('80%').justifyContent(FlexAlign.Center)
  83.     }
  84.     .width('100%')
  85.     .height('100%')
  86.   }
  88.   private requestAd(adReqParams: advertising.AdRequestParams, adOptions: advertising.AdOptions): void {
  89.     // 广告请求回调监听
  90.     const adLoaderListener: advertising.AdLoadListener = {
  91.       // 广告请求失败回调
  92.       onAdLoadFailure: (errorCode: number, errorMsg: string) => {
  93.         clearTimeout(this.timeOutIndex);
  94.         if (this.isTimeOut) {
  95.           return;
  96.         }
  97.         hilog.error(0x0000, 'testTag', '%{public}s',
  98.           `Failed to request ad. errorCode is: ${errorCode}, errorMsg is: ${errorMsg}`);
  99.         Prompt.showToast({
  100.           message: `Failed to request ad, code is:  ${errorCode} , errorMsg is: ${errorMsg}`,
  101.           duration: 1000
  102.         });
  103.       },
  104.       // 广告请求成功回调
  105.       onAdLoadSuccess: (ads: Array<advertising.Advertisement>) => {
  106.         clearTimeout(this.timeOutIndex);
  107.         if (this.isTimeOut) {
  108.           return;
  109.         }
  110.         hilog.info(0x0000, 'testTag', '%{public}s', 'Succeeded in requesting ad!');
  111.         // 保存请求到的广告内容用于展示
  112.         hilog.info(0x0000, 'testTag', '%{public}s', `ads[0].adType is : ${ads[0].adType}`);
  113.         if (canIUse("SystemCapability.Advertising.Ads")) {
  114.           if (ads[0].adType === AdType.SPLASH_AD) {
  115.             // 调用开屏广告展示页面
  116.             if (ads[0]?.isFullScreen === true) {
  117.               routePage('pages/SplashFullScreenAdPage', ads, this.adDisplayOptions);
  118.             } else {
  119.               routePage('pages/SplashHalfScreenAdPage', ads, this.adDisplayOptions);
  120.             }
  121.           } else {
  122.             hilog.error(0x0000, 'testTag', '%{public}s', 'Error adType');
  123.           }
  124.         }
  125.       }
  126.     };
  127.     // 创建AdLoader广告对象
  128.     const load: advertising.AdLoader = new advertising.AdLoader(this.context);
  129.     // 调用广告请求接口
  130.     hilog.info(0x0000, 'testTag', '%{public}s', 'Request ad!');
  131.     adReqParams.oaid = this.oaid;
  132.     this.timeOutHandler();
  133.     load.loadAd(adReqParams, adOptions, adLoaderListener);
  134.   }
  136.   private timeOutHandler(): void {
  137.     this.isTimeOut = false;
  138.     // 超时处理
  139.     this.timeOutIndex = setTimeout(() => {
  140.       this.isTimeOut = true;
  141.       const options: router.RouterOptions = {
  142.         // 开发者可根据项目实际情况修改超时之后要跳转的目标页面
  143.         url: 'pages/AdsServicePage',
  144.       };
  145.       router.pushUrl(options);
  146.       hilog.error(0x0000, 'testTag', '%{public}s', 'load ad time out');
  147.     }, this.timeOutDuration);
  148.   }
  149. }
  151. async function routePage(pageUri: string, ads: Array<advertising.Advertisement | null>,
  152.   displayOptions: advertising.AdDisplayOptions) {
  153.   let options: router.RouterOptions = {
  154.     url: pageUri,
  155.     params: {
  156.       ads: ads,
  157.       displayOptions: displayOptions
  158.     }
  159.   }
  160.   try {
  161.     hilog.info(0x0000, 'testTag', '%{public}s', `RoutePage: ${pageUri}`);
  162.     router.pushUrl(options);
  163.   } catch (error) {
  164.     hilog.error(0x0000, 'testTag', '%{public}s',
  165.       `Failed to routePage callback, code: ${error.code}, msg: ${error.message}`);
  166.   }
  167. }
  169. export enum AdType {
  170.   // 开屏广告的类型
  171.   SPLASH_AD = 1
  172. }
  174. @Component
  175. export struct CustomButton {
  176.   private mText: string | Resource = '';
  177.   private mHeight: number = 40;
  178.   private mOnClick: (event?: ClickEvent) => void = (): void => {
  179.   };
  181.   build() {
  182.     Column() {
  183.       Button(this.mText)
  184.         .backgroundColor('#d3d4d6')
  185.         .fontSize(20)
  186.         .fontColor('#000')
  187.         .fontWeight(FontWeight.Normal)
  188.         .align(Alignment.Center)
  189.         .type(ButtonType.Capsule)
  190.         .width('90%')
  191.         .height(this.mHeight)
  192.         .margin({ top: 10, bottom: 5 })
  193.         .onClick(this.mOnClick);
  194.     }
  195.   }
  196. }
复制代码
再展示广告（半屏广告）：
  1. import { Prompt, router } from '@kit.ArkUI';
  2. import { advertising, AdComponent } from '@kit.AdsKit';
  3. import { hilog } from '@kit.PerformanceAnalysisKit';
  5. @Entry
  6. @Component
  7. export struct SplashHalfScreenAdPage {
  8.   private ads: Array<advertising.Advertisement> = [];
  9.   private displayOptions?: advertising.AdDisplayOptions;
  11.   aboutToAppear() {
  12.     hilog.info(0x0000, 'testTag', '%{public}s', 'Start to splashHalfScreenAdPage aboutToAppear');
  13.     const params: Record<string, Object> = router.getParams() as Record<string, Object>;
  14.     if (params && params.ads as Array<advertising.Advertisement> &&
  15.       params.displayOptions as advertising.AdDisplayOptions) {
  16.       this.ads = params.ads as Array<advertising.Advertisement>;
  17.       this.displayOptions = params.displayOptions as advertising.AdDisplayOptions;
  18.     } else {
  19.       hilog.info(0x0000, 'testTag', '%{public}s', 'Router params are empty');
  20.     }
  21.   }
  23.   build() {
  24.     Column() {
  25.       // 运行在提供方进程里
  26.       AdComponent({
  27.         ads: this.ads, displayOptions: this.displayOptions,
  28.         interactionListener: {
  29.           onStatusChanged: (status: string, ad: advertising.Advertisement, data: string) => {
  30.             switch (status) {
  31.               case AdStatus.AD_OPEN:
  32.                 hilog.info(0x0000, 'testTag', '%{public}s', 'Status is onAdOpen');
  33.                 Prompt.showToast({
  34.                   message: 'splash ad open',
  35.                   duration: 1000
  36.                 });
  37.                 break;
  38.               case AdStatus.AD_CLICKED:
  39.                 hilog.info(0x0000, 'testTag', '%{public}s', 'Status is onAdClick');
  40.                 Prompt.showToast({
  41.                   message: 'splash ad click',
  42.                   duration: 1000
  43.                 });
  44.                 break;
  45.               case AdStatus.AD_CLOSED:
  46.                 hilog.info(0x0000, 'testTag', '%{public}s', 'Status is onAdClose');
  47.                 Prompt.showToast({
  48.                   message: 'splash ad close',
  49.                   duration: 1000
  50.                 });
  51.                 router.replaceUrl({
  52.                   url: 'pages/Index',
  53.                 })
  54.                 break;
  55.             }
  56.           }
  57.         }
  58.       })
  59.         .width('100%')
  60.         .height('87%')
  62.       // 展示媒体自定义icon、应用名称、版权信息
  63.       Column({}) {
  64.         Row() {
  65.           Image($r('app.media.video')).width(24).height(24).margin({ right: 8 })
  66.           Text($r('app.string.video')).fontColor('#1A1A1A').fontSize(16).width(32).height(21)
  67.         }.margin({ bottom: 8 })
  69.         Column() {
  70.           Text($r('app.string.copyright')).fontColor('#1A1A1A').fontSize(9).height(15)
  71.         }
  72.       }.width('100%').height('100%')
  73.     }
  74.   }
  75. }
  77. export enum AdStatus {
  78.   AD_OPEN = 'onAdOpen',
  79.   AD_CLICKED = 'onAdClick',
  80.   AD_CLOSED = 'onAdClose'
  81. }
复制代码
广告接口封装

  1. import { router } from '@kit.ArkUI';
  2. import { advertising, identifier } from '@kit.AdsKit';
  3. import { common, abilityAccessCtrl } from '@kit.AbilityKit';
  4. import { BusinessError } from '@kit.BasicServicesKit';
  5. import { Log } from './logutil';
  7. /**
  8. * 广告类型
  9. */
  10. export enum AdType {
  11.   // 开屏广告的类型
  12.   SPLASH_AD = 1,
  13.   // 原生广告的类型
  14.   NATIVE_AD = 3,
  15.   //8：banner广告。
  16.   BANNER_AD = 8
  17.   //12：插屏广告。
  18.   //60：贴片广告。
  19. }
  21. /**
  22. * 广告状态
  23. */
  24. export enum AdStatus {
  25.   AD_OPEN = "onAdOpen",
  26.   AD_CLICKED = "onAdClick",
  27.   AD_CLOSED = "onAdClose",
  28.   AD_LOAD = "AD_LOAD",
  29.   AD_FAIL = "AD_FAIL"
  30. }
  31. export default class AdUtil {
  32.   /**
  33.    * 设备oaid
  34.    */
  35.   public static oaid: string = '';
  36.   /**
  37.    * 广告展示参数
  38.    */
  39.   public adDisplayOptions: advertising.AdDisplayOptions = {
  40.     // 是否静音，默认不静音
  41.     mute: false,
  42.     // 广告轮播的时间间隔，单位ms，取值范围[30000, 120000]
  43.     refreshTime: 30000
  44.   }
  45.   /**
  46.    * 原生广告配置
  47.    */
  48.   public adOptions: advertising.AdOptions = {
  49.     // 是否允许流量下载  0不允许 1允许，不设置以广告主设置为准
  50.     allowMobileTraffic: 1,
  51.     // 是否希望根据 COPPA 的规定将您的内容视为面向儿童的内容: -1默认值，不确定 0不希望 1希望
  52.     tagForChildProtection: -1,
  53.     // 是否希望按适合未达到法定承诺年龄的欧洲经济区 (EEA) 用户的方式处理该广告请求: -1默认值，不确定 0不希望 1希望
  54.     tagForUnderAgeOfPromise: -1,
  55.     // 设置广告内容分级上限: W: 3+,所有受众 PI: 7+,家长指导 J:12+,青少年 A: 16+/18+，成人受众
  56.     adContentClassification: 'A'
  57.   }
  58.   // Banner广告请求参数
  59.   public bannerAdReqParams: advertising.AdRequestParams = {
  60.     adId: 'x5txrf02lv',
  61.     adType: AdType.BANNER_AD,
  62.     adCount: 1,
  63.     adWidth: 360,
  64.     adHeight: 57
  65.   }
  66.   /**
  67.    * 开屏视频广告请求参数
  68.    */
  69.   public splashVideoAdReqParams: advertising.AdRequestParams = {
  70.     adId: 'x09l50xtco',
  71.     adType: AdType.SPLASH_AD,
  72.     adCount: 1
  73.   }
  74.   /**
  75.    * 开屏图片广告请求参数
  76.    */
  77.   public splashImageAdReqParams: advertising.AdRequestParams = {
  78.     adId: 'testq6zq98hecj',
  79.     adType: AdType.SPLASH_AD,
  80.     adCount: 1,
  81.     oaid:AdUtil.oaid
  82.   }
  83.   /**
  84.    * 原生视频广告请求参数
  85.    */
  86.   public nativeVideoAdReqParams: advertising.AdRequestParams = {
  87.     adId: 't5q3phvauy',
  88.     adType: AdType.NATIVE_AD,
  89.     adCount: 1,
  90.     // 原生广告自定义扩展参数。等所有广告素材下载完后再回调
  91.     enableDirectReturnVideoAd: true
  92.   }
  93.   /**
  94.    * 原生大图广告请求参数
  95.    */
  96.   public nativeBigImageAdReqParams: advertising.AdRequestParams = {
  97.     adId: 't5q3phvauy',
  98.     adType: AdType.NATIVE_AD,
  99.     adCount: 1,
  100.     // 原生广告自定义扩展参数。等所有广告素材下载完后再回调
  101.     enableDirectReturnVideoAd: true
  102.   }
  103.   /**
  104.    * 原生三图广告请求参数
  105.    */
  106.   public nativeThreeImageAdReqParams: advertising.AdRequestParams = {
  107.     adId: 't5q3phvauy',
  108.     adType: AdType.NATIVE_AD,
  109.     adCount: 1,
  110.     // 原生广告自定义扩展参数。等所有广告素材下载完后再回调
  111.     enableDirectReturnVideoAd: true
  112.   }
  113.   /**
  114.    * 原生小图广告请求参数
  115.    */
  116.   public nativeSmallImageAdReqParams: advertising.AdRequestParams = {
  117.     adId: 't5q3phvauy',
  118.     adType: AdType.NATIVE_AD,
  119.     adCount: 1,
  120.     // 原生广告自定义扩展参数。等所有广告素材下载完后再回调
  121.     enableDirectReturnVideoAd: true
  122.   }
  124.   /**
  125.    * 获取 OAID
  126.    * @param context
  127.    */
  128.   public requestOAIDTrackingConsentPermissions(context: common.Context): void {
  129.     // 进入页面时，向用户请求授权广告跨应用关联访问权限
  130.     const atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
  131.     try {
  132.       atManager.requestPermissionsFromUser(context, ['ohos.permission.APP_TRACKING_CONSENT']).then((data) => {
  133.         if (data.authResults[0] === 0) {
  134.           Log.info('Succeeded in requesting permission');
  135.           identifier.getOAID().then((data: string) => {
  136.             AdUtil.oaid = data;
  137.             Log.info('Succeeded in getting adsIdentifierInfo by promise : ' + data);
  138.           }).catch((error: BusinessError) => {
  139.             Log.error(`Failed to get AdsIdentifierInfo, message: ${error.message}`);
  140.           })
  141.         } else {
  142.           Log.info('user rejected');
  143.         }
  144.       }).catch((err: BusinessError) => {
  145.         Log.error(`Failed to request permission , error: ${err.code} ${err.message}`);
  146.       })
  147.     } catch (err) {
  148.       Log.error(`catch err, code: ${err.code}, msg: ${err.message}`);
  149.     }
  150.   }
  152.   public requestAd(context: common.Context, adReqParams: advertising.AdRequestParams, adOptions: advertising.AdOptions,
  153.     routePage: string,errPage:string): void {
  154.     // 给AdRequestParams设置oaid参数
  155.     adReqParams.oaid = AdUtil.oaid;
  156.     // 广告请求回调监听
  157.     const adLoaderListener: advertising.AdLoadListener = {
  158.       // 广告请求失败回调
  159.       onAdLoadFailure: (errorCode: number, errorMsg: string) => {
  160.         Log.error(`request ad errorCode is: ${errorCode}, errorMsg is: ${errorMsg}`);
  161.         if (errPage != '') {
  162.           this.routePage(errPage);
  163.         }
  164.       },
  165.       // 广告请求成功回调
  166.       onAdLoadSuccess: (ads: Array<advertising.Advertisement>) => {
  167.         Log.info('succeeded in requesting ad!');
  168.         // 保存请求到的广告内容用于展示
  169.         if (canIUse('SystemCapability.Advertising.Ads')) {
  170.           if (ads[0].adType === AdType.SPLASH_AD) {
  171.             // 调用开屏广告展示页面
  172.             if (ads[0]?.isFullScreen === true) {
  173.               this.routePage('pages/SplashFullScreenAdPage', ads, this.adDisplayOptions);
  174.             } else {
  175.               this.routePage('pages/SplashHalfScreenAdPage', ads, this.adDisplayOptions);
  176.             }
  177.           } else {
  178.             this.routePage(routePage, ads, this.adDisplayOptions);
  179.             //hilog.error(0x0000, 'testTag', '%{public}s', 'Error adType');
  180.           }
  181.         }
  182.       }
  183.     };
  184.     // 创建AdLoader广告对象
  185.     const load: advertising.AdLoader = new advertising.AdLoader(context);
  186.     // 调用广告请求接口
  187.     Log.info('request ad!');
  188.     load.loadAd(adReqParams, adOptions, adLoaderListener);
  189.   }
  191.   public routePage(pageUri: string, ads?: Array<advertising.Advertisement | null>,
  192.     displayOptions?: advertising.AdDisplayOptions) {
  193.     let options: router.RouterOptions = {
  194.       url: pageUri,
  195.       params: {
  196.         ads: ads,
  197.         displayOptions: displayOptions
  198.       }
  199.     }
  200.     try {
  201.       Log.info(`routePage  + ${pageUri}`);
  202.       router.replaceUrl(options);
  203.     } catch (error) {
  204.       Log.error(`routePage fail callback, code: ${error.code}, msg: ${error.message}`);
  205.     }
  206.   }
  207. }
  209. export const adUtils = new AdUtil()
复制代码
封装后使用

  1. // 组件生命周期
  2.   async aboutToAppear() {
  3.     Log.info('StartPage aboutToAppear');
  4.     let value:Object = await PreferencesUtils.getPreferences(Constant.KEY_IS_FIRST_OPEN);
  5.     if(value === null || value === 'YES'){
  6.       this.privacyDialogController?.open()
  7.     }else{
  8.       adUtils.requestOAIDTrackingConsentPermissions(this.context);
  9.       adUtils.requestAd(this.context,adUtils.splashImageAdReqParams,adUtils.adDisplayOptions,'pages/SplashFullScreenAdPage','pages/Index')
  10.      
  11.     }
  12.   }
复制代码
作者：csdn猫哥blog.csdn.net/qq8864，转载请注明出处。
团队：坚果派
团队先容：坚果派由坚果等人创建，团队拥有12个华为HDE带领热爱HarmonyOS/OpenHarmony的开发者，以及若干其他范畴的三十余位万粉博主运营。专注于分享HarmonyOS/OpenHarmony、ArkUI-X、元服务、仓颉。团队成员聚集在北京，上海，南京，深圳，广州，宁夏等地，现在已开发鸿蒙原生应用，三方库60+，接待交换。
                        
原文链接：https://blog.csdn.net/yyz_1987/article/details/144561085
 
其他资源

文档中心--Ads Kit（广告服务）


免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

本帖子中包含更多资源

您需要 登录 才可以下载或查看，没有账号？立即注册

x
回复

使用道具 举报

0 个回复

正序浏览
返回列表

快速回复

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

篮之新喜

论坛元老
这个人很懒什么都没写!

楼主热帖

标签云

AI 运维 CIO 存储 服务器
微信订阅号
微信服务号
微信客服
小程序
H5
关于我们 商务合作 网站地图
©Copyright 2022-2024 杭州祥升科技有限公司 版权所有 浙ICP备20004199号
快速回复 返回顶部 返回列表