SDK接入配置 SDK configuration

1. 准备工作 Preparation

• 选择需要接入的第三方广告网络，创建应用并拿到聚合SDK所需的参数，详细信息可查看【第三方广告网络操作指南】

Select the third-party advertising network you want to access, create an application and obtain the parameters required by the aggregation SDK. For detailed information, please refer to the [Third-Party Advertising Network Operation Guide]

• 解压我们提供的压缩包，把*.aar放入app的libs工程中，并添加所需的其他配置项

Unzip the compressed package we provided, put *.aar into the libs project of the app, and add other required configuration items

2. 示例Demo Demo

点击查看ToBid聚合示例Demo

Click to view ToBid aggregation example Demo

3. 集成步骤 Integration steps

3.1 添加ToBid SDK 依赖 Add ToBid SDK dependency

dependencies {

    //ToBidSdk-ZIP包内Core目录下的aar文件放入项目libs中
    implementation fileTree(include: ['*.aar'], dir: 'libs')
}

加入 AndroidX 或者 Android Support V4 依赖支持库(二选一)

Add AndroidX or Android Support V4 dependency support library (choose one)

dependencies {
    //AndroidX
    implementation 'androidx.legacy:legacy-support-v4:1.0.0'

    //Android support v4
    implementation 'com.android.support:support-v4:23.0.+'
}

3.2 更新 AndroidManifest.xml Update AndroidManifest.xml

权限声明

Permission Statement

<!--联⽹权限-->
<uses-permission android:name="android.permission.INTERNET" />
<!--检测当前⽹络状态是2G、3G、4G还是WiFi-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!--获取设备标识IMEI。⽤于标识⽤户-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!--读写存储权限-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission
    android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    tools:node="replace" />
<!--获取MAC地址，⽤于标识⽤户-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!--安装应⽤权限-->
<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" />

3.3 混淆配置 Obfuscation Configuration

# 不优化输入的类文件
-dontoptimize
#忽略警告
-ignorewarnings

# ToBid
-dontwarn com.sigmob.**
-keep class com.sigmob.**{ *;}
-keep interface com.sigmob.**{ *;}

-dontwarn com.czhj.**
-keep class com.czhj.**{ *;}
-keep interface com.czhj.**{ *;}
-keep class com.tan.**{ *;}

-dontwarn com.windmill.**
-keep class com.windmill.**.**{*;}
-keep interface com.windmill.**{ *;}

# miitmdid
-dontwarn com.bun.**
-keep class com.bun.** {*;}
-keep class a.**{*;}
-keep class XI.CA.XI.**{*;}
-keep class XI.K0.XI.**{*;}
-keep class XI.XI.K0.**{*;}
-keep class XI.vs.K0.**{*;}
-keep class XI.xo.XI.XI.**{*;}
-keep class com.asus.msa.SupplementaryDID.**{*;}
-keep class com.asus.msa.sdid.**{*;}
-keep class com.huawei.hms.ads.identifier.**{*;}
-keep class com.samsung.android.deviceidservice.**{*;}
-keep class com.zui.opendeviceidlibrary.**{*;}
-keep class org.json.**{*;}
-keep public class com.netease.nis.sdkwrapper.Utils {public <methods>;}

3.4 资源混淆配置 Resource Obfuscation Configuration

• 如果您的应⽤启⽤了资源混淆或资源缩减，您需要保留SDK的资源，SDK的资源名都是以tobid_、sig_开头的。您可以在资源混淆配置⽂件添加如下配置：

If your application has resource obfuscation or resource reduction enabled, you need to keep the SDK resources. The SDK resource names all start with tobid_ or sig_. You can add the following configuration to the resource obfuscation configuration file:

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@drawable/tobid_*,@layout/tobid_*,@id/tobid_**,@style/tobid_*,@string/tobid_*,@anim/tobid_*, @xml/tobid_*,@color/tobid_*,@attr/tobid_*,@dimen/tobid_*" />
    
<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@drawable/sig_*,@layout/sig_*,@id/sig_**,@style/sig_*,@string/sig_*,@anim/sig_*, @xml/sig*,@color/sig_*,@attr/sig_*,@dimen/sig_*"/>