请输入
菜单

SDK接入配置

文件结构

  • ADN_UnionDemo
    • 接入Demo
  • libs
    • beiziSDK_x.x.x.aar : 广告SDK
    • common_x.x.x.aar : 依赖库SDK
  • xml
    • amps_file_paths : FileProvider配置

接入准备

导入SDK文件

在应用的build.gradle文件中, 于dependencies标签内增加

复制代码
    dependencies{
        implementation(name: 'beiziSDK_x.x.x', ext: 'aar')
        implementation(name: 'common_x.x.x', ext: 'aar')

        //其他引用
        ... ...
    }
    

修改工程Manifest.xml文件

添加权限
注意:SDK不强制获取可选权限, 即使没有获取可选权限SDK也能正常运行; 获取可选权限将帮助SDK优化投放广告精准度和用户的交互体验, 提高eCPM.
注意:SDK本身不会发起动态权限申请.

复制代码
    <!-- 必要权限 --> 
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    
    <!-- 可选权限 -->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

权限说明

系统平台 申请权限 调用时机 使用目的
Android 访问互联网 初始化时 检查设备连网络状态,确保SDK与服务端的通讯求
网络状态 初始化时

检查设备连网络状态,确保SDK与服务端的通讯

应用下载广告投放及广告素材存储

广告投放及广告监测归因、反作弊

安装应用 广告请求

应用下载广告投放及广告素材存储

广告投放及广告监测归因、反作弊

访问粗略位置(可选) 广告请求

广告投放及广告监测归因、反作弊

访问精准位置(可选) 广告请求

广告投放及广告监测归因、反作弊

添加http支持
当App的targetSdkVersion >= 28时, 需要在<application>标签中, 增加允许使用HTTP协议.

复制代码
    
    <application
        //方式1:
        android:usesCleartextTraffic="true"
        //方式2:
        android:networkSecurityConfig="@xml/network_security_config">
        ... ...
    </application>

<application>标签中,增加以下内容以支持硬件加速

复制代码
    <application
        android:hardwareAccelerated="true">
        ... ...
    </application>

增加Provider组件

复制代码
    <provider
        android:name="biz.beizi.adn.amps.AMPSFileProvider"
        android:authorities="${applicationId}.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/amps_file_paths" />
    </provider>

增加Res文件

在应用res/xml文件中添加amps_file_paths.xml

上一个
Android文档中心
下一个
SDK初始化及API说明
最近修改: 2025-08-21