Developed by Bendersky Maxim (C) 2001, www.remlo.noonet.ru
Tested and documented by Rusin Alexander (C) 2001
English translation by Sheremet Dmitry (C) 2001
--------------------------------------------------------------------------
Count your visitors !
--------------------------------------------------------------------------


RCounter v1.0 Multiplatform / FREE! (09.11.2001)

  - Product homepage: www.rcounter.noonet.ru
  - English version
  - Tested on Windows NT, FreeBSD, Linux
  - Powered by "ESF BDMS" (DataLinX compliant)



    G E N E R A L   N O T E S



Annotation:
---------
RCounter is a system for gathering and reviewing statistics, analysis of
web-site attendance (and separate web-pages).

The basic functions and advantages of the system:

 - a plenty of diverse kinds of statistics (hits, hosts totally and by dates,
   unique IP-addresses, "where from" statistics);
 - support of statistics on separate pages of a large site;
 - access to statistics (review) through  Internet;
 - set-up of the RCounter system through Internet (Web-access);
 - storage of site statistics in the separate database completely belonging
   to a site owner;
 - support of "skin" technology for counter appearance setting on the site,
   capability to disable show of the counter on the site;

The special advantage of the system is the reliable registration of site
attendance. As RCounter is placed on the same server, as the site contents,
- a visitor who opens the site  "is inevitably counted" unlike other counters
and rating systems, for example, Rambler which by virtue of the congestion
periodically is unavailable and "skips" some part of your site visits. 


--------------------------------------------------------------------------
C O N T E N T S :
------------------

1. Dear user!
2. "Why RCounter?" - distinctive features of the system
3. Functions, purpose, general description of the RCounter system
4. About the program developers and used technologies
5. Plans about improving the system
6. Other useful documentation, Internet-resources, addresses


--------------------------------------------------------------------------
1. Dear user!
--------------------------

Today, we represent to your attention the first version of the RCounter system.
The RCounter system has various effective functions which, we hope, will be
useful to you and will open new management capabilities of web-projects. 

The system is improving continuously and you can send us your offers and
remarks about the general system work, system problems, new system functions
which you would like to see in RCounter and etc.

The RCounter system is developed permanently in various directions. In the
near future we are going to:
 - Increase the number of kinds of statistics;
 - Construct diagrams;
 - Increase the number of  "skins";
 - Open the rating web-page of sites using RCounter.

You always can supplement this list! 

The remarks, offers and general thoughts about RCounter, please, send
remlo@noonet.ru 

Do not forget to visit RCounter home page - www.rcounter.noonet.ru - here
you can find new versions of the system, news and future plans, fresh "skins"
and other useful information about RCounter.

To all authors of the letters written to us, we promise to send the next
version of the program within 7 (seven) days from the moment of its issue! 

Thank you for choosing the RCounter system!


--------------------------------------------------------------------------
2. "Why RCounter?" - distinctive features of the system
--------------------------

You may ask yourself - Why should I use exactly this new product?
Especially, when there are many analogs on the market, in which the similar
problems have already solved. Such question is lawful for the RCounter system.
In this chapter you can find answers for such questions, which certain will
allow you to make right choice - whether it is necessary to use RCounter or
it is possible to work with more simple approaches.

Main advantages of the RCounter system

 1.  Many kinds of gathered statistics.
 2.  Statistics for separate pages of the site.
 3.  "Where from" statistics.
 4.  Rights on the statistic base.
 5.  Access limitation to statistics.
 6.  Editing the statistic base.
 7.  Quality of count of visits.
 8.  Possibility of skin editing (creation).
 9.  Ignoring "debug" site visits.
 10. Handy representation of statistics.

More detailed description of the RCounter advantages you can see on the
special document: WhyRCounter.doc


--------------------------------------------------------------------------
3. Functions, purpose, general description of the RCounter system
--------------------------

RCounter is a system for gathering and reviewing statistics, analysis of
web-site visits as well as separate web-page ones.

The basic functions of the system: 

 - Gathering of different kinds of visit statistics of your site as a whole
   and by separate pages;
 - Optional display of the counter picture on arbitrary pages of the site;
   flexible setting of displayed picture (skin technology);
 - Set-up of the counter and review of statistics via the Internet
   (web-access);
 - Storage of your site statistics in the separate database completely
   belonging to you (to the site owner).

The basic possibilities, which RCounter gives you:

 - To control visit level of your site, in proper time to find out visit
   growth or falling;

 - To analyze your site audience (for example - what percent of the unique
   site visitors, how audience has grown, what percent of the visitors comes
   back to your site);

 - To show or not to show the counter on your site pages (only you make a
   decision on it and you can change it at any moment); at displaying the
   counter on your site - you can adjust its appearance without any problem;

 - To optimize structure and contents of your site - making it more attractive
   (this possibility is given by "statistics of separate pages", which can
   help you to make important conclusions about what it is necessary to
   correct/optimize for increasing visits of separate pages and your site
   as a whole);

 - To possess the base of statistics completely. You can correct, copy,
   transfer from server to server or even delete it.


