.. 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