本项目由上海摩邑诚广告有限公司提出并提供需求,目的为指导开发适用于iOS系统的SDK包文件的工作。
该SDK将可用于iOS系统移动端应用接入,主要功能是在应用内支持其展示激励视频形式的广告,以及围绕其提供的接受服务端配置、数据上报、统计等功能。
全局功能
初始化配置:初始化通常发生在应用启动时。应用主程序主动调用初始化方法,上报应用、设备等信息,向MEX Server校验SDK内写入的授权token的合法性,并获取MEX 服务器内对该应用的配置信息;
预加载:初始化配置完成后,根据配置信息内的创意列表下载创意的素材(落地页图片、视频文件)。
每当创意(该创意的视频、图片文件)加载完成,上报该创意的加载完成事件。
广告请求:由应用主程序主动调用的方法。将向MEX Server请求一个广告信息列表。该列表包含接下来几次视频播放的创意id,SDK将在播放视频方法被调用时根据该列表依次进行播放,并将已播放的视频标记;
视频播放:
当应用主程序调用播放视频方法时,开始播放视频。
横竖屏都可播放视频:实际展示的视频横竖屏由视频创意内的描述决定。
全屏播放视频:应用调用请求展示方法后,开始全屏播放视频。
开始播放时,显示所有页面元素(“5秒后可跳过的倒计时(如果可跳过)”、关闭声音按钮、总时长倒计时)
5秒无用户触摸操作则隐藏按钮。下次触摸时出现这些按钮,并继续遵守以上规则。
全屏展示落地页图片:视频文件播放完成/用户点击跳过按钮后,自动打开并停留在落地页。该落地页全屏展示,并且点击后调用内部appstore窗口,打开appstore url;
跳过按钮及其5秒倒计时:根据配置信息。当配置为“5秒后可跳过”时,视频播放前5秒显示“5秒后可跳过”,并且数字随时间逐秒减少,到达5秒时显示“跳过”按钮。点击后可跳过剩余视频,并打开落地页图片;
视频播放倒计时:视频播放时显示“剩余播放时间n秒”。初始数值为该视频的总时长(参数:duration),根据播放时间逐秒减少;
声音开关:视频播放时显示。
关闭按钮:到达落地页后显示,点击后可关闭该广告。
MEX 标志:广告展示期间,全程显示摩邑诚logo(logo图片将另外提供)。
播放完成上报:当播放完成/跳过并到达落地页,SDK通知MEX Server本次展示id。
奖励通知:当播放完成/跳过并到达落地页,通知应用允许用户领取奖励。
点击上报:当落地页被点击,SDK向MEX Server上报该点击事件;