Ad Rotator 组件参考

Ad Rotator 组件参考
www.lucky365.net  2002-7-24  吉祥365

    Ad Rotator组件创建一个Ad Rotator对象，该对象在Web页上自动轮换显示广告图像。当用户每次打开或重新加载Web页时，Ad Rotator组件将根据在Rotator Schedule文件中指定的信息显示一个新广告。

　　可以记录每个广告被多少个用户单击访问，方法是在Rotator Schedule文件中设置一个URL参数，将用户定向到重定向文件中。如果指定了此参数，那么当每次跳转到一个广告客户的URL时，都会在Web服务器的活动日志中作相应的记录。关于活动日志的详细信息，请参阅记录Web站点活动。

　　文件名

　　adrot.dll Ad Rotator组件。

　　重定向文件 可选文件，用于实现重定向并允许Ad Rotator组件记录每个广告被多少个用户单击访问。

　　Rotator Schedule文件文本文件，包含广告的显示计划和文件信息。此文件必须在Web服务器的某个虚拟路径上可用。
　　
　　语法

　　Set AdRotator = Server.CreateObject("MSWC.AdRotator")

　　参数

　　AdRotator 指定AdRotator对象的名称，此对象通过调用Server.CreateObject创建。

　　注册表项

　　无。

　　属性

　　Border指定广告边框的大小。

　　Clickable指定广告是否为超链接。

　　TargetFrame 指定显示广告的框架的名称。

　　方法

　　GetAdvertisement从数据文件中获取下一个计划广告的详细说明并将其格式化为HTML格式。

　　示例

　　下面的示例在用户每次查看Web页时显示不同的广告。

　　＜% Set ad = Server.CreateObject("MSWC.AdRotator") %＞
　　＜%= ad.GetAdvertisement("/ads/adrot.txt") %＞

　　下面的HTML由GetAdvertisement方法生成且被添加到网页的输出中，以便显示Rotator Schedule文件中的下一个广告。

　　＜A HREF="http://www.msn.com/isapi/adredir.asp?http://www.company.com/"＞

　　＜IMG SRC="http://msnnt3web/ads/homepage/chlogolg.gif" ALT="Check out the new Technology Center" WIDTH=440 HEIGHT=60 BORDER=1＞＜/A＞

　　Rotator Schedule文件包含的Ad Rotator组件用于管理和显示各种广告图象的信息。在该文件中，用户可以指定广告的细节，例如广告的空间大小、使用的图象文件以及每个文件的显示时间所占百分比。

　　Rotator Schedule文件由两部分组成。第一部分设置应用于轮换安排中所有广告图象的参数；第二部分指定每个单独广告的文件和位置信息以及应当接收的每个广告的显示时间所占百分比。这两部分由全是星号(*)的一行隔开。

　　在第一部分中有四个全局参数，每个参数都由一个关键字和值组成。所有的参数都是可选的。如果用户未指定全局参数的值，则Ad Rotator将使用默认的值。在这种情况下，文件的第一行必须只有一个星号(*)。

　　语法

　　

[REDIRECT URL] 　　[WIDTH numWidth] 　　[HEIGHT numHeight] 　　[BORDER numBorder] 　　* 　　adURL 　　adHomePageURL 　　Text 　　impressions

　　参数

　　URL

