配置离线广告之前,需先在dcloud广告联盟申请账号。

AndroidManifest.xml文件的application节点中添加如下节点到节点中,并配置替换其中uni-app或5+应用appid和广告联盟会员adid的值,因为涉及到开屏广告业务,项目工程必须以io.dcloud.PandoraEntry作为应用的入口Activity。该activity已包含在lib.5plus.base-release中,开发者无需实现。

  1. <meta-data android:name="DCLOUD_AD_ID" android:value="广告标识"/>
  2. <meta-data android:name="DCLOUD_AD_SPLASH" android:value="true"/><!--如果不开启开屏广告则不设置此字段或者值设置为false-->
  3. <meta-data android:name="DCLOUD_STREAMAPP_CHANNEL" android:value="包名|应用标识|广告标识|渠道,如io.dcloud.appid|appid|adid|google" /><!--为了保证广告统计的有效性,请正确设置此值-->
  • 包名:对应Android项目中build.gradle中的applicationId,如io.dcloud.HBuilder
  • 应用标识:对应5+ APP或uni-app项目manifest.json中appid,当前应用必须开通广告并且必须与dcloud_control.xml中的appid保持一致。
  • 广告标识:联盟ID,开通广告后可在uniad.dcloud.net.cn获取,如果没有开通广告,设置值为空即可
  • 渠道:渠道包制作指南

今日头条穿山甲

库文件配置

将以下文件放入工程的libs目录下

路径 文件名
SDK/libs ads-release.aar、ads-csj-release.aar、open_ad_sdk.aar

Androidmanifest.xml配置

application节点下添加

将“${applicationId}”替换成应用的包名

  1. <provider
  2. android:name="com.bytedance.sdk.openadsdk.TTFileProvider"
  3. android:authorities="${applicationId}.TTFileProvider"
  4. android:exported="false"
  5. android:grantUriPermissions="true">
  6. <meta-data
  7. android:name="android.support.FILE_PROVIDER_PATHS"
  8. android:resource="@xml/file_paths"
  9. tools:replace="android:resource"/>
  10. </provider>
  11. <provider
  12. android:name="com.bytedance.sdk.openadsdk.multipro.TTMultiProvider"
  13. android:authorities="${applicationId}.TTMultiProvider"
  14. android:exported="false" />

dcloud_properties.xml配置

features 节点添加

  1. <feature name="Ad" value="io.dcloud.feature.ad.AdFlowFeatureImpl">
  2. <module name="csj" value="io.dcloud.feature.ad.csj.ADCsjModule"/>
  3. </feature>

腾讯优量汇

库文件配置

将以下文件放入工程的libs目录下

路径 文件名
SDK/libs ads-release.aar、ads-gdt-release.aar、GDTSDK.unionNormal.aar

Androidmanifest.xml配置

application节点下添加

将“${applicationId}”替换成应用的包名

  1. <provider
  2. android:name="io.dcloud.gdt.GdtFileProvider"
  3. android:authorities="${applicationId}.fileprovider"
  4. android:exported="false"
  5. android:grantUriPermissions="true">
  6. <meta-data
  7. android:name="android.support.FILE_PROVIDER_PATHS"
  8. android:resource="@xml/gdt_file_path"
  9. tools:replace="android:resource"/>
  10. </provider>

dcloud_properties.xml配置

features 节点添加

  1. <feature name="Ad" value="io.dcloud.feature.ad.AdFlowFeatureImpl">
  2. <module name="gdt" value="io.dcloud.feature.ad.gdt.ADGdtModule"/>
  3. </feature>

快手

库文件配置

将以下文件放入工程的libs目录下

类型 路径 文件名
快手广告联盟 SDK/libs ads-release.aar、ads-ks-release.aar、ks_adsdk-ad.aar
快手内容联盟 SDK/libs ads-release.aar、ads-ks-content-release.aar、kssdk-allad-content.aar

Androidmanifest.xml配置

manifest节点下添加

