英文原文地址:http://www.openx.org/en/docs/whitepapers/magic-macros
宏(Macro)指的是可以应用在Banner HTML(或目标URL)中的宏命令,通过这些宏命令,可以在生产的广告代码中添加不同的属性值。
说明:
每个宏包括:
- 宏名称
- 描述包括使用目的、实例和结果
- 更多信息的链接
| 神奇的宏 | 说明 |
| {clickurl} | 投放广告时的Openx点击跟踪地址,例如: http://…/delivery/ck.php?oaparams=2__bannerid=… |
| {timestamp} | 时间戳(自Unix元时间的毫秒数)例如: 1185290310.72 |
| {random} | 10个字符的随机字符串例如:b616f31e72 |
| {logurl}* | Openx展示计数用URL,例如: http://…/delivery/lg.php?bannerid=… |
| {logurl_enc}* | 和 {logurl}一样,但只是被URL编码过,例如: http%3A%2F%2F…%2Fdelivery%2Flg.php%3Fbannerid%3D… |
| {target} | 被选择Banner的Target值,例如: _blank |
| {url_prefix} | Openx投放服务器的根目录,例如: http://ads.example.com/www/delivery |
| {bannerid} | 所选Banner的ID,例如:123 |
| {zoneid} | 所选广告位的ID,例如:456 |
| {source} | 在网站代码中传递的Source参数值,例如:source=cat123/cat456… |
| {pageurl} | 广告请求所在页面地址(URL编码过),例如: http%3A%2F%2Flocalhost%2Fmagic_macros%2Ftest.html |
| {referer} | 广告请求页面的Referer(URL编码过),例如:http%3A%2F%2Flocalhost%2Fmagic_macros%2F |
| {width} | 当前广告的宽度(像素),例如:468 |
| {height} | 当前广告的高度(像素),例如:60 |
| {clickurlparams} | 将会被传递给{clickurl}的参数值,例如: 2__bannerid=X__zoneid=Y__source=cat123/cat456__cb=0d9139d879__maxdest= |
| {ANY_INPUT_VARIABLE} | 任何在php $_REQUEST数组中表现的值($_GET/$_POST/$_COOKIE),例如:{OAID} -> $_COOKIE['OAID'] = 1fd819ffc7267757ba681ff5daa3007e |
如果在HTML中使用了宏,但是相应的值没有找到,则视宏的类型而定赋予相应的值:
- 以ID结尾的核心宏 — 赋值为0
- 其他核心宏 — 空值
- 任何”ANY_INPUT_VARIABLE”宏 — 宏字符串将不会被替换
*注意:如果在HTML广告中发现了{logurl}或者{logurl_enc},Openx将不会直接记录展现日志,而是将此日志记录URL传递给第三方并通过他们来执行提供的日志记录URL。
在URL中使用宏
{clickurl}
通过在第三方方服务器上的广告HTML中添加{clickurl}宏,Openx可以跟踪对应广告上的点击数。
更多信息: 第三方点击跟踪白皮书将描述如何应用这个功能。
当广告被点击时,Openx替换掉点击跟踪URL中的宏,例如:http://.../delivery/ck.php?oaparams=2__bannerid=.... 浏览器将前往该URL,而这个URL则是Openx用来记录点击数并转向浏览广告地址的。
{clickurlparams}
{clickurlparams}是用来为第三方点击跟踪传递{clickurl}中的相关参数,这些参数是:
- bannerid
- zoneid
- source
- cb
- maxdest
{pageurl}
广告请求页面的URL(URL编码),例如:http%3A%2F%2Flocalhost%2Fmagic_macros%2Ftest.html