广告(Unity)

Unity 通过 FRVRSDK.Ad 暴露两种广告类型:插屏(非自愿打断,全屏)与激励(玩家自愿,看完拿到奖励)。两者都基于回调 —— 你提供 onStart / onError / onFinish 处理函数。

插屏

FRVRSDK.Ad.ShowInterstitialAd(
    onStart:  () => Debug.Log("Interstitial started"),
    onError:  error => Debug.Log("Interstitial error: " + error),
    onFinish: () => Debug.Log("Interstitial finished"));

无论用户看完还是中途关闭,onFinish 都会触发 —— 它只表示广告视图结束。插屏没有”看完 vs. 投放成功”这种概念。

激励

FRVRSDK.Ad.ShowRewardAd(
    onStart:  () => Debug.Log("Reward started"),
    onError:  error => Debug.Log("Reward error: " + error),
    onFinish: () => GiveExtraLife());   // 只在成功完成时调用

onFinish 只在用户看完整个广告(完整观看)时触发。如果跳过、关闭或广告渲染失败,触发的是 onError —— 这种情况下你不要发奖励。

error: 'Ad not completed' 表示用户跳过了广告

当 onError 回调收到 error.error == "Ad not completed" 时,说明广告正常渲染了,但用户在结束前跳过或关闭了广告 —— 没有拿到奖励。把它当作用户的正常选择,而不是失败:不要弹出错误提示,只需不发奖励即可(可选地重新启用按钮,让玩家再试一次)。

(SdkError error) => {
    if (error.error == "Ad not completed")
        ShowToast("未获得奖励 —— 你跳过了广告。");   // 用户主动跳过
    else
        ShowToast("当前无法展示广告 —— 请稍后再试。");   // 真正的失败
}

如果你的游戏提供激励广告,必须先检查可用性,并在没有可用广告时禁用或隐藏激励入口。不要给玩家一个点了没反应的按钮:

// 在展示入口前重新检查一次 —— 可用性在每一局之间会变化。
rewardButton.gameObject.SetActive(FRVRSDK.Ad.IsAdReady("reward"));

IsAdReady("reward") 等价于 Web SDK 的 .isReady 检查。它是尽力而为的信号,不是保证。 即使返回 true,广告仍可能无法展示(请求时没有填充、网络中断、宿主拒绝)。务必在 onError 回调里处理这种情况 —— 绝不发奖励,并提示玩家广告未能展示:

FRVRSDK.Ad.ShowRewardAd(
    onStart:  () => { /* 暂停 + 静音 */ },
    onError:  err => ShowToast("当前无法展示广告,请稍后再试。"),
    onFinish: () => GiveExtraLife());   // 只有走到这里才算拿到奖励

典型范式:“看广告拿 2 倍金币”

void OnDoubleRewardButtonPressed()
{
    doubleRewardButton.interactable = false;

    FRVRSDK.Ad.ShowRewardAd(
        onStart:  () => { /* 暂停游戏音频等 */ },
        onError:  err => {
            doubleRewardButton.interactable = true;
            ShowToast("Ad unavailable right now");
        },
        onFinish: () => {
            currentRunCoins *= 2;
            ShowToast("Rewarded!");
        });
}

频率

插屏默认有节流 —— 底层 SDK 强制两次插屏之间的最短间隔,并屏蔽 init 后头约 100 秒。游戏代码里不需要再加自己的节流。如果某次插屏调用触发 onError,通常就是节流器在说”还不行”。

激励广告不节流 —— 按需触发。

游戏流程

当一个插屏或激励广告打开时,SDK 会自动挂起浏览器标签页在广告下的渲染/音频行为。Unity 游戏通常通过封装包转发的浏览器 focus/blur 信号来处理这件事 —— 你不必手动暂停自己的游戏循环。

广告(Unity)

插屏

激励

典型范式:“看广告拿 2 倍金币”

频率

游戏流程

相关