跳到主要内容

SDK 集成

一、TradPlus_Flutter_SDK 导入​

Flutter版本要求: flutter: ">=2.5.0"

1.通过pub.dev集成​

您可以通过 pub.dev集成TradPlus_Flutter_SDK插件

  • 通过命令直接安装
flutter pub add tradplus_sdk
  • 或 手动在项目的 pubspec.yaml 中添加依赖，并执行 flutter pub get
dependencies:
  tradplus_sdk: ^1.1.7
  • 然后 引入插件
import 'package:tradplus_sdk/tradplus_sdk.dart';

2.手动下载集成​

第一步：下载TradPlus_Flutter_SDK插件​

sdk包含文件如下：

res：附带的默认原生广告布局

tradplus_sdk：flutter平台tradplus插件

第二步：工程目录下创建plugins文件夹,将下载好的SDK插件放入plugins文件夹中​

如图:

第三步：项目工程pubspec.yaml中添加本地依赖​
dependencies:
  flutter:
    sdk: flutter

  cupertino_icons: ^1.0.2
  # 添加TradPlus Flutter SDK本地依赖
  tradplus_sdk:
    path: plugins/tradplus_sdk/
第四步：引入插件​
import 'package:tradplus_sdk/tradplus_sdk.dart';

二、平台配置说明​

（1）Android平台配置​

第一步：TradPlusSDK下载平台下载SDK​

  • 接入方式直接选择Android下载SDK
  • 开发者要确认项目是AndroidX还是Support，引入错误会导致项目编译不过

第二步：导入SDK​

选择需要接入的广告源后，点击“生成接入代码”按钮获取需要的Gradle引用，如图一：

开发者需要将Maven库的引用添加到项目层级的build.gradle中，如图二：

将Gradle引用部分添加到app中build.gradle中，如图三：

第三步：SDK配置​

这步配置开发者需要在AndroidManifest文件中配置，位置如图三所示：

开发者可参考Android SDK配置文档在项目工程中进行配置

（2）IOS平台配置​

有两种导入SDK方式： cocopods配置导入及 手动下载导入

cocopods 配置导入 SDK​

1、请至 iOS打包平台下载相关SDK , cocopods接入 选择 是

2、勾选需要集成的平台

3、选择生成代码

将生成的代码,修改为:

s.dependency 'TradPlusAdSDK', '7.8.10'
s.dependency 'TradPlusAdSDK/FacebookAdapter', '7.8.10'
s.dependency 'FBAudienceNetwork','6.11.1'
s.dependency 'TradPlusAdSDK/AdMobAdapter', '7.8.10'
s.dependency 'Google-Mobile-Ads-SDK','9.7.0'
s.dependency 'TradPlusAdSDK/AppLovinAdapter', '7.8.10'
s.dependency 'AppLovinSDK','11.4.3'
s.dependency 'TradPlusAdSDK/PangleAdapter', '7.8.10'
s.dependency 'Ads-CN/International', '4.5.1.6'
s.dependency 'Ads-CN/BUAdSDK', '4.5.1.6'

3.将修改后的配置添加到 tradplus_sdk.podspec 中

手动下载导入​

1、请至 iOS打包平台下载相关SDK，cocopods接入 选择 否

2、勾选需要集成的平台，选择生成代码 并下载SDK zip包

3、将解压后的 TradPlusFrameworks 文件夹放置在 插件iOS目录下

3. 在ios/Runner/Info.plis添加配置​

  • Http访问请求权限
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
  • 配置 App Tracking Transparency (IDFA) 授权
<key>NSUserTrackingUsageDescription</key>
<string>点击"允许"以使用设备信息获得更加相关的广告内容，未经同意我们不会用于其他目的；开启后，您也可以前往系统“设置-隐私 ”中随时关闭</string>

建议在 ios/Runner/AppDelegate 中添加IDFA授权代码

Objc代码


#import <AppTrackingTransparency/AppTrackingTransparency.h>

 if (@available(iOS 14.5, *)) {
        [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
        }];
 }

swift代码


import AppTrackingTransparency

if #available(iOS 14.5, *) {
	ATTrackingManager.requestTrackingAuthorization { status in
	}
}

  • 设置SKNetworkID

三方SKNetworkID配置

  • 如使用 Admob 或 GoogleAdManager 时需要添加的配置

     必须要将产品在 Admob 的唯一性标识写在客户端中，否则将会造成应用crash。

     在Info.plist中添加 GADApplicationIdentifier配置, 应用发布时请替换成应用在Admob后台的appid。

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</string>