Skip to content

预缓存高级集成

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

GroMore 预缓存功能默认关闭,若需使用 GroMore 在 show/close 后的预缓存,在平台上瀑布流属性设置中开启即可;如需使用 GroMore 在融合 SDK 初始化完成后的预缓存,需在平台打开“开启”按钮,同时也需配置相关 preload 接口相关参数,详见下方介绍。

请参考文档 预缓存平台设置操作指引 启用指定广告位预缓存功能

TIP

react-native-gromore v0.1.21 或以上版本开始支持预缓存 RNADManager.preload 接口

adv_preload_01.png

调用示例

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信息流