应用管理-聚合单元

1. 聚合单元列表

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

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

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

 

2. 添加聚合单元

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

2.1 步骤一：填写基础信息

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

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

 

2.2 步骤二：选择请求模式

(1) 比价

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) 并行请求

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

(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