TopOn统一SDK

一、接入前的准备工作

• 1、开发者须具备Android开发基础及AndroidStudio编辑器的使用基础能力
• 2、到TopOn后台申请APP ID和广告位ID
  
• 3、遇到问题请阅读TopOn官方文档
  
• 4、更多原始广告平台支持请到第三方广告SDK下载
  
• 5、配置、混淆、资源、权限等请参阅官方文档
  

二、AndroidStudio接入

一、环境配置

1、项目根build.gradle配置

    allprojects {
        repositories {
            maven { url 'https://jitpack.io' }
        }
    }

2、模块build.gradle配置

    dependencies {

        //TopOn统一SDK
        implementation 'com.github.hty527.advert:topon:1.1.6.1'
    
        /**
         * 如果是Support环境
         */
        //implementation "com.android.support:appcompat-v7:28.0.0"
        //implementation 'com.android.support:localbroadcastmanager:28.0.0'
        //dex 分包，当minSdkVersion>=21时会出现找不到androidx.multidex.MultiDexApplication 解决办法
        //implementation 'com.android.support:multidex:1.0.3'
    
        /**
         * 如果是androidx环境
         * 需在工程的gradle.properties文件增加下列配置：
         * android.useAndroidX=true
         * android.enableJetifier=true
         */
        implementation 'androidx.appcompat:appcompat:1.0.2'
        implementation 'androidx.localbroadcastmanager:localbroadcastmanager:1.1.0'
        //dex 分包，当minSdkVersion>=21时会出现找不到androidx.multidex.MultiDexApplication  解决办法
        implementation 'androidx.multidex:multidex:2.0.1'
    }

3、第三方聚合SDK及第三方广告SDK配置

• 3.1、复制模块app-topon下libs_topon到你的项目模块根目录下
  
• 3.2、复制模块app-topon下libs-adn到你的项目模块根目录下，可根据需要保留第三方聚合adapter和第三方广告SDK，更多广告SDK，请前往官方下载
  
• 3.3、兼容Android10及以上设备建议集成模块app-topon下libs目录中的oaid_sdk_1.0.25.aar
  
• 3.4、完成文件拷贝后在模块build.gradle配置中添加下列配置
  
• 下列配置示例仅适配了穿山甲、快手、优量汇三家广告，其它广告配置请参阅TopOn官方文档

    dependencies {
        //引入libs、libs_gromore、libs-adn目录下的所有.aar文件和.jar文件
        implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
        implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs_topon')
        implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs-adn')

        /**
         * 如果集成了快手：
         */
        //Support：
        //implementation "com.android.support:design:28.0.0"
        //AndroidX：
        implementation "androidx.recyclerview:recyclerview:1.2.0"
        implementation 'androidx.legacy:legacy-support-v4:1.0.0'
    }

4、权限

• 请尽可能的申明下列权限，以免影响ECPM

    <!--TopOn SDK通用 必要权限-->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <!--中国区SDK必要权限-->
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

    <!--可选权限-->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.GET_TASKS"/>
    <!--可选，穿山甲提供“获取地理位置权限”和“不给予地理位置权限，开发者传入地理位置参数”两种方式上报用户位置，两种方式均可不选，添加位置权限或参数将帮助投放定位广告-->
    <!--请注意：无论通过何种方式提供给穿山甲用户地理位置，均需向用户声明地理位置权限将应用于穿山甲广告投放，穿山甲不强制获取地理位置信息-->
    <!--    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />-->
    <!-- 如果有视频相关的广告且使用textureView播放，请务必添加，否则黑屏 -->
    <uses-permission android:name="android.permission.WAKE_LOCK" />
    <uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"/>

二、广告展示、拉取、缓存、混淆等请阅读接入文档