Previous PageNext Page

10.3.3 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


Copyright © 2000 Chili!Soft

Previous PageTop Of PageNext Page