Ad Rotator 组件参考(一) - 概述
| 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> |
Ad Rotator 组件参考(二) - Rotator Schedule 文件&nb
| 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 ByteComp Technology 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 |
Ad Rotator 组件参考(三) - 重定向文件
重定向文件是用户创建的文件。它通常包含用来解析由 AdRotator 对象发送的查询字符串的脚本并将用户重定向到与用户所单击
的广告所相关的 URL。
用户也可以将脚本包含进重定向文件中，以便统计单击某一特定广告的用户的数目并将这一信息保存到服务器上的某一文件中。
示例
下面的示例将用户重定向到广告客户的主页。
---ADREDIR.ASP---
<% Response.Redirect(Request.QueryString("url")) %>
Ad Rotator 组件参考(四) - Ad Rotator 的属性
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") %>
Ad Rotator 组件参考(五) - Ad Rotator 的方法
AdRotator 对象只有一个方法.GetAdvertisement
GetAdvertisement 方法从 Rotator Schedule 文件中获取下一个广告。每次运行脚本时，例如当用户打开或刷新一页时，此方
法会获取下一个安排的广告。
语法
GetAdvertisement(rotationSchedulePath)
参数
rotationSchedulePath
指定 Rotator Schedule 文件相对于虚拟目录的位置。例如，若物理路径为 C:InetpubWwwrootAdsAdrot.txt （其中
Wwwroot 是 "/" 虚拟目录）则应指定路径 AdsAdrot.txt。
返回值
返回在当前页中显示广告的 HTML。
示例
下面的示例从 Adrot.txt 文件中获取广告，此文件位于 /Ads/ 虚拟目录下。
<% Set NextAd = Server.CreateObject("MSWC.AdRotator") %><%= NextAd.GetAdvertisement("/ads/adrot.txt") %>