聚合宝广告SDK文档

夜间

On this page

sdk接入 ​

1.下载sdk及demo包 ​

将下载的demo包解压后，包含可运行的apk文件，广告sdk以及demo代码

2.导入sdk ​

将demo包中libs目录下的aar文件复制到您的app/libs目录中（没有libs目录，则手动创建一个）

3.添加依赖 ​

① 将以下代码添加到您app Module的build.gradle文件中，找到depedencies

java
depedencies {

    //....原有代码
    
    // AndroidX 工程需要添加
    implementation 'androidx.appcompat:appcompat:1.4.1'

    // Support 工程需要添加
    implementation 'com.android.support:appcompat-v7:28.0.0'
    
    //广告sdk（其中x.x.x.x为具体版本号）
    implementation files("libs/juhebao_ad_sdk_x.x.x.x.aar");
    
}

② AndroidX 工程需要在项目根目录的gradle.properties文件中添加：

android.enableJetifier=true

4.AndroidManifest 配置 ​

添加权限

<!-- 必要权限 -->   
<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_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.READ_PHONE_STATE" />  

<!--可选权限，申请后用于防作弊功能以及有助于广告平台投放广告-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<permission 
    android:name="${applicationId}.openadsdk.permission.TT_PANGOLIN"   
    android:protectionLevel="signature" /> 
<uses-permission android:name="${applicationId}.openadsdk.permission.TT_PANGOLIN" />  
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" /> 

<!-- 可选权限 -->  
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />    
<!--suppress DeprecatedClassUsageInspection -->    
<uses-permission android:name="android.permission.GET_TASKS" />    
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />  
<!-- 如果有视频相关的广告且使用textureView播放，请务必添加，否则黑屏 -->  
<uses-permission android:name="android.permission.WAKE_LOCK" />

注意

  1. SDK不强制获取以上权限，即使没有获取可选权限SDK也能正常运行；获取以上权限将帮助优化投放广告精准度和用户的交互体验，提高eCPM

  2. 如果开发者声明 targetSdkVersion 到 API23 以上，请确保调用本SDK的任何接口前，已经申请到了SDK要求的所有权限，否则SDK部分特性可能受限。

5.sdk初始化 ​

初始化操作一定要在广告请求之前进行，建议在Application的onCreate方法中进行初始化操作

public class MainApplication extends Application {
    @Override
    public void onCreate(){
        super.onCreate();
        
        //后台对应的应用appId及应用appKey，填错不会计算收益！！！
        JuHeBaoAdSdk.init(this, "应用appId", "应用appkey");
    }
}

5.混淆设置（没有开启混淆请忽略） ​

如果你的项目没有开启混淆，请忽略此步骤。如果您的项目开启了混淆，需要在混淆文件末尾添加以下配置：

-keep class com.shengqu.juhebaosdk.** {*;}
-keep class com.shengqu.juhebaoapi.** {*;}
-keep class bykvm*.**
-keep class com.bytedance.msdk.adapter.**{ public *; }
-keep class com.bytedance.msdk.api.** {
 public *;
}
-keep class com.bytedance.msdk.base.TTBaseAd{*;}
-keep class com.bytedance.msdk.adapter.TTAbsAdLoaderAdapter{
    public *;
    protected <fields>;
}
-keep class org.chromium.** {*;}
-keep class org.chromium.** { *; }
-keep class aegon.chrome.** { *; }
-keep class com.kwai.**{ *; }
-dontwarn com.kwai.**
-dontwarn com.kwad.**
-dontwarn com.ksad.**
-dontwarn aegon.chrome.**