中文
登录
后可查看全部文档
GroMore/平台使用指南/瀑布流管理/瀑布流属性
瀑布流属性
最近更新 2026-03-13 14:05:50

什么是瀑布流属性

在广告变现场景中,基础的瀑布流配置仅能满足广告请求与比价的核心需求,但开发者在实际运营中还会面临冷启动加载失败、广告展示时机紧张、请求耗时过长、用户体验与收益平衡难等问题。

为此,GroMore 推出「瀑布流属性」配置项合集,涵盖预缓存+缓存本地配置、并行请求与超时控制、信息流一次请求多条广告、用户展示频控、样式轮播等能力,用于精细化调控瀑布流运行策略优化广告加载效率展示效果与变现收益

瀑布流属性概览

瀑布流属性是GroMore为解决开发者实际运营痛点、优化瀑布流变现效能与用户体验,推出的一系列补充配置功能合集,各功能相互独立、可按需开启,核心包括:

  • 预缓存+缓存本地配置:解决应用冷启动配置拉取失败、素材加载耗时过长等问题,提升首次展示率
  • 并行请求与超时控制:优化广告请求耗时,减少因超时导致的请求损失,提升瀑布流填充效率
  • 信息流一次请求多条广告:提升信息流场景广告请求效率,增加广告展示机会,挖掘场景变现潜力
  • 用户展示频控:控制单一用户广告展示频次与间隔,防止无效展示、保护用户体验,避免收益损耗
  • 样式轮播:优化Banner、插屏广告展示效果,增加广告展示次数,提升对应场景的变现收益

入口:【瀑布流管理】页->「瀑布流属性设置」

一、预缓存+缓存本地配置

1. 预缓存

1.1 功能介绍

GroMore预缓存在show/close/融合SDK初始化完成后,调用preload接口时发起请求,通过预缓存缩短等待时长,减少因超时导致的请求损失。(GroMore预缓存功能默认关闭)

  • 若需使用GroMore在show/close后的预缓存,在平台上瀑布流属性设置中开启即可
  • 如需使用GroMore在融合SDK初始化完成后的预缓存,还需配置相关preload接口相关参数,详见下方介绍

支持的样式类型

版本要求

支持的预缓存时机

show后

(打开“开启”按钮即可)

close后

(打开“开启”按钮即可)

msdk初始化完成后调用preload接口

(打开“开启”按钮+配置preload接口参数)

激励、全屏、插全屏

(双端)融合SDK 5150及以上

支持

支持

支持

信息流

(双端)融合SDK 5150及以上

第一条素材show后发起

不支持,因信息流滑动而无close回调

支持

开屏

不支持

支持

支持,建议使用场景为有频繁切换前后台的场景

banner

因大部分ADN暂未支持banner的预缓存,GroMore暂不支持

draw信息流

暂未支持

  • 提示:
    • 调用preload接口的最早时机:msdk初始化完成后,最早调用时机为各 ADN 初始化完成后,该时机与开屏加载的时机可能非常靠近,不建议开屏用preload接口提前加载
    • 可能的逻辑冲突已自研预缓存机制的应用,不建议开启 GroMore 预缓存,避免逻辑冲突

1.2 适用场景

  • 开屏:适用于应用频繁切换前后台的场景,可开启预缓存保证广告可用;单日仅展示一次的开屏不建议使用,避免广告素材缓存后无展示机会
  • 其他样式类型:适用于信息流滑动等广告频繁展示的场景,以及冷启动后需快速展示广告的场景(如游戏开局激励视频)

1.3 操作指引

平台设置

Preload接口参数配置

如使用show/close后预缓存,在平台打开开关即可,无需代码设置;preload 则需接口配置。

开发者需在List<PreloadInfo>中配置流量位id、并行数、间隔时间。

信息

是否必填

备注

流量位id

必填

上限20个,超过上限会去重保留前20个

并行加载的流量位数

选填,空值时采用默认值

默认值为2,合法值为[1,20]

时间间隔

选填,空值时采用默认值

默认值为2s,合法值为[1,10]

Android示例:

复制

