Video类型曝光接口, 当APP中视频广告需要进行曝光监测时, 由APP在视频开始播放时调用该接口. 如传递adView则包含可见曝光监测功能,若不需监测可见曝光需传递“null”.
public static long adTrackVideo(Context context, String trackingURL, View adView, int playType)
Parameters
context
参见Context
trackingURL
广告对应的曝光监测代码
adView
可见曝光监测时传入广告视图对象, 用来计算广告曝光面积和持续曝光时间. 普通曝光监测时传null.
playType
视频播放类型, 1-自动播放, 2-手动播放, 0-无法识别.
Return
可见曝光的监测id, 需要APP保存变量, 并在广告结束时作为调用adTrackStop接口的参数停止对广告的可见曝光监测. 普通曝光监测返回0, 无需处理.
Discussion
trackingURL来源: 广告开始投放前,
由秒针为广告主需要监测的广告分配对应的曝光监测代码. 媒体需要将监测代码录入到其投放系统中并与广告保持一一对应的关系.
投放系统在响应APP发送的投放请求时, 不仅需要返回广告创意本身, 还需返回与广告对应的曝光监测代码.
APP从中解析出广告以及对应监测代码, 并在后续相应广告曝光行为产生时调用adTrackVideo接口, 将监测代码当作参数传给该接口.
adview来源: 媒体投放系统在响应APP发送的投放请求时, 返回广告创意本身, APP需要将广告对象所在的view作为参数传给该接口.
Related Sample Code
longtrackId=0;
HttpURLConnectionconnection=null;try{intvideoPlayType=1;trackId=MZMonitor.adTrackVideo(context,trackingURL,adView,videoPlayType);}catch(Exceptione){Log.e("unhandled exception happened");URL url=newURL(trackingURL);connection=(HttpURLConnection)url.openConnection();if(connection!=null){connection.setUseCaches(false);connection.setInstanceFollowRedirects(true);connection.connect();}}finally{if(connection!=null){connection.disconnect();connection=null;}}
WARN:
为防止运行时因未知异常抛错,
建议媒体在调用第三方SDK接口时进行保护性异常捕获. 出现异常时, 可通过非SDK的方式将监测请求发出.
这样既能防止抛错而导致APP崩溃, 同时也能避免因该问题而引发的数据GAP