The mgiToken Tag
Tag Behavior
Use the mgiToken tags to append a token to URLs (HREFs and
ACTIONs) between the beginning and ending tags. A token number
can be used as a visitor's unique shopping basket identification.
A token is composed of the visitor's IP number and time interval
so that each token is absolutely unique.
Tag Syntax
The mgiToken tag has a beginning tag with no required parameters
and three optional parameters, a body, and an ending tag. The
tag form is:
<mgiToken mode="Mode" pathArgumentName="Name"
pathArgumentValue="Value">
URLs to be tokenized
</mgiToken>
Required Parameters:
Optional Parameters:
- mode - The mode is the function that the mgiToken
tag performs. In "addTokenOnly" mode, the mgiToken
tag appends the mgiToken path argument and unique token value
to URLs. In "addTokenWithPathArguments" mode,
the mgiToken tag appends the token and all path arguments to
URLs. In "addPathArgumentsOnly" mode, the mgiToken
tag appends all path arguments to URLs. The default value is
"addTokenOnly".
- pathArgumentName - The pathArgumentName is the name
of a path argument that is always appended to tokenized URLs.
If this parameter is not followed by a pathArgumentValue parameter
in the tag, it is ignored.
- pathArgumentValue - The pathArgumentValue is the value
of the specified path argument that is always appended to tokenized
URLs. If this parameter is not preceded by a pathArgumentName
parameter in the tag, it is ignored.
Technical Notes
- Token Exceptions - The mgiToken tag does not append
a token to "mailto" HREFs or URLs with an ending slash
(/). URLs with an ending slash usually indicate a link to an
external site.
Example Usage and Output
<mgiToken>
<A HREF="purchase.html">Purchase Our Products!</A>
</mgiToken>
When this example token tag is processed through an MGI server,
the HREF is appended with a unique token number such as:
<A HREF="purchase.html?mgiToken=CD982415B2F65040">
Purchase Our Products!</A>
Suggested Usage
- Shopping Baskets
- Affiliate Systems
|