　　指定动态链接库(.dll)或执行重定向的应用程序(.asp)文件的路径。该路径必须是完整的(http://MyServer/MyDir/redirect.asp)或相对的虚拟目录(/MyDir/redirect.asp)。

　　numWidth

　　以像素为单位指定网页上广告的宽度。默认值是440个像素。

　　numHeight

　　以像素为单位指定网页上广告的高度。默认值是60个像素。

　　numBorder

　　以像素为单位指定广告四周超链接的边框宽度。默认值是1个像素。如果将该参数设置为0，将没有边框。

　　adURL


　　广告图象文件的位置。

　　adHomePageURL

　　广告主页的位置。如果广告客户没有主页，请在该行写上一个连字符(-)，指出该广告没有链接。

　　Text

　　在浏览器不支持图形或关闭图象功能的情况下显示的替代文字。

　　impressions

　　从0到4,294,967,295的数，指出广告的相对权值。

　　例如，如果Rotator Schedule文件包含3个广告，其impressions分别设为2、3和5，则第一个广告占用20%的显示时间，第二个占用30%的显示时间，第三个占用50%的显示时间。

　　示例

　　下面的脚本演示是如何使用Rotator Schedule文件显示各种广告以及如何包含重定向文件。

　　---ADROT.TXT---

REDIRECT /scripts/adredir.asp WIDTH 440 HEIGHT 60 BORDER 1 * http://kabaweb/ads/homepage/chlogolg.gif http://www.bytecomp.com/ Check out the ByteCompTechnology Center20 http://kabaweb/ads/homepage/gamichlg.gif -Sponsored by Flyteworks20  http://kabaweb/ads/homepage/ismodemlg.gif http:// www.proelectron.com/28.8 internal PC modem, only $99 80 http://kabaweb/ads/homepage/spranklg.gif http://www.clocktower.com/The #1 Sports site on the net 10

　　
　　重定向文件是用户创建的文件。它通常包含用来解析由 AdRotator 对象发送的查询字符串的脚本并将用户重定向到与用户所单击的广告所相关的URL。

　　用户也可以将脚本包含进重定向文件中，以便统计单击某一特定广告的用户的数目并将这一信息保存到服务器上的某一文件中。

　　示例

　　下面的示例将用户重定向到广告客户的主页。

　　---ADREDIR.ASP---

　　＜% Response.Redirect(Request.QueryString("url")) %＞

　　AdRotator 对象有下列属性：

　　一.Border

　　二.Clickable

　　三.TargetFrame

　　1.Border 属性允许用户指定显示广告时四周是否带边框。

　　语法

　　Border = size

　　参数

　　size

　　指定显示的广告四周的边框宽度。其默认值在 Rotator Schedule 文件的文件头中设置。

　　示例

　　下面的例子显示不带边框的广告。

　　＜% Set ad = Server.CreateObject("MSWC.AdRotator") ad.Border = 0 %＞
　　＜%= ad.GetAdvertisement("/ads/adrot.txt") %＞

　　2.Clickable

　　Clickable 属性允许用户指定是否将广告作为超链接显示。

　　语法

　　Clickable = value

　　参数

　　value

　　指定广告是否为超链接。此参数可为下列值之一。默认值是TRUE。值意义:TRUE 将广告作为超链接显示。

　　FALSE 将广告不作为超链接显示。

　　示例

　　下面的示例只将广告作为图像显示，而不是作为超链接。

　　＜% Set ad = Server.CreateObject("MSWC.AdRotator") ad.Clickable = FALSE %＞
　　＜%= ad.GetAdvertisement("/ads/adrot.txt") %＞

　　3.目标框架

　　TargetFrame 属性指定链接将被装入的目标框架。该属性完成的功能等价于 HTML 语句中的 TARGET 参数。

　　语法

　　TargetFrame = frame

　　参数

　　frame

　　指定用来显示广告框架的名称。该参数也可以是一个 HTML 框架关键字, 例如 _TOP、_NEW、_CHILD、_SELF、_PARENT 或 _BLANK。默认值是 NO FRAME。

　　示例

　　下面的例子显示框架 AdFrame中的广告。

　　＜% Set ad = Server.CreateObject("MSWC.AdRotator") ad.TargetFrame = AdFrame %＞
　　＜%= ad.GetAdvertisement("/ads/adrot.txt") %＞

　　AdRotator 对象只有一个方法.GetAdvertisement

　　GetAdvertisement 方法从 Rotator Schedule 文件中获取下一个广告。每次运行脚本时，例如当用户打开或刷新一页时，此方法会获取下一个安排的广告。

　　语法

　　GetAdvertisement(rotationSchedulePath)

　　参数

　　rotationSchedulePath

　　指定 Rotator Schedule 文件相对于虚拟目录的位置。例如，若物理路径为 C:/Inetpub/Wwwroot/Ads/Adrot.txt（其中Wwwroot 是 "/" 虚拟目录）则应指定路径 /Ads/Adrot.txt。

　　返回值

　　返回在当前页中显示广告的 HTML。

　　示例

　　下面的示例从 Adrot.txt 文件中获取广告，此文件位于 /Ads/ 虚拟目录下。

　　＜% Set NextAd = Server.CreateObject("MSWC.AdRotator") %＞

　　＜%= NextAd.GetAdvertisement("/ads/adrot.txt") %＞