1. 聚合单元列表

(1) 在【应用管理】-【聚合单元】页面，你可以查看目前应用聚合单元基础数据情况，便于及时发现聚合单元数据变化趋势。主要指标包括预估收益、预估eCPM、展示数。

(2) 在聚合单元列表，你可以根据实际情况，调节聚合单元状态开关。
注意：关闭聚合单元后，会影响线上收益情况，请根据实际需要进行调整。

(3) 编辑聚合单元，点击聚合单元名称，可跳转到编辑聚合单元页面，你可以根据实际情况调节聚合单元内瀑布流配置。

2. 添加聚合单元

在【应用管理】-【聚合单元】页面，点击【+添加聚合单元】，进入聚合单元添加流程

2.1 步骤一：填写基础信息

(1) 基础聚合单元信息：聚合单元名称、广告类型

(2) Hyperbid Tools支持的广告类型：开屏、激励视频、横幅、原生、插屏

2.2 步骤二：选择请求模式

(1) 比价

比价模式下，Hyperbid Tools将同时对全部广告单元发起请求，调用show()方法后进行比价，最高价格的广告单元胜出并展示。

注意：对于设置了价格系数的广告单元，参与比价价格=广告单元返回的eCPM*价格系数

如果需要针对不同广告单元进行展示倾斜，可联系AM开通价格系数权限

(2) 瀑布流

瀑布流模式下，Hyperbid Tools将根据设置的并行请求数对广告单元进行分组，组内广告单元将同时发起请求。当广告单元填充数>聚合单元有效缓存数时，将不再发起广告单元请求。调用show()方法后对组内填充的广告单元进行比价，最高价格的广告单元胜出并展示。

注意：可在广告单元配置预览处，对广告单元优先级进行拖拽调整。

使用建议：如果希望优先展示某些聚合平台的广告，可采用瀑布流模式，并将优先展示的聚合平台的广告单元调整到最高优先级。

2.3 步骤三：录入广告单元

(1) 根据实际情况需要，选择你需要使用的聚合平台，录入对应的聚合平台广告位信息；

(2) 广告单元中，对应各个聚合平台关系如下，根据对应聚合平台命名录入三方ID信息；

(3) 注意：同个聚合平台同个广告位ID不能配置在多个Hyperbid Tools的广告单元内，否则可能导致同一次load获取不到广告的情况；

Hyperbid Tools中，”广告单元“对应各个聚合平台的名称：

聚合平台	参数名称
TopOn	广告位ID
MAX	AD Unit ID
Admob	AD Unit ID

其中，录入topon广告单元时，可在下拉框选择对应的广告位

(3) 权重系数，默认值为1，用于调节广告单元展示优先级。支持输入范围为（0-5]，保留小数点后2位。

如果你需要优先展示某个聚合平台下的广告单元，你可以输入>1的权重系数，实际比价时，参与比价价格=广告单元返回eCPM*权重系数。
如果你需要降低某个聚合平台下的广告单元的展示排序，你可以输入<1的权重系数进行调节。

(4) 针对自定义聚合平台，Hyperbid Tools默认定义了三方广告位ID为广告位ID。如果需要传入其他广告单元维度参数（如广告尺寸），可以在其他自定义参数中，以json形式进行传入。

(5) 添加广告单元时，将自动生成广告单元名称。

(6) 点击聚合平台状态按钮，可一键控制广告单元状态

2.4 步骤四：确认瀑布流配置情况

(1)完成广告单元录入后，可以在瀑布流预览中查看已配置的广告单元情况，确认是否满足实际需求

(2)瀑布流请求模式下，如果需要调整广告单元请求优先级，可以通过拖拽最左侧的图标进行调节优先级

3. 其他策略功能

3.1 流量分组

Hyperbid Tools提供了丰富的流量分组规则，以便开发者根据多种实际变现场景进行细分瀑布流策略配置。

(1) 添加/编辑聚合单元页面内，点击【添加流量分组】，选择对应的流量分组规则，生成新的流量分组。在流量分组下录入广告单元，完成瀑布流配置。

(2) 支持的流量分组规则：地区，城市，日期，星期，小时，网络类型，应用版本名，应用版本号，SDK版本，系统版本，设备ID，设备类型，设备品牌，设备内存，安装时间，渠道，子渠道，IDFA状态，安装来源，用户编号，自定义规则

(3) 流量分组优先级：针对同时命中多个流量分组规则的情况，你可以调节流量分组优先级，决定优先下发哪个瀑布流策略配置。

