常见问题

一、广告加载失败

常见问题举例：

加载不到广告&204/103错误码&vpn问题

204或者103错误码都只是无填充，属于正常现象，建议使用测试广告填充率会比较高：

• (1)用tradplus的 测试模式
• (2)配置 三方的测试id
• (3)如果是海外广告源，设备需要开启海外的vpn(建议新加坡、日本地区)，可通过日志过滤“TradPlusLog”关键字查看ip归属，如果切了vpn但还是判断在中国，请确认vpn软件是否需要开启全局模式，并且卸载重装app后再次请求
• (4)部分三方平台应用在审核中、被封禁、广告位刚创建还未生效等均不会填充
• (5)不建议直接请求线上正式广告来本地测试，可能会出现未知报错或者账户封禁风险

response为空：

没有拉取到所使用广告位ID的后台配置，可能的原因是：

• (1)adUnitId填入错误
• (2)广告位ID在Tradplus后台没有配置三方广告源，或者广告源没有添加到中介组
• (3)对海外Bidding广告源，设备需要切海外vpn，可通过日志查看ip归属，如果切了vpn但日志还是显示在国内，请检查vpn是否有全局模式需要开启，并且卸载重装app后再次请求

adapter不存在（ios同理）

代码集成上，gradle文件里没有引入对应三方的adapter，请根据sdk下载平台生成的代码引入对应版本的依赖，举例Mintegral平台的adapter不存在，需要引入mplementation 'com.tradplusad:tradplus-mintegralx_overseas:18.13.4.20.1'

Meta的测试方法：

需注意：

• (1)设备切VPN到美国地区
• (2)设备上需安装Facebook应用，Facebook需处于登录状态，且账号能正常使用 1.优先建议到meta后台添加测试设备或者使用tradplus后台测试模式

2.可以配置meta测试id，需注意模板为Test Ad Types#YOUR_PLACEMENT_ID，其中YOUR_PLACEMENT_ID为meta后台导出的版位编号；Test Ad Types取值如下，其他素材类型可参考Test Your Implementation on a Test Device：

Test Ad Type	Supported Ad Format
CAROUSEL_IMG_SQUARE_APP_INSTALL	Interstitial, Native
IMG_16_9_LINK	Banner, Interstitial, Native
VID_HD_16_9_15S_LINK	Interstitial, Native, Rewarded Video

Admob测试：

建议在admob后台添加测试设备后直接请求，也可使用tradplus 测试模式，但请注意Admob必须使用测试广告测试，否则会有封号风险。

加载失败原因：

1、集成错误

• 适配文件没有集成

开发者需要根据打包平台确认集成的SDK都正确添加到项目中,找不到三方Adapter会报错adapter not found 或 Couldn't locate or instantiate custom event null

• TP的混淆配置没有添加

根据《SDK配置》文档添加混淆，不添加混淆会报Couldn't locate or instantiate custom event null

• 确认集成广告源是否需要传入Activity

部分三方源需要activity才能请求成功，没有传入Activity会一直失败

• 对象调用错误

确认TP的广告位类型和new TPObject的类型一致，例如不能创建开屏的广告位ID，但是用激励视频API去请求

2、后台配置问题

• 后台没有添加广告源

确认在TradPlus创建的广告位ID下已经添加了三方广告网络，会由于拉取不到配置报no config

• 同一个广告平台配置不同的APPID
• 确认TradPlus后台是否配置的三方广告源有多个APPID
• 后台配置错误即使是不同类型也只能配置同一个APPID
• 例如Mintegral开屏类型的appId、appkey和激励视频类型的appId、appkey不一致，三方平台只支持初始化同一个APPID，多个APPID初始化会导致请求失败

3、请求某个源一直无填充

• 开发者需配合《错误码和错误信息》定位错误问题

• 如果广告一直请求失败，就需要开发者根据三方平台错误码确认集成三方广告加载失败的原因

• 开发者可以通过过滤TradPlusLog查看日志信息或设置LoadAdEveryLayerListener监听oneLayerLoadFailed(TPAdError adError, TPAdInfo adInfo)回调，打印每个广告源加载失败的原因

(1)Meta或者Admob一直没有填充

• **Meta必须使用测试广告测试，否则会有封号风险。**需要使用三方提供的测试ID去测试，可配合如何使用测试模式来测试

• Admob必须使用测试广告测试，否则会有封号风险。（见下面截图）TradPlus测试模式测试，TradPlus后台已经将Admob测试广告配置到后台，开发者可以直接使用。

• 网络不好会偶现插屏视频中间视频播放黑屏，或者原生广告展示无展示事件。

