导入和配置

一、添加SDK到项目工程#

cocoapod集成#

进入TradPlusSDK下载平台，根据需求选择所需三方广告平台，点击生成接入代码后，就可以一键获取您要添加的pod配置信息

手动集成#

如果您使用的是手动集成，请参考手动集成

二、申请IDFA权限#

在iOS14.5+上通过弹窗来获取IDFA，使用IDFA需要征得用户的同意。详细请参考适配iOS14.5+

在info.plist里添加NSUserTrackingUsageDescription键，并附上描述您使用的自定义消息。格式可参考以下内容。

<key>NSUserTrackingUsageDescription</key>
<string>该标识符将用于向您投放个性化广告。</string>

在应用启动后，弹出IDFA权限申请

//建议在TradPlus SDK初始化前调用
if (@available(iOS 14.5, *)) {
    [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
}];

三、初始化SDK#

在AppDelegate类的didFinishLaunchingWithOptions方法调用如下代码, 必须正确传入应用在TradPlus后台的AppId，否则后台无法准确统计DAU。

    #import <TradPlusAds/TradPlus.h>

    [TradPlus initSDK:@"tradplus后台的应用对应appid" completionBlock:^(NSError *error){
        if (!error)
        {
            MSLogInfo(@"tradplus sdk init success!");
        }
    }];

四、开启http请求权限#

由于部分三方源的广告及其数据统计，仍然会使用 http请求，为了您APP的最大化收益，建议您开启APP的http请求权限。

您需要在APP项目中的 info.plist 中添加如下设置：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

五、启用SKAdNetwork跟踪转化#

支持了Apple官方的SKAdNetwork框架的三方渠道，会在获取不到IDFA的时候，正常获取转化。为了实现这个功能，需要在info.plist添加对应的SKAdNetworkItems。详细请参考适配iOS14.5+

<key>SKAdNetworkItems</key>
 <array>
        <dict>
            <key>SKAdNetworkIdentifier</key>
            <string>xxx.skadnetwork</string>
        </dict>
        .......
</array>

六、注意事项#

Facebook要求#

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

Admob要求#

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

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

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

其他#

在测试应用时，Admob和Meta请确保使用的是测试广告，而不是正式广告，否则会有封号风险。
设置SDK的日志级别

//开启SDK全部日志打印
[TradPlus setLogLevel:MSLogLevelAll];