.. You may want to use the usual include line. Uncomment and adjust the path.
.. include:: ../Includes.txt
======================
EXT: Affiliate Tracker
======================
:Author:
Suman Debnath
:Created:
2006-06-03T11:07:22
:Changed by:
Suman Debnath
:Changed:
2006-06-03T11:15:05
:Author:
Suman Debnath
.. _EXT-Affiliate-Tracker:
EXT: Affiliate Tracker
======================
Extension Key: **affiliate\_tracker**
Copyright: 2005 Cannonbose, LLC < `cannonbose.com
`_ >
Author: , < `suman@srijan.in `_ >
This document is published under the Open Content License
available from http://www.opencontent.org/opl.shtml
The content of this document is related to TYPO3
\- a GNU/GPL CMS/Framework available from www.typo3.com
.. _Table-of-Contents:
Table of Contents
-----------------
**Introduction 1**
**Installation & Configuration 1**
**How to use 2**
.. _Introduction:
Introduction
------------
This Typo3 extension is an affiliate and reporting system that tracks
affiliate codes for incoming web visitors. The primary functions of
the extension:
Records affiliate codes for visitors to the site.
Records the source and index codes associated with an affiliate code
Generates reports both in downloadable CSV format and direct display
in web page in the Typo3 back end depending upon different parameters
supplied.
.. _Installation-Configuration:
Installation & Configuration
----------------------------
Follow normal installation procedure via the extension manager. On
successful installation, a text box with label 'Sysfolder PID' will be
shown in the extension information page. Enter the page id where you
want to store the tracking data for the extension. Preferably this
should be the page where the sponsor data are stored.
|img-1|
|img-2|
If you are using the extension RealURL, you need to configure the
same. The extension accepts the URL parameter 'tac' as the source
code, so you will need to add 'tac' to the RealURL configuration.
.. _How-to-use:
How to use
----------
**Visitor Tracking**
Tracking of visitors happen automatically. Affiliate codes for
sponsors can be create from the sponsor record itself.
|img-3|
You can also create affiliate codes independently. However, it won't
have any effect until it is associated with a sponsor within the
sponsor record.
|img-4|
A Affiliate code can be any non zero number.
**Reporting**
To generate reports, go to the Functions module in the back end and
click on the page where the tracking data is stored. In the selector
menu, there is an item 'Affiliate Data'. Click on it to load the
reporting tool.
|img-5|
Various options are available in the reporting tool:
Report Type: Here you can select the type of the report i.e. Summary
or Details. If this is unselected, the tool will generate individual
listing of tracking data.
View Type: Here you can select the kind of view you want i.e. Daily or
Monthly. If report type is not selected, this does not have any
effect.
Sponsors: Here you can select the sponsor for whom you want the
report. Only those sponsors for whom there is corresponding tracking
data will appear here.
Referrer: Here you can select the referrer URL for whom you want the
report. Only those URLs for whom there is corresponding tracking data
will appear here.
Start Date / End Date: With these you can control the time boundaries
of the report. The format of the date has to be 'mm/dd/yyyy' i.e. a
date like 20 July, 2005 will have to be entered as 07/20/2005.
View Data: On clicking this button, the report will be shown in page.
Download as CSV: On clicking this button, the report will be
downloaded in CSV format.
The look and organization of this page can be changed by editing the
templates which are located in the 'res' sub folder of the extension
directory. However, care should be taken to preserve the placeholder
tags in the template during such editing.
.. ######CUTTER_MARK_IMAGES######
.. |img-1| image:: img-1.jpeg
.. :align: left
.. :border: 0
.. :height: 284
.. :id: graphics1
.. :name: graphics1
.. :width: 520
.. |img-2| image:: img-2.jpeg
.. :align: left
.. :border: 0
.. :height: 286
.. :id: graphics2
.. :name: graphics2
.. :width: 519
.. |img-3| image:: img-3.jpeg
.. :align: left
.. :border: 0
.. :height: 277
.. :id: graphics3
.. :name: graphics3
.. :width: 409
.. |img-4| image:: img-4.jpeg
.. :align: left
.. :border: 0
.. :height: 87
.. :id: graphics4
.. :name: graphics4
.. :width: 444
.. |img-5| image:: img-5.jpeg
.. :align: left
.. :border: 0
.. :height: 203
.. :id: graphics5
.. :name: graphics5
.. :width: 481