sinaads制作demo文档

先看下sinaads介绍

常规广告demo

这部分内容在介绍中静态数据模拟已经说明。针对页面上已有广告位情况，制作demo是为了查看效果和审核。制作demo只需要伪造广告数据即可。

制作demo步骤：

1. 将素材上传至ad4
2. 下载页面内容，填充广告数据，可能需要修改广告参数
3. 上传广告页面至ad4

例如，双十一浪首天猫疯狂流媒体该广告的pdps是PDPS000000002520，类型是流媒体，对应的广告type值是stream，尺寸是1000*450，需要两个素材，在content的type字段中指明类型。

支持的素材类型有：

素材类型	type值
图片	image
flash	flash
文字	text
资源地址	url
代码片段	html
脚本地址	js
adbox素材	adbox

	_sinaadsCacheData = window._sinaadsCacheData || {};
	_sinaadsCacheData["PDPS000000002520"] = {
        size : "1000*450",
        type : 'stream',
        content : [{
            src: ['http://d1.sina.com.cn/litong/zhitou/zhangfei/demo/fb/tmall1111-1000-450.swf', 'http://d1.sina.com.cn/litong/zhitou/zhangfei/demo/fb/tmall1111-25-150.swf'],
            monitor : [""],
            link : [''],
            pv: [],
            type: ['flash', 'flash']
        }],
        id : "PDPS000000002520"
    };

非标广告demo

某一个位置临时需要投放一个特定形式广告，现有的广告不支持新形式。

可以直接在页面插入一个广告脚本。

例如，游戏背景广告，这个背景广告与常规的背景广告形式不同，这儿是单独投的一个js。替换背景时就替换这个js中的素材。

投放一个脚本

如果在这个脚本中需要引用sinaToolKit提供的方法，必须等sinaads加载完成才能使用。因为sinaads开始时是一个普通数组，目前sinaads还没有提供加载完成后的回调方法。这可以通过在流媒体中投放一个js的方式来做到。例如，天猫双十一背景广告，这个广告需要设置两边的flash高度，常规的背景广告是不支持的。

_sinaadsCacheData = window._sinaadsCacheData || {};

_sinaadsCacheData["PDPS00000000bg00"] = {
    size : "1600*600",
    type : 'stream',
    content : [{
        src: ['http://d1.sina.com.cn/litong/zhitou/zhangfei/demo/fb/bgExtend.js'],
        monitor : [""],
        link : [],
        pv: [''],
        type: ['js']
    }],
    id : "PDPS00000000bg00"
};

新增广告类型

sinaads/view/ 下注册一个广告类型，如bg，遇到type为bg的广告就交由其处理，这个处理函数接受的参数形式如下：

@element 对应的ins标签 @width @height 不解释 @content 参见上面的数据content内容 @config 参见广告支持参数 function (element, width, height, content, config){ }

sinaadToolKit提供的常用方法：

sinaadToolkit.Box 创建一个附属在任意元素或者视口的盒子，并可以实现跟随

sinaadToolkit.ad.createHTML 创建广告内容

sinaadToolkit.dom.getPosition 获取元素位置

sinaadToolkit.event.on

sinaadToolkit.event.un

sinaadToolkit.cookie.set

sinaadToolkit.cookie.get

注册一个新的广告类型，就是将渲染方法挂在sinaadsRenderHandler下，如下面的底浮广告，当渲染广告类型为bolgbf的广告时就用该方法渲染。

sinaadsRenderHandler.blogbf = function (element, width, height, content, config) {
.....
}

之后还需要在管理端增加新的广告类型blogbf，需要告诉新增的广告名称、类型，创建的新广告资源就可以是这个类型的广告，线上返回的数据中广告类型就是新增的这个广告类型blogbf。如果返回的类型和前端的类型名称不一样，需要在sinaads对应类型和值映射表中添加一条新的映射。