iOS示例:

复制

2. 缓存本地配置

2.1 功能介绍

GroMore 支持导出应用下跨流量位的瀑布流配置,在发版前导入客户端,保证应用首次启动即可正常发起广告请求,降低配置拉取失败率,提升冷启动广告展示率(开屏场景下,该方案收益显著优于自定义兜底方案)

  • 优先走本地配置(如有),请注意由于本地配置需单独导出,可能非线上最新版本
  • 建议在应用发版前再导入本地配置,如平台配置更新后请及时重新导入,避免收益损失
  • 含 AB 测试 / 流量分组的流量位,默认仅导出 A 组(对照组)/ 默认分组的瀑布流配置,建议待应用发版后再开启 AB 测试 / 流量分组功能

2.2 操作指引

  • 入口:【应用管理】-> 「导出配置信息」,填写对应信息即可完成配置信息导出
  • 将导出的配置文件拖入工程中,并在SDK初始化时传入文件路径,示例如下:

Android

复制

iOS

复制

二、并行请求与超时设置

1. 并行请求模式

功能名称

功能介绍

备注

请求加速器(推荐)

瀑布流每一次请求,会动态同时请求n个代码位,n=媒体自行设置的并行请求数。例如并行3个代码位,有一个代码位返回填充失败/在层超时上限前仍未返回广告,则立即请求下一个代码位,保证同时并行3个代码位

可自行设置「并行请求数」,默认为2,上限为5

固定数量代码位并行请求

瀑布流每一次请求,会同时请求n个代码位,n=媒体自行设置的并行请求数。例如并行3个代码位,这3个代码位必须在单层超时内都有响应(成功/失败)才会再向下请求3个代码位

相同价格代码位并行请求

瀑布流每一次请求,会同时请求价格相同的代码位


2. 超时设置

超时设置将影响填充率,建议开发者根据历史情况设置,若无历史数据参考可先采用GroMore平台提供的默认值,然后再根据填充耗时、请求超时报错码等信息调整设置。

功能名称

概念说明

设置范围(秒)

默认值(秒)

单次并行请求超时时长

一次并行请求没有返回广告填充结果(成功或失败)时最多等待的时长,超过该设定上限时长时,会自动请求下一轮广告;

0.3~10.0

2

瀑布流总请求超时时长

一次瀑布流总请求还没有返回任何成功广告填充时最多等待的时长,超过上限时长时,本次瀑布流总请求视为结束,无有效返回。

开屏:1.0~20.0
banner/插屏/信息流:2.0~30.0
激励视频/全屏视频:20.0~180.0

开屏:5.0
banner/插屏/信息流:10.0
激励视频/全屏视频:60.0

3. 操作指引

  • 入口:在【瀑布流属性设置】页 -> 查看「并行请求与超时设置」->「保存」
  • 配置成功后,【瀑布流管理】页会显示当前瀑布流采用的并行请求模式,以及当前并行请求数(相同价格代码位并行请求没有并行请求数)

三、信息流一次请求多条广告

1. 功能介绍

GroMore支持在信息流场景上一次请求多条广告,以提升信息流广告的请求效率。开发者可以在后台开启该功能并设置加载广告数量N,GroMore将对所在瀑布流下的代码位均请求N条广告,最终也将返回N条最高价的广告

2. 操作指引

2.1 平台操作

在【瀑布流属性设置】页-> 开启「单次请求返回多条广告」设置一次请求的返回条数,可设置1-3条,默认为1条

2.2 客户端配置

开发者可以在构建原生信息流广告时通过设置请求广告数量来发起请求

Android:加载广告时通过设置.setAdCount字段进行配置,实现代码如下

复制

iOS:加载广告时通过设置loadAdDataWithCount:方法进行设置,实现代码如下

复制

注意事项

  • 版本要求:安卓和iOS双端均支持,若开启ab测试效果建议可搭配流量分组功能
  • 平台功能未开启时,以客户端配置返回的条数为准
  • 数据差异:
    • 预估数据:开启该功能后,一次请求带来的多条填充和展示,GroMore的预估请求量、填充量、展示量和点击量均记一次,与现有平台口径保持一致
    • API数据:各家ADN对一次请求多条广告的统计方法不同,可能记 1 次或多次,实际结算以API数据为准