将“${applicationId}”替换成应用的包名

  1. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  2. <uses-permission android:name="android.permission.READ_PHONE_STATE" />
  3. <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
  4. <permission
  5. android:name="${applicationId}.permission.KW_SDK_BROADCAST"
  6. android:protectionLevel="signature" />
  7. <uses-permission android:name="${applicationId}.permission.KW_SDK_BROADCAST" />

dcloud_properties.xml配置

features 节点添加

  1. <feature name="Ad" value="io.dcloud.feature.ad.AdFlowFeatureImpl">
  2. <module name="ks" value="io.dcloud.feature.ad.ks.ADKsModule"/>
  3. </feature>

Sigmob

库文件配置

将以下文件放入工程的libs目录下

路径 文件名
SDK/libs ads-release.aar、ads-sigmob-release.aar、windAd.aar

Androidmanifest.xml配置

manifest节点下添加

  1. <uses-permission android:name="android.permission.INTERNET" />
  2. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  3. <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
  4. <uses-permission android:name="android.permission.READ_PHONE_STATE" />
  5. <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  6. <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  7. <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" tools:node="replace"/>
  8. <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
  9. <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
  10. <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

dcloud_properties.xml配置

features 节点添加

  1. <feature name="Ad" value="io.dcloud.feature.ad.AdFlowFeatureImpl">
  2. <module name="sgm" value="io.dcloud.feature.ad.sigmob.ADSMModule"/>
  3. </feature>

百度广告

最低支持版本:离线sdk 3.4.1

库文件配置

将以下文件放入工程的libs目录下

路径 文件名
SDK/libs ads-release.aar、ads-bd-release.aar、Baidu_MobAds_SDK.aar

dcloud_properties.xml配置

features 节点添加

  1. <feature name="Ad" value="io.dcloud.feature.ad.AdFlowFeatureImpl">
  2. <module name="bd" value="io.dcloud.feature.ad.bd.ADBDModule" />
  3. </feature>

华为广告

最低支持版本:离线sdk 3.4.1

库文件配置

将以下文件放入工程的libs目录下

路径 文件名
SDK/libs ads-release.aar、ads-hw-release.aar

Gradle配置

项目级build.gradle

  1. buildscript {
  2. repositories {
  3. ...
  4. maven {url 'https://developer.huawei.com/repo/'}
  5. }
  6. dependencies {
  7. ...
  8. classpath 'com.huawei.agconnect:agcp:1.6.0.300'
  9. }
  10. }
  11. allprojects {
  12. repositories {
  13. ...
  14. maven {url 'https://developer.huawei.com/repo/'}
  15. }
  16. }

应用级的build.gradle

  1. dependencies {
  2. implementation 'com.huawei.hms:ads-lite:13.4.49.301'
  3. }

dcloud_properties.xml配置

features 节点添加

  1. <feature name="Ad" value="io.dcloud.feature.ad.AdFlowFeatureImpl">
  2. <module name="hw" value="io.dcloud.feature.ad.hw.AdHwModule" />
  3. </feature>

360广告

库文件配置

将以下文件放入工程的libs目录下

路径 360聚合模块配置 360聚合穿山甲模块配置 360聚合广点通模块配置
SDK/libs ads-release.aar、ads-360-release.aar、torch-adcore-5.12.3140.aar open_ad_sdk.aar、torch-plcsjsdk-5.12.3140.aar torch-plgdtapi-5.12.3140.aar、torch-plgdtsdk-5.12.3140.aar

如果没有在360聚合平台申请穿山甲和广点通的广告,则对应的aar不需要添加

dcloud_properties.xml配置

features 节点添加

  1. <feature name="Ad" value="io.dcloud.feature.ad.AdFlowFeatureImpl">
  2. <module name="360" value="io.dcloud.feature.ad.juhe360.AD360Module"/>
  3. </feature>

nvue配置

库文件配置

注意:配置nvue组件之前需要先按照上面文档配置好对应的广告平台。

路径 文件名
SDK/libs weex_ad-release.aar

uni-AD广告联盟开通指南

注意事项

如果出现uni-AD业务状态提醒如下提醒:

avatar

请删除掉未申请的平台的相关配置和aar,例如广告后台添加了穿山甲广告,但没有添加360和广点通的广告,请删除掉广点通和360的相关配置和aar。