激励视频广告

激励视频广告允许您向用户提供应用程序内的物品，例如继续游戏的机会、虚拟货币或其他奖励，以此作为用户与广告互动的交换条件。激励视频广告能够提高用户参与度，因为用户会因为投入时间而获得实实在在的好处。

本指南将指导您如何将奖励性广告整合到您的应用程序中。

请求广告

构建CTAdRequest并传入placementId，调用CTReward.loadAd方法请求广告。

• Java

CTAdRequest adRequest = new CTAdRequest.Builder()
    .setPlacementId("REWARD_PLACEMENT_ID")// [必要] carty开发者平台生成的placementId
    .setMute(true)// [可选] 控制视频是否静音播放 sdk默认值true
    .build();
CTReward ctReward = new CTReward(adRequest);
ctReward.loadAd();

• kotlin

val adRequest = CTAdRequest.Builder()
    .setPlacementId("REWARD_PLACEMENT_ID")// [必要] carty开发者平台生成的placementId
    .setMute(true)// [可选] 控制视频是否静音播放 sdk默认值true
    .build()
val ctReward = CTReward(adRequest)
ctReward.loadAd()

注册监听

调用CTReward.setRewardAdListener方法注册监听，建议在loadAd前调用。

ctReward.setRewardAdListener(new CTRewardAdListener() {
    @Override
    public void onLoaded(CTBaseAd baseAd) {
    }

    @Override
    public void onLoadFailed(CTAdError adError) {
    }

    @Override
    public void onShown(CTBaseAd baseAd) {
    }

    @Override
    public void onShowFailed(CTBaseAd baseAd, CTAdError adError) {
    }

    @Override
    public void onClicked(CTBaseAd baseAd) {
    }

    @Override
    public void onClosed(CTBaseAd baseAd) {
    }

    @Override
    public void onRewarded(CTBaseAd baseAd, Map<String, Object> rewardMap) {
    }

    @Override
    public void onVideoPlay(CTBaseAd baseAd) {
    }

    @Override
    public void onVideoComplete(CTBaseAd baseAd) {
    }
});

• kotlin

ctReward.setRewardAdListener(object : CTRewardAdListener {
    override fun onLoaded(baseAd: CTBaseAd?) {
    }

    override fun onLoadFailed(adError: CTAdError?) {
    }

    override fun onShown(baseAd: CTBaseAd?) {
    }

    override fun onShowFailed(baseAd: CTBaseAd?, adError: CTAdError?) {
    }

    override fun onClicked(baseAd: CTBaseAd?) {
    }

    override fun onClosed(baseAd: CTBaseAd?) {
    }

    override fun onRewarded(baseAd: CTBaseAd?, rewardMap: Map<String?, Any?>?) {
    }

    override fun onVideoPlay(baseAd: CTBaseAd?) {
    }

    override fun onVideoComplete(baseAd: CTBaseAd?) {
    }
})

确认广告可用

在展示广告前，调用isReady方法确认广告可用。

ctReward.isReady();

• kotlin

ctReward.isReady()

展示广告

调用CTReward.showAd方法展示广告。

ctReward.showAd(activity);

• kotlin

ctReward.showAd(activity)

其他

服务端激励回调

GitHub示例

• 激励视频