General description of the system 
--------------------------

The RCounter system consists of several applications and set of the
documentation. The basic applications of the system (counter.exe and
counter.cgi) are installed on the web-server (see Install.doc).
If you set-up the system correctly -  the RCounter  system will gather
visit statistics, which allows analyzing your site visitors and evaluating
attractiveness of various pages. In the documentation you can find all
aspects of operation with the system, its possibilities and even some
details about  data formats and parameters of requests. The separate
document is wholly devoted to the analysis of statistics assembled by
RCounter applications. Here you can find the recommendations for research
of your site audience, some brief articles and interesting conclusions
of the authors, which were obtained during testing the system and visit
analysis of "experimental" sites (www.noonet.ru and others).

In the code of your site it is necessary to place calls of one of the basic
system applications (counter.exe). Thus, you can use the display mode of the
counter - in that case, the counter picture will appear on site pages and
it will have the number of the visitors who have visited your site. You are
free not to use  the counter displaying mode - thus, on your site anything
superfluous will not be displayed and the application, called from your site,
will register only visitors (conduct statistics) for the subsequent analysis.

When you use the counter displaying mode on your site - you can adjust its
appearance very flexibly. It is achieved by support of skin technology.
You can use one of several standard skins, delivered in the product package
or develop your own skin. You can also get new skins on www.rcounter.noonet.ru.

After placing the RCounter system on a web-server and inserting calls of the
counter in the code of your site - the application of the system will conduct
automatically visit statistics. All kinds of statistics are gathered or
calculated automatically. All what you should do - do not forget to insert
calls of the counter in new pages of your site. Also, there are some settings
which have an impact on statistics gathering in the system, but originally
you may don't use them - just use the default settings, hereinafter you
always can change them (it is in detail described in the separate chapter).

The system gathers statistics in the separate database, formed automatically,
especially for your site (at the moment of the first start of the system
web-application). It is a big advantage of the RCounter system over analogs
and competitors. You are the rightful owner of the database with statistics 
- you can transfer it on other server, make a backup copy of the base, edit
the information in the base, and even completely delete the database. Thus,
you will not infringe someone's information, as each RCounter database
contains statistics on one and only one site. And nobody can spoil your base
and get access to it (except cases of server cracking and unauthorized access
to your site code). The aspects of safety and confidentiality of your site
statistics are in detail considered in Install.doc.

For obtaining and analyzing statistics, gathered the system, it is not
necessary for you to work directly with the database and with the help of
any sophisticated means to extract the necessary information from it.
For this purpose, there is a special application in the RCounter system,
which also is installed on the web-server and allows you to receive all
kinds of statistics in the form of a usual web-page (via the Internet).
For access to this page you need to enter the special address (URL),
which depends on the site name and the web-server settings. After input
of this address in the usual Internet-browser - you will see a page,
on which the part of statistics is indicated and there will be references
to pages with the extended information. By the way, with the help of the
same application you can carry out set-up of the counter parameters and
skin installation. Thus, practically all kinds of operations with the
RCounter system you can carry out "not leaving a browser ".

Gathering statistics by separate pages of your site is another very important
ability of "RCounter". It is one of exclusive functions of the system, partly
for the sake of it the authors have carried out development of  "RCounter",
not finding free useful analogues with this possibility. Gathering statistics
by separate pages of your site means, that the system conducts some kinds
of statistics on your site as a whole, and some - including on each separate
page of your site. It allows you to find the answers to the very important
questions originating at the analysis of your site visitors:
 - What page is the most visited from all site pages? 
 - At general increase of visitors - what page is getting the most popular?
 - At general decrease of visitors - what page is getting the less popular?
 - From what page to what do the visitors carry out transition?
 - On what page (what pages) does the majority of your visitors your site
   stop viewing?

The large part of the document, in which the methods and recommendations for
the analysis of your site visitors are described, is devoted to questions
connected to the analysis (the comparative analysis) of visits of separate
pages. These kinds of statistics allow you not simply to answer on some
separate questions, but let you make the important conclusions and optimize
both structure of your site and its contents. So, it makes your site more
attractive and helps to increase visits of both separate pages and your
site as a whole.

