共享广告位介绍

为了优化开发者收益，Taku提供了共享广告位机制，让广告位加载、展示时，在原广告池基础上，能额外从共享缓存池中获取广告内容，从而增加广告位填充，提高广告位价格。

1. 功能介绍

• 共享广告位可在应用管理页面一键开启or手动添加，仅支持广告位接入同样广告类型的共享广告位。
• 所有相同样式的广告位接入共享池后，会共享同样式的共享广告位。
• 当开发者调用已接入共享池的广告位时，将会让原始广告位与共享广告位比价，挑选高价的进行展示。
• 共享广告位的功能有两种：

 

2. 使用说明

• 如需支持共享广告位策略，无需客户端进行额外代码开发，只需更新Taku SDK v6.2.20及以上版本，并在后台进行相关配置。目前该功能为白名单机制，如需使用，请联系Taku客户经理进行开通。

  若在客户端回调接口或S2S激励回调接口中，有对广告位进行校验，则需按照以下文档进行兼容性处理。

• 整个后台配置过程只需两步：

  1. 选择广告位接入共享池
  2. 配置共享广告位的Waterfall

具体操作步骤如下：

2.1. 选择广告位接入共享广告位

2.1.1 主广告位直接打开共享广告位开关

1. 打开应用管理页面
2. 选择希望接入共享广告位的广告位，打开开关。

根据不同场景选择新增or接入已有共享广告位

①默认选择新增共享位，填写共享广告位名称即可正常创建绑定。推荐您在命名的时候带上【共享广告位】字段，便于后续查看数据

②如果已有共享位，可选择接入已有共享广告位，默认仅显示当前广告类型的共享广告位（适用于多个主广告位接入同一个共享广告位的场景）

2.1.2 手动添加共享广告位

在应用管理-共享广告位列表，可手动添加共享广告位

选择广告类型后，接入的主广告位仅可选对应广告类型的广告位。注意：启用的共享位必须接入主广告位。

支持针对共享广告位配置指定生效的应用版本号，将按照填写的内容精确匹配，建议咨询App研发技术提供应用版本号；规则：>=指定版本号。不填写则默认所有版本号生效。安卓：填写正整数；iOS：版本号只能是数字和"."的组合；

2.1.3 共享广告位管理

添加共享广告位成功后，可在应用管理页面，查看当前主广告位接入了哪个共享广告位；

亦可在【共享广告位】页面显示当前应用的所有共享广告位及状态和绑定关系

2.2 配置共享广告位的Waterfall

添加共享广告位成功后，若共享广告位未配置任何广告源，将显示提醒：

为能完整使用共享广告位功能、发挥共享池作用，对于被接入的共享广告位，请到聚合管理页面配置对应的广告源。具体流程如下：

1. 可以在聚合管理页面，自行选择共享广告位进行waterfall设置。

2.共享广告位Waterfall设置建议：

根据对共享广告位的定位，可采用普通位+共享高价池的组合，抬高ecpm；也可以采用高价位+共享兜底池的组合，提升填充率。

1. 由于共享广告位的加载时机与普通广告位不同，为避免影响原本广告位的填充情况，建议针对共享广告位使用额外的广告源。
2. 若把共享广告位作为高价池，建议在共享广告位较密集地交叉设置高底价广告源，并预留几个中底价广告源，且设置并行条数为1（即串行请求)；而对接入共享池的普通广告位，正常设置中低底价广告源的同时，稀疏地预留几个高底价广告源。
3. 若把共享广告位作为兜底池，建议瀑布流结构与普通广告位一致，且打开缓存数量为2，且设置并行条数为2，并多打开bidding源.

2.3 共享广告位推荐配置waterfall

我们提供了共享广告位推荐配置的功能，通过算法能快速帮助您根据当前共享广告位接入的主广告位的数据，自动生成共享广告位的瀑布流配置情况。

可在聚合管理页面-推荐配置 入口，点击共享位推荐入口查看

按照配置流程选择需要生成配置的内容，需要当前应用已有绑定的广告平台+推荐您开启自动创建广告源的功能。

3. 查看共享广告位数据

如果需要查看共享广告位的数据情况，可以到综合报表下，筛选广告位维度，查看形如“Shared_广告类型_应用UUID”的广告位数据；或搜索您创建的共享广告位的关键词。

需要注意的是，原始广告位接入共享池后，将会让原始广告位与共享广告位比价，挑选高价的进行展示。当原始广告位价格偏低时，展示机会将会让给共享广告位。 因此接入了共享池的广告位自身的展示率可能会降低。如果需要查看整体展示率的影响，建议筛选应用+广告类型维度进行查看整体数据。

4. 共享广告位兼容性修改说明

若开发者在客户端回调接口或S2S激励回调接口中，有对广告位进行校验，则需参考以下文档，对共享广告位进行兼容处理。

若没有对回调信息中的广告位进行进行校验，则无需进行额外处理，也能正常使用共享广告位功能。

