激励视频广告全自动加载

1. 全自动加载激励视频广告介绍

全自动加载模式，是Taku推出的一站式请求维护方案，能够根据用户的使用状态和广告消耗进度，多节点智能判断下一条广告的预加载和缓存时机。在满足开发者运营策略的基础上，规避广告数据实时加载的失败风险和展示机会被浪费，减轻用户因为广告未加载或加载不流畅造成的负面情绪。通过全自动加载方案，开发者可以避免反复冗杂的人工干预请求方案，效率提升立竿见影。SDK开始支持全自动加载模式。

1.1 集成建议

(1) 初始化：在主Activity onCreate()里调用ATRewardVideoAutoAd.init(mainActivity,placementIds,listener)并传入主Activity进行初始化，后续如需添加全自动加载广告位请调用addPlacementId(placementId)添加

(2) 建议进入可展示广告场景后调用entryAdScenario(placementId,scenarioId)统计当前广告位的缓存状态，具体的统计说明可查看广告场景区分不同业务场景的数据

(3) 展示广告：展示前判断isAdReady(placementId)是否准备好，准备好后再调用 show(activity,placement,listener)进行广告展示

(4) 服务器回调：如需支持服务器回调（S2S）传入userId，extraData请在以下时机进行设置：

注意：

① 全自动激励视频内部实现自动加载逻辑，所以请避免在onRewardVideoAutoLoaded回调中直接执行广告展示

② 广告位如果设置为全自动加载则不要调用ATRewardVideoAd（普通激励视频）.load()进行广告加载

1.2 注意事项：

(1) 激励视频的激励下发时会回调onReward()，开发者可以在onReward回调中下发激励给用户

(2) 全自动加载激励视频支持服务器回调（S2S）的激励下发机制，同时也支持各广告平台的服务器回调功能，请参考 激励视频服务器激励(S2S)说明

2. API说明

2.1 广告初始化

ATRewardVideoAutoAd: 全自动加载激励视频广告的管理类

初始化：

public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //建议在主Activity onCreate时传入Activity进行初始化
        ATRewardVideoAutoAd.init(MainActivity.this, new String[]{"your rv placementID1", "your rv placementID2"},autoLoadListener);
    }
}

2.2 本地参数

ATAdConst.KEY：LocalExtra本地参数预定义Key取值

服务器回调：

//设置服务器回调localExtra信息
private static void setPlacementIdLocalExtra(String placementId) {
    String userid = "test_userid_001";
    String userdata = "test_userdata_001_" + placementId + "_" + System.currentTimeMillis();
    Map localMap = new HashMap<>();
    localMap.put(ATAdConst.KEY.USER_ID, userid);
    localMap.put(ATAdConst.KEY.USER_CUSTOM_DATA, userdata);
    //从下一次的广告加载开始生效
    ATRewardVideoAutoAd.setLocalExtra(placementId, localMap);
}

//设置时机1：初始化前或添加广告位前
setPlacementIdLocalExtra("your rv placementID1");//初始化前，对指定广告位设置localExtra
ATRewardVideoAutoAd.init(this, new String[]{"your rv placementID1", "your rv placementID2"}, autoLoadListener);
//ATRewardVideoAutoAd.addPlacementId("placementId1");

//设置时机2：广告填充后
private static ATRewardVideoAutoLoadListener autoLoadListener = new ATRewardVideoAutoLoadListener() {
    @Override
    public void onRewardVideoAutoLoaded(String placementId) {
        //如需更新localExtra则在此处设置localExtra，从下次加载生效
        setPlacementIdLocalExtra(placementId);
    }

    @Override
    public void onRewardVideoAutoLoadFail(String placementId, AdError adError) {
    }
};

2.3 广告展示

ATRewardVideoAutoAd:

boolean isAdReady(String placementId)

广告展示：

        /*
     为了统计场景到达率，相关信息可查阅 "https://help.takuad.com/docs/1RWLAv"
     在满足广告触发条件时调用“进入广告场景”方法，比如：
     ** 广告场景是在清理结束后弹出广告，则在清理结束时调用；
     * 1、先调用 "entryAdScenario"
     * 2、在调用 "isAdReady" 是否可展示
     * 3、最后调用 "show" 展示
     * 4、scenario 传入场景id后台场景管理才会有数据显示
     */
 ATRewardVideoAd.entryAdScenario("your rv placementID", "your scenarioID");
//需判断广告位是否准备好
if(ATRewardVideoAutoAd.isAdReady("your rv placementID")){
    ATRewardVideoAutoAd.show(activity, "your rv placementID", "your scenarioID"，autoEventListener);
}

2.4 广告对象

ATRewardVideoAutoAd:

ATAdStatusInfo：广告位的状态对象

2.5 广告监听

ATRewardVideoAutoLoadListener：ATRewardVideoAutoAd广告的加载事件回调监听:

监听示例：

private static ATRewardVideoAutoLoadListener autoLoadListener = new ATRewardVideoAutoLoadListener() {
    @Override
    public void onRewardVideoAutoLoaded(String placementId) {
     
    }

    @Override
    public void onRewardVideoAutoLoadFail(String placementId, AdError adError) {
    }
};

ATRewardVideoAutoEventListener：ATRewardVideoAutoAd广告的事件回调监听:

3. 示例代码

//设置服务器回调localExtra信息
private static void setPlacementIdLocalExtra(String placementId) {
    String userid = "test_userid_001";
    String userdata = "test_userdata_001_" + placementId + "_" + System.currentTimeMillis();
    Map localMap = new HashMap<>();
    localMap.put(ATAdConst.KEY.USER_ID, userid);
    localMap.put(ATAdConst.KEY.USER_CUSTOM_DATA, userdata);
    //从下一次的广告加载开始生效
    ATRewardVideoAutoAd.setLocalExtra(placementId, localMap);
}

//设置时机1：初始化前或添加广告位前
setPlacementIdLocalExtra("your rv placementID1");//初始化前，对指定广告位设置localExtra
ATRewardVideoAutoAd.init(this, new String[]{"your rv placementID1", "your rv placementID2"}, autoLoadListener);
//ATRewardVideoAutoAd.addPlacementId("placementId1");

//设置时机2：广告填充后
private static ATRewardVideoAutoLoadListener autoLoadListener = new ATRewardVideoAutoLoadListener() {
    @Override
    public void onRewardVideoAutoLoaded(String placementId) {
        //如需更新localExtra则在此处设置localExtra，从下次加载生效
        setPlacementIdLocalExtra(placementId);
    }

    @Override
    public void onRewardVideoAutoLoadFail(String placementId, AdError adError) {
    }
};
    /*
     为了统计场景到达率，相关信息可查阅 "https://docs.takuad.com/#/zh-cn/android/NetworkAccess/scenario/scenario"
     在满足广告触发条件时调用“进入广告场景”方法，比如：
     ** 广告场景是在清理结束后弹出广告，则在清理结束时调用；
     * 1、先调用 "entryAdScenario"
     * 2、在调用 "isAdReady" 是否可展示
     * 3、最后调用 "show" 展示
     * 4、scenario 传入场景id后台场景管理才会有数据显示
     */
 ATRewardVideoAd.entryAdScenario("your rv placementID1", "your scenarioID");
//需判断广告位是否准备好
if(ATRewardVideoAutoAd.isAdReady("your rv placementID1")){
    ATRewardVideoAutoAd.show(activity, "your rv placementID1", "your scenarioID"，autoEventListener);
}

详细激励视频广告示例代码请参考：Demo的RewardVideoAdActivity类