目录

• 概述
• SDK 配置方法
• SDK 委托安装
• 静态和视频插页式广告委托方法
• “更多应用”委托方法
• 激励式视频委托方法
• 原生广告委托方法
• 其他委托方法
• 年龄限制方法

概述

Chartboost SDK 的委托方法让您可以对集成具备高度控制。例如，您可以:

• 在您的游戏试图加载插页式广告时记录调试信息
• 阻止在用户第一次运行游戏时显示广告
• 明确用户是点击广告抑或只是点击“关闭” — 然后据此进行不同操作
• 阻止插页式广告或“更多应用”页面在可能干扰您的游戏的时间或位置出现

您可以查看包括在您的 SDK 下载的 doc 文件夹中的文档以查看供您使用的 Chartboost Android SDK 方法。您可以在包括在文件包中的示例项目里看到这些方法的使用示例。

SDK 配置方法

这些方法让您可以访问 Chartboost SDK 功能和设置:

// 在指定位置检查已缓存插页式广告。public static boolean hasInterstitial(String location)// 在指定位置检查已缓存“更多应用”页面。public static boolean hasMoreApps(String location)// 在指定位置检查已缓存激励式视频。public static boolean hasRewardedVideo(String location) // 检查是否有任何视图可见public static boolean isAnyViewVisible()// 设置以启用或禁用自动缓存功能 (默认启用)。*public static void setAutoCacheAds(boolean autoCacheAds)// 获取当前自动缓存行为 (默认为 TRUE)。*public static boolean getAutoCacheAds()// 设置 POST 正文发送的自定义标识符，用于所有 Chartboost API 服务器请求。public static void setCustomId(String customID)// 获取当前 POST 正文发送的自定义标识符，用于所有 Chartboost API 服务器请求。public static String getCustomID()// 判断 Chartboost SDK 是否应该在首次会话展示插页式广告。public static void setShouldRequestInterstitialsInFirstSession(boolean shouldRequest)//  // 判断 Chartboost SDK 在准备显示“更多应用”界面时是否显示加载视图。public static void setShouldDisplayLoadingViewForMoreApps(boolean shouldDisplay)// 判断 Chartboost SDK 是否尝试从 Chartboost API 服务器抓取视频。public static void setShouldPrefetchVideoContent(boolean shouldPrefetch)

(您可以在此了解常规 AutoCacheAds 设置和广告缓存。)

SDK 委托安装

在使用委托函数前，在您的活动的 onCreate() 方法中设置 Chartboost 委托，例如:

Chartboost.setDelegate(YourDelegateObject);

然后，按照如下实例化委托对象和声明委托方法:

private ChartboostDelegate YourDelegateObject = new ChartboostDelegate() {// 在此声明委托方法，请查看 CBSample 项目以获取示例};

静态和视频插页式广告委托方法

// 在通过 Chartboost API 服务器请求插页式广告前调用。public boolean shouldRequestInterstitial(String location)// 插页式广告在屏上显示前调用。public boolean shouldDisplayInterstitial(String location)// 插页式广告在屏上显示后调用。public void didDisplayInterstitial(String location)// 在插页式广告从 Chartboost API 服务器加载// 并且本地缓存后调用。public void didCacheInterstitial(String location)// 在插页式广告尝试从 Chartboost API 服务器加载// 但失败后调用。public void didFailToLoadInterstitial(String location, CBImpressionError error)// 插页式广告消除后调用。public void didDismissInterstitial(String location)// 插页式广告关闭后调用。public void didCloseInterstitial(String location)// 插页式广告点击后调用。public void didClickInterstitial(String location)

“更多应用”委托方法

// “更多应用”页面在屏上显示前调用。public boolean shouldDisplayMoreApps(String location)// “更多应用”页面在屏上显示后调用。public void didDisplayMoreApps(String location)// 在“更多应用”页面从 Chartboost API 服务器加载// 并且本地缓存后调用。public void didCacheMoreApps(String location)// “更多应用”页面消除后调用。public void didDismissMoreApps(String location)// “更多应用”页面关闭后调用。public void didCloseMoreApps(String location)// “更多应用”页面点击后调用。public void didClickMoreApps(String location)// 在“更多应用”页面尝试从 Chartboost API 服务器加载// 但失败后调用。public void didFailToLoadMoreApps(String location, CBImpressionError error)

激励式视频委托方法

(有关 Chartboost 视频的更多信息，参见此页。)

// 激励式视频在屏上显示前调用。public boolean shouldDisplayRewardedVideo(String location)// 激励式视频在屏上显示后调用。public void didDisplayRewardedVideo(String location)// 在激励式视频从 Chartboost API 服务器加载// 并且本地缓存后调用。public void didCacheRewardedVideo(String location)// 在激励式视频尝试从 Chartboost API 服务器加载// 但失败后调用。public void didFailToLoadRewardedVideo(String location, CBImpressionError error)// 激励式视频消除后调用。public void didDismissRewardedVideo(String location)// 激励式视频关闭后调用。public void didCloseRewardedVideo(String location)// 激励式视频点击后调用。public void didClickRewardedVideo(String location)// 在激励式视频观看完毕，用户可获得奖励时调用public void didCompleteRewardedVideo(String location, int reward)// 实施后会进行通知，如果视频将于 // 指定 CBLocation 的屏幕上播放。您可以接着进行关闭音乐和音效等操作。public void willDisplayVideo(String location)

原生广告委托方法

// 在原生广告对象从 Chartboost API 服务器加载// 并且本地缓存后调用。public void didCacheInPlay(String location)// 在原生广告尝试从 Chartboost API 服务器加载// 但失败后调用。public void didFailToLoadInPlay(String location, CBImpressionError error)

其他委托方法

// 在应用发生点击后而用户未转至 App Store 时调用。public void didFailToRecordClick(String uri, CBClickError error)//SDK 成功初始化，视频预提取完成后调用。public void didInitialize(){ Log.i("Chartboost, DID INITIALIZE! ")); }

年龄限制方法

Android 年龄限制已弃用。