预缓存高级集成
GroMore 预缓存在 show/close 融合 SDK 初始化完成后调用 preload 接口时发起广告请求,通过预缓存缩短广告等待时长,减少因超时导致的请求损失。
GroMore 预缓存功能默认关闭,若需使用 GroMore 在 show/close 后的预缓存,在平台上瀑布流属性设置中开启即可;如需使用 GroMore 在融合 SDK 初始化完成后的预缓存,需在平台打开“开启”按钮,同时也需配置相关 preload 接口相关参数,详见下方介绍。
请参考文档 预缓存平台设置操作指引 启用指定广告位预缓存功能
TIP
react-native-gromore v0.1.21 或以上版本开始支持预缓存 RNADManager.preload
接口
调用示例
WARNING
显示广告时调用参数必须与调用 Preload 时参数完全一致才能命中缓存!!!
广告位需要单独开启预缓存功能!!!
预缓存调用时机请参考并以 GroMore 文档最新文档为准!!!
使用该功能需要自行排查是否在 GroMore 后台启用了预缓存功能以及调用参数是否一致,需自行判断和调试缓存是否生效(缓存不生效等问题,最好是开发者自己具备一定的调试能力,react-native-gromore 团队目前不提供任何缓存是否命中以及生效排查的技术支持服务)。
tsx
import {
RNADFullscreenVideoDirection,
RNADManager,
RNADPreloadType,
RNADRewardedVideoDirection,
} from '@zmide/react-native-gromore';
// 预加载广告,需要在调用 RNADManager.init 成功后调用!!!预加载时传递的广告参数必须与调用显示广告时参数一致,否则无法命中缓存
async function preloadAds() {
await RNADManager.preload(
[
{
type: RNADPreloadType.RewardedVideo,
options: {
slotId: '1000000',
muted: true, // 是否禁音
direction: RNADRewardedVideoDirection.vertical, // 横屏、竖屏
userConfig: {
userId: 'xxx',
extra: `${JSON.stringify({
order_number: 'xxxx',
})}`,
}, // 用户配置
},
},
{
type: RNADPreloadType.FullscreenVideo,
options: {
slotId: '1000001',
muted: false, // 是否禁音
direction: RNADFullscreenVideoDirection.vertical, // 横屏、竖屏
},
},
{
type: RNADPreloadType.Splash,
options: {
slotId: '1000002',
},
},
{
type: RNADPreloadType.FeedView,
options: {
slotId: '1000003',
},
},
],
2, // 并行加载的广告位数,默认值为 2
2 // 时间间隔,默认值为 2s
);
}
RNADPreloadType 类型参数
类型值 | 广告类型 |
---|---|
RNADPreloadType.RewardedVideo | 激励视频 |
RNADPreloadType.FullscreenVideo | 全屏/插屏视频 |
RNADPreloadType.Splash | 开屏 |
RNADPreloadType.FeedView | 信息流 |