rsContext Technical Details
The Setup Tool is the easiest way to
determine the URL to use to call the rsContext script. But you can
manually create the URL or edit the URL generated by the Setup Tool if you wish.
Call rsContext using a URL similar to the following:
http://www.yourdomain.com/rscontext.php?arg=value&arg=value&...
Where http://www.yourdomain.com/ is the path the script
(use http://www.browsenodes.com/ads/ if you wish to use the script on our server),
arg is the name of an argument, and value is the value of the
argument.
The rsContext script accepts the following arguments (parameters):
width
The width of the ad in pixels. If not specified, the default value from rsconfig.php is used. Note that
because of the way browsers handle tables and varying font sizes, the size of the displayed ad may actually
be larger than the height and width you specify. If an exact size is required, you can display the ad in a fixed
size IFRAME element.
height
The height of the ad in pixels. If not specified, the default value from rsconfig.php is used. Note that
because of the way browsers handle tables and varying font sizes, the size of the displayed ad may actually
be larger than the height and width you specify. If an exact size is required, you can display the ad in a fixed
size IFRAME element.
rows
The number of rows of product in the ads. If not specified, the default value from rsconfig.php is used.
cols
The number of columns of products in the ads. If not specified, the default value from rsconfig.php is used. The actual number of products displayed in each ad is equal to rows times cols.
imagesize
The size of images to display in the ads - none, small, medium, or large. Setting
images to "none" produces ads without images. If not specified, the default value from rsconfig.php is used.
imageposition
The position of images in ads - top, bottom, left, right. If not specified, the default value from rsconfig.php is used.
title
The maximum number of characters displayed in the title of the product. If the title is longer than this argument's value, it is truncated and "..." is displayed at the end of the shortened title. If not specified, the default value from rsconfig.php is used.
length
The maximum number of characters displayed in the description of the product. If not specified, the default value from rsconfig.php is used.
border
The color of the border around the ad and separating the products. The value is specified as a six digit hexadecimal color code representing the red, green, and blue parts of the color - the same representation used in HTML. If not specified, the default value from rsconfig.php is used.
back
The background color for the ad. If not specified, the default value from rsconfig.php is used.
link
The color for links in the ad. Currently, only the title of the product is displayed as a link. If not specified, the default value from rsconfig.php is used.
url
The color of the display URL shown at the bottom of each product listing in the ads. If not specified, the default value from rsconfig.php is used.
text
The color of the text in the description of each product in the ads. If not specified, the default value from rsconfig.php is used.
center
Center the ad. If center is yes, the ad will be centered in its container. If not specified, the default value from rsconfig.php is used.
usnode
The Amazon.com browse node ID. If a keyword is not specified, rsContext will use the browse node IDs and modes to select products to display. rsContext accepts both a US (Amazon.com) and a UK (Amazon.co.uk) browse node ID and mode. rsContext will attempt to choose which country's browse node to use based on the visitor's home country. Visit BrowseNodes.com for help choosing a browse node ID and mode. If omitted, rsContext will use the specified keyword argument value to select products to display. Generally, specifying a browse node ID and mode results in better product selections in ads.
usmode
The Amazon Web Services (AWS) mode for the browse node identified by usnode. Visit BrowseNodes.com for help determining the mode to use.
uknode
The Amazon.co.uk browse node ID. Visit BrowseNodes.co.uk for help choosing a browse node ID and mode.
ukmode
The Amazon Web Services (AWS) mode for the browse node identified by uknode. Visit BrowseNodes.co.uk for help determining the mode to use.
keyword
A key word or phrase to use to select products to display. Set the value to nothing (or omit the keyword argument) if you have specified browse node IDs and modes. If keyword is set to a value, rsContext will perform an AWS "BlendedSearch" using the keyword and use the results to select the products to display in the ads.
country
The country version of Amazon to use. If country is us then rsContext will only display products from Amazon.com. If country is uk then rsContext will only display products from Amazon.co.uk. If country is usuk or ukus then rsContext will display products from either Amazon.com or Amazon.co.uk depending on the visitor's country. If country is usuk and rsContext cannot determine the visitor's country, products from Amazon.com are displayed. If country is ukus and rsContext cannot determine the visitor's country, products from Amazon.co.uk are displayed. If not specified, the default value from rsconfig.php is used.
alt
The URL of an alternate ad to display if rsContext finds no matching products. The alt argument may be set to the URL of an ad to display if rsContext cannot find any products to display. The URL may be the URL of rsContext.
cache
Use the mySQL cache. If cache is yes, rsContext caches AWS query using a mySQL table. If not specified, the default value from rsconfig.php is used.
amazonus
Your Amazon.com Associates ID. If not specified, the default value from rsconfig.php is used.
amazonuk
Your Amazon.co.uk Associates ID. If not specified, the default value from rsconfig.php is used.
[Home]
[Download]
[Documentation]
[FAQ]
|
