菜单

插屏广告

💡Tips

Smart Cache 自动管理多广告位并行加载、缓存与比价展示，无需传入聚合单元 ID。

广告关闭后 SDK 会自动补量，开发者无需手动触发二次加载。

智能缓存拥有独立的回调通道（McSmartCacheInterstitialListener），与标准插屏广告回调互不影响。

如需自行手动控制加载、缓存，请参考这里

1. 设置回调监听

在加载广告前，先注册智能缓存插屏广告的独立回调：

dart 复制代码

McSdk.setSmartCacheInterstitialListener(McSmartCacheInterstitialListener(
  onDidLoadAd: (McAd ad) {
    // 至少一个广告就绪，可以展示
  },
  onDidFailToLoadAd: (McError error) {
    // 所有广告位均加载失败
  },
  onDidDisplayAd: (McAd ad) {
    // 广告展示成功
  },
  onDidHideAd: (McAd ad) {
    // 广告关闭，SDK 自动补量
  },
  onDidClickAd: (McAd ad) {
    // 广告被点击
  },
  onDidFailToDisplayAd: (McAd ad, McError error) {
    // 广告展示失败
  },
  onDidAdLoadFinished: () {
    // 本轮加载结束（无论成功失败）
  },
  onDidPayRevenueForAd: (McAd ad) {
    // 收益回调
  },
));

2. 加载广告

调用以下方法触发智能缓存插屏广告加载，SDK 将自动管理多广告位并行请求与缓存：

dart 复制代码

McSdk.smartLoadInterstitial();

3. 判断广告是否就绪

展示前可通过以下方法判断是否有缓存广告可展示：

dart 复制代码

bool? isReady = await McSdk.smartIsInterstitialReady();
if (isReady == true) {
  // 广告就绪，可以展示
}

4. 展示广告

当广告就绪后，调用以下方法展示插屏广告：

dart 复制代码

McSdk.smartShowInterstitial();

5. 设置自定义参数

可通过以下方法设置额外参数，用于精细化控制广告行为：

dart 复制代码

// 设置额外参数，只用于 Max
McSdk.smartSetInterstitialExtraParameter("key", "value");

// 设置本地额外参数
McSdk.smartSetInterstitialLocalExtraParameter("key", value);

上一个

广告样式

下一个

开屏广告

最近修改: 2026-06-25Powered by

大纲