Skip to main content

1、激励视频

一、简介#

主要介绍在Android项目中如何集成 TradPlus SDK的激励视频:

  • 支持Android 16以上的应用;
  • 针对v6.x以上版本的集成;
  • 建议先注册TradPlus账户,并添加应用;
  • 按照流程成功集成TradPlus SDK;
  • 如何正常展示测试广告

> 激励视频广告

  • 激励视频广告一般是全屏的15-30s的视频,调用时机是在给用户奖励或者获得某些特定物品时,用户看完广告下发奖励发放给用户
  • 激励视频广告是三方广告平台提供的activity,一般不支持做定制或者修改
  • 激励视频广告一般需要预加载,在展示前判断isReady()是否准备好,准备好后可以调show()
  • 自动加载功能是TradPlus独有的针对部分需要频繁展示广告的场景做的自动补充和过期重新加载的功能,推荐在广告场景触发较多的场景下使用
  • 自动加载功能只需要初始化一次,后续在广告场景到来的时候判断isReady()然后show广告即可,不需要额外的调用load()

二、集成步骤#

  • V6.X 为例
// 1、初始化广告位。仅调用一次。AdUnitId是广告位ID,在TradPlus后台创建。自动reload模式,true 开启 ,false 关闭
TPReward mTpReward = new TPReward(activity, "AdUnitId", true);
// 2、进入广告场景(可选)。sceneId广告场景ID,在TradPlus后台创建。使用该方法`showAd()`时需要传入sceneId。
mTpReward.entryAdScenario(sceneId);
// 3、设置广告监听
mTpReward.setAdListener(new RewardAdListener() {...});
// 4、设置每层广告源回调监听(可选)
mTpReward.setAllAdLoadListener(new LoadAdEveryLayerListener() {...});
// 5、请求广告
mTpReward.loadAd();
// 6、判断是否有可用广告
if (mTpReward.isReady()) {
// 7、展示广告。不使用`entryAdScenario()`,参数2可直接传空字符串。
mTpReward.showAd(activity,sceneId)
}

具体集成请参考Demo

三、API说明#

3.1 加载类API#

V6.X API TPReward方法说明
TPReward(Activity activity, String adUnitId, boolean isAutoLoad)激励视频广告的初始化方法。仅初始化时调用一次。adUnitId广告位ID在TradPlus后台创建。isAutoLoad是自动加载模式,true开启,false 关闭。了解更多,请看自动加载功能
entryAdScenario(String sceneId)(可选)进入广告场景。sceneId广告场景ID,在TradPlus后台创建。广告场景是用来统计进入广告场景的次数和进入场景后展示广告的次数,所以请在准确的位置调用。 了解更多,请看广告场景的调用时机和用途说明
setAdListener(RewardAdListener adListener)设置广告监听,其中InterstitialAdListener是需要实现广告事件回调的接口类。
setAllAdLoadListener(LoadAdEveryLayerListener everyLayerListener)(可选)设置单个源维度的监听回调,其中LoadAdEveryLayerListener是需要实现广告事件回调的接口类。
loadAd()请求广告。
isReady()检查是否有可用广告。自动加载模式下,isReady()false会自动加载广告。
showAd(Activity activity, String sceneId)展示广告。(可选)参数2:设置广告场景ID。sceneId需和entryAdScenario()配套使用。如果不使用entryAdScenario(),可以传空字符串。

3.2 监听回调API#

V6.X API RewardAdListener 方法说明
onAdClicked(TPAdInfo tpAdInfo)广告被点击。事件回调监听中的TPAdInfo,请参考回调信息说明。同下
onAdImpression(TPAdInfo tpAdInfo)广告被展示。部分三方源没有该回调。AdColony、AppLovin、Unity Ads 、Admob、Mopub、Criteo、MyTarget无此回调。
onAdClosed(TPAdInfo tpAdInfo)广告被关闭。
onAdLoaded(TPAdInfo tpAdInfo, TPBaseAd tpBaseAd)广告加载成功。
onAdFailed(TPAdError error)广告加载失败。事件回调监听中的TPAdError,请参考错误码&错误信息说明。同下
onAdReward(TPAdInfo tpAdInfo)广告奖励。
onAdVideoError(TPAdInfo tpAdInfo)视频播放失败。
  • (可选)设置单个源维度的监听回调