四、用户展示控制设置

1. 功能介绍

用户展示控制,是指开发者可以控制某瀑布流/代码位对单一用户的展示时间间隔/单位时间内的展示次数。

2. 适用场景

  • 客户反作弊控制:防止羊毛党频繁刷广告赚金币,控制瀑布流/代码位展示上限
  • 保护用户体验:防止插屏/开屏等广告展示过于密集,控制瀑布流/代码位展示间隔
  • 保护广告收益:高频低价值或无效展示一定程度会影响cpm或填充率,从而对收益造成影响

3. 注意事项

① 支持维度:针对整个瀑布流维度、代码位维度生效

*注意:如需进行代码位维度的展示频次设置,请避免给所有代码位均设置展示控制,可能会造成填充耗时增加

②支持广告类型:激励、全屏、插屏、开屏、banner和插全屏【暂不支持竞价功能(Bidding)及综合比价】

4. 操作指引

瀑布流维度

入口:【瀑布流管理】->【瀑布流属性设置】->「展示控制设置」

代码位维度(白名单功能)

入口:【瀑布流管理】页 ->「添加代码位」,所有添加代码位方式均支持展示控制设置;以添加单个代码位为例

功能维度

定义

使用填写规范

展示上限(天)

单个用户一天内可观看的广告次数上限,单位“次”

支持填入1-1000的整数,默认为空即“不限”

展示上限(小时)

单个用户一小时内可观看的广告次数上限,单位“次”

支持填入1-1000的整数,默认为空即“不限”

展示间隔(秒)

单个用户上次广告展示到下次广告请求之间的时间间隔,单位“秒”

支持填入1-3600的整数,默认为空即“不限”

推荐使用方法

① 结合GroMore的A/B测试功能使用

A/B测试的A组和B组使用不同的展示控制设置方式。对比数据指标变化,重点关注ipu、cpm、填充率及arpu等数据,其中arpu是最终配置决策的关键指标

② 结合GroMore的流量分组功能使用

不同流量分组使用不同的展示控制设置方式,如新/老用户、不同渠道包等

举例:新用户处于对app认知及使用习惯建立期,高频广告可能影响用户体验从而流失,则可针对新用户设置广告展示限制。重点关注用户留存、arpu、cpm、ltv及roi等数据指标,其中roi是最终配置决策的关键指标

五、样式轮播

样式轮播支持对 Banner、插屏广告进行自动轮播展示,提升广告展示次数与变现收益

  • Banner 轮播:在 Banner 广告位下,按设置的时长自动切换下一条广告,提升广告展示效率。
  • 插屏轮播:在插屏广告展示过程中,按设置的单次展示时长自动轮播下一条广告,可配置轮播次数;仅发起一次广告请求,实际可轮播条数取决于本次请求返回的有效广告数量

1. Banner轮播

1.1 功能介绍

媒体在banner广告位中创建瀑布流时,可直接在GroMore平台进行轮播设置,并设置轮播时长

1.2 注意事项

  • 版本升级后:

①新建广告位时,GroMore轮播功能默认关闭;

②原有已设置轮播的banner广告位默认开启,且轮播时长更新至30s,可在GroMore中自行修改

  • 在GroMore开启轮播前,请关闭包括自定义ADN在内的三方ADN轮播功能,部分ADN (Admob、Unity)需前往对应ADN平台关闭轮播或自动刷新功能,否则会影响广告展示和收益

1.3 操作指引

  • 【瀑布流管理】页->【瀑布流属性设置】-> 「Banner轮播设置」,轮播时长范围为(10~180s)

2. 插屏轮播

2.1 功能说明

在插屏展示场景下,当前插屏广告展示 X 秒后自动轮播下一条插屏广告,可自动轮播N次(X、N开发者可自行配置),插屏轮播功能在融合SDK 6000及以上版本(双端)生效

