Skip to main content

集成说明

一、简介#

本文档主要介绍在Unity3D中如何集成 TradPlus的SDK:

  • 支持的广告类型有:横幅广告、插屏广告、激励视频广告、原生广告;
  • 针对v6.x版本的集成;
  • 建议先注册TradPlus账户,并添加应用;
  • 集成时,海外和国内广告必须分包集成,否则会出现集成上的冲突;
  • 如果集成国内广告源的版本发布到Google Play上,应用会无法上架。

二、集成步骤#

  • 1、下载TradPlus SDK
  • 2、Android平台导入
  • 3、混淆配置
  • 4、初始化SDK

三、下载TradPlus SDK#

  • (2)通过点击生成接入代码,获取所需三方源Maven引入,如图:

也可以参考TradPlus各版本Gradle配置进行配置

  • (3)点击下载地址,获取某些三方源所需aar文件,如图:

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

  • third-party_libs :某些三方平台SDK集成所需aar包文件
  • unity_assets中的cs脚本文件
  • res:原生广告所需布局文件(有集成需要就导入,没有则不需要导入)

四、Android平台导入#

1、 Editor 2019及以上版本#

(1)生成Gradle和AndroidManifest.xml文件#

按照下图,生成baseProjectTemplate.gradlemainTemplate.gradleAndroidManifest.xml文件

(2)baseProjectTemplate.gradle配置#

在上图生成的baseProjectTemplate.gradle文件中引入所需Maven库,请参考AndroidManifest.xml文件配置进行配置,如下举例说明

allprojects {
buildscript {
repositories {**ARTIFACTORYREPOSITORY**
google()
jcenter()
//TradPlus Maven (Support版本库)
maven { url 'https://dl.bintray.com/tradplus/support' }
}
...
}
repositories {**ARTIFACTORYREPOSITORY**
google()
jcenter()
//TradPlus Maven (Support版本库)
maven { url 'https://dl.bintray.com/tradplus/support' }
flatDir {
dirs "${project(':unityLibrary').projectDir}/libs"
}
}
}
...
(2)mainTemplate.gradle配置#

在上图生成的mainTemplate.gradle文件中引入所需依赖,请参考TradPlus自动打包平台,进行配置添加引用到dependencies中,如下举例说明

apply plugin: 'com.android.library'
**APPLY_PLUGINS**
dependencies {
//注意:具体根据各版本配置引入
//TradPlus Maven Support版本
implementation 'com.tradplus.ads:tradplus-sdk:6.0.1'
implementation 'com.tradplus.ads:tradplus-core:6.0.1'
implementation 'com.tradplus.ads:tradplus:6.0.1'
//Admob
implementation 'com.google.android.gms:play-services-ads:17.2.1'
implementation 'com.tradplus.ads.google:tradplus-google:2.6.0.1'
//Facebook
implementation 'com.facebook.android:audience-network-sdk:6.2.0'
implementation 'com.tradplus.ads.facebook:tradplus-facebook:1.6.0.1'
**DEPS**}
...

(3)Manifest.xml文件配置#

在上图生成的AndroidManifest.xml文件中需要添加一些配置,具体配置请参考AndroidManifest.xml文件配置进行添加。


2、 Editor 2018#

(1)mainTemplate.gradle文件生成并配置#

如下图生成mainTempate.gradle文件

WeChatWorkScreenshot_0767252a-d886-49b8-afb7-19680a49ea77.png

(2)生成Manifest.xml文件#

在unity的安装目录下,可以找到unity默认的Manifest文件,复制到您的生成mainTempate.gradle的同级目录中,具体配置请参考AndroidManifest.xml文件配置进行添加


五、AndroidX配置#

按照下图,生成gradleTemplate.properties文件。 在生成的gradleTemplate.properties文件中添加如下配置

//添加以下配置
android.enableJetifier=true
android.useAndroidX=true

如果使用的Unity Editor没有生成gradleTemplate.properties文件的选项。需要在项目的Assets/Plugins/Editor新增文件SupportAndroidXGradlePropertiesBuildProcessor.cs,添加如下内容:

using System.IO;
using UnityEditor.Android;
using UnityEngine;
public class SupportAndroidXGradlePropertiesBuildProcessor : IPostGenerateGradleAndroidProject
{
public int callbackOrder
{
// 同种插件的优先级
get { return 999; }
}
public void OnPostGenerateGradleAndroidProject(string path)
{
Debug.Log("Bulid path : " + path);
string gradlePropertiesFile = path + "/gradle.properties"; //2019版及其以上使用的路径
if (File.Exists(gradlePropertiesFile))
{
File.Delete(gradlePropertiesFile);
}
StreamWriter writer = File.CreateText(gradlePropertiesFile);
writer.WriteLine("org.gradle.jvmargs=-Xmx4096M");
writer.WriteLine("android.useAndroidX=true");
writer.WriteLine("android.enableJetifier=true");
writer.Flush();
writer.Close();
}
}

六、混淆配置#

如果APP打Release包需要添加混淆,先在如下位置勾选User Proguard File生成对应的配置文件,之后在生成的文件中添加如下配置:

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

七、初始化SDK#

在游戏启动类中进行TradPlus的初始化:

即在Application中初始化SDK,如果应用DAU统计是UI DAU,那么建议在activity中初始化SDK。

//初始化,AppId是应用Id,需要您去开发者后台添加APP
TradPlus.InitializeSdk(“AppId“);

仅供测试使用AppId:44273068BFF4D8A8AFF3D5B11CBA3ADE,正式上线时替换成您在TradPlus开发者后台的应用ID

八、其他功能#

V6.9.1新增API

  • 广告位对象创建后调用,这两个方法对全局设置有效。
  • 为防止游戏过程中补充过期广告会占用带宽,可以调用SetAutoExpiration(),传false关闭每隔5分钟自动过期检测。默认true,将自动进行广告过期检测。
  • 如果调用SetAutoExpiration()关闭过期检测,那么在游戏即将展示广告前要调用CheckAutoExpiration()来触发一次广告过期检测。
// 关闭每隔5分钟自动过期检测
TradPlus.SetAutoExpiration(false);
// 可主动触发过期检测(如有失效广告会触发加载)
TradPlus.CheckAutoExpiration();