Rotator Schedule File

The Rotator Schedule file contains information that the Ad Rotator component uses to manage and display the various advertisement images. In it you can specify the details for the advertisements, such as the size of the advertisement space, the image files to use, and the percentage of time that each file should be displayed.

The Rotator Schedule file has two sections. The first section sets parameters that apply to all advertisement images in the rotation schedule. The second section specifies file and location information for each individual advertisement and the percentage of display time that each advertisement should receive. The two sections are separated by a line containing only an asterisk (*).

In the first section there are four global parameters, each consisting of a keyword and a value. All are optional. If you do not specify values for the global parameters, the Ad Rotator uses default values. In this case, the first line of the file must contain only an asterisk (*).

Syntax

[REDIRECT URL]

[WIDTH numWidth]

[HEIGHT numHeight]

[BORDER numBorder]

*

adURL

adHomePageURL

Text

impressions

Parameters

URL

Specifies the path to the dynamic-link library (.dll) or application (.asp) file that implements redirection. This path can be specified either fully (http://MyServer/MyDir/redirect.asp) or relative to the virtual directory (/MyDir/redirect.asp).

numWidth

Specifies the width of the advertisement on the page, in pixels. The default is 440 pixels.

numHeight

Specifies the height of the advertisement on the page, in pixels. The default is 60 pixels.

numBorder

Specifies the thickness of the hyperlink border around the advertisement, in pixels. The default is a 1-pixel border. Set this parameter to 0 for no border.

adURL

The location of the advertisement image file.

adHomePageURL

The location of the advertiser's home page. If the advertiser does not have a home page, put a hyphen (-) on this line to indicate that there is no link for this ad.

Text

Alternate text that is displayed if the browser does not support graphics, or has its graphics capabilities turned off.

impressions

A number between 0 and 10000 that indicates the relative weight of the advertisement.

For example, if a Rotator Schedule file contains three ads with impressions set to 2, 3, and 5, the first advertisement is displayed 20 percent of the time, the second 30 percent of the time, and the third 50 percent of the time.

Remarks

If the sum of the impressions parameters for all items exceeds 10000, an error will be generated the first time the Rotator Schedule file is accessed by a call to the GetAdvertisement method.

Example

The following script demonstrates how you can use a rotator schedule file to display a variety of advertisements and how to include a redirection file.

---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 Center
20 
http://kabaweb/ads/homepage/gamichlg.gif 
-
Sponsored by Flyteworks
20 
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