我们支持Android系统版本Version 4.1 (API Level 16) 及以上。请确保满足以下要求:
使用Android Studio 2.0 版本及以上
Target Android API level 28
MinSdkVersion level 16 及以上
本手册介绍如何将京媒SDK集成到您的Android应用中。
京媒SDK支持开屏、信息流等丰富的广告类型。
注意:
针对 2.0.0 以前升级用户,广告接口更改,详情见接口升级说明文档
针对 2.1.0 及以后版本 ,京媒SDK默认支持AndroidX版本,接入时请注意是否为AndroidX项目
在进行SDK集成之前,您得先有一个 京媒合作平台 的账号,然后注册您的应用、创建广告位等操作,得到集成所必要的信息:APP_ID 和 Slot ID。
APP_ID: APP_ID 是给开发者应用分配的唯一标识,您可以在京媒合作平台创建应用后即可获取APP_ID。
Slot ID: 是广告位的唯一标识。开发者可以创建多个广告位。 京媒SDK广告位类型支持开屏、插屏、横幅、信息流四种广告类型。
方式一:整包接入
下载SDK后,解压将本SDK压缩包内的jad_yun_sdk_x.x.x.aar复制到Application Module/libs文件夹(没有的话须手动创建), 并将以下代码添加到您app的build.gradle中:
方式二:分包接入
将开屏、信息流、媒体渲染5种广告类型的组件化,您可以按实际业务场景接入所需的广告组件。 下载SDK后,解压将本SDK压缩包内您需要的aar复制到Application Module/libs文件夹(没有的话须手动创建), 并将以下代码添加到您app的build.gradle中:
``
方式三:自动接入
添加仓库:在project级别的build.gradle文件中添加Maven的引用
添加依赖:在主module的build.gradle文件添加SDK依赖
接下来需要添加配置到您的AndroidManifest.xml 文件中.
注意: 广告SDK不强制获取以上权限,即使没有获取可选权限SDK也能正常运行;获取以上权限将帮助优化投放广告精准度和广告填充率,提高收益。
建议开发者在Application#onCreate()方法中调用以下代码来初始化京媒SDK
请媒体用户设置OAID参数, 否则可能影响广告填充
1、OAID的获取请查看移动安全联盟文档, 将获取的OAID值按照如下进行设置:
2、设置其他控制权限(位置,IMEI等)
3、隐私信息控制类说明: 重要!!重要!!
创建隐私信息控制类的实例,媒体可以自主控制是否提供权限给广告SDK使用
为了保证广告的填充率,注意oaid和imei的配置:
(1)oaid配置项必须实现,并传入有效值
(2)imei的配置与isCanUsePhoneState有关(isCanUsePhoneState配置项默认为true)
当isCanUsePhoneState 配置为false,不允许SDK主动获取imei,但是需要接入方主动传入imei
当isCanUsePhoneState 配置为true,允许SDK主动获取imei,但必须保证接入方已经动态申请了 Manifest.permission.READ_PHONE_STATE,否则SDK会获取失败
其他采用可以采用默认配置(可以不用实现相关方法,默认都是支持SDK主动获取的)
为了广告SDK正常使用,请对所有广告SDK 接口的调用, 都放在主线程中,如广告的创建,广告的加载等
注意: 1.集成移动安全联盟SDK需要将 supplierconfig.json 拷贝到项目 assets 目录下 2.appid 只与 VAID(开发者匿名设备标识符) 的获取有关,用于判断是否为同一开发者,如不需获取 vaid 可 不填写。目前只需设置 vivo 的 appid。 3.其他注意事项可参考移动广告联盟SDK F&Q文档