• 请求次数过多，即使是使用测试广告也会无填充。

(2)Bidding源正式广告拉不到配置

报错日志为：
waterfall bean is null
或
Bidding Failed

• 由于TradPlus服务器策略能访问国内ip的网无法拉取到海外Bidding配置的。

• 开发者可以使用TradPlus测试模式进行测试。测试广告请求成功并展示表示内部流程已经跑通，是可以直接上线。

• 如果有需求上线前必须要用正式广告测试，那么IP必须在海外Bidding才能拉取到配置。例如：VPN开启后，不能打开CSDN情况下，才能拉取到，如下图：

(3)TapTap请求没有填充

• 由于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());

4、请求pangle报错Bidding Failed.Token Empty

• 原因是pangle sdk没返回竞价token
• 少量报错属于正常，因为首次请求时因为pangle下发配置可能会有延迟导致获取不到Token
• 若大量报错，可能是开发者把pangle的资源混淆了，pangle一直初始化失败导致，如果app有资源混淆需求，请加白pangle资源id

二、广告加载成功但是展示失败

1、广告加载成功后没有调用showAd

• （1）各类型广告onAdLoaded(TPAdInfo tpAdInfo, TPBaseAd tpBaseAd)或oneLayerLoaded(TPAdInfo adInfo)加载成功监听是否回调
• （2）激励、插屏、开屏isReady()为true，后调用showAd()。

2、广告位类型请求的API是否类型匹配

• 例如创建开屏的广告位，但是使用激励视频的API去请求。
• 开发者可以通过打印onAdVideoError(TPAdInfo tpAdInfo, TPAdError tpAdError)或onAdShowFailed(TPAdError error, TPAdInfo tpAdInfo)查看报错原因。

3、激励视频、插屏

• （1）showAd调用没有传入activity

  showAd(Activity activity, String sceneId) 展示广告是否传入Activity，context会导致部分广告源展示失败。

• （2）后台配置问题

  errorMsg为frequency limit，TP广告位是否设置了频次限制。

4、标准原生

• （1）showAd(ViewGroup adContainer, int layoutId)容器是否为空

• （2）开发者是否修改布局文件中的android🆔 资源ID，会导致自渲染广告的元素无法找到对应id而展示失败

• （3）后台配置问题

  errorMsg为frequency limit，TP广告位是否设置了频次限制。

5、开屏

• （1）开发者需确认加载和展示广告是否使用配对的API，正确传入容器，具体请查看《开屏文档》
• （2）后台配置问题 errorMsg为frequency limit，TP广告位是否设置了频次限制。

6、Meta的原生横幅

• 容器的宽必须是match_parent，不能是wrap_content，否则会导致展示失败。

7、Bigo的原生横幅

• bigo原生横幅有填充但是没展示，bigo对原生广告的要求是一定要有大图，即mediaView，否则不算展示。用我们的默认布局模板是有设置mediaView的，如果是自定义样式注意需要加上mediaView。

三、应用ID与广告位ID不匹配问题

一般出现这样提示有以下几种情况：

• 没有调用tradplus的初始化就去load了，这种情况下load广告的时候用的appid是空的
• 调用tradplus的初始化是在load广告后，同上一种情况
• 初始化没有成功就load广告，同上一种情况
• 开启了tradplus的测试模式，测试模式下发的是tradplus默认配置，确实会不一样。这种可以忽略
• 初始化也是提前调的，但是load还提示这个，那么可能确实用的appid和广告位id不是一个app下的，需要去tradplus后台查看应用管理。

四、编译报错

1、拉取TP SDK 或 TP对应的三方Adapter Gradle 失败

• 步骤1:开发者需根据打包平台确认集成的SDK正确

  • (1)是否是5.X更新上来的用户：由于JCenter仓库停止服务，TP和三方平台的仓库均有更新，请老版本升级上来的客户对照打包平台一一修改引用
  • (2)版本号是否能一一对应或者是否有字母写错的情况
  • (3) Android Studio HTTP Proxy状态正常
  • (4) Gradle是否属于“离线模式”—— 'offline mode'情况下构建项目是不会在线拉取第三方依赖包的

• 步骤2:确认Module级和Project级中build.gradle中正确引入了mavenCentral()和google()

	repositories {
		mavenCentral()
		google()
		jcenter()
		...
		}
	}

• (1)关于Module和Project，Unity开发者可以参考Google官网的Android Studio模块结构说明。

• (2)需注意mavenCentral()是否写成mavenLocal()，mavenLocal()是本地Maven仓库，第一次拉取TP Gradle需从线上拉取