4.1 Android SDK回调处理

如果展示的是共享广告位，将会在回调接口中增加共享广告位字段，传递是共享广告位id；而广告位字段传递的是真实广告位id。其中涉及到的回调信息说明如下：

ATAdInfo回调信息说明

若开发者要对广告位进行校验，建议先判断getSharedPlacementId() 是否为共享广告位展示，没有的话获取getTakuPlacementId()。

ATAdInfo回调信息说明

4.2 iOS SDK回调处理

如果展示的是共享广告位，将会在回调接口中增加共享广告位字段，传递是共享广告位id；而广告位字段传递的是真实广告位id。其中涉及到的回调信息说明如下：

ATCheckLoadModel回调信息说明

若开发者要对广告位进行校验，建议先判断shared_placement_id 是否为共享广告位展示，没有的话获取adunit_id。

ATCheckLoadModel回调信息说明

4.3 激励视频服务端激励(S2S)处理

如果展示的是共享广告位，将会在回调接口中增加真实广告位字段，传递是原始广告位id；而广告位字段传递的是共享广告位id。其中涉及到的字段如下：

回调URL参数信息说明

若开发者要对广告位进行校验，建议先判断{share_placement_id}是否为共享广告位展示，没有的话获取{placement_id} 。

Taku服务端激励回调信息说明

5. 快捷创建共享广告位实验

若您想要通过AB实验测试有无开启共享广告位的数据表现，可通过【广告位AB测试】中的智能【共享广告位实验】配置实验。

主广告位接入共享广告位后，本身的展示和收益将会降低，为了查看整体的数据效果，建议您在进行AB测试的时候，需要同时勾选主广告位和对应接入的共享广告位。

也可使用自动勾选共享广告位和主广告位的功能，如下图1

勾选自动实验之后，将自动为您调整实验分组的配置，不支持再自动修改。

实验原理：实验组将开启共享广告位，对照组不开启共享广告位。

提交后效果如下，将创建两个实验。

6. 一键创建共享位+AB实验（推荐使用）

支持在没有创建共享广告位的前提下，直接使用我们的共享广告位推荐配置功能。我们将为您自动创建好共享位，同时配置好共享广告位的AB实验。

查看文档获取详细引导：共享广告位推荐配置功能说明

7. 常见问题说明

1.共享广告位会在什么时候被使用？

答：在原始广告位被调用load()、isReady()、和show()时，都会查询所关联的共享广告位进行查询比价；在共享广告位的缓存数低于阈值时，Taku SDK会自动加载共享广告位的广告源。

2.我可以通过SDK方法控制共享广告位吗？

答：不可以。

系统自动创建的共享广告位不能被开发者通过接口独立控制，只能由Taku SDK根据使用场景自动调用与使用。共享广告位若被错误调用，将会返回错误码10009（具体错误信息说明可参考《错误码说明》）。

开发者如需调整共享广告位的调用策略，可联系Taku客户经理进行处理。

3.共享广告位可以设置流量分组及ab实验吗？

答：可以。

4.我该如何设置a/b实验，对比使用共享广告位的效果？

答：可以对原始广告位 与 共享广告位 配置同样的a/b实验分组，其中共享广告位实验组配置Waterfall，而对照组不配置Waterfall。最后通过在综合报表筛选“应用”+“广告类型”+“a/b测试”维度进行数据对比。

5.展示共享广告位的原生广告时，广告的宽高异常

答：请参考如下code进行设置，

注意：localExtra中的宽高 需和Native广告请求前ATNative.setLocalExtra(localExtra)中的宽高保持一致。

● Android

Map<String, Object> localExtra = new HashMap<>();
localExtra.put(ATAdConst.KEY.AD_WIDTH, adViewWidth);
localExtra.put(ATAdConst.KEY.AD_HEIGHT, adViewHeight);

ATSDK.setSharedPlacementConfig(new ATSharedPlacementConfig.Builder().nativeLocalExtra(localExtra).build());

ATSDK.init(this, "Your App ID", "Your App Key");

#pragma mark - 共享广告位
- (void)setSharePlacementConfig {
    NSMutableDictionary *nativeLoadExtra = [NSMutableDictionary dictionary];
    [nativeLoadExtra setValue:[NSValue valueWithCGSize:CGSizeMake(300.0f, 200.0f)] forKey:kATExtraInfoNativeAdSizeKey];
    [nativeLoadExtra setValue:@"PPPPPP_native" forKey:kATAdLoadingExtraMediaExtraKey];
    //建议与普通广告位处的设置一致
    [nativeLoadExtra setValue:@YES forKey:kATNativeAdSizeToFitKey];
    
    ATSharePlacementConfig *sharePlacementConfig = [[ATSharePlacementConfig alloc] init];
    sharePlacementConfig.nativeLoadExtra = nativeLoadExtra;
    [[ATAPI sharedInstance] setSharePlacementConfig:sharePlacementConfig];
}