规则	条件	规则数量	描述	示例
渠道	包括、不包括	1	支持填入多个渠道号，用英文逗号隔开，渠道号需先通过SDK的自定义规则传入	channel_1
地区	包括、不包括	1	可多选地区	中国内地、日本、韩国
城市	包括、不包括	1	可多选城市。选择地区后再添加规则才可以选择城市	广州、北京、上海
日期	包括	1	可选择时间段和时区	2023/01/01-2023/01/02
小时	包括	多个	选择日期时可选择00:00 至 23:59	10:00 至 23:59
时区	等于	1	选择日期时可选择，可选择各个时区	UTC+8 北京
网络类型	包括	1	可选择2G\3G\4G\仅WiFi网络。可多选	4G
应用版本名	包括、不包括	多个	App Version Name，可填多个应用版本，用英文逗号分隔（可在TopOn综合报表勾选应用版本维度查询）	2.2.1,2.2.2
应用版本号	包括、不包括、≥、≤	1个或多个	安卓：App version_code，需要填写整数，建议咨询App研发技术提供应用版本号。 iOS：应用版本号与应用版本名一致。（可在TopOn综合报表勾选应用版本维度查询）	安卓：112345；iOS：1.1.1
SDK版本	包括、不包括、>、<	1	TopOn SDK版本，包括和不包括时，可填多个SDK版本号，用英文逗号分隔。>和<时，只能填写一个	5.0.0
系统版本	包括、不包括、>、<	1	手机系统版本(Android对应version name)，包括和不包括时，可填多个系统版本号，用英文逗号分隔。>和<时，只能填写一个	iOS：13.3.1；Android：13
设备ID	包括	1	可填多个设备ID ，用英文逗号分隔，设备ID可以是iOS(IDFA、IDFV)，安卓（GAID、Android ID、OAID、IMEI，IMEI在Android10以下支持）	28968E75-E7BE-4AA2-BFA0-C455DD74C111
设备类型	包括、不包括	1	可选择iPhone、iPad。可多选	iPad
设备品牌	包括、不包括	1	可选择多个品牌	Xiaomi
CPU型号	包括、不包括	1	可选择不同的CUP型号，仅针对安卓版本适用	x86
安装时间	>、<	多个	以首次初始化TopOn SDK的时间来计算安装时间，多个安装时间规则是且的关系，需同时满足流量分组才生效	< 1天或< 24小时
子渠道	包括、不包括	1	支持填入多个子渠道号，用英文逗号隔开，子渠道号需先通过SDK的自定义规则传入	sub_channel_1
冷启动请求	只能选是	/	SDK将自动判断是否应用冷启动，冷启动时将使用此流量分组配置。建议针对冷启动配置较少的广告源，减少请求耗时提升展示率。	是
用户编号	包括、不包括、≥、≤、区间	多个	上传用户编号后匹配词规则	11111
安装来源	包括、不包括	多个	可识别用户安装来源，包括各个应用商店，比如Google Play 注意：该规则只能对安卓系统生效	com.google.com
自定义规则	等于用=符号，不等于用!=符号，且用&符号	1	通过Key-Value条件进行设置，Key和Value的条件可以是等于=或不等于!=，一个Key可以对应多个Value，用英文逗号分隔。多个条件之间使用&，即多个条件需要同时满足	例如将18岁的男性用户,且通过头条或腾讯推广带来的用户，分成一组，需填写的自定义规则是age=18&sex=male&pnetwork=bytedance,tencent

(4) 新增流量分组时，支持复制默认分组配置到新建的流量分组，复制的配置包括：开启状态的广告单元、请求模式、高级设置

(5) 点击【复制广告单元】，可以从同应用-同广告类型不同分组中复制广告单元到当前分组

注意：可复制分组为单选，且必须为已提交创建的分组，当前新增且未提交完成的分组无法复制

3.2 高级设置

(1) 并行请求

聚合单元加载时，广告单元的并行加载数量，默认为全部。

请求模式为比价时，并行请求数固定为全部。

请求模式为瀑布流时，并行请求数默认为1，可根据实际需要进行调整。

(2) 聚合单元有效缓存数

SDK在回调聚合单元的Load Success后，判断当前聚合单元是否达到缓存数量要求。如果没达到，SDK将继续执行WaterFall流程，直到全部广告单元执行完成或达到缓存数量要求。默认值为1。

聚合单元有效缓存数仅在瀑布流请求模式生效。

(3) 广告单元超时时间

一个广告单元加载超过多长时间后还没返回加载结果，则加载下一个广告单元。

广告单元超时时间仅在瀑布流请求模式生效。

注意：这里是超过时长后加载下一个广告单元，超时后广告单元填充仍会保留

(4) 自动刷新

设置广告定时自动刷新的时间间隔，建议设置间隔10秒至150秒，输入0则不开启自动刷新功能。默认值为15秒，仅针对横幅版位开放。

注意：建议关闭三方广告平台的自动轮播功能，统一由Hyperbid Tools进行开关控制。

(5) 聚合单元填充回调模式

Hyperbid SDK v3.2.0及以上支持两种聚合单元填充成功回调模式：展示优先、价格优先

● 价格优先：可以更快拿到聚合单元填充回调。当用户频繁展示广告或对App对广告加载时长有限制时，建议选择此模式。

● 展示优先：接受长时间等待更高价的广告填充回调。用户可以等待广告展示时，建议选择此模式。

您可通过AB测试结合设置和自身接口调用时机情况进行实验，选择合适的回调模式。

填充回调模式的选择建议：

广告触发是否由用户行为主动触发	是否依赖load回调展示广告	建议Hyperbid load回调模式选择
是	是	展示优先
是	否	展示优先
否，可处理预加载逻辑	是	1）未存在预加载逻辑且依赖load回调，建议展示优先； 2）存在预加载逻辑且依赖load回调，建议价格优先或者通过ab实验抉择，同时开发者可根据产品类型和诉求设置等待超时时间
否，可处理预加载逻辑	否	建议价格优先，或通过Hyperbid 后台进行ab实验

(6) 价格优先回调超时时间

Hyperbid Tools提供不同广告样式超时时间默认值，建议开发者通过A/B Test和实际数据情况针对不同聚合单元配置超时时间。最小值为1秒，当前默认值如下：

原生	3s
横幅	3s
开屏	4.5s
插屏	45s
激励视频	45s

可以结合广告单元填充耗时分位数进行设置，举例：查看当前聚合单元中填充耗时较长的广告单元的填充耗时分位数，结合75/90填充耗时分位数进行设置。

Hyperbid Tools后台指南