Posts Tagged ‘宏’

在Banner HTML和URL中应用宏(Macro)

August 10th, 2009

英文原文地址: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