# AdsKit-Codelab-Placement-ArkTS

**Repository Path**: harmonyos_codelabs/ads-kit-codelab-placement-arkts

## Basic Information

- **Project Name**: AdsKit-Codelab-Placement-ArkTS
- **Description**: 此Codelab将引导您在您的App中通过接口获取并展示贴片广告。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-06-18
- **Last Updated**: 2025-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 鲸鸿动能广告服务HarmonyOS ArkTs示例代码

## 目录

- [简介](#简介)
- [使用说明](#使用说明)
- [效果预览](#效果预览)
- [工程目录](#工程目录)
- [示例代码](#示例代码)
- [相关权限](#相关权限)
- [约束与限制](#约束与限制)

## 简介

鲸鸿动能广告服务HarmonyOS ArkTs示例代码向您介绍如何在应用中使用将鲸鸿动能API并实现广告展示。

## 使用说明

运行本示例前需要参考指导[配置应用签名信息](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/application-dev-overview#section42841246144813)。

## 效果预览

| 贴片图片广告页面                                 |
|------------------------------------------|
| ![avatar](./screenshots/device/roll.png) |

## 工程目录

```
├─entry/src/main/ets       // 代码区  
│ ├─entryability
│ │ └─EntryAbility.ets     // 主程序入口类
│ ├─pages                  // 存放页面文件目录                
│ │ ├─Index.ets            // 应用主页面
│ │ └─RollAdPage.ets       // 贴片广告页面
│ ├─viewmodel              // 存放ViewModel文件目录
│ │ └─AdsViewModel.ets     // 广告ViewModel
└─entry/src/main/resources // 资源文件目录
```

## 示例代码

### 流量变现服务示例代码

鲸鸿动能广告服务HarmonyOS-ArkTs示例代码为您提供贴片广告的展示页面。
本示例代码包括以下文件，便于您进行广告请求、广告展示：

1. Index.ets
   流量变现服务演示界面，可以请求并展示贴片广告，点击对应按钮可以展示相应的广告内容。
   <br>代码位置：entry\src\main\ets\pages\Index.ets</br>
2. RollAdPage.ets
   用于展示贴片广告。
   <br>代码位置：entry\src\main\ets\pages\RollAdPage.ets</br>
3. AdsViewModel.ets
   用于管理广告UI状态和业务逻辑。
   <br>代码位置：entry\src\main\ets\viewmodel\AdsViewModel.ets</br>

## 相关权限

- 获取OAID功能需要申请广告跨应用关联访问权限：[ohos.permission.APP_TRACKING_CONSENT](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/permissions-for-all-user#ohospermissionapp_tracking_consent)。

## 约束与限制

1. 本示例仅支持标准系统上运行，支持设备：华为手机、平板设备。
2. HarmonyOS系统：HarmonyOS NEXT Developer Beta1及以上。
3. DevEco Studio版本：DevEco Studio NEXT Developer Beta1及以上。
4. HarmonyOS SDK版本：HarmonyOS NEXT Developer Beta1及以上。