*注意:轮播可展示的广告数量取决于插屏场景发出流量请求后,多填充回来的广告数量,并非每一次轮播都实时发起请求

插屏轮播demo

2.2 操作指引

入口:【瀑布流管理】页->【瀑布流属性设置】-> 「插屏轮播设置」,填写广告展示数量(2~10条)及单次展示时长(2s~15s)

提示:支持通过管理api批量调整瀑布流配置中的轮播参数,详见管理api-瀑布流管理-修改瀑布流属性【智能管家已做参数适配】开启智能管家的瀑布流,开发者只需要把控制组轮播打开,实验组会自动同步轮播参数

常见问题

1. 并行请求与超时设置

Q1:并行请求多个代码位并均返回广告,那最终会展示哪个广告?

A:按瀑布流比价规则,展示价格最高的广告。

Q2:如果调整了代码位顺序或者价格,当前并行请求模式会如何适配?

A:如果调整了代码位顺序,「请求加速器」、「固定数量并行请求」将按照更新后的顺序并行请求;如果修改了代码位价格,「相同价格代码位并行请求」会按照新的价格进行并行请求。

Q3:如何对比不同并行请求模式的效果?

A:在该广告位下点击「创建A/B测试」,选择「A/B测试(瀑布流)」,A组保持原有配置不变,B组使用其他并行请求模式,注意“并行请求数”、“单次并行请求超时时长”和“瀑布流总请求超时时长”需要与A组保持一致。实验期间,重点关注实验组流量填充耗时、流量填充率。

Q4:GroMore请求广告个数对收益有何影响?

A:GroMore 内部采用串行 + 并行结合的请求逻辑,可自定义并行请求层数。

Q5:GroMore中串并行策略具体指什么?

A:GroMore瀑布流属性配置包含【自定义并行及请求配置】,自定义并行请求,即媒体可自定义设置瀑布流中串并行请求方式和层数,当前支持【固定层数并行请求】和【固定数量并行请求】两种方式。详细可见>>瀑布流调优建议

2. 预缓存+缓存本地配置

Q1:如何做预缓存?

A:预缓存功能不需要申请,开发者可自行设置:在使用广告之前,先请求下来广告,到需要展示的场景调用广告展示的方法即可。

【需要注意】

(1)每次请求广告都需要新创建一个AdSlot参数 新创建一个广告对象

(2)展示完广告之后需要把广告对象置空处理

(3)不建议在广告show回调中做请求广告的逻辑处理

建议使用GroMore预缓存功能。详见帮助中心文档

3. 样式轮播

Q1:广告展示数量、单次展示时长设置多少合适?

A:①间隔时长,建议在2~10s,间隔太短可能影响用户体验,间隔太长损失轮播展示机会;②展示数量,建议2~5

开启轮播将增加广告展示频次,可能会影响用户体验和ecpm,建议使用GroMore的AB工具测试不同配置下的用户arpu,寻找最合适的轮播频次。

Q2:插屏轮播过程中用户点击广告/点击关闭按钮会怎样?

A:用户点击广告/点击关闭按钮,插屏轮播中断,将不会再展示后续轮播广告。

Q3:瀑布流应该如何配置,只配置bidding代码位可以轮播吗?

A:瀑布流需要包含bidding固定设价代码位。如果只配置bidding代码位,bidding比价后只返回一条广告,不满足轮播数量,因此无法轮播。

Q4:轮播和展示频控是否冲突?

A:建议不要同时开启插屏轮播和展示频控,配置展示频控后将限制用户可观看的广告数量,可能导致轮播实际不生效或者轮播次数低于实际配置值。

Q5:哪些adn不支持插屏轮播?

A:百度暂时不支持轮播。即:如果当前展示广告为百度代码位,轮播中断,将不会再展示后续轮播广告

Q6:banner广告是否可以支持轮播功能?

A:支持轮播,但是设置轮播后对应banner的轮播都是由各自的adn实现,后续广告轮播展示时不会有内部的请求返回回调,可能会导致banner使用轮播后数据存在gap的问题。具体数据差异参见帮助中心文档


本篇目录
联系我们