• (3)各个代码库的列出顺序决定了 Gradle 在这些代码库中搜索各个项目依赖项的顺序。类似如下图情况表明tradplusad跑错了仓库导致拉取失败，此时开发者需要将mavenCentral()的位置调整到最高，重新拉取。

• 步骤3:Android Studio Gradle是否是离线状态？

  • 不知道怎么判断，初次接触Android的开发者可直接Google或Baidu，“gradle切换online/offline mode模式”。

• 步骤4:电脑是不是开了代理？导致“All packages are not available for download”报错。

  • 不知道怎么关闭，初次接触Android的开发者可直接Google或Baidu，“Android Studio如何关闭代理”。

• 步骤5:海外源一些拉取成功，个别拉取失败，大多是网络问题，开VPN切换国家尝试。

2、queries相关

unexpected element <queries> found in <manifest> or Error: Missing package key attribute on element package

• 由于集成的三方广告平台SDK对Gradle plugin的版本有要求，而旧版本的 Android Gradle 插件找不到对应的元素导致报错。

• 开发者需要先确认使用的Gradle版本。然后根据各个Android Gradle 插件版本所需的Gradle 版本。找到可使用的Gradle plugin 版本范围，并根据Android Gradle plugin fixes更新Gradle plugin版本就可以解决报错问题。

3、try name ‘AndroidManifest.xml’ collided`

需开发者要在build.gradle中添加

    android {
        packagingOptions {
            exclude 'AndroidManifest.xml'
        }
    }

4、java.lang.NoClassDefFoundError:Failed resolution of:Lcom/google/android/gms/ads/rewarded/RewardedAd

• 原因：同时引入 AdMob 与 Firebase

• 解决: 只能引入一个，同时firebase要引入和推荐的Admob Adapter一样的版本。

// 版本号，仅作举例说明，具体Firebase接入的版本要和TP Admob 推荐的版本号一致
//        implementation 'com.google.android.gms:play-services-ads:21.0.0'
    implementation 'com.google.firebase:firebase-ads:21.0.0'

5、The Google Mobile Ads SDK was initialized incorrectly

• 原因：集成Google Admob后自 Google 移动广告 SDK v17.0.0 起，必须添加此 <meta-data> 标记，如果不添加应用会崩溃，同时收到上面的Log。

• 解决: 根据《集成文档》中三方配置声明部分，正常集成SDK

6、AAPT: error: resource android:attr/lStar not found.

详细报错信息如下：

Execution failed for task ':app:checkDebugAarMetadata'.
> Multiple task action failures occurred:
   > A failure occurred while executing com.android.build.gradle.internal.tasks.CheckAarMetadataWorkAction
      > The minCompileSdk (31) specified in a
        dependency's AAR metadata (META-INF/com/android/build/gradle/aar-metadata.properties)
        is greater than this module's compileSdkVersion (android-30).
        Dependency: androidx.core:core-ktx:1.7.0.
        AAR metadata file: .gradle/caches/transforms-2/files-2.1/14c9ccd33a3c43ada608a2400c01e86e/jetified-core-ktx-1.7.0/META-INF/com/android/build/gradle/aar-metadata.properties.
   > A failure occurred while executing com.android.build.gradle.internal.tasks.CheckAarMetadataWorkAction
      > The minCompileSdk (31) specified in a
        dependency's AAR metadata (META-INF/com/android/build/gradle/aar-metadata.properties)
        is greater than this module's compileSdkVersion (android-30).
        Dependency: androidx.core:core:1.7.0.
        AAR metadata file:.gradle/caches/transforms-2/files-2.1/ac6a4373db31c761b96c2d467c311f0a/core-1.7.0/META-INF/com/android/build/gradle/aar-metadata.properties.

• 原因：集成三方平台SDK版本中引用core-ktx、core版本和项目版本不同
• 解决方法一: 需要更改编译版本compileSdkVersion升级到31，然后重新编译
• 解决方法二: 在app的build.gradle中添加如下，强制项目使用具体的版本，代码示范如下：

configurations.all {
    resolutionStrategy {
		// 开发者需引入项目中已有版本
        force 'androidx.core:core-ktx:1.5.0','androidx.core:core:1.6.0'
    }
}

7、com.tencent.mm.opensdk重复引用

• MTG从SDK16.1.7版本起，支持小程序跳转功能

• 非上架GP市场SDK会自动引入opensdk。如果开发者同时接入GDT会有冲突。可以使用exclude排除.

implementation ("com.mbridge.msdk.china:reward:${sdkVersion}"){
	exclude group: "com.tencent.mm.opensdk", module: "wechat-sdk-android"
}
implementation ("com.mbridge.msdk.china:mbsplash:${sdkVersion}"){
	exclude group: "com.tencent.mm.opensdk", module: "wechat-sdk-android"
}
implementation ("com.mbridge.msdk.china:mbbanner:${sdkVersion}"){
	exclude group: "com.tencent.mm.opensdk", module: "wechat-sdk-android"
}
implementation ("com.mbridge.msdk.china:mbnative:${sdkVersion}"){
	exclude group: "com.tencent.mm.opensdk", module: "wechat-sdk-android"
}
implementation ("com.mbridge.msdk.china:mbnativeadvanced:${sdkVersion}"){
	exclude group: "com.tencent.mm.opensdk", module: "wechat-sdk-android"
}
implementation ("com.mbridge.msdk.china:newinterstitial:${sdkVersion}"){
	exclude group: "com.tencent.mm.opensdk", module: "wechat-sdk-android"
}
implementation ("com.mbridge.msdk.china:mbbid:${sdkVersion}"){
	exclude group: "com.tencent.mm.opensdk", module: "wechat-sdk-android"
}

8、更新Google Admob SDK到V21.0.0后与Firebase有冲突报错

Duplicate class com.google.android.gms.measurement.internal.zzhe found in modules jetified-play-services-measurement-base-20.1.2-runtime (com.google.android.gms:play-services-measurement-base:20.1.2) and jetified-play-services-measurement-impl-19.0.1-runtime (com.google.android.gms:play-services-measurement-impl:19.0.1)

• 解决: 更新FireBase到最新版本

9、Error：AAPT: error: unexpected element ＜property＞ found in ＜manifest＞＜application＞

• 原因：Google Admob 更新到 22.4.0 或者 Yandex 更新到6.0.1，这两个平台对Android Gradle版本有要求，低版本Android Gradle找不到对应的元素导致报错。

• 解决: 更新Gradle插件版本到4.2.0+,Unity3D平台集成用户可以参考升级 Gradle for Android来更新Gradle

10、更新Yandex到V7.10.0后Gradle报错

原因：Yandex要求AGP至少是7.3.1版本,项目低于7.3.1会有Gradle相关报错。 解决：整个项目AGP更新到7.3.1版本

11、“String.length()“ because “＜parameter1＞“ is null

原因：Android高版本androidx引发D8问题，类似的bug会出现在一些高版本的androidx相关库文件中，如：

Failed to transform camera-extensions-1.4.0-alpha05.aar Failed to transform lifecycle-livedata-core-2.8.0.aar Failed to transform appcompat-resources-1.7.0.aar等

如果升级的库包含以上 package 都可能触发 R8/D8 的 bug，因为 androidX 之前已经开始升级到了 JDK 21，其中有些已经包含，但在旧版 AGP 中没有正确处理。

• 解决方法一：升级到 AGP 8.3+ 之后，问题在 8.3.3-dev 里修复了

• 解决方法二：使用特定的 D8/R8 版本

buildscript {
	repositories {
		mavenCentral()
		maven {
			url = uri("https://storage.googleapis.com/r8-releases/raw")
		}
	}
	
	dependencies {
		classpath("com.android.tools:r8:8.1.44")
	}
}

12、Columbus 更新到V3.5.0.2 项目各种编辑报错问题

• 因为该版本官方要求compileSdk = 35

• 而Android Studio版本2024.2.1以上才能支持compileSdk = 35，此外2024.2.1要求Gradle版本最低要在8.6.0以上，开发者需要升级AS和Gradle版本

13、Helium 更新到V5.3.0. 项目Gradle报错

• 该版本官方要求Gradle V8.2

14、更新Yandex到V7.15.+后Gradle报错

• 该版本官方要求Gradle V8.7

五、运行时异常

1、Adx Crash：android.content.res.Resources$NotFoundException: String resource ID #0x0.

• 需要将tp为前缀的资源添加到白名单中，详细了解《SDK配置-资源优化》文档

2、Caused by: android.view. InflateException: Binary XML file line #34:Error inflating class com. kwad.components.ad.reflux. KsRefluxView

Caused by: android.view. InflateException: Binary XML file line #34:Error inflating class com. kwad.components.ad.reflux. KsRefluxView Caused by: android. view. InflateException: Binary XML file line #34: Error inflating class com.kwad.components.ad.reflux. KsRefluxView.

• 集成快手SDK，在展示视频的时候出现Crash。

• 原因：缺少recyclerview引入导致

• 解决: 核对打包平台，填加漏引入的依赖

3、java.lang.NoClassDefFoundError: Failed resolution of: Lorg/apache/http/ProtocolVersion

• 原因：在 Android 6.0 中，SDK移除了对 Apache HTTP 客户端的支持。从 Android 9 开始，该内容库已从 bootclasspath 中移除，且默认情况下应用无法使用它。
• 解决:清单文件中配置apache

<application>
    <uses-library android:name="org.apache.http.legacy" android:required="false"/>
</application>

4、java.lang.RuntimeException: Manifest merger failed with multiple errors

• 原因：V9.2.0.1版本网络安全配置写入SDK。老版本升级上来的项目，清单文件中会因有添加过该配置而导致报错

• 解决

• 方法一 : 删除原本项目中添加的网络安全配置

<application
	// 删除此配置
	android:networkSecurityConfig="@xml/network_security_config">
</application>

• 方法二 :指定属性替换，使用项目中的配置

<application
	android:networkSecurityConfig="@xml/network_security_config"
	tools:replace="android:networkSecurityConfig"
	>
</application>

5、android.view.WindowManager$BadTokenException: Unable to add window -- token android.os.BinderProxy@cdac0e0 is not valid; is your activity running?

admob的原生广告验证器导致崩溃，只在admob的原生测试广告上可能会出现，可以关掉验证器再行测试，具体关闭方法可参考admob文档： https://developers.google.com/admob/android/native/validator?hl=zh-cn

六、Unity接入

1、激励(插屏)广告播放时切屏再回到游戏广告没有继续播放问题

• unity在编译时使用的singletask模式，所以切到桌面点击icon进入会将游戏界面上层的全部清除。如果是任务管理器回来并不会有异常。
• singletask是Unity官方建议模式，如果需要修改，可以网上查找下相关文章。

2、Unity打Android包报错Error building Player Exception OBSOLETE

• 从unity 2012开始，unity不再支持将资源文件放在 Assets / Plugins / Android / [res,assets]目录下unity官方说明
• 如果用不到原生横幅类型可直接删除res文件夹

3、Unity引擎对接归因平台，可能导致部分以“逗号”作为小数点的国家用户在转换ecpm时出现异常数据，可参考如下转换方式：

double.TryParse(adInfo["ecpm"].ToString(),NumberStyles.Float| NumberStyles.AllowThousands, CultureInfo.InvariantCulture, out revenue);

七、国内上架应用市场

1、点击直接下载问题

开发者可根据《国内隐私规范》文档中的“下载类广告二次弹窗确认”调用API或联系广告平台配置

2、开启个性化广告问题

开发者可根据《国内隐私规范》文档中的“国内个性化推荐广告开关”调用API

八、上架GooglePlay

1、权限问题

开发者需根据打包平台确认是否集成国内源，国内源不能上架GP。

2、发布警告提醒 “play-services-tasks (com.google.android.gms:play-services-tasks)”版本 18.0.0 存在严重问题，要求更新

• 原因：由于某一海外源pom文件中引入play-services-tasksV18.0.0的版本导致。

• 解决: build.gradle中配置移除指定版本

android {
	...
	configurations.all{
		resolutionStrategy.force 'com.google.android.gms:play-services-tasks:18.0.0'
	}
}

3、上架报错com.my.tracker：mytracker-sdk该SDK会收集个人数据或敏感数据。

• 原因：MyTarget SDK某个引用导致
• 解决: build.gradle中配置移除指定mytracker-sdk版本

implementation ('com.my.target:mytarget-sdk:5.15.0') {
    exclude group: 'com.my.tracker', module: 'mytracker-sdk'
}
implementation 'com.my.tracker:mytracker-sdk:3.0.9'

九、其他

1、kotlin调java代码

如果是kotlin项目集成tp，对于各种接口参数需要注意做好判空处理

2、初始化相关

• 建议在Application中初始化SDK，否则后台无法准确统计DAU
• SDK内部只会初始化一次，建议在所有tp操作之前调用；可以不等初始化结果就去加载广告
• 如果应用DAU统计是UI DAU，即应用有保活或者通知，那么建议在activity中初始化SDK
• 多进程的应用，只在一个进程中进行初始化

3、广告声音

目前sdk的逻辑是，如果三方sdk(admob除外)有提供控制是否静音的api，tpsdk都会默认置为静音；如果三方没有提供静音api就会以tp后台的设置为准，所有广告类型都是这样。 admob文档：https://developers.google.com/admob/android/global-settings?hl=zh-cn#video_ad_volume_control

更多问题，请联系我们，邮箱：tech_support@tradplus.com