导入和配置

如果您是初次使用TradPlus SDK，我们建议您利用Demo来了解SDK的使用。

一、添加SDK到项目工程#

TradPlus支持通过 gradle 添加 SDK 到工程中，开发者可以通过TradPlusSDK下载平台获取 Gradle引用。

二、清单文件配置#

开发者需在App级别的AndroidManifest.xml文件中添加如下配置：

<manifest
    xmlns:android="http://schemas.android.com/apk/res/android"
    package="your package name"
    xmlns:tools="http://schemas.android.com/tools">

    <!--声明权限-->
    <!--穿山甲CSJ国内 必要权限-->
    <permission
        android:name="${applicationId}.openadsdk.permission.TT_PANGOLIN"
        android:protectionLevel="signature" />
    <uses-permission android:name="${applicationId}.openadsdk.permission.TT_PANGOLIN" />
    
    <!--穿山甲CSJ 国内、Pangle V45以下，请务必添加，否则黑屏 -->
    <uses-permission android:name="android.permission.WAKE_LOCK" />

    <!--Android 12 以上，同意获取 Android Advertiser Identifier -->
    <uses-permission android:name="android.permission.AD_ID" />

    <application
        <!-- 视频广告的硬件加速 -->
        android:hardwareAccelerated="true"
                

        <!-- AndroidV9.2写入SDK，无需配置；老版本升级的项目会因清单文件中有添加过该配置导致报错，删除配置即可 -->
        <!-- 添加网络安全配置，文件见下文 -->
        android:networkSecurityConfig="@xml/network_security_config">

         <!-- Apache的兼容 -->
        <uses-library android:name="org.apache.http.legacy" android:required="false"/>
    </application>
</manifest>

在项目的res/xml文件夹新增network_security_config.xml，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config 
        cleartextTrafficPermitted="true">
            <domain includeSubdomains="true">127.0.0.1</domain>
    </domain-config>
</network-security-config>

三、混淆配置#

开启混淆后，在proguard-rules.pro中添加混淆配置

-keep public class com.tradplus.** { *; }
-keep class com.tradplus.ads.** { *; }

四、初始化SDK#

建议在Application中初始化SDK

TradPlusSdk.setTradPlusInitListener(new TradPlusSdk.TradPlusInitListener() {
    @Override
    public void onInitSuccess() {
        // 初始化成功，建议在该回调后 发起广告请求
    }
});
TradPlusSdk.initSdk(context, "您在TradPlus平台创建的应用ID");

五、TapTap设置OAID#

由于Oaid对于TapADN SDK 的广告转化效果尤为重要，开发者请求广告前要传OAID
V9.9.10.1+ 支持开发者设置oaid
第一次请求广告时设置，以激励视频为例

TPReward mTpReward = new TPReward(activity, "AdUnitId");
Map<String, Object> mLocalExtras = new HashMap<>();
mLocalExtras.put("tap_oaid","开发者自行获取的oaid");
mTpReward.setCustomParams(mLocalExtras);

mTpReward.loadAd();

V9.9.10.1之前的版本，开发者要重写TapAdCustomController类，传入oaid，请求广告前传给TP，开发者可参考Demo设置

TapTapInitManager.getInstance().setTTCustomController(new TapTapUserDataCustomController());

六、资源优化#

广告SDK的资源不能被混淆，如果使用第三方的资源优化框架，请配置SDK的资源为白名单，例如：

TradPlus#

R.string.tp_*
R.drawable.tp_*
R.layout.tp_*
R.id.tp_*

集成交叉推广#

R.string.cp_*
R.drawable.cp_*
R.layout.cp_*
R.id.cp_*

集成游可赢Klevin#

R.anim.klevin_*
R.color.klevin_*
R.drawable.klevin_*
R.id.klevin_*
R.layout.klevin_*
R.mipmap.klevin_*
R.string.klevin_*
R.integer.klevin_*
R.style.klevin_*
R.dimen.klevin_*
R.xml.klevin_*

集成Pangle#

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@layout/tt_*,
    @layout/notification_*,
    @anim/tt_*,
    @drawable/tt_*,
    @string/tt_*,
    @color/tt_*,
    @string/ad*,
    @string/star_*,
    @dimen/tt_*,
    @integer/tt_*,
    @style/tt_*,
    @style/Theme.Dialog.TT_*,
    @style/tt_*,
    @style/quick_*,
    @style/EditTextStyle*"
    @attr/tt_*"/>

除此之外，Pangle还需要根据接入的Pangle版本进行白明单资源配置
下载 whiteList.txt 。

集成腾讯优量汇#

"R.integer.min_screen_width_bucket",
"R.style.DialogAnimationUp",
"R.style.DialogAnimationRight",
"R.style.DialogFullScreen",
"R.drawable.gdt_*"

集成Mintegral#

"R.string.mbridge*",
"R.layout.mbridge*",
"R.drawable.mbridge*",
"R.anim.mbridge*",
"R.color.mbridge*",
"R.style.mbridge*",
"R.id.mbridge*"