Clicktimizer Professional 1.3 User Manual
Table Of Contents
Introduction
Key Features
Service Funtionality and Over View
- Description
- Wizard Interface
- Request Optimization Agent
- Popup Window Objects(CLickies)
Installation Notes
- Requirements
- Pre-Installation Procedures
- On-line Installation
- Re-Installation Notes
Service Configuration
- Wizard Screens Configuration
- Remote Configuration with XML Data
- Internet Access Methods and Syntaxes
- Security Considerations
Managing Configuration Patterns In Clicktimizer
- The Configuration Process
- Setting Session Patterns
- Creating Randomly Generated Windows
- Creating Random Urls
- Hotspot Select Boxes
Site and Revenue Enhancement Solutions
- Reopening Windows After A Preset Period
- Optimizing Stealth Requests
- Pop Under Windows
- Using Page Events To Trigger Popup Campaigns
- Effective User Tracking
- Using Multiple Windows To Deliver Solutions
- Animation Patterns and Solutions
Summary
Software Licence and Copyright Notes
Glossary Of Terms
Introduction
Clicktimizer is a popup window management service integrated with a Request Optimization Agent.It allows the website administrator to conveniently create,store,manage and process popup and popunder windows within the adminstrator's website
and on affiliate websites.
Clicktimizer consists of two software modules,the popup window management
configuration wizard which creates and manages popup window objects and
the Request Optimization Agent(Click Optimizer) which listens on webpages
for user interaction.The optimization agent can be triggered by
several
factors on the user's page,it will act on configuration information,user
pattern detection information and user page interaction data, to determine
the suitability of a user for a popup window advertisement or page delivery.
Clicktimizer can accurately predict which users will respond more favourably to the content displayed in a popup window
by retaining information about the web page user and matching it against a pattern created in the configuration
wizard.
Clicktimizer is written in perl, compatible with perl versions 5.006 and above,but requires the user to have javascript and cookies
activated on their browsers.(It will work in cookieless browsers but will revert to Classic mode delivery)
Clicktimizer must be installed on your web server for it to function properly and does not require any extraordinary maintenance
procedures.It allows the administrator to securely connect to the service using http while enforcing RSA Data Security standards
to authenticate the administrator with the service.RSA Data Security standards is maintained in all communications with external
sites with the exception of the Request Optimization Agent (ROA).
Clicktimizer can be remotely configured by affiliate schemes using
Clicktimizer AutoConfig1.1,which uses XML for data interchange.
It will allow you to automatically configure clicktimizer popup objects into your instance of the software from another website while maintaining the
integrity of security restrictions imposed on the service.
Top
Key Features
Top
Popup Window Management Service
Clicktimizer is primarily a poup window management service.It creates,modifies
and stores popup window objects which contain data relating to how a popup or popunder window is displayed,
when the popup is displayed,what activates the popup,which
users can be clicktimized (an arbitary term for a user receiving a popup
window display) and what events on the users browser can trigger popup window generation.
The popup campaigns created by clicktimizer are 100% configurable with the popup objects retaining properties relating to:
- Windowing Properties
- Activation and Deactivation Properties
- User Browser Event Properties
- Sessional Properties
- Animation Properties
- Behavioural Properties
- URL Properties
Clicktimizer relates to all this properties before generating popup window campaigns on any website where it is activated.
Top
Click Through Ratio Optimization
Clicktimizer optimizes your websites click-through-ratio by selectively delivering your popup campaign.
It will deliver a popup window based on pre-defined criteria which has been stored in the configuration data associated with that window.
This criteria can accurately predict if a user has seen the advertisement previously,intensify the urge to investigate the advertisement and
increase the visibility of the advertisement to a maximum allowable target audience.
Top
On-line Wizard Driven Configuration Interface
Clicktimizer allows the site administrator to configure
popup campaigns and traffic forwardings on the fly.
The online Clicktimizer configuration interface resides on your website, and can be accessed at your chosen url.It provides the gateway to your
popup campaigns and allows you to make changes to your advertisement campaigns at anytime you wish.
The configuration interface offers full grade industry security without SSL and cannot be accessed without the
appropriate authorisation.
Top
Multiple User Event Activation and De-activation Mechanisms
The Web page user on a Clicktimizer activated page is closely monitored by the request optimization agent.User events like mouse movements,mouse clicks,keyboard inputs,
page load and unload changes can be used to trigger a popup campaign.Popup activation can be timed inclusive and exclusive of these
user events giving the administrator a chance to develop popup campaign strategies beyond the norm.
These user events are also used to perform clean up operations on the
generated popup window operations.We are of the opinion that if you clean
up a popup after you believe it is no longer in use,you will preserve
the user's system resources,giving you an advantage when you decide to
spawn another popup window on the user's browser.
For information on how to create and store strategies relating to popup delivery,read the topic
Managing Configuration Patterns In Clicktimizer.
Top
User Surf Pattern Recognition
Clicktimizer has the ability to recognise each website user.It does this by saving information on the users computer
in the form of a cookie.This information(cryptic to the user but meaningful to the agent) is used to determine the users
history in relation to Clicktimizer enabled pages across the internet.
The agent does not store a users details but uses the information it has
derived to determine what action to take with that particular user.A user
may not be allowed to view the same advertisement twice on different websites
within 30mins depending on the configuration the administrator has chosen
to impose on that campaign.An affiliate provider running clicktimizer
no longer has to pay twice for an advertisement that he paid for 5 seconds
ago on another website because we all know the user does not need that
advertisement twice in 5 seconds, Clicktimizer will make sure that the
advertisement is not repeated without due cause.
Top
Remote Auto Configuration
Clicktimizer can be remotely configured using XML data.A
CLickie can be represented by an XML object as
described in the
CLickie XML Schema.
While ordinary users may not have access to the tool needed to automatically configure Clicktimizer remotely,Clicktimizer.com
is developing a scalable version of this routine known as
Clicktimizer AutoConfig1.1.AutoConfig preserves
your service's security restrictions while remotely sending XML data to your service.This data is used to create and register popup window
objects within the service saving time and allowing affiliate managers a chance to recreate popup window delivery patterns
on the fly.
This does not infer that anyone can suddenly re-configure your service,we have only made it possible for trusted resources
to register popup objects into your service, if you authorise the transaction by explicitly giving your service's administrative username and password and
set auto-config to
"ON" from the service's administrative interface.
Top
XML Messaging Enabled
Clicktimizer recognises the popup object(
CLickie) in three different ways.
The CLickie is an object that can be represented by Perl,Javascript and XML type descriptions.The XML description
needed to create a CLickie is described in the
CLickie XML Schema.
Clicktimizer allows remote web sites to relate to the service by sending streams of XML data to the service which the service
can use to determine configuration patterns pertaining to popup objects within the system.While not SOAP or .NET enabled,
Clicktimizer may provide this facility in future releases.
Top
Stealth Url Request Capability
Clicktimizer can make a request to an external or internal url while working in stealth mode.
It will not display a popup advertisement in stealth mode,but will
make the request in the background without the website user knowing what is happening behind the scenes.
It mimics a mouse click on a url of your choice(only one url per transaction).A
common pattern is to configure a multiple popup advertisement,with one
of the CLickies set to stealth mode to perform an external transaction.
Use this facility to activate events on remote websites.
Top
RSA Data Security Standards Layer
Clicktimizer uses RSA Data security routines to authenticate administrators with the service.The security restrictions imposed
on Clicktimizer are never lessened even when an external website wishes to configure your version of the service.
3DES and MD5 digest algorithms are the main channels by which Clicktimizer transports secure encrypted data across the internet and because
this data is never repeated for the same type of transaction,hackers will always find it extremely difficult to intercept and use your
data.
Affiliate providers who wish to utilize Clicktimizer should contact
customer services for information on how to configure
Clicktimizer services on the web.
Clicktimizer administrators have to explicitly accept an affiliate's popup object before it can be registered with their service,
a procedure which requires the administrator to submit his username and password.
NB: Your details are never made public in any way, affilate providers who use
Clicktimzer AutoConfig1.1 do not even get
to see your details.If security is a primary issue you can install the service behind an https layer but do remember to move
the request optimization agent files to a normal http layer.
MD5 Digest Algorithm is derived from Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991. All rights reserved
Top
Interchangeable User Interfaces (skins)
Clicktimizer has been built to accommodate different user interface types.While
not supporting templates,you can view your favourite money making service
on your website in a plethora of colours of your choice.
You can change the look and feel of your service by clicking a selectbox
on the admin pages of the Clicktimizer service at anytime.Skin change
is instantenous and this look and feel is saved as your default setting.
We are constantly updating available choices(skins) which you can download
and install into your system at any time.Graphic artists who wish to donate
their templates or any other suitable skin should contact the
skin
administrator for notes on how to create templates.
Top
Targeted Content Delivery
Clicktimizer will deliver targeted advertisements to your users
by using that user's history of site usage to deliver the requisite advert.
Users do not just get a popup, they get a popup if they deserve it!!.This allows the site administrator to deliver targeted advertisements to
users who have been browsing certain sectors of the website.
Top
Intelligent User Advertisement Delivery
Clicktimizer will intelligently deliver your popup campaign to your users as at when due.
It can use several factors to determine when to deliver a campaign to the users.
These factors include:
|
|
- The time spent by the user on the site
- The last time the user was on the site
- The number of times a particular page has been accessed
- The number of times a user has accessed a certain page
- The period of time from site user's last visit to a page
- A random index specified by the site administrator
- A daily advert delivery for regular users
|
All of these delivery options are fully configurable for each popup campaign instance
via the Clicktimizer configuration interface.
Top
Synchronous and Asynchronous Window Generation
Clicktimizer can generate windows on any web page driven by a suitable web server, It allows the advertiser to
selectively generate a popup campaign without fuss.
Window generation can be event driven or time driven depending on the site
administrator's choice.
Clicktimizer provides
CLickies
(Clickimizer popup window objects) which a developer can manipulate on
the website's pages giving the site administrator total control over all
the visual and non visual aspects of these generation processes.
The CLickie also maintains data relating to the ability to determine which website user deserves an advertisement campaign.
Top
Window Motion Control
You can control the motion of a window by relating to its animation properties.A popup window object with preset motion properties
can be made to move around a users screen in any direction and at any time.
For resource consumption reasons you should not pause a window in motion for more than a minute but you can move the popup window
around the users screen for as long as you wish.
Top
Random Window Generation
Clicktimizer can generate random urls with each window or it can choose to deliver popup windows based on a random index determined by the adminstrator
of the service.This random index can be applicable to the campaign itself,a preset click ratio e.g(2 popups per 5 users) or
the index can relate to a particular user who may get a popup once every 5 visits to the site.
Clicktimizer does not stop here,it has the cappability to recognise the same user across several internet domains and will perform the same action
if the user transverses several websites displaying the same popup campaigns.
Top
Single and Multiple Window Delivery
Clicktimizer can be configured to either deliver a single window or a collection of windows( multiple windows).
The multiple windows generated by clicktimizer allow a wide range of options allowing the adminstrator to display up to 10 windows
to the website user either synchronously or asynchronously.
Administrators should note that it is impossible to accurately determine if a web user has enough resources to generate another window
and should limit the resources consumed by each window when designing the advertisement campaign.
Top
Animated Window Delivery
Clicktimizer has the capability to animate popup windows!!.A popup window can be configured to present different animation
modes(presently move,increment and decrement).
This animation can be controlled by fine tuning the configuration to perform certain actions at certain times or at certain
spots on the web page where the popup window is activated.Administrators will need to familiarize themselves with the configuration
dynamics to use this feature properly.Javascript developers are also encouraged to relate to the animation patterns by addressing the CLickie
object created on the web page with Javascript.
Top
Manages up to 5000 Popup Windows
Clicktimizer can conveniently manage up to 5000 popup campaigns
each pointing to various url's as defined in the Clicktimizer configuration wizard.
The wizard interface allows you to define various properties for your popup campaign, including window properties,sessional properties,display
properties,creation properties,animation properties,event activation properties and window manipulation properties.
The configuration interface effectively manages the data associated with these popup campaigns and can also bind them into groups of multiple
windows.
The service is capable of storing more than 50,000 popup windows but administrators
are advised to limit the number of popup window objects registered with
the service to not more than 5,000.Our tests show that under full load
conditions (100,000 simultenous requests,5000 popup objects running on an intel driven
P3 linux machine, Clicktimizer will service a request in approximately 2.1 secs).
Top
Extensible with Javascript and Programmable with XML
Clicktimizer can be extended using Javascript.The objects created
on the users web page are Javascript objects which a developer can manipulate
till his hearts content.Simply setting the window activation property
to
"None" will create the popup object on the web page but
will not activate this object.A Javascript developer can then use this
object in any way he sees fit.
The objects created by clicktimizer also have their XML representation.Administrators who wish to deploy Clicktimizer objects
to external services should familiarize themselves with the
CLickie schema.It is the XML schema needed
to create an XML representation of the CLickie and is mainly used to remotely configure an external service with a popup window
object deliverable by a request optimization agent.
Top
Requires no External Database
Clicktimizer professional 1.3 does not use a database to store it's data.It
uses system related perl db files to manage its data which is not relational
in nature.It however imposes transactional restrictions on the data sets
it maintains and can process up to 50,000 data entry and retrieval operations
in less than 1.1secs if running a Berkerly type db.This setting is dependent
on the system administrator of the web server but Clicktimizer will try
to use a berkerly db or the next fastest db file type before falling back
to the default settings of the sytstem it is deployed on.
Top
Service Functionality and Over view
Top
Description
Clicktimizer can be configured to provide several different types of popup windows.It retains the data pertaining to each poup window
in it's internal database, and presents an object oriented representation of the popup window to the service and to the web page visitor
who interacts with the request optimization agent on a webpage.
The diagram on your left represents the clicktimizer professional1.3 software running on a Linux machine with apache webserver and perl5.6 installed on it.
Administrators are allowed to logon to the service,(only one administrator per software licence) to create,edit,delete,copy,rename,manage
and demo the popup window campaign used either on the administrators website or on a website belonging to an affiliate.
The transaction engine and the internal database are never exposed to the user or the administrator but is shown here to indicate how Clicktimizer manages multiple
requests to the request optimization agent.
The optimization agent listens on the web page for user interaction and comparatively determines the extent to which a
web site visitor can become a suitable recipient for your popup advertisement campaign.
Top
Wizard Interface
The configuration wizard which the administrator uses to create and manage popup advertisement campaigns is semi automated
and has the capability to store as many popup window objects as you can manage.An upper limit of 5,000 popups is stated to maintain
speed of page delivery(You can create more than 50,000 popup campaigns but you will lose speed).Several configuration screens are presented to the user at different times
during a configuration process,a help screen describing the configuration parameters need to complete configuration of that page
is shown if the user clicks on the green I graphic shown at the top of the configuration screen.
The configuration screens presented to the user have a wizard like attitude.The user interaction is minimized i.e the wizard
dictates the page needing configuration parameters except when specifically dictated by the administrator(Certain select boxes initiate a page change).
This wizard interface allows you to configure
single and multiple popup windows
into the system while presenting access to configuration parameters necessary to drive the Request Optimization Agent.(ROA)
Top
Request Optimization Agent
The request optimization agent resides on your website but can be accessed
across the internet by as many websites choosen to deliver your popup
advertisement campaign.It is the workhorse of the service and can service
as many page requests as your web server can deliver.
It uses a combination of user interaction,stored configuration parameters,events generated by the user,and user
history to determine it's possible action.
It is accessed by an
in-line call coded into the web page.The call itself can be of several forms which
may depend on your web server.
Because you run perl on your web server, an SSI include syntax provides faster access within your website(SSI include will not work
from remote websites).Your web server may provide other means of accessing clicktimizer using a native include syntax or using php,asp or jsp.
The most common way of accessing clicktimizer across the internet is with Javascript which the optimization agent uses to
communicate with the web page.
Top
Clickimizer Popup Objects(CLickies)
The popup window created and stored in the clicktimizer service is known to us as the CLickie.It is a software object
with properties,functions,initializers and destructors.
The popups created by Clicktimizer exist until when they are destroyed by the administrator explicitly deleting them
from the service.The properties of single popup windows are exposed by the wizard interface and can be edited by the administrator.The
functions available with each popup window include window options(width,height,position,decoration,and url),activation properties,
deactivation properties,sessional properties and functions,animation and exposure functions and event synchronisation functions.
The CLickie is exposed to the website as a javascript object and the website developer can make inline calls to the objects created
by Clicktimizer.An active CLickie on a web page is exposed to the website developer as [ javascript:click_name() ] where the name is the registered
name of the CLickie in the web service.It can also be represented by an XML Object as stated in the
CLickie schema.
Top
Installation notes
Requirements
Pre-Installation Procedures
On-line Installation
Re-Installation Notes
Top
Requirements
To run Clicktimizer from your website you will need to have:
- An Operating System (Win32,Unix,Mac,etc) capable of running
- Perl5.005 or higher
- A Web Server
- Version 4 browser with Javascript Enabled
- Javascript1.1 or better
Top
Pre-Installation Procedures
Before installing the program please make sure that the actions enumerated below have been performed.
We will refer to your installation directory as clickpro1.x (x is the version number eg clickpro1.3).
- Unzip or untar the downloaded archive file using either the
Tar extraction utility or
a zip utility for a zipped archive.
The tar command is tar -zvf clickpro1.x.tar.gz.
This creates a directory "clickpro1.3/" on your file system and contains the necessary distribution files.This can then be ftp-ed to your web servers
cgi-bin or any other directory capable of running perl and accessible over the internet (You should not need to use an ftp utility if you have telnet or direct access to your web server).
- Ensure all the .pl or .cgi files in the base directory and in the
clickpro1.x/clicktimizer directory have a reference to your servers perl executable
(usually "#!/usr/bin/perl").
- Make sure the clickpro1.x/logs directory is writeable.
- Ensure the clickpro1.x/config directory is writeable.You may use another writeable directory for extra security.
- Make sure the clickpro1.x/clicktimizer directory has been moved to another directory
outside of the distribution directory but accessible by the web server.
- Ensure the new-directory/clicktimizer/conf directory is writeable.
- Make sure the clickpro1.x/web directory has been moved to your web server's public directory.
Top
On-line Installation
You should now open your browser to the address of the distribution install (eg http://www.anywhere.com/cgi-bin/clickpro1.3/install.pl).
This should open an installation form which expects names of installation directories/folders and the registration number you
obtained with the distribution.The information required by the installation form is explained below:
| Installation Form Field |
Information Required |
| Path to clicktimizer directory |
This is the directory name of the clickpro1.x/clicktimizer.You
are required to move this directory to a directory outside the distribution
for security reasons.This directory contains the agent files and
runs independently of the distribution.
|
| Url to your clicktimizer directory |
The same as above with the full url to the clicktimizer directory as the path.
E.g http://www.anywhere.com/cgi-bin/clicktimizer/
|
| Url to your web directory |
If you remember copying some files to your public directory on your web server,
then you should specify the url to your public directory with the path to the /web/ directory
i.e http://www.anywhere.com/web/
|
| Path to your config directory |
You do not need to enter any details here.Users who are security conscious can move this directory (clickpro1.x/config) elsewhere on their
web site.If you do move this directory (clickpro1.x/config) please remember to set it as a writtable directory.
|
| Permission mode to access files |
This dictates the permission level and is synonymous with unix file permission settings. It is only valid on unix
servers is best set to 0600 for security reasons.
|
| Serial Number |
The registration number emailed to you when you purchased the software
|
| |
|
If the details you have provided are okay,the installation screen will display an OK button,Click
Submit when you see this
OK button and you should have a working installation.
Top
Re-Installation Notes
Clicktimizer can be re-installed at any time simply by going to the install.pl file and re-entering the details you
need for a configuration.
Please make sure you have a valid registration number or you will not be able to perfom the installation.
Most parameters will revert to their default values on a re-installation but your data should still be intact.(No popup object is lost).
If you wish to have a new installation, delete all the contents of the
clickpro1.x/config directory before re-installing the service.
Top
Service Configuration
Administrative Functions
The administrator of the service can customize several features related to the service.The administrator can make changes to his details and to
the properties available to him.These properties are explained in the
admin pages table below.
If you are the administrator, you are not allowed to logon more than 3 times unsuccessfully.If you do get locked out of the system
,you may retry again after 30 minutes or after the time set in the lockout period textfield of the admin pages has expired.
You can also set the session period which tells the service how long you may be away from the wizard before it logs out the
administrator.You should not normally set the logfiles to log.Use these feature if you wish to read the log files generated by service.
Please turn off logging in clicktimizer if you are running a live service as it will slow down the speed of page delivery.
Top
Wizard screens configuration notes
Major wizard screens are pages that are available from any of the tabs at the top of the configuration interface.The minor
wizard screens are only available form the animation select box on the options page.Please note that this select box is active, i.e
when you change the selected option the page will open another page.
|
Major Wizard Pages
|
Minor Wizard Pages
|
|
|
|
|
|
Top
Home Page Configuration
|
You can create,edit,copy,rename and delete popup windows from this page.The window alias is the name of the current popup window
you are configuring.You may select a new window to configure from the edit window select box.This box selects a new alias and then refreshes the page.
A Search box with a viewall button is provided to enable the administrator search and viewall the popups registered in the service
database.
You are also allowed to filter the popups on this page by the first alphabet of that popup's name.Clicking the checkbox
activates this function and selecting an alphabet from the filter alias selectbox will display all available names starting with
that alphabet.
The table below gives a listing of available functions on the Home page.
|
Label |
Funtion |
Settings |
Default |
Create a Window Configuration |
Type a name here to represent a new popup window instance(alias).It will
usually display the present alias under configuration |
Any name will do |
default |
Select A Delivery Type |
Create a multiple window or a single window |
Multiple or Single |
Single |
Choose A Window Alias To Edit |
Choose from a list of configured windows to edit page refreshes when you
choose | Any name in the database will do |
Last alias used |
Filter Alias by Alphabet |
Filter the names in the database by alphabet |
A-Z | The present
name's start alphabet |
Filter Alias |
Set to On to activate the filter | Off or On |
On |
Create Button |
Clicking on this button will create a new popup window alias |
| |
Edit Button | Clicking on
this button will start the edit process for the present popup window alias | |
|
Delete Button |
Clicking on this button will delete the present popup window alias |
|
|
Copy Button |
Clicking on this button will copy all the properties of the present alias to a new name of your choice |
|
|
Rename Button |
Clicking on this button will rename the present alias |
| |
Search Button |
Pressing this button searches for the
word in the search box
|
|
|
ViewAll Button |
Pressing this button displays all the aliases in the database |
|
|
|
|
|
|
Top
Option Page Configuration for Single Windows
|
The options page allows you to configure behavioural patterns for a popup object.You should read the table below for
information about these properties.
Hotspot: The Animation properties selectbox opens another page when you select Increase,Decrease or Movement.You may
need to wait up to 5 seconds for the page to refresh and load a new configuration page to store your options.
|
Label |
Funtion |
Settings |
Default |
Window Alias |
The alias use to decribe the popup window configuration |
Immutable |
The active alias |
Timeout |
The time to elapse before window is generated |
millisecs before window is generated |
100 |
Window Activation |
This decribes when you wish to launch the popup window.
Timed is the default, you set a time period after which the window is generated |
Timed,Page Entry,Page Exit,
Timed Page Exit,Mouse Click,
Timed Mouse Click,Keyboard,
Timed Keyboard,None |
Timed |
Pattern to use to deliver pages |
When it's regular,it's one url per popup.When in random mode you can choose
one of any number of urls. | Regular or Random |
Regular |
Operational Mode |
The type of action to use.
Can be Open where a popup window is generated or Stealth where a remote click is activated |
Stealth and Open | Open |
Animation Mode |
Set to None if you want no animation.
Set to Increment to increment the window.
Set to decrement to
decresase the size of the popup window.
Set to movement | None,Increment,
Decrement,Movement,
Fill Screen,Blink,
Minimize,Maximize |
None |
Close Activation |
This describes when you wish to close
the popup window.None is the default
|
Timed,Page Exit,
Timed Page Exit,Timed Mouse Click,
Timed Keyboard,None |
None |
Close Mode |
The action taken by the popup window when you activate the close action |
None,Close,Blur,
Timed Reopen |
None |
Save Button |
Pressing this button saves the contents of this page |
|
|
Reset Button |
Pressing this button resets the contents of this page to it's initial value |
|
|
|
|
|
|
Top
Windows Page Configuration
|
The windows page allows you to configure the windowing properties of a popup window.These are the options relating to
window height,width, and the position of the window.
You are also allowed to specify the window's available options like the statusbar,menubar,location,toolbars and the history
pages.
The table below describes the window options available for the popup configuration.
|
Label |
Function |
Settings |
Default |
Window Alias |
The alias representing the popup window under configuration |
Immutable |
The present alias |
Window Width |
The width of the popup window |
A number |
Null |
Window Height |
The height of the popup window |
A number | Null |
Window topleft x-coordinate |
The distance from the left side of
the caller window to the top left corner of the popup window
|
A number |
Null |
Window topleft y-coordinate |
The distance from the top side of the
caller window to the top left corner of the popup window
|
A number |
Null |
Window Options |
The window options available at creation time |
locationbar, toolbar, copyhistory, menubar, statusbar, resizeable,
scrollbars | None |
Save Button |
Pressing this button saves the contents of this page |
|
|
Reset Button |
Pressing this button resets the contents of this page to it's initial value |
|
|
|
|
|
|
Top
Data Page Configuration
|
The data page allows you to save and view the url to the alias.Simply enter the name of the popup window and click viewurl
to view a url,or if you are saving a url string,enter both the name of the popup and the Url you wish the popup to display when
activated.
The table below shows the properties available for configuring the data page.
|
Label |
Funtion |
Settings |
Default |
Popup Window Alias |
The alias to add or search into the database |
The present alias |
None |
Address to open |
The url to open up in the popup window |
The url you wish to popup |
None |
View Url Button |
Pressing this button reveals the url this alias pops up |
|
|
Continue Button |
Pressing this button takes you to the next stage |
|
|
Add Button |
Pressing this button saves the alias/Url pair in the service |
| |
Reset Button |
Pressing this button resets the contents of this page to it's initial value |
|
|
|
|
|
|
Top
Session Page Configuration
The session page allows you to configure several properties relating to when you wish to load a popup window.The options available
to the user varied and are explained in the table below.
The other terms to note are explained here
Classic: This response generates a popup window if either the ClickNumber,ClickRatio or the
sessional property is matched.
Sessional: This option generates a popup window if the sessional properties are matched and the Click Period is set to session
Random: This option generates
a popup window according to the Click Ratio in a random fashion
i.e. if a Click Ratio of 5 is set,a popup window is generated once
if the page is refreshed 5 times but with the window generation
occuring at any time a random seed is matched.
ClickNumber: This represents
the number of times a user has seen a page.If set it will display
a popup window when the set number is reached.It is differrent from
the Counter which counts the number of requests made for that popup
window object.
Counter: This represents the number of users who have requested a popup window object.It allows the administrator to deliver
popups to a certain percentage of total users.
Access Expiry: This indictates the agent will display a popup window when the access period has elasped
Daily: This indictates the agent will display a popup window once daily
Session: This indictates the agent will display a popup window once during a valid session
|
Label |
Funtion |
Settings |
Default |
Window creation control type |
The creation controls. Determines which method to use to analyse if a popup
should be displayed or not |
Classic,Sessional,Random,
ClickNumber,Counter |
Classic |
|
Maximum time Elasped
|
The maximum time to elaspe before this user can receive another popup |
Years,Months,Days,Hours,Mins |
0 |
Session Duration |
The average time you expect the user to stay on your website or maximum
period of inactivity by the user during which he or she can be considered to be a new user |
23 hours and 60 mins |
30mins |
Click Ratio |
The number of users to access page before page
is clicked or the number of times user has seen page before popup is displayed |
1-20 |
1 |
Click Period |
The period when this user becomes active or able to receive a popup
window | Access Expiry,Daily,Session |
Access Expiry |
Save Button |
Pressing this button saves the contents of this page |
| |
Reset Button |
Pressing this button resets the contents of this page to it's initial
value | |
|
|
|
|
|
Top
Admin Page Configuration
|
The administrative page allows you to change properties related to managing the service.The available options are listed
and explained in the table below.
|
Top
Option Page Configuration for Multiple Windows
|
The options page for multiple windows allows you to configure popup window activation and deactivation routines for the multiple
windows.Because a multiple window consists of several single windows,the properties you set here override the behavioural properties
of the individual windows except when stated otherwise.
The properties you set for the multiple windows options page are explained in the table below.
|
Label |
Funtion |
Settings |
Default |
Window Alias |
The alias used to describe the popup
window configuration
|
Immutable |
The active alias |
Timeout |
The time to elapse before window is generated |
millisecs before window is generated |
100 |
Window Activation |
This describes when you wish to launch
the popup window.Timed is the default, you set a time period after
which the window is generated
|
Timed,Page Entry,Page Exit,
Timed Page Exit,Mouse Click,
Timed Mouse Click,Keyboard,
Timed Keyboard,None |
Timed |
Close Activation |
This describes when you wish to close
the popup window.None is the default
|
Timed,Page Exit,
Timed Page Exit,Timed Mouse Click,
Timed Keyboard,None | None |
Close Mode | The
action taken by the popup window when you activate the close action | None,Close,Blur,
Timed Reopen |
None |
Save Button |
Pressing this button saves the contents of this page | |
|
Reset Button |
Pressing this button resets the contents of this page to it's initial value |
|
|
|
|
|
|
Top
Multiple Windows Page Configuration
| This page allows you to select the single popup window objects that
form a collection or a multiple window.
Simply select the single windows you wish to put in this collection and click the Add button.The popup windows belonging to this multiple
window are displayed on the right.You can also remove single popups from this collection.
|
Label |
Funtion |
Settings |
Default |
Window Alias |
Select an alias to edit |
Aliases of multiple popups |
The present alias |
Left Box |
Select any of the aliases in this box.Mulptiple selection is allowed |
Aliases of single popups |
None |
Right Box |
Select any of the aliases in this box.Mulptiple selection is allowed |
Aliases of single popups |
None |
Add Button |
Pressing this button adds the selected aliases |
|
|
Remove Button |
Pressing this button removes the selected aliases |
|
|
Back Button |
Pressing this button takes the user back |
|
|
Finish Button |
Pressing this button saves the contents of this page |
|
|
Reset Button |
Pressing this button resets the contents of this page to it's initial value |
|
|
|
|
|
|
Top
Demo Page Usage
|
The demo page allows you demonstrate the configured window.You may demonstrate a single or a multiple popup object from this page by clicking
on the demo button.
The page also allows you to filter and search for names of windows
you wish to demonstrate.
|
Label |
Funtion |
Settings |
Default |
Choose a window alias to demonstrate |
Select any of the windows to demo that alias |
All windows |
The present alias |
Filter Alias by Alphabet |
Filter the names in the database by alphabet |
A-Z |
The present name's start alphabet |
Filter Alias |
Set to On to activate the filter |
Off or On |
On |
Demo Button |
Pressing this button demonstrates the selected alias |
|
|
Cancel Button |
Pressing this button cancels the present operation |
|
|
ViewAll Button |
Pressing this button displays all the aliases in the database |
|
|
Search Button |
Pressing this button searches for the
word in the search box
|
|
|
|
|
|
|
Top
View and Search Page Usage
|
This page allows you view the names of registered popup objects in the service.The popups displayed are sorted alphabetically by name.
A search facility is also provided so you can seacrh by the name of the popup object.
|
Label |
Funtion |
Settings |
Default |
Demo Link |
Clicking this link demonstrates the window |
|
|
Edit Link |
Pressing this button edits the window represented by this alias |
|
|
Show Entry Switch |
Setting this selectbox determines the number of entries displayed |
|
|
ViewAll Button |
Pressing this button displays all the aliases in the database |
|
|
Search Button |
Pressing this button searches for the
word in the search box
|
|
|
Ok Button |
Pressing this button ends the present configuration process |
| |
|
|
|
|
Top
Move Window Page Configuration
|
The move window page is the gateway to the animation configurator. To use this unique feature you will have to select custom
from the direction settings of the page.
The page allows you to set direction,speed,timing and final position of a popup window that moves around the user's screen.
The user will always notice your advertisement if it moves across his screen.
You will find more information on configuring the move window page
in the table below. |
Label |
Funtion |
Settings |
Default |
Window Alias |
The present window alias under configuration |
Immutable |
None |
Screen Edge Offset |
The distance from the screen edge from the popup window's edge |
Number of pixels |
None |
Movement Pattern |
The animation pattern this popup window should exhibit |
Both,Horizontally,
Vertically,Custom |
Both |
Movement Speed |
The speed at which this window will be moved |
milliseconds | None |
X-Movement Size |
The amount by which the width of the window will be decreased |
Number of pixels |
None |
Y-Movement Size |
The amount by which the height of the window will be decreased |
Number of pixels |
None |
Final Window Position | The final position this window will occupy on the users screen |
center,top,
bottom,
Left,
Right,TopLeft,
TopRight,BottomLeft,
BottomRight |
Center |
Save Button |
Pressing this button saves the contents of this page |
|
|
Reset Button |
Pressing this button resets the contents of this page to it's initial value |
|
|
Cancel Button |
Pressing
this button cancels the present configuration and resets the database variables back to what they were. |
|
|
|
|
|
|
Top
Increment Window Page Configuration
|
The increment window page allows you to configure a window that increases in size as it opens.It is a feature which if properly used will
make your popup window more attractive to it's users.
You can configure properties related to this animation as explained in the table below.
|
Label |
Funtion |
Settings |
Default |
Window Alias |
The present window alias under configuration |
Immutable |
None |
Window Offset |
The distance from the screen edge of the popup windows edge |
Number of pixels |
None |
|
Increment Speed
|
The speed at which this window should be decreased |
milliseconds |
None |
Final Window Position |
The position this window will occupy on the users screen |
center,top,
Left,bottom,
Right,TopLeft,
TopRight,BottomLeft
,BottomRight | Center |
X-Increment Size |
The amount by which the width of the window will be increased |
Number of pixels |
None |
Y-Increment Size |
The amount by which the height of the window will be increased |
Number of pixels |
None |
Save Button |
Pressing this button saves the contents of this page |
| |
Reset Button |
Pressing this button resets the contents of this page to it's initial value |
| |
Cancel Button |
Pressing this button cancels the present configuration and resets the database variables back to what they were. |
|
|
|
|
|
|
Top
Decrement Window Page Configuration for Single Windows
|
|
The decrement window page allows you to configure a window that decreases in size as it opens.Please use this feature on windows that
are opened with sizeable heights and widths(The minimum size of a popup window is usually about 100,100).
You can configure properties related to this animation as explained in the table below.
|
Label |
Funtion |
Settings |
Default |
Window Alias |
The present window alias under configuration |
Immutable |
None |
Window Offset |
The distance from the screen edge of the popup windows edge |
Number of pixels |
None |
Decrement Speed |
The speed at which this window should be decreased |
milliseconds |
None |
Final Window Position |
The final position this window will occupy on the users screen |
center,top,
bottom,Left,
Right,TopLeft,
TopRight,BottomLeft,
BottomRight |
Center |
X-Increment Size |
The amount by which the width of the window will be decreased |
Number of pixels | None |
Y-Increment Size |
The amount by which the height of the window will be decreased |
Number of pixels |
None |
Save Button |
Pressing this button saves the contents of this page |
|
|
Reset Button |
Pressing this button resets the contents of this page to it's initial value |
|
|
Cancel Button |
Pressing this button
cancels the present configuration and resets the database variables back to what they were. |
|
|
|
|
|
|
Top
Custom Animate Window Page Configuration
|
The custom animate page allows the administrator to configure a movable popup window with controls.You can define animation steps
where the window performs first one action followed by as many steps as you can define.
The available actions are move,pause,stop,increment and decrement.The properties required by this actions can be entered from the popup window
which this page uses to collect information.
Read the table below for information on the properties required by this page.
|
Label |
Funtion |
Settings |
Default |
X start point |
Number of pixels from screen left edge |
Number |
None |
Y start point |
Number of pixels from screen top edge |
Number |
None |
X end point |
Number of pixels from screen left edge |
Number |
None |
Y end point |
Number of pixels from screen top edge |
Number |
None |
Total animation steps |
The total number of animation stages |
1-10 |
1 |
Save Button |
Pressing this button saves the contents of this page |
|
|
Edit Button |
Pressing this button edits the current animation properties |
|
|
Delete Button |
Pressing this button deletes the contents of this aniamtion |
|
|
Reset Button |
Pressing this button resets the contents of this page to it's initial value | | |
Cancel Button |
Pressing this button cancels the
present configuration and resets the database variables back to what they were. |
|
|
|
|
|
|
Top
View Multiple Windows Page Configuration
|
This page allows you to view the properties of the individually selected windows in a multiple window.
You can also remove an unwanted popup window object from this page.Or alternative edit the popup window object by clicking on the edit
button.
|
Label |
Funtion |
Settings |
Default |
Remove Button |
Pressing this button removes a single window from a multiple window group |
|
|
Edit Button |
Pressing this button edits the single window represented by this alias |
|
|
Ok Button |
Pressing this button ends the present configuration process |
|
|
|
|
|
|
Top
Conclusion
The configuration instructions given on this pages provide enough information to configure a popup window object of both single
and multiple type windows.
You should read the chapters relating to
site and revenue enhancement solutions and
managing configuration patterns
in Clicktimizer for details on further configuration attributes and optimizing your popup window campaigns.
Top
Remote Configuration with XML Data
Clicktimizer objects have an XML representation which is best described by the
CLickie Schema.
An example of this XML is shown below.It represents an advertiser from obeliskproperties.com who has decided to inundate you with two different
advertisements.The first one is a multiple window with 3 singular windows,it is known as "multitest" and encompasses
each singular window's properties is shown between the <popup> </popup> tags including the
other parameters needed by the window for a complete definition.You are
allowed to leave out definations of certain properties which the wizard
will usually replace with it's default values if it is necessary.
The second advertisement is a singular popup window object known as "singleseparate"
it has the same definition tags as the popup tag but is declared as a
<single> </single> tag.Notice the casthash statement at the end of the single
popup representations,this is necessary for the service to recognise what
type of popup window object it is creating.(Rodney Broom)
<?xml version="1.0" ?>
<clickad:document xmlns:clickad="http://www.clicktimizer.com/webservices/xml/autoconfig.xml"/>
<advert name=clickad1>
<owner value="obelisk properties"/>
<url value="http://www.obeliskproperties.com"/>
<multiple name=multitest>
<windows>trial3,trial4,trial5</windows>
<timeout name=multitest casthash>
<activatetimeout>100</activatetimeout>
<deactivatetimeout>0</deactivatetimeout>
<modetimeout>0</modetimeout>
<reactivatetimeout>0</reactivatetimeout>
</timeout>
<event name=multitest casthash>
<windowactivation>Timed Mouse Click</windowactivation>
<closeactivation>Timed Page Exit</closeactivation>
<closemode>Minimize All</closemode>
</event>
<session name=multitest casthash>
<controltype>Classic</controltype>
<elaspedtime>60000</elaspedtime>
<sessiontime>9000</sessiontime>
<clickperiod>Daily</clickperiod>
<click>1</click>
</session>
<popup name=trial4 casthash>
<timeout name=trial4 casthash>
<activatetimeout>100</activatetimeout>
<deactivatetimeout>30000</deactivatetimeout>
<modetimeout>5000</modetimeout>
<reactivatetimeout>0</reactivatetimeout>
</timeout>
<animation name=Movement casthash>
<offset>50</offset>
<speed>300</speed>
<xsize>20</xsize>
<ysize>20</ysize>
<position>Center</position>
<direction>Custom</direction>
<custom name=trial4 casthash>
<initialValue>0</initialValue>
<waitValue>0</waitValue>
<actionValue>displace:displace</actionValue>
<displaceValue>150,300</displaceValue>
<startValue>0,0</startValue>
<stopValue>150,300</stopValue>
<endValue>200,450</endValue>
<position>Center:Center</position>
</custom>
</animation>
<height>300</height>
<top>50</top>
<width>240</width>
<left>50</left>
<options>status</options>
<event name=trial4 casthash>
<windowactivation>Timed Mouse Click</windowactivation>
<closeactivation>Page Exit</closeactivation>
<closemode>Minimize</closemode>
</event>
<pattern>Regular</pattern>
<path value="http://www.altavista.com"></path>
<mode>Open</mode>
<session name=trial4 casthash>
<controltype>Classic</controltype>
<elaspedtime>7776000000</elaspedtime>
<sessiontime>960000</sessiontime>
<clickperiod>Access Expiry</clickperiod>
<click>1</click>
</session>
</popup>
<popup name=trial3 casthash>
<animation name=Increment casthash>
<offset>50</offset>
<speed>300</speed>
<xsize>20</xsize>
<ysize>20</ysize>
<position>Center</position>
</animation>
<timeout name=trial3 casthash>
<activatetimeout>100</activatetimeout>
<deactivatetimeout>0</deactivatetimeout>
<modetimeout>0</modetimeout>
<reactivatetimeout>0</reactivatetimeout>
</timeout>
<height>300</height>
<top>50</top>
<width>240</width>
<left>50</left>
<options>status,location,toolbars</options>
<pattern>Regular</pattern>
<event name=trial3 casthash>
<windowactivation>Timed Mouse Click</windowactivation>
<closeactivation>Page Exit</closeactivation>
<closemode>Minimize</closemode>
</event>
<path value="http://www.yahoo.com"></path>
<mode>Stealth</mode>
<session name=trial3 casthash>
<controltype>Classic</controltype>
<elaspedtime>7776000000</elaspedtime>
<sessiontime>960000</sessiontime>
<clickperiod>Access Expiry</clickperiod>
<click>1</click>
</session>
</popup>
<popup name=trial5 casthash>
<timeout name=trial5 casthash>
<activatetimeout>100</activatetimeout>
<deactivatetimeout>0</deactivatetimeout>
<modetimeout>0</modetimeout>
</timeout>
<height>500</height>
<top>70</top>
<width>640</width>
<left>100</left>
<animation name=Minimize casthash></animation>
<event name=singleseperate casthash>
<windowactivation>Timed Mouse Click</windowactivation>
<closeactivation>Page Exit</closeactivation>
<closemode>Minimize</closemode>
</close>
<options>scrollbars,status,location,toolbars</options>
<pattern>Random,Timed</pattern>
<path value="http://www.clicktimizer.com/"></path>
<path value="http://www.yahoo.com/"></path>
<path value="http://www.altavista.com/"></path>
<mode>Stealth</mode>
<session name=trial5 casthash>
<controltype>Classic</controltype>
<elaspedtime>7776000000</elaspedtime>
<sessiontime>960000</sessiontime>
<clickperiod>Access Expiry</clickperiod>
<click>5</click>
</session>
</popup>
</multiple>
<single name=singleseparate casthash>
<timeout name=singleseparate casthash>
<activatetimeout>100</activatetimeout>
<deactivatetimeout>0</deactivatetimeout>
<modetimeout>0</modetimeout>
</timeout>
<event name=singleseperate casthash>
<windowactivation>Timed Mouse Click</windowactivation>
<closeactivation>Page Exit</closeactivation>
<closemode>Minimize</closemode>
</event>
<animation name=Blink casthash></animation>
<height>500</height>
<top>70</top>
<width>640</width>
<left>100</left>
<options>status</options>
<pattern>Regular</pattern>
<path value="http://www.psitech.netfirms.com/"></path>
<mode>Open</mode>
<session name=singleseperate casthash>
<controltype>Classic</controltype>
<elaspedtime>4560000</elaspedtime>
<sessiontime>90000</sessiontime>
<clickperiod>Session</clickperiod>
<click>5</click>
</session>
</single>
</advert>
The table below lists the elements in the schema and describes the functionality delivered by each element.Some elements are available
within sub-elements of other types.The first letter of each xml element in the table is uppercased for easy viewing but it is actually all
lowercase in real life scenario except for the sub elements of the custom element
| XML Tag |
Tag Definition |
| Advert |
The opening tag for the xml data set.It describes the advertisement and gives it a qualified name.
The advertisement above is named clickad for reference purposes.
|
| Owner |
This describes the author or copyright owner of the advertisement.The copyright holder of the advertisement
above is a little known property development firm known as obelisk properties.
|
| Url |
The home url of the advertisement or popup owner.The xml above owned by obelisk properties has a
home url of http://www.obeliskproperties.com.
|
| Multiple |
The opening element name for a multiple popup configuration.It carries an attribute name which refers to the
name given to the popup object represented by this element within the service.
There is an additional attribute casthash,which we use at the end of elements that contain sub elements.
|
| Single |
The opening element name for a single popup configuration.It carries an attribute name which refers to the
name given to the popup object represented by this element within the service.
|
| Popup |
The opening element name for a single popup configuration which is a sub popup object of a multiple popup
object.
It carries an attribute name which refers to the name given to the popup object represented by this element within the service.
|
| Path |
The url which the popup object(window) opens on activation.There may be one or several paths to each popup
object.When using several paths,the pattern element must be set to random not regular or the popup will open the first path saved in the
service.
|
| Pattern |
The pattern element can be either of Regular or Random
|
| Mode |
The Mode can be either Open or Stealth.When in Open mode the popup or popunder is activated and displayed on the
website.
When operating in stealth mode the popup is not exposed to the reader but a stealth request is actuated from the host server which can be
used to trigger events or a request at the specified url or path.
|
| Options |
This describes the options available to a popup on window activation. This must be written as a comma seperated
list of options notably:
- location
- toolbars
- resizeable
- menubar
- copyhistory
- status
- scrollbars
You can use all or any of the listed options within the <options></options> tag of the xml data
|
| Height |
This specifies the height of the popup or popunder object under configuration.
|
| Width |
This specifies the width of the popup or popunder object under configuration.
|
| Left |
This refers to the distance from the left edge of the users screen
|
| Top |
This refers to the distance from the top edge of the users screen
|
| Timeout |
The timeout settings needed to activate or deactivate a popup object on a users screen.
|
| ActivationTimeout |
The time elasped before opening or activating a popup window object.This time is normally counted
from the moment the deactivation event is actuated
|
| DeactivationTimeout |
The time elasped before closing or deactivating or closing a popup window object.This time is normally counted
from the moment the deactivation event is actuated
|
| ModeTimeout |
The time elasped before performing an action activated by the deactivation process e.g a popup may launch a
timed reopen on deactivation.This time is normally counted from the moment the deactivation event is actuated
|
| ReactivationTimeout |
The time elasped before performing an action activated by the deactivation process e.g a popup may go into
blink mode on deactivation.This time is normally counted from the moment the deactivation event is actuated
|
| Event |
The element which determines the events which the Request Optimization Agent listens to on a users page.The major events listened to are:
- Window Entry
- Window Exit
- Mouse Down
- Mouse Up
- Mouse Click
- KeyPress
- KeyDown
- KeyUp
The mouse and keyboard events are grouped together but can also be timed i.e a pause period can be introduced between the time when the event
is fired and the time when the popup activation or deactivation takes place.
|
| WindowActivation |
This determines when the popup object is activated.This can be one of:
- Timed
- Keyboard
- Timed Keyboard
- Page Entry
- Page Exit
- Timed Page Exit
- Mouse Click
- Time Mouse Click
- None
|
| CloseActivation |
This determines when the popup object is deactivated.This can be one of:
- Timed
- Timed Keyboard
- Page Exit
- Timed Page Exit
- Time Mouse Click
- None
|
| CloseMode |
This determines the action taken by the Request Optimization Agent when the popup object is deactivated.This can be one of:
- Close
- Minimize
- Maximize
- Timed Reopen
- None
|
| Animation |
This element defines the animation properties available to the popup object
|
| Offset |
This element describes the distance of the animated popup from the screen edges.
|
| Speed |
This element describes the speed at which the animation is rendered.It is normally measured in milliseconds
|
| Xsize |
The move,increment or decrement size of the popup window width
|
| Ysize |
The move,increment or decrement size of the popup window height
|
| Position |
The final position of the popup window after the animation has completed.Presently the available positions are:
- Center
- Top
- Bottom
- Left
- Right
- TopLeft
- TopRight
- BottomLeft
- BottomRight
|
| Direction |
The direction element used as a sub-element of an animation element can be one of:
- Both
- Horizontally
- Vertically
- Custom
|
| Custom |
This element defines the properties available to a custom animation configuration.
|
| InitialValue |
This sub-element defines the total types of actions taken by the popup window during the animation process.The
actions are seperated by a semi colon e.g displace:pause:displace represents a move action followed by a pause, then further
movement.
|
| ActionValue |
This sub-element defines the type of action taken by the popup window during a single step of animation.The
possible actions are:
- displace
- pause
- stop
- decrease
- increase
|
| WaitValue |
This sub-element defines the time in milliseconds to pause an animation
|
| DisplaceValue |
This sub-element defines the total distance moved by the popup window during an animation.
|
| StopValue |
This sub-element defines the stop point of the popup window after movement during an animation
|
| StartValue |
This sub-element defines the start point of the popup window during an animation
|
| EndValue |
This sub-element defines the end point of the popup window during an animation
|
| Session |
The session element defines the sessional properties available to the popup object
|
| ControlType |
The controlType element defines the session control applied to the popup on display.It can be one of:
- Classic
- Random
- ClickNumber
- Session
- Counter
|
| ElaspedTime |
This defines the time elasped from the last time the user accessed a Request Optimization Agent enabled
page.This time is expressed in milliseconds.
|
| SessionTime |
This defines the session time from the first time the user accessed a Request Optimization Agent enabled
page on that day.This time is expressed in milliseconds.
|
| ClickPeriod |
This element describes the initilisation factor to consider when activating a popup campaign.It can be one of:
- Access Expiry
- Daily
- Session
|
| Click |
This element defines the number of times a user should have accessed an optimization agent enabled web page
before receiving a popup campaign.
|
| |
|
If you wish to remotely configure Clicktimizer services across the web, you will need to create an XML page with syntax
resembling that shown above.You will not be able to deploy it to another Clicktimizer service without
Clicktimizer AutoConfig1.1.
Contact
customer services if you require this product.
Top
Web Access methods and Syntaxes
To use Clicktimizer from your website or from affiliate websites,you will need to write a single line
statement into your web pages.This statement can take several forms depending on your web server or on
the access method that you use.
While we prefer you use a server side include(SSI),it is a well known fact this method does not work from external sites
but some web servers/application servers will actually process an external call to a server side include.
If you use clicktimizer only from your web server please use a server side include as it guarantees the fastest access time
to a server process.The form of this include syntax for Apache web servers placed between the <head> and </head> is as shown below:
<!--#include virtual="/cgi-bin/clicktimizer/ctz.pl?sctype=server&pwntype=CLickieName">
The CLickieName parameter at the end of this statement is an anagram for the popup window alias(the name of the popup window
as it is known to the service.Each popup window has an alias by which is known in to service ).
The other way to access Clicktimizer is by using Javascript placed between the <head> and </head> tags of your
web page.The syntax for this sort of inline call is as shown below:
<SCRIPT LANGUAGE="JAVASCRIPT" SRC="http://www.YourDomainName.com/cgi-bin/Path_Clicktimizer_Agent/ctz.pl?sctype=jscp&pwntype=CLickieName">
</SCRIPT>
If you wish to automatically tack additional query strings into the url displayed by the popup window,( useful for creating individual url strings for affiliates), you must
use the extended syntax.
The extended syntax request that you add another name value pair to the javascript code as shown below:
<!--#include virtual="/cgi-bin/clicktimizer/ctz.pl?sctype=server&pwntype=CLickieName&std=true&extraname1=extravalue1&extraname2=extravalue2">
or for external calls to the Request Optimization Agent:
<SCRIPT LANGUAGE="JAVASCRIPT" SRC="http://www.YourDomainName.com/cgi-bin/Path_Clicktimizer_Agent/ctz.pl?sctype=jscp&pwntype=CLickieName&std=true&extraname1=extravalue1&extraname2=extravalue2">
</SCRIPT>
Notice the name/value pair known as
std.If it is set to true(lowercase), it means a question mark
(?) is appended to the url inputted on the data page of the configuration wizard followed by the rest of the query string e.g for a
generated popup window pointing to
http://www.test.com/test.html, the final popup url is:
http://www.test.com/test.html?extraname1=extravalue1&extraname2=extravalue2...extraname(n)=extravalue(n).
if std is set to false(lowercase),then an ampersand
(&) is appended to the the url inputted on the data page of the configuration wizard followed by the rest of the query string e.g for a
generated popup window pointing to
http://www.test.com/test.html?ask=jeeves, the final popup url is:
http://www.test.com/test.html?ask=jeeves&extraname1=extravalue1&extraname2=extravalue2...extraname(n)=extravalue(n).
The interpretations for the whole of the javascript is as shown below:
| Syntax Term |
Term Definition |
YourDomainName |
Your domain name e.g clicktimizer.com.
|
Path_To_Clicktimizer_Agent |
The path to your clicktimizer agent files.
|
sctype |
if sctype=server, then we are using a form of server side include, if sctype=jscp,the service is in Javascript mode.
|
pwntype |
Requires you to provide the alias or name of the popup window object
you wish to use on that page. |
std |
An indicator which tells the agent to append extra name value pairs to the url displayed to the user.If set to "true", then a question mark (?)
is inserted to the popup url before adding the extra query string.If set to "false", then an ampersand (&) is inserted after the generated popup window's url
before displaying the extra query string.
|
| |
|
There are other ways of accessing clicktimizer.The important thing to remember is that if you do not use Javascript mode
simply change the query string on the url to reflect the name of the popup window you wish to use.We have successfully called
Clicktimizer with php by using the syntax below:
<?php
virtual="/cgi-bin/clicktimizer/ctz.pl?sctype=server&pwntype=CLickieName";
?>
Please note that all query string variables apart from the name of the popup object must be lower case and that the call must be made between the <head> and </head> tags of your
web page.
You do not need any extraordinary lines of code to configure and use your popup windows just that line of code and
access to your configuration interface(Wizard).Placing any of these lines into a web page will activate your request optimization agent
and the web page visitor will be monitored by the request optimization agent.
Top
Security Considerations
Clicktimizer enforces security at several points within the service.The
administrators details are encrypted using RSA Data security procedures
while sensitive data is not available to anyone but the administrator.
The databases running behind the system are available only to the web service and are not declared to be accessible by any other means but
via the service.
The request optimization agent does not affect the security of any website from which it is used in any way.
The agent does not respond to any other calls and cannot write external data to the system,it does not possess any extra
security features but maintains the integrity of secure data resident on the system.
While the service is considered to be very secure,users are advised to
write to us should they notice
any security breaches within the service.
Top
Managing Configuration Patterns In Clicktimizer
Top
The Configuration Process
The configuration process begins on the home page.The administrator creates a new popup window object by typeing a name in the
object name textfield selecting either multiple or single from the delivery type textfield and clicking on the create button.The page
then loads an options page where the adminstrator can continue the configuration process.
The home page allows the administrator to create,edit,delete,copy,rename,search and viewall the popup window objects registered
in the service.The wizard interface automatically loads a new page to be configured as soon as the administrator clicks on save.
Certain page configurations usually the animation pages allow the administrator to configure the particular page and then sends
the administrator back to the originating page.In such circumstances the administrator must click on the save button to get to the
next stage of the configuration process.A full configuration will always return the administrator to the home page.
Top
Setting Session Patterns
To create session patterns the administrator must set the following parameters:
- Window Creation Control Type: This can be any one of the following:
- Counter: The number of users accessing the agent is matched against the click ratio e.g one popup window per five users.
- ClickNumber: The number of times this user has accessed the agent is matched against the click ratio e.g one popup window per five accesses.
- Random: A random popup window is shown to the user once during accesses of the click number e.g if the click ratio is set to 5, then a popup campaign
is delivered once randomly at any time before or at the fifth count.
- Sessional: A popup window delivery based on the session duration properties set up for that alias or name delivered by agent.
- Classic: A popup window delivery based on a logical match of any of Counter,ClickNumber or Sessional as defined in the window creation control property.
- Maximum Time Elasped: The last time this user encountered the request optimization agent.
- Session Duration: The amount of time a user is accepted as been valid within an agent enabled cyberspace.
- Click Ratio: A number representing the number of counts that should be taken before a popup window is generated.
- Click Period: The property which specifies when a popup window should be generated.The following properties are available:
- Access Expiry: Generate a popup window when the Counter or ClickNumber or Time Elasped properties of the window creation control type has expired or reached the preset click ratio number.
- Daily: Generate a popup window once a day for this user.
- Session: Generate a popup window once during a valid session.
The administrator of the Clicktimizer service should familiarize himeself/herself with the available patterns whilst utilizing known website user
statistics to create optimized patterns.
Top
Creating Randomly Generated Windows
The administrator can create randomly generated windows by setting the window creation control type to random in the session
configuration page.The administrator must then set the click ratio to a suitable number.This implies that a popup
will be generated once during the preset number.
Top
Creating Random Urls
To create randomly generated urls, simply select random from the pattern to use to deliver pages selectbox on the options page
and then input a comma seperated list of urls into the url textfield of the data page.
Top
Hotspot Select Boxes
The hotspot boxes refresh the page when a default action is performed,most are listed below:
- Filter Aliases by alphabet.
- Filter Aliases checkbox.
Both are available on the home page and on the demo page.
- The choose an alias selectbox on the home page.
- The animation mode selectbox on the options page.
- Most timed activation selects will popup a time entry dialog.
- The movement pattern selectbox on the movement animation page.
- Changing the window alias from the multiple windows page will refresh the page.
The adminstrator should wait for a page refresh from any of these hotspots especially where there are bandwidth limitations.
Top
Site and Revenue Enhancement Solutions
Top
Reopening Windows After A Preset Period
By setting the Close Mode to Timed Reopen in the options page or in the multiple options page, the popup object is closed and then re-initialized
after the time preset for this mode.
When setting a timed re-open the administrator should bear in mind that the window to be re-opened is the same one as was opened from the
present page.You should use this option if you wish to remind the user of a particular product after a preset time. Reduce the time
before a reopen to less than 15mins as the user is not guaranteed to be online after this period.
Top
Optimizing Stealth Requests
A stealth request can be made from a page to another url as defined in the popup objects properties.You can also set up a multiple
popup object which refers to a couple of singular popup objects one or more of which may operate in stealth mode.
The implications are that you will have actually made several requests to different url's with a single access from an
agent enabled page.
Top
Pop Under Windows
The administrator can set up a popunder window from the options page.The popunder window is opened behind the window currently
in focus and will be seen by the user after he or she minimizes or closes the currently active window.
Top
Using Page Events To Trigger Popup Campaigns
User page events can be used to trigger popup and popunder windows.This triggering can be timed ( a period of time to wait before activating the popup or popunder window),
currently the possible choices relate to the following:
- Mouse Clicks
- Keyboard Press
- Page Entry
- Page Exit
Any of these options can be used on its own or in timed mode to activate a popup.
Typical Scenarios
- You can activate a popup object using a Keyboard action or timed Keyboard action on a page with a form for gathering user information.
The act of entering values in any of the form fields will trigger the agent,combining this action with time will render the action invisible to the
user.Do make sure that the timeline you have set into a timed keyboard is not more than 15 secs as most users will submit the page and negate
the popup activation.
- You can also do the same with a mouse click which will be activated when a link is clicked.A feature of the agent makes it possible to
activate the popup object long after the user has left the page.In Internet explorer4, and above a mouse click on any sector of the page will
activate a popup object.
- Page entry activation will activate the popup object as soon as the page is loaded.The timed page entry will introduce an element of time
into popup activation.The time period should be set to a period which is dependent on the average time spent by a user on that page.
Affiliate providers should set a time period of less than a minute as most web pages will load within 30 secs and the user may click a link
within 30 secs.
- Page exit activation offers a better chance of display to your consumers.A timed page exit will spawn a popup window after the expiration
of the time period setup in it's properties.A typical viral scenario uses a timed page exit from a popup window with instructions to respawn
the same page after a preset time.The user may shut down the page only to have the same page popup after the preset period is over.
Top
Effective User Tracking Solutions
A typical user on a web page enabled with the Request Optimization Agent is effectively a tracked user.As the user trawls the internet
interacting with the ROA, the agent may chose to display a popup object if the user has met the criteria set for the popup object name
in the database.
The administrator of the service can set up a popup campaign based on several criteria e.g:
- The time spent by the user on the site
- The last time the user was on the site
- The number of times a particular page has been accessed
- The number of times a user has accessed a certain page
- The period of time from site user's last visit to a page
- A random index specified by the site administrator
- A daily advertisement delivery for regular users
A page in this instance refers to any request optimization agent enabled page which refers to the same popup campaign.It may reside
on any web server across the internet but it will relate to each user individually because of the agent's knowledge of
the particular user.
Top
Using Multiple Windows To Deliver Solutions
A multiple window campaign will always generate several popup windows.It is best that a time period is set in between generation of
each window ( i.e the generation of each singular window should be timed in such a way that the windows do not popup at the same time to
save resources ).It is also prefered that a multiple window display should not use maximum sizes for each window and that the
position of each individual window be taken into consideration.
A good multiple window campaign should take most of these factors into consideration and the designers of this campaign should
note that a well design advertisement will always awaken the user's interest in their products.
Top
Animation Patterns and Solutions
Clicktimizer allows the administrator some predefined animation modes (increment,decrement,movement,blink,fullscreen,popunder,maximize).The following scenarios describe
some possible ways of maximizing this functions:
- An increment window popup campaign attached to a link will popup a window which incrementally increases to display your campaign.
- A decrement window popup campaign which decrements the window to a banner sized window showing off a banner.
- A moving window which zips across the user's screen to constantly remind him of updates to his favorite web site.
- A blink action can be used to bring a window into focus every couple of minutes.
- A fullscreen display can be used to take over a user's screen, setting a short time period on a timed close activation should close
this window after a preset period.The alternative is to have a button or a link in the window to close this window eg:
<a href="javascript:self.close()">A Link</a>.
- A popunder window to open up behind the scenes.
- A maximized window to grab the focus on the user's screen,replacing the user's current window but not closing the original window.
You may come up with other novel ways of catching the web site users attention using this animation patterns.The custom animation
page which is accessible from the movement animation page.
Top
Summary
Clicktimizer offers the best strategy for using popup windows to
deliver targeted advertisement to your website visitors,it creates traffic
on any site that runs the service,offers unprecedented revenue advantage
and allows user tracking across several websites.
It is a tool which it's developers know will enable site owners to propagate
their products,services and ideas and later versions will be built to
accommodate varied interests and their demands for faster and better software
services.
An enterprise version is in our labs undergoing development and will address issues related to database management,multi-user interfaces,
affiliate registration and direct XML configuration.
For news of updates to the product please go to our
website where you will
find software updates to the service.
Top
Glossary of Terms