There is a very important setting - Skip-list for increasing of statistics
quality in the RCounter system. It is a list of IP-addresses, the visits
from which should completely be ignored. It is recommended to bring computer
addresses of those employees, who conduct development/debugging of your site
in the given list. As they very frequently go on your site (and update its
pages) during their work - they are not "normal visitors" - so, the account
of their visits infringes correctness of your statistics. Adding IP-addresses
of their computers in the Skip-list completely solves this problem (after
that, RCounter will ignore their visits, not representing them in any kinds
of statistics).

In addition to the foregoing, it is necessary to mention one of service
possibilities of the system. You can "overcounter" statistics of your site
(for the moment, only by several parameters). This possibility is realized
mainly for the case, when you have already accumulated visits, which have
been registered by other system of gathering statistics. And you would like
to "transfer" your past statistics to the RCounter base. So, in this case,
the statistics of your site will begin to be counted not from zero, but from
the defined value accumulated earlier. It not the most important function of
the system, but it is rather useful to the owners of existing sites, which
have accumulated visits.


Kinds of statistics
--------------------------

The RCounter system of the described version carries out gathering/calculation
of the following kinds of statistics:
 - Total hit count of all site.
 - Total host count of all site.
 - Total count of unique visitors (unique IP-addresses), visited your site.
 - Total count of different URL-addresses, with which the transition was
   carried out to your site. 
 - Total count of hits/hosts (today and yesterday).
 - For each unique visitor (IP-address) - the number of visitor's hits/hosts
   and time of the last visit.
 - For each page of your site (registered in the system) - total count of
   hits on it and time of the last visit.
 - Calendar statistics (most detailed statistics of your site). For each day
   - total hit count on each of site pages, total count of site hits/hosts.
   The greatest number of hits is calculated by one of site pages for each
   day; the greatest number of hits is calculated by each page within a month;
   the average number of hits by each page within a month; total count of
   hits/hosts for one month. The calendar statistics is conducted by a month,
   but the information is stored concerning all time of the site existence
   and the statistics of the previous months is always available.
 - "Where from" statistics - list of addresses (URL), from which the
   transition was carried out to your site. For each address - total count
   of transitions on your site and time of the last transition.

Note: 

 1. Hit - a one show of any site page to any visitor.
 2. Host - a one show of any site page to a new site visitor - who was not
    on your site (on any page) during the certain space of time (by default
    - 12 hours).


--------------------------------------------------------------------------
4. About the program developers and used technologies
--------------------------
 
RCounter, version 1.0, 09.11.2001, FREEWARE

(C) 2001 Bendersky M, remlo@noonet.ru 
I thank Rusin Alexander and Sheremet Dmitry for the help in product creation.

RCounter home page - www.rcounter.noonet.ru.

The product is developed with using "DataLinX" technology
(www.noolab.ru/projects/datalinx.htm).

"ESF Inside" DBMS is used in the product
(www.noolab.ru/products/esffamily/esfinside.htm).


--------------------------------------------------------------------------
5. Plans about improving the system
--------------------------

The developers of the RCounter system plan to develop it in the following
directions and realize the following improvements:

 - Display of geographical distribution of site visitors;
 - Using graphs (diagrams) for reviewing statistics;
 - Account and display of distribution of visitors according to the time of
   day;
 - Open the rating of sites using RCounter pages (participation of sites
   in the rating at desire of site owners) on www.rcounter.noonet.ru; 
 - Account of enclosure of site pages, count of total parameters for groups
   of pages (by site sections);
 - Preparation and issue of statistic report in the form of Excel tables;
 - Writing detailed log-files with information about visits of sites
   (optional).


--------------------------------------------------------------------------
6. Other useful documentation, Internet-resources, addresses
--------------------------

Please, visit www.rcounter.noonet.ru to find other documentation and articles
about the RCounter product, new product versions, add-ons, and plug-ins as
well as free version of the product and some examples of its usage.

Some references to the RCounter documentation:
--------------------------
 1. Product structure. "Contents.doc" is in the root directory of the product.
 2. License and warranties. License.doc is in the root directory of the
    product.

Some Internet-resources:
--------------------------
 1. www.rcounter.noonet.ru - Internet-site of the RCounter product
 2. www.noonet.ru & www.noonet.ru/eng - Internet-studio NooNet (our
    web-hosting provider, thank them for a lot of help and useful consulting).

Electronic addresses:
--------------------------
 
 - Maxim Bendersky - remlo@noonet.ru
 - Alexander Rusin - amfora@lvs.ru. 
 - NooNet studio noonet@noonet.ru 


--------------------------------------------------------------------------

   RCounter v1.0 multiplatform. FREE             www.rcounter.noonet.ru
   Count your visitors!
   GENERAL NOTES

   Developed by Bendersky Maxim c 2001
   Tested and documented by Rusin Alexander c 2001
   English translation by Sheremet Dmitry c 2001
   November 09, 2001.

