美數廣告 SDK

接入流程

1.嵌入廣告SDK

將 sdk-android-demo/app/libs 中的 meishu-sdk_xxx_release.aar、open_ad_sdk_xxx.aar、Baidu_MobAds_SDK-release-xxx.aar、GDTSDK.unionNormal.xxx.aar、msa_mdid_1.0.13 拷貝到項目的 libs 下，對應的 build.gradle 文件里面添加如下配置

xxx代表版本號，建議使用 demo 中的版本

穿山甲、百度、廣點通三個包可選，不接入可以不添加

repositories{

flatDir{

dirs 'libs'

}

}

dependencies {

implementation(name: 'meishu-sdk_xxx_release', ext: 'aar') // 美數

implementation(name: 'open_ad_sdk_xxx', ext: 'aar') // 穿山甲

implementation(name: 'Baidu_MobAds_SDK-release-xxx', ext: 'aar') // 百度

implementation(name: 'GDTSDK.unionNormal.xxx', ext: 'aar') // 廣點通

implementation(name: 'msa_mdid_xxx', ext: 'aar') // oaid

}

2.添加SDK依賴庫

請添加如下依賴庫

dependencies {

implementation 'com.squareup.okhttp3:okhttp:3.12.1'

implementation 'com.google.code.gson:gson:2.8.5'

implementation 'com.googlecode.android-query:android-query:0.25.9'

implementation 'com.github.razerdp:BasePopup:2.2.1'

implementation 'pl.droidsonroids.gif:android-gif-drawable:1.2.6'

}

3.添加 manifest 聲明

要注意 provider 中的 android:authorities 不能有重復，xxx_file_path 文件可以從 demo 程序中獲取

穿山甲、百度、廣點通三個包可選，不接入可以不添加

百度 5.85 之前 provider 使用 com.baidu.mobads.openad.FileProvider，5.85(含) 之后使用 com.baidu.mobads.openad.BDFileProvider

android:name="com.meishu.sdk.core.service.MeishuFileProvider"

android:authorities="${applicationId}.MeishuFileProvider"

android:exported="false"

android:grantUriPermissions="true">

android:name="android.support.FILE_PROVIDER_PATHS"

android:resource="@xml/meishu_file_path" />

android:name="com.bytedance.sdk.openadsdk.TTFileProvider"

android:authorities="${applicationId}.TTFileProvider"

android:exported="false"

android:grantUriPermissions="true">

android:name="android.support.FILE_PROVIDER_PATHS"

android:resource="@xml/csj_file_path" />

android:name="com.bytedance.sdk.openadsdk.multipro.TTMultiProvider"

android:authorities="${applicationId}.TTMultiProvider"

android:exported="false" />

android:name="com.baidu.mobads.AppActivity"

android:configChanges="keyboard|keyboardHidden|orientation"

android:theme="@android:style/Theme.Translucent.NoTitleBar"/>

android:name="com.baidu.mobads.openad.FileProvider"

android:authorities="${applicationId}.bd.provider"

android:exported="false"

android:grantUriPermissions="true">

android:name="android.support.FILE_PROVIDER_PATHS"

android:resource="@xml/bd_file_path" />

android:name="com.qq.e.comm.DownloadService"

android:exported="false" />

android:name="com.qq.e.ads.ADActivity"

android:configChanges="keyboard|keyboardHidden|orientation|screenSize" />

android:name="com.qq.e.ads.PortraitADActivity"

android:configChanges="keyboard|keyboardHidden|orientation|screenSize"

android:screenOrientation="portrait" />

android:name="com.qq.e.ads.LandscapeADActivity"

android:configChanges="keyboard|keyboardHidden|orientation|screenSize"

android:screenOrientation="landscape" />

android:name="android.support.v4.content.FileProvider"

android:authorities="${applicationId}.fileprovider"

android:exported="false"

android:grantUriPermissions="true">

android:name="android.support.FILE_PROVIDER_PATHS"

android:resource="@xml/gdt_file_path" />

4.添加權限

5.oaid

sdk 內置了 oaid 獲取的功能，必須添加 oaid 包，版本最好大于等于 1.0.13，不然可能會出現崩潰情況

需要在 assets 文件夾中添加文件 supplierconfig.json，這樣才能正確獲取到 oaid，開發者可以調用 AdSdk.getOaid() 來直接獲取 oaid，如果您獲取不到正確的 oaid，請檢查接入方式

文件內容如下：

{

"supplier":{

"vivo":{

"appid":""

},

"xiaomi":{

},

"huawei":{

},

"oppo":{

}

}

}

6.代碼混淆

如果您需要使用 proguard 混淆代碼，需確保不要混淆 SDK 的代碼。請把 demo 下的 sdk-android-demo/app/proguard-rules.pro 文件的內容追加到您項目的混淆配置文件中，文件中包含了美數、穿山甲、百度、廣點通的混淆

7.代碼接入

請在您的 Application 初始化 sdk，代碼如下，更多選項及設置詳見 demo 代碼

// 一定要在 Application 中初始化 sdk，否則無法正常使用sdk

// appId 是在美數注冊的 appId

// testModeEnabled 表示是否開啟測試模式，測試模式無法用于生產環境

AdSdk.init(context, "101629", true);

// 設置下載提示類型，默認不提示 AdSdk.DOWNLOAD_MODE_DIRECTLY

AdSdk.setDownloadMode(AdSdk.DOWNLOAD_MODE_NOTIFY);

// 設置是否 debug 模式，debug 模式會打印內部 log，默認不打印

AdSdk.setDebug(true);

// 設置用戶標簽，什么時候獲取到，什么時候設置就可以了

AdSdk.setAge(18);

AdSdk.setGender(AdSdk.GENDER_MALE);

AdSdk.setKeywords("food,game");

8.廣告位代碼接入

請參考 demo 代碼

目前貼片視頻廣告需要在 Activity 中的 onResume 和 onPause 調用代碼才能實現暫停和恢復，詳見 PasterActivity

穿山甲 Draw視頻流廣告接入方法見 VideoFeedActivity