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 ＞

　　＜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 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

　　
　　重定向文件是用戶創建的文件。它通常包含用來解析由 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") %＞