激励广告

用户可自主选择与此类广告进行互动，以换取应用内奖励，例如在游戏中获得加分或额外生命值。广告内容支持图片、视频。

简介

激励广告，一般在App的游戏页面展示。全屏播放广告后获得相应的奖励。可参考广告源Hisavana，效果如图：

全屏图

加载广告

请设置相应参数和监听回调。

强烈建议：在广告展示期间，需避免使用相同的广告对象重复发起广告请求。如果需要发起新的广告请求，请创建一个新的广告对象。否则，广告请求将无效，并会通过onError回调返回错误信息。

// 初始化激励广告对象，其中"rewarded_id"是激励广告广告位ID
TRewardedAd tRewardedAd = new TRewardedAd(this, "rewarded_id");
// 构建广告请求体
TAdRequestBody tAdRequest = new TAdRequestBody.AdRequestBodyBuild() 
                .setAdListener(new TAdAlliance()) 
                .build();
// 设置广告请求体       
tRewardedAd.setRequestBody(tAdRequest);      
// 加载广告后在设置的等待时间内将最优广告回调返回                          
tRewardedAd.loadAd();

// 广告监听器，监听广告加载完成（填充）、展示、点击、异常、关闭、激励动作的回调
private static class TAdAlliance extends TAdListener {
  
    // 加载完成回调（适用的广告位：所有广告位）
    @Override
    public void onLoad() {
        // Ad loaded callback
    }
    
    // 异常回调（适用的广告位：所有广告位）
    @Override
    public void onError(TAdErrorCode errorCode) {
        // Ad failed callback
    }
    
    // 展示回调（适用的广告位：Splash、Interstitial、Banner、Reward）
    @Override
    public void onShow(int source) {
        // Ad show callback
    }
    
    // 点击回调（适用的广告位：Splash、Interstitial、Banner、Reward）
    @Override
    public void onClicked(int source) {
        // Ad click callback
    }
    
    // 关闭回调（适用的广告位：Splash、Interstitial、Banner、Reward）
    @Override
    public void onClosed(int source) { 
       // Ad close callback
    }
    
    // 激励回调（适用的广告位：Reward）
    @Override 
    public void onRewarded() { 
       // Rewarded playback completed
    }
}

提醒：source表示广告源，请参考广告源关联表; 比如:此次广告填充展示的是pangle广告，那么source=6。

展示广告

请把激励广告广告展示出来。

// 展示激励广告广告
if (tRewardedAd != null && tRewardedAd.hasAd()) {
    tRewardedAd.show(activity); 
}

/**
 * 可选项
 * 对于需要统计到达广告场景的应用，可自行设置场景值
 * 主要目的是统计当前广告场景利用率，第一个参数自定义场景名称，第二个参数广告数量
 */
String sceneToken = tRewardedAd.enterScene("rewarded_ad_scene_name", 1); 
if (tRewardedAd != null && tRewardedAd.hasAd()) {
    tRewardedAd.show(activity, sceneToken); 
}

销毁广告

退出广告场景后，请销毁该广告对象。

@Override
protected void onDestroy() {
    super.onDestroy();
    if (tRewardedAd != null) {
        tRewardedAd.destroy();
    } 
}

提醒：激励广告接入请参考聚合帮助，否则会引起异常。

其它API

API调用	介绍
tRewardedAd.hasAd()	当前是否有可用广告