菜单

1. SDK接入配置

文件结构

AMPSUnionDemo
- 接入Demo
libs
- AMPSSDK_x.x.x.aar : 广告SDK
- common_x.x.x.aar : 依赖库SDK
xml
- amps_file_paths : FileProvider配置

接入准备

导入SDK文件

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

复制代码

    dependencies{
        implementation(name: 'AMPSSDK_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.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <!-- 可选权限 -->
    <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="com.beizi.fusion.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文档中心

下一个

2. SDK初始化及API说明

最近修改: 2025-04-11

大纲