ASP實用大全-ASP服務(wù)器組件(6)

Ad Rotator 組件參考

    　Ad Rotator組件創(chuàng)建一個Ad Rotator對象，該對象在Web頁上自動輪換顯示廣告圖像。當(dāng)用戶每次打開或重新加載Web頁時，Ad Rotator組件將根據(jù)在Rotator Schedule文件中指定的信息顯示一個新廣告。

　　可以記錄每個廣告被多少個用戶單擊訪問，方法是在Rotator Schedule文件中設(shè)置一個URL參數(shù)，將用戶定向到重定向文件中。如果指定了此參數(shù)，那么當(dāng)每次跳轉(zhuǎn)到一個廣告客戶的URL時，都會在Web服務(wù)器的活動日志中作相應(yīng)的記錄。關(guān)于活動日志的詳細(xì)信息，請參閱記錄Web站點活動。

　　文件名

　　adrot.dll Ad Rotator組件。

　　重定向文件 可選文件，用于實現(xiàn)重定向并允許Ad Rotator組件記錄每個廣告被多少個用戶單擊訪問。

　　Rotator Schedule文件文本文件，包含廣告的顯示計劃和文件信息。此文件必須在Web服務(wù)器的某個虛擬路徑上可用。
　　
　　語法

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

　　參數(shù)

　　AdRotator 指定AdRotator對象的名稱，此對象通過調(diào)用Server.CreateObject創(chuàng)建。

　　注冊表項

　　無。

　　屬性

　　Border指定廣告邊框的大小。

　　Clickable指定廣告是否為超鏈接。

　　TargetFrame 指定顯示廣告的框架的名稱。

　　方法

　　GetAdvertisement從數(shù)據(jù)文件中獲取下一個計劃廣告的詳細(xì)說明并將其格式化為HTML格式。

　　示例

　　下面的示例在用戶每次查看Web頁時顯示不同的廣告。

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

　　下面的HTML由GetAdvertisement方法生成且被添加到網(wǎng)頁的輸出中，以便顯示Rotator Schedule文件中的下一個廣告。

　　＜A ＞

　�。糏MG 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組件用于管理和顯示各種廣告圖象的信息。在該文件中，用戶可以指定廣告的細(xì)節(jié)，例如廣告的空間大小、使用的圖象文件以及每個文件的顯示時間所占百分比。

　　Rotator Schedule文件由兩部分組成。第一部分設(shè)置應(yīng)用于輪換安排中所有廣告圖象的參數(shù)；第二部分指定每個單獨(dú)廣告的文件和位置信息以及應(yīng)當(dāng)接收的每個廣告的顯示時間所占百分比。這兩部分由全是星號(*)的一行隔開。

　　在第一部分中有四個全局參數(shù)，每個參數(shù)都由一個關(guān)鍵字和值組成。所有的參數(shù)都是可選的。如果用戶未指定全局參數(shù)的值，則Ad Rotator將使用默認(rèn)的值。在這種情況下，文件的第一行必須只有一個星號(*)。

　　語法

　　

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

　　參數(shù)

　　URL

　　指定動態(tài)鏈接庫(.dll)或執(zhí)行重定向的應(yīng)用程序(.asp)文件的路徑。該路徑必須是完整的(http://MyServer/MyDir/redirect.asp)或相對的虛擬目錄(/MyDir/redirect.asp)。

　　numWidth

　　以像素為單位指定網(wǎng)頁上廣告的寬度。默認(rèn)值是440個像素。

　　numHeight

　　以像素為單位指定網(wǎng)頁上廣告的高度。默認(rèn)值是60個像素。

　　numBorder

　　以像素為單位指定廣告四周超鏈接的邊框?qū)挾�。默認(rèn)值是1個像素。如果將該參數(shù)設(shè)置為0，將沒有邊框。

　　adURL


　　廣告圖象文件的位置。

　　adHomePageURL

　　廣告主頁的位置。如果廣告客戶沒有主頁，請在該行寫上一個連字符(-)，指出該廣告沒有鏈接。

　　Text

　　在瀏覽器不支持圖形或關(guān)閉圖象功能的情況下顯示的替代文字。

　　impressions

　　從0到4,294,967,295的數(shù)，指出廣告的相對權(quán)值。

　　例如，如果Rotator Schedule文件包含3個廣告，其impressions分別設(shè)為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

　　
　　重定向文件是用戶創(chuàng)建的文件。它通常包含用來解析由 AdRotator 對象發(fā)送的查詢字符串的腳本并將用戶重定向到與用戶所單擊的廣告所相關(guān)的URL。

　　用戶也可以將腳本包含進(jìn)重定向文件中，以便統(tǒng)計單擊某一特定廣告的用戶的數(shù)目并將這一信息保存到服務(wù)器上的某一文件中。

　　示例

　　下面的示例將用戶重定向到廣告客戶的主頁。

　　---ADREDIR.ASP---

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

　　AdRotator 對象有下列屬性：

　　一.Border

　　二.Clickable

　　三.TargetFrame

　　1.Border 屬性允許用戶指定顯示廣告時四周是否帶邊框。

　　語法

　　Border = size

　　參數(shù)

　　size

　　指定顯示的廣告四周的邊框?qū)挾�。其默認(rèn)值在 Rotator Schedule 文件的文件頭中設(shè)置。

　　示例

　　下面的例子顯示不帶邊框的廣告。

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

　　2.Clickable

　　Clickable 屬性允許用戶指定是否將廣告作為超鏈接顯示。

　　語法

　　Clickable = value

　　參數(shù)

　　value

　　指定廣告是否為超鏈接。此參數(shù)可為下列值之一。默認(rèn)值是TRUE。值意義:TRUE 將廣告作為超鏈接顯示。

　　FALSE 將廣告不作為超鏈接顯示。

　　示例

　　下面的示例只將廣告作為圖像顯示，而不是作為超鏈接。

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

　　3.目標(biāo)框架

　　TargetFrame 屬性指定鏈接將被裝入的目標(biāo)框架。該屬性完成的功能等價于 HTML 語句中的 TARGET 參數(shù)。

　　語法

　　TargetFrame = frame

　　參數(shù)

　　frame

　　指定用來顯示廣告框架的名稱。該參數(shù)也可以是一個 HTML 框架關(guān)鍵字, 例如 _TOP、_NEW、_CHILD、_SELF、_PARENT 或 _BLANK。默認(rèn)值是 NO FRAME。

　　示例

　　下面的例子顯示框架 AdFrame中的廣告。

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

　　AdRotator 對象只有一個方法.GetAdvertisement

　　GetAdvertisement 方法從 Rotator Schedule 文件中獲取下一個廣告。每次運(yùn)行腳本時，例如當(dāng)用戶打開或刷新一頁時，此方法會獲取下一個安排的廣告。

　　語法

　　GetAdvertisement(rotationSchedulePath)

　　參數(shù)

　　rotationSchedulePath

　　指定 Rotator Schedule 文件相對于虛擬目錄的位置。例如，若物理路徑為 C:\Inetpub\Wwwroot\Ads\Adrot.txt（其中Wwwroot 是 "/" 虛擬目錄）則應(yīng)指定路徑 \Ads\Adrot.txt。

　　返回值

　　返回在當(dāng)前頁中顯示廣告的 HTML。

　　示例

　　下面的示例從 Adrot.txt 文件中獲取廣告，此文件位于 /Ads/ 虛擬目錄下。

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

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