菜单

开屏广告

💡Tips

为提高开屏广告的加载效率可以参考预置策略

可根据实际业务需要传入期望的开屏广告加载超时时间，建议传入 6000ms - 10000ms

广告加载超时时间，即可以等待开屏广告加载的最长时间（仅为等待广告加载的超时，不包括广告展示的时间）

⚠️ 传入的超时时间太短或没有根据传入的超时时间去作为开屏等待加载广告的时间，可能会影响开屏广告的效果

⚠️ HyperBid Tools控制台-应用管理-聚合单元-高级设置中若启用价格优先模式，则价格优先回调超时时间的优先级将高于传入的 fetchTimeout

1. 加载广告

csharp 复制代码

private void InitializeAppOpenAds()
{
      McSdkCallbacks.AppOpen.OnAdLoadedEvent += OnAppOpenAdLoadedEvent;
      McSdkCallbacks.AppOpen.OnAdLoadFailedEvent += OnAppOpenAdFailedEvent;
      McSdkCallbacks.AppOpen.OnAdDisplayFailedEvent += OnAppOpenAdFailedToDisplayEvent;
      McSdkCallbacks.AppOpen.OnAdDisplayedEvent += OnAppOpenAdDisplayedEvent;
      McSdkCallbacks.AppOpen.OnAdClickedEvent += OnAppOpenAdClickedEvent;
      McSdkCallbacks.AppOpen.OnAdHiddenEvent += OnAppOpenAdDismissedEvent;
      McSdkCallbacks.AppOpen.OnAdRevenuePaidEvent += OnAppOpenAdRevenuePaidEvent;
      McSdkCallbacks.AppOpen.OnAdLoadFinishedEvent += OnAppOpenAdLoadFinishedEvent;
      McSdkCallbacks.AppOpen.OnAdLoadTimeoutEvent += OnAppOpenAdLoadTimeoutEvent;

    LoadAppOpenAd();
}

// 加载开屏广告
private void LoadAppOpenAd()
{
    McSdk.LoadAppOpenAd("your mediation unit id", fetchTimeout); // 毫秒值
}

private void OnAppOpenAdLoadedEvent(string adUnitId, McSdkBase.AdInfo adInfo)
{
    // 加载成功回调 
}

private void OnAppOpenAdLoadFailedEvent(string adUnitId, McSdkBase.ErrorInfo errorInfo)
{
    // 加载失败回调
}

private void OnAppOpenAdDisplayFailedEvent(string adUnitId, McSdkBase.ErrorInfo errorInfo, McSdkBase.AdInfo adInfo)
{
    // 展示失败回调
    // 热启开屏推荐进行pre-load
    // LoadAppOpenAd();
}

private void OnAppOpenAdDisplayedEvent(string adUnitId, McSdkBase.AdInfo adInfo)
{
    // 展示成功回调
}

private void OnAppOpenAdClickedEvent(string adUnitId, McSdkBase.AdInfo adInfo)
{
   // 点击回调
}

private void OnAppOpenAdHiddenEvent(string adUnitId, McSdkBase.AdInfo adInfo)
{
    // 关闭回调
    // 热启开屏推荐进行pre-load
    // LoadAppOpenAd();
}

private void OnAppOpenAdRevenuePaidEvent(string adUnitId, McSdkBase.AdInfo adInfo)
{
    // 收益回调
}

private void OnAppOpenAdLoadTimeoutEvent(string adUnitId)
{
    // 加载超时回调
}

2. 展示广告

csharp 复制代码

if (McSdk.IsAppOpenAdReady("your mediation unit id")) {
    McSdk.ShowAppOpenAd("your mediation unit id");
} else {
    LoadAppOpenAd();
}

3. 设置自定义参数

csharp 复制代码

McSdk.SetAppOpenAdExtraParameter("your mediation unit id", "appopen_test_extra_key", "appopen_test_extra_value");
#if UNITY_ANDROID
    McSdk.SetAppOpenAdLocalExtraParameter("your mediation unit id", "appopen_test_local_extra_key", new AndroidJavaObject("java.lang.String","appopen_test_local_extra_value"));
#elif UNITY_IOS
    McSdk.SetAppOpenAdLocalExtraParameter("your mediation unit id", "appopen_test_local_extra_key", "appopen_test_local_extra_value");
#endif

McSdk.LoadAppOpenAd("your mediation unit id", fetchTimeout); // 毫秒值

上一个

横幅广告

下一个

MREC广告

最近修改: 2025-08-06Powered by

大纲