Skip to main content

基础集成说明

集成步骤#

请开发者根据下面步骤进行集成，跳过或漏看会导致集成失败。

第一步：从打包平台上下载SDK#

初次使用TradPlus的开发者，可通过下文《如何使用打包平台》了解如何使用，项目漏集成会导致广告请求失败。

常见情况说明
集成某个源，但漏集成其Adapter或该源SDK上线前注释该源的上线后广告会一直无法请求成功
项目工程是AndroidX的，但开发接的是Support的SDK上线会有Crash的可能。
这是由Android X和Support的库文件不同导致。
非Android开发的技术人员想了解项目是否支持AndroidX，可Google或百度“如何区分AndroidX”，这是Android的基础。
集成某个源，但引用不全请求该源时可能会因为缺少某个依赖导致Crash。

第二步：SDK配置#

Android#

这部分属于Android开发的基础，非Android技术人员，配置这块需先Google或百度学习：

  • Android Studio项目结构 —— 了解AndroidManifest文件和混淆文件在哪里
  • Android 清单文件 —— 了解如何声明权限，provider在哪个标签下配置
  • Android 代码混淆配置 —— 了解如何正确使用ProGuard
配置说明
Android平台导入如何生成mainTemplate.gradle和AndroidManifest.xml文件
配置AndroidManifest文件漏加会导致有些广告填充失败或展示异常
添加混淆配置项目开启混淆后，不加配置会影响正式包正常请求
接入原生广告，要配置广告资源白名单项目使用资源优化框架，不加会影响原生广告素材展示，比如广告展示一片空白

iOS#

iOS SDK配置

第三步：SDK初始化#

不初始化SDK，会直接影响后台统计DAU，导致数据不准确，增加运营工作难度。

第四步：接入具体广告类型#

  • 初次接触广告的开发者，可参考Google AdMob Ad Format（外网IP，国内流量可能会访问异常）稍微了解不同类型的广告，比如什么是横幅广告，一般展示在应用什么位置。

  • 文档中每个类型都有注意事情的说明，请开发者读完。

第五步：测试#

  • TradPlus 提供两种测试方式供开发者集成后测试广告。

  • 两种方法生效前提是开发者已经在后台配置了广告；没有配置广告，直接请求，不会拉取到策略。

  • 第一种需要开发者在TP后台开启测试模式

    • TP服务器会根据您指定开启测试模式的应用，下发广告策略。
    • 例如：开启应用ID为12345的快手激励视频的广告。开发者需要先清除应用缓存，然后初始化相同的应用ID同时请求激励视频，服务器会直接拉取配置好的快手广告。（Tip：初始化的应用ID错误或者，请求的是其他类型的广告一样会导致拉取失败哦）

  • 第二种开发者可直接使用三方平台提供的测试广告位进行测试。运营可直接将三方提供的测试广告位添加到TP后台，开发清除应用缓存后，拉取刚配置的广告进行测试。

  • 两种测试方法不可同时使用。

    测试模式

    三方测试ID

如何使用打包平台#

这部分文档可帮助初次使用TradPlus打包平台的开发者了解一下使用注意事项，以便能快速接入SDK。

1.发布地区的选择，有什么集成上的注意事项#

  • 国内广告源由于权限问题不能发布到谷歌市场，所以集成国内广告源上架谷歌会导致应用上架失败。
  • 部分广告源，国内海外均有支持，集成时，同一项目不能同时引入。例如：穿山甲支持海外和国内，需要分别导入国内或海外的项目，同时引入会导致冲突。
  • 发布国内要参考国内隐私规范设置二次弹窗、个性化广告等，否则发布应用市场会失败。
  • 发布海外要参考海外隐私规范，比如应用发布到欧盟地区设置GDPR等。

2.选择AndroidX还是非AndroidX（Support）#

  • AndroidX和Android Support Library是Google支持的两个不同的库，同时引用会导致开发编译不过，二者只能选其一。
  • 这个问题需要Android技术人员确认接入SDK的项目是AndroidX还是Support的版本的。
  • 非Android技术人员或初次接触Android的开发者可根据Android工程中gradle.properties确认
  • 找不到gradle.properties的开发，可Google或百度“Android Studio项目结构”

该项目是AndroidX

android.useAndroidX=true
android.enableJetifier=true

该项目是Android Support

android.useAndroidX=false
android.enableJetifier=false

3.哪些广告源支持Header Bidding#

如图：广告源有“Header Bidding”标签，表明该源支持HB。

4.怎么确认该广告源支持什么类型#

  • 如图：AdMob 支持激励视频、插屏、原生、横幅、开屏，五个类型。

  • 没有的类型，表示不支持。例如，问题3中的Meta，就不支持开屏类型。

5.FaceBook在哪，找不到这个源#

  • 如图问题3，就是FaceBook。
  • 2021年扎克伯格在Facebook的Connect开发者大会上宣布，将公司名称改为“Meta”。

6.哪些文件是TradPlus的引用#

所有Gradle引用包含tradplus的是TP的引用。其他均为三方广告平台的引用。

7.将生成接入代码的Gradle引用直接复制到项目中，为啥拉不下来 （纯开发问题）#

  • repositories中仓库地址是否在project层级中的build.gradle添加
  • 海外源一些拉取成功，个别拉取失败，大多是网络问题，开VPN切换国家尝试。

8.将生成接入代码的Gradle引用直接复制到项目中，和项目里其他SDK冲突 （纯开发问题）#

  • 该问题不是TP SDK有BUG，发布前TP有进行这部分的测试。
  • 是开发者的项目中的某个引用和三方广告平台的SDK的引用有了冲突。
  • 开发者首先需要排查是哪个三方广告平台的引用和项目中引用起了冲突。

排查方式（开发者可举一反三，自行排查，思路都是一样的）

9.为什么有些源选择后，生成接入代码中没有Gradle的引用#

  • 部分源提供aar包的方式集成，开发者需要点击下载地址，获取集成所需的aar文件

10.下载地址中的压缩包都包括哪些文件#

下载SDK的压缩包，解压后TradPlusSDK_Android的文件夹里面会有以下内容：

文件夹说明
unity_assetscs脚本文件。
res原生广告提供的TP模版布局。
接入原生类型的开发者，直接将xml布局文件扔到项目layout文件夹下即可。
无接入原生类型的开发者，可直接忽略该文件夹。
third-party_libs根据开发者选择的三方平台生成的aar文件。
请注意大部分海外源直接提供Gradle引入，不提供aar包；所以当开发者选择三方源全部为Gradle引入时，文件夹为空。

11.接入UnityAds时的注意事项#

如果您会接入 UnityAds 广告源，请确认在unity项目中的 Package Manager (Window>Package Manager) 中是否有引入 unity 广告插件，如有请移除后再集成，否则可能会导致集成冲突，google商店审核不通过等问题。