委托方法 — Android

上次更新:

Chartboost 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 年龄限制已弃用。