SDK预置策略

为了减少首次请求广告位时Taku SDK获取Taku广告位策略的耗时，以及规避Taku SDK获取Taku广告位策略失败的情况出现，Taku支持应用在本地预置Taku广告位策略。

Taku SDK 支持开屏、激励视频、插屏、原生、横幅全部广告类型使用SDK预置策略。

 

1. 介绍

Taku支持开发者导出广告位维度的SDK预置策略，在应用发版前预置到您的App中。当首次请求广告位时，Taku会使用SDK预置策略请求广告，以提高首次请求广告位时广告请求效率。

注意事项：

① 应用在本地预置SDK策略需要更新Taku SDK v6.1.78及以上版本

② SDK预置策略仅在首次请求广告位时使用。Taku SDK获取线上广告位策略成功后，后续将会使用Taku线上配置的广告位策略

 

2. 创建SDK预置策略的流量分组

使用SDK预置策略需要创建特定的流量分组，具体流程如下：

(1) 在聚合管理页面添加流量分组，流量分组规则选择SDK内置策略

(2) 流量分组里SDK预置策略规则不能跟其他规则同时使用

(3) SDK预置策略的流量分组下的广告位策略只提供导出并预置到您的App。

(4) 如果您修改了SDK预置策略的策略，您需要重新导出并预置到您的应用。

(5) 您可以在Taku广告位下创建多个SDK预置策略。为了更好得分析不同的Taku SDK版本使用SDK预置策略的效果，建议您为不同的Taku SDK版本创建不同的SDK预置策略。

 

3. 配置SDK预置策略

创建完成SDK预置策略的流量分组后，您可以跟其他流量分组一样，针对此SDK预置策略进行配置，如添加/编辑/复制广告源，修改高级设置等

 

4. 导出SDK预置策略

(1) 当您修改SDK预置策略的广告位策略后，Taku服务端需要15钟完成新策略同步。建议您完成SDK预置策略配置后，等待15分钟之后再导出SDK预置策略。

 

(2) 在导出SDK预置策略时，您需要选择您在应用中使用的Taku SDK版本。请确保您导出Taku SDK版本跟您应用中集成的Taku SDK版本是一致的。（sdk版本 >= 预制策略导出版本）

 

(3) 如果您在导出SDK预置策略时出现以下提示，说明Taku服务端尚未完成SDK预置策略的广告位策略同步时，建议您等待15分钟之后再导出SDK预置策略。

(4) 在导出SDK预置策略成功后Taku会生成一个以广告位ID命名的json文件

 

5. 导入SDK预置策略到应用

① 将导出的json文件放到您应用项目中，同时参考SDK接入文档在应用项目中完成SDK预置策略的代码集成

② 参考以下Taku SDK集成说明

 

5.1 Android接入说明

(1) 在项目的 src/main/assets 目录下新建一个目录 localStrategy,目录命名规则可以自定义，用于以下的步骤。

(2) 将从后台导出的json文件放到刚新建的目录下 src/main/assets/localStrategy 。

(3) 只需要在发起加载广告之前调用 ATSDK#setLocalStrategyAssetPath(Context context, String path) API进行设置即可，参数Path是第一步新建的目录名称localStrategy。示例代码如下：

//在Application#onCreate()调用
public class DemoApplication extends Application {
      @Override
    public void onCreate() {
        super.onCreate();
             //...
          ATSDK.setLocalStrategyAssetPath(this, "localStrategy");
          //...
    }
}

 

5.2 iOS接入说明

(1) 将从后台导出的json文件引入到工程项目中

(2) 在发起加载广告之前调用 setPresetPlacementConfigPathBundle: API进行设置即可，参数Bundle是第一步json文件引入工程所在的Bundle。示例代码如下：

// 根据json文件引入到工程对应Bundle来传入，示例中使用为mainBundle
[[ATAPI sharedInstance] setPresetPlacementConfigPathBundle:[NSBundle mainBundle]];

 

6. 查看SDK预置策略的数据

(1) 您可以在聚合管理页面查看SDK预置策略的流量分组，您也可以在综合报表筛选A/B测试、流量分组来查看SDK预置策略的流量分组数据。

(2) 如果广告位在开启动AB实验前已创建了SDK预置策略的流量分组，在开启AB实验后，SDK预置策略的流量分组也会被复制到AB实验中ID最小的实验分组

(3) 开启动AB实验后，原来的SDK预置策略的流量分组可以在未分组里查看数据

 

7. 常见问题

(1) 完成SDK预置策略后多久可以导出？

答：当您修改SDK预置策略的广告位策略后，Taku服务端需要15钟完成新策略同步。建议您完成SDK预置策略配置后，等待15分钟之后再导出SDK预置策略。

 

(2) 每次应用发版更新时是否均需要重新导入Taku的SDK预置策略文件 ？

答：建议您在以下情况下重新导入Taku的SDK预置策略文件：

(1) 本次应用发版有更新Taku SDK，建议您针对本次更新的Taku SDK版本重新导出SDK预置策略并预置到应用中(请确保您导出Taku SDK版本跟您应用中集成的Taku SDK版本是一致的)

(2) 当您修改了SDK预置策略的广告位策略时，建议您在下次应用发版时重新导入Taku的SDK预置策略

 

(3) 新版本应用中更新了Taku SDK但没有更新旧的SDK预置策略文件会有什么影响？

答：新版本的Taku SDK会兼容旧版本的SDK预置策略文件。如果新版本有增加了新的广告位策略，但您的应用没有重新导入相应版本的SDK预置策略文件，这样新版本Taku SDK的新功能可能无法生效。为了保证更好的变现效果，如果您更新了Taku SDK版本建议您针对本次更新的Taku SDK版本重新导出SDK预置策略并预置到应用中。

注：旧版本的Taku SDK无法使用新版本的SDK预置策略文件。

 

(4) 首次安装开屏加载效率如何提升？

v6.1.78及以上版本，可以参考以下优化建议：

① 针对开屏广告位的SDK预置策略添加一个兜底广告源。请参考 兜底广告 配置广告源(不需要导出兜底广告源的配置)

② 在应用集成时针对开屏广告位使用SDK预置策略