## 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 (*).

After you change a Rotator Schedule File, the IIS Services may need to be restarted to pick up the change.

###### 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.

Note

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 Adredir.asp
    WIDTH 340
    HEIGHT 100
    BORDER 1
    *
    http://www.microsoft.com/library/homepage/images/init_win2k.gif
    http://www.microsoft.com/windows2000/guide/professional/overview/
    Introducing Microsoft Windows XP Professional!
    20
    http://www.microsoft.com/library/homepage/images/init_dotnet.gif
    -
    Sponsored by Flyteworks
    20
    http://www.microsoft.com/library/homepage/images/init_office.gif
    http://www.microsoft.com/office/
    The Tools of Microsoft Office 2000
    80
    http://www.microsoft.com/library/homepage/images/ts_001025msnexp.gif
    http://explorer.msn.com/home.htm
    MSN Explorer!  It's here at last!
    10

© 1997-2001 Microsoft Corporation. All rights reserved.