菜单

激励视频广告

💡Tips

调用广告 API 前，请确保 McSdk.initialize() 已完成初始化，否则调用将被忽略

建议在应用启动时尽早设置 Listener 并加载广告，以确保在需要展示时广告已准备就绪

onAdReceivedRewardCallback 是发放奖励的唯一可靠时机，请务必在该回调中处理奖励逻辑

加载失败时 SDK 内置指数退避重试逻辑，避免频繁请求导致填充率下降

1. 加载广告

dart 复制代码

const String _adUnitId = "your mediation unit id";
int _retryAttempt = 0;

void initRewardedAd() {
  McSdk.setRewardedAdListener(McRewardedAdListener(
    onAdLoadedCallback: (McAd ad) {
      // 广告加载成功，重置重试计数
      _retryAttempt = 0;
    },
    onAdLoadFailedCallback: (String adUnitId, McError error) {
      // 广告加载失败，使用指数退避策略重试
      _retryAttempt++;
      if (_retryAttempt >= 3) {
        return;
      }
      final delaySeconds = pow(2, min(3, _retryAttempt)).toInt();
      Future.delayed(Duration(seconds: delaySeconds), () {
        McSdk.loadRewardedAd(_adUnitId);
      });
    },
    onAdDisplayedCallback: (McAd ad) {
      // 广告展示成功，预加载下一条广告
      McSdk.loadRewardedAd(_adUnitId);
    },
    onAdDisplayFailedCallback: (McAd ad, McError error) {
      // 广告展示失败，重新加载
      McSdk.loadRewardedAd(_adUnitId);
    },
    onAdClickedCallback: (McAd ad) {
      // 用户点击了广告
    },
    onAdHiddenCallback: (McAd ad) {
      // 广告关闭，预加载下一条广告
      McSdk.loadRewardedAd(_adUnitId);
    },
    onAdRevenuePaidCallback: (McAd ad) {
      // 广告收益回调
    },
    onAdLoadFinishedCallback: (String adUnitId) {
      // 当前加载轮次结束（无论成功或失败均会触发）
    },
    onAdReceivedRewardCallback: (McAd ad, McReward reward) {
      // ⚠️ 用户完成激励，在此发放奖励
      // reward.amount — 奖励数量（int）
      // reward.label — 奖励类型（String）
      print("奖励类型: ${reward.label} x ${reward.amount}");
    },
    onAdFailedToReceivedRewardCallback: (McAd ad) {
      // 奖励发放失败回调
    },
  ));

  // 发起加载请求
  McSdk.loadRewardedAd(_adUnitId);
}

2. 展示广告

dart 复制代码

Future<void> showRewardedAd() async {
  final isReady = await McSdk.isRewardedAdReady(_adUnitId);
  if (isReady == true) {
    McSdk.showRewardedAd(_adUnitId);
  } else {
    McSdk.loadRewardedAd(_adUnitId);
  }
}

3. 设置自定义参数

dart 复制代码

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

// 设置额外参数
McSdk.setRewardedAdLocalExtraParameter(_adUnitId, "key", value);

// 参数需在 loadRewardedAd() 之前设置，对后续所有加载请求生效

上一个

插屏广告

下一个

开屏广告

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

大纲