Skip to main content

使用入门

开始使用#

      本指南适用于希望借助TradPlus SDK通过 iOS 应用获利的发布商。

前提条件#

  • SDK v4.6.6以上请使用 Xcode 12 或更高版本,定位到 iOS 9.0 或更高版本
  • 下载最新版 TradPlus iOS SDK
  • 创建 tradplus 帐号并注册应用

注意:自 iOS 9 开始,iOS 应用一律使用应用传输安全 (ATS) 功能,这是一种强制使用加密连接的数据传输安全功能。在继续之前,请参阅应用传输安全中的要求配置您的 info.plist,以确保您的广告不受 ATS 影响。

SDK部署配置#

1.目录结构#

      TradPlusFrameworks

2.添加SDK静态库和头文件#
  • 添加TradPlusFrameworks目录到工程中

    TradPlusFrameworks对应各个渠道,不同类型广告的处理。 对于不想要的第三方渠道,直接删除对应子framework。

  • 在 “TARGETS” > “Build Setting” > “Linking” > “Other Linker Flags” 中加入 -ObjC
  • 在 “TARGETS” > “General” 将 MoPub.framework和KSAdSDK.framework(如果有使用) 设置为Embed & Sign
3.添加常用系统依赖框架#
  • libz.tbd
  • libbz2.tbd
  • libxml2.tbd
  • libresolv.9.tbd
  • libsqlite3.tbd

pod接入方法#

我们也支持pod方式接入。 请前往iOS SDK下载,选择Cocoapod接入,SDK版本及需要接入的广告平台,然后点击生成接入代码按钮,就可以一键获取您要添加的pod配置信息。

TradPlus要求#

  • 请在mac上下载解压sdk,否则会导致部分文件格式损坏。
  • 请不要在TradPlus同一应用的不同广告位,配置相同的三方渠道广告位,会导致回调错乱等各种问题。
  • 关于头条广告,在iOS这边不分国内海外,在后台新增源的时候都选(穿山甲)海外, TradPlusFrameworks目录下如果有ByteDance目录,请删掉。

Facebook要求#

      需要下载Facebook并成功登录,才能展现广告,包括测试广告。

Admob要求#

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

      Info.plist 添加 GADApplicationIdentifier值为ca-app-pub-1111111111111111~1111111111, 应用发布时请替换成应用在Admob后台的appid。

用测试广告进行测试#

      在构建和测试应用时,请确保使用的是测试广告,而不是实际投放的广告。否则,可能会导致您的帐号被暂停。

SDK初始化#

      在AppDelegate类的didFinishLaunchingWithOptions方法调用如下代码, 只要调用即可,初始化结果不影响其他功能。

//v5.0.0+
[TradPlus initSDK:@"tradplus后台的应用对应appid" completionBlock:^(NSError *error){
if (!error)
{
MSLogInfo(@"tradplus sdk init success!");
}
}];
//v5.0.0-
[MsSDKUtils msSDKInit:^(NSError *error){
if (!error)
{
//初始化成功
NSLog(@"tradplus sdk init success!");
}
}];

广告加载成功,广告展示,广告关闭回调时获取三方渠道信息#

//相关回调时可以访问到的具体渠道信息。
@property (nonatomic, strong) NSMutableDictionary *dicChannelInfo;

主要key说明:

  • channel_id 三方渠道id 定义如下:
#import <TradPlusAds/MsCommon.h>
typedef enum
{
NETWORK_FACEBOOK = 1,
NETWORK_ADMOB,
NETWORK_MOPUB,
NETWORK_ADCOLONY,
NETWORK_UNITYADS,
NETWORK_TAPJOY,
NETWORK_VUNGLE,
NETWORK_APPLOVIN = 9,
NETWORK_IRONSOURCE,
// NETWORK_INMOBI,
NETWORK_SMAATO = 12,
NETWORK_ADEXPRESS,
NETWORK_MOBFOX,
NETWORK_CHARTBOOST,
NETWORK_GDTMOB,
NETWORK_BYTEDANCE,
NETWORK_MINTEGRAL,
NETWORK_PANGLE,
NETWORK_KUAISHOU,
NETWORK_SIGMOB,
NETWORK_INMOBI = 23,
NETWORK_YOUDAO = 25, //有道
NETWORK_HELIUM = 30
} MSThirdNetwork;
  • iso
    国家两位简码
  • appkey
    mintegral除了appid之外还提供了appkey
  • appid
    三方广告源 标识应用唯一标识的appid/appkey/sdkkey等
  • placementid
    对应三方placement id,zone id等
  • unitid
    mintegral单个广告位placement id下面还分unit id
  • load_time
    加载时长,单位毫秒
  • is_play_complete
    是否播放完成
  • ecpm 每一千次展示可以获得的广告收入