一、前置参数申请

1. 开发者在穿山甲媒体平台需要重新申请鸿蒙新测试状态的应用ID和代码位ID

登录穿山甲媒体平台->流量变现->广告变现->流量->应用->创建测试应用即可，详见如下截图。

若使用聚合功能，登录穿山甲媒体平台->流量变现->GroMore->应用管理->添加第一步创建的测试应用即可，详见如下截图，聚合功能支持ADN&广告类型，开发者按照实际情况到各ADN平台申请即可。

2. 正式应用创建进行变现，登录穿山甲媒体平台->流量变现->广告变现->流量->应用->创建正式应用即可；按照平台要求填写以下信息：应用名称、应用包名、接入的穿山甲账号ID、公司名称、鸿蒙应用商店链接、软件著作权证书（纸质、电子均可）、授权书、软著著作权人的营业执照原件或复印件盖公章。
1. 鸿蒙应用商店链接获取方式：应用上架界面右上角分享->复制，即为鸿蒙的上架链接。
2. 软著证书注意事项：纸质软著需原件或彩色扫描件；电子软著需提交PDF原件；Android 或 iOS渠道软著不可使用。
3. 授权书注意事项：若软著主体与账号主体不一致需提供授权书，需使用平台模版（模版下发自行下载即可）。号主体不一致需提供授权书，需使用平台模版（模版下发自行下载即可）。

二、鸿蒙 SDK下载与接入

请您注册登录穿山甲后台，在后台中接入中心下载穿山甲 SDK并接入，下载具体入口如下：

在开发者平台进入“接入与测试”-“广告变现”，可下载对应SDK并查看接入文档， 点击跳转

三、工程配置

IDE最低版本：5.0.3.403

鸿蒙SDK最低版本：基于OpenHarmony SDK Ohos_sdk_public 5.0.0.25 (API 12 Beta1)【DevEco Studio版本请从DevEco Studio界面菜单选择“Help > About”进行查询】

手机最低系统版本：NEXT.0.0.26

1. SDK集成

1.1 方式一 远程依赖【推荐】

1.1.1穿山甲SDK

穿山甲广告SDK-HarmonyOS 6.5.0版本开始，支持远程仓库依赖，接入方式详见：

步骤一：添加仓库

项目根目录 .ohpmrc配置仓库地址

可以配置多个仓库地址，以英文逗号间隔，多个仓库地址的优先级按照配置顺序排序。

步骤二：添加依赖

在工程主module的oh-package.json5文件中需要引入穿山甲SDK的模块，以远程包形式引入：

1.1.2 聚合功能

聚合支持的三方ADN

步骤一：添加仓库

项目根目录 .ohpmrc配置仓库地址

可以配置多个仓库地址，以英文逗号间隔，多个仓库地址的优先级按照配置顺序排序。

步骤二：添加依赖

在应用中主module的oh-package.json5中添加csj和adapter的依赖配置：

在项目中主module的build-profile.json5中添加，详见截图位置：

在工程级别的build-profile.json5中配置，详见截图位置：

1.2 方式二 手动集成

1.2.1 穿山甲SDK

穿山甲平台下载鸿蒙SDK【接入与测试-广告变现-SDK-Harmony】，解压后获取demo工程和穿山甲har包；

• harmonyadsdk：穿山甲对外的demo工程，可参考此工程示例代码接入各种类型广告。
• Harmony SDK引入：将openadsdk.har放置到媒体的工程libs目录，在工程oh-package.json5文件中引入穿山甲sdk的模块以本地har包形式引入，参考代码如下，工程完成依赖接入后，执行ohpm install 执行har包的安装，即可在工程中使用穿山甲api了。

1.2.2 聚合功能说明

穿山甲平台下载鸿蒙SDK【接入与测试-广告变现-SDK-Harmony】，解压后获取demo工程和各ADN的har包和adapter，详见如下截图，接入聚合功能时，强烈建议通过远程依赖的方式集成，避免adn与adapter版本不匹配导致功能不兼容问题

穿山甲 Harmony SDK支持接入穿山甲、广点通、快手三家ADN，开发者可以按需接入对应的ADN的SDK和adapter；

注意事项

1. 如果之前接入了har或者本次为替换har包更新版本，则需要先删除模块的 oh_modules目录，避免更新har包失败。

2. 如果需要在新module中引入本地三方har，请不要使用Shared Library，否则会导致三方har包无法被打包到hap （也可以通过oh-package.json5中是否存在"packageType":"interfaceHar"来判断当前module是否是Shared Library）。

2. 权限申请

广告依赖部分设备信息进行优化投放模型，需要媒体在module.json5文件中添加以下权限：

其中地理位置和oaid获取依赖用户动态授权，媒体可自行发起授权申请（建议在广告请求前发起），也可以调用穿山甲接口请求权限