V6.X API LoadAdEveryLayerListener 方法说明
onAdAllLoaded(boolean isSuccess)V6.4.5新增API。广告位的状态。loadAd()完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。
oneLayerLoadFailed(TPAdError adError, TPAdInfo adInfo)V6.4.5新增API。配置多个广告源,d每个广告源加载失败后会都会回调一次。
oneLayerLoaded(TPAdInfo adInfo)V6.4.5新增API。配置多个广告源,每个广告源加载成功后会都会回调一次。
onLoadAdStart(TPAdInfo tpAdInfo)V6.4.5新增API。请求广告后,广告开始加载。
onBiddingStart(TPAdInfo tpAdInfo)V6.4.5新增API。Bidding开始加载。
onBiddingEnd(TPAdInfo tpAdInfo)V6.4.5新增API。Bidding加载完成。

3.3 5.X旧版本API#

  • 注意:接入V6.X版本,可跳过这部分API说明。
  • 加载类API

V5.X API TradPlusInterstitialExt方法说明
TradPlusInterstitialExt(Context context, String adUnitId, boolean isAutoLoad)创建广告位。仅初始化时调用一次。adUnitId广告位ID在TradPlus后台创建。isAutoLoad是自动加载模式,true开启,false 关闭。
initUnitId()初始化广告位。使用自动加载模式可以直接初始化广告位,否则需要先setCanLoadListener()
setCanLoadListener(CanLoadListener listener)设置初始化监听回调。同时第一次请求广告需要在canLoad()中调用。
setInterstitialAdListener(TradPlusInterstitial.InterstitialAdListener listener)设置广告监听,其中InterstitialAdListener是需要实现广告事件回调的接口类。
setOnAllInterstatitialLoadedStatusListener(OnAllInterstatitialLoadedStatusListener listener)(可选)设置广告位状态监听。
load()请求广告。
isReady()检查是否有可用广告。自动加载模式下,isReady()false会自动加载广告。
entryAdScenario(String sceneId)(可选)进入广告场景。sceneId广告场景ID,在TradPlus后台创建。需和show(String adSceneId)配套使用。
show()展示广告。
show(String sceneId)(可选)展示广告并设置广告场景ID。需和entryAdScenario(String sceneId)配套使用。
  • 监听回调API
TradPlusInterstitial.InterstitialAdListener 方法说明
onInterstitialClicked(TradPlusInterstitial tradPlusInterstitial)广告被点击。
onInterstitialShown(TradPlusInterstitial tradPlusInterstitial)广告被展示。
onInterstitialLoaded(TradPlusInterstitial tradPlusInterstitial)配置多个广告源,每个广告源加载成功后会都会回调一次。
onInterstitialFailed(TradPlusInterstitial tradPlusInterstitial,TradPlusErrorCode tradPlusErrorCode)配置多个广告源,每个广告源加载失败后会都会回调一次。
onInterstitialDismissed(TradPlusInterstitial tradPlusInterstitial)广告被关闭。
onInterstitialRewarded(TradPlusInterstitial tradPlusInterstitial, String currencyName, int amount)广告奖励。currencyName奖励项目,TradPlus后台设置下发;amount奖励数量,TradPlus后台设置下发。
  • (可选)设置广告位维度的监听回调
OnAllInterstatitialLoadedStatusListener 方法说明
onLoadStatus(boolean isLoadedSuccess, String adUnitId)广告位的状态。loadAd()完毕后用于判断是否有可用广告,true表明有可用广告,false表明没有可用广告。