.. You may want to use the usual include line. Uncomment and adjust the path. 
.. include:: ../Includes.txt


===========
EXT: Cookie
===========

:Author:
      Kasper Skårhøj

:Created:
      2002-11-01T00:32:00

:Changed by:
      Michael Fritz

:Changed:
      2009-12-03T17:52:25.650000000

:Classification:
      Cookie Tracking

:Description:
      Powered by http://www.marit.ag

:Author:
      Michael Fritz

:Email:
      michael.fritz@marit.ag

:Info 4:
      http://www.marit.ag

:Language:
      en


|img-1| |img-2| EXT: Cookie - Cookie Tracking


.. _EXT-Cookie:

EXT: Cookie
===========

Extension Key: Cookie Tracking

Language: en

Keywords:

Copyright 2009, Michael Fritz, <michael.fritz@marit.ag>

`http://www.marit.ag/ <http://www.marit.ag/>`_

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

.. _Table-of-Contents:

Table of Contents
-----------------

`EXT: Cookie 1 <#1.EXT:%20Cookie|outline>`_

**`Introduction 3 <#1.1.Introduction|outline>`_**

`What does it do? 3 <#1.1.1.What%20does%20it%20do_|outline>`_

`What will be tracked? 3
<#1.1.2.What%20will%20be%20tracked_|outline>`_

**`Installation 4 <#1.2.Installation|outline>`_**


.. _Introduction:

Introduction
------------


.. _What-does-it-do:

What does it do?
^^^^^^^^^^^^^^^^

This extension finds search engine traffic and store the search terms
in a cookie (yahoo, google, bing.com, web.de, ask.com). Its also
possible to track one or more url params as a campaign marker.

This extension is quite useful if you're processing the cookie data
afterwards e.g. in a shop, to track where the buyer came from.

This extension can be one part of a patchwork. It doesn't do anything
valuable for people who don't code by themselves.


.. _What-will-be-tracked:

What will be tracked?
^^^^^^^^^^^^^^^^^^^^^

The Cookie stores all referrer in following format:

google.com\|keyword1 keyword2\|123456789 (= referrer Marker\|Keyword
strings if defined\|timestamp of action)

What referrers will be tracked?

From:

- google.\* with Keywords

- Ask.com with Keywords

- yahoo.\* with keywords

- web.de with keywords

- Defined URL Param as: campaignParam\|value-of-the-param\|123456789

- Other specified refferer will be tracked, but just as
  otherReferrer\|\|123456789

- Direct Access, if referrer is blank

Multiple referrers are stored seperated by a ';'.

The cookie is valid for 31 days.


.. _Installation:

Installation
------------

- Install the Extension

- Check for the constants
  
  - Is jQuery already loaded?
  
  - Load it by google.jsapi or from static resources
  
  - cookie.jquery.js and jquery.getUrlParam.js have to be loaded
  
  - Domain part have to be defined (in regexp style)
  
  - Records with possible params should be defined. You can assign a
    record to every level of your page tree in order to track that
    specific parameter in this branch. All parameters will be inherited to
    subpages of all levels.

|img-3|

For one request only one referrer can be tracked at the same time. The
priority is:

Custom params (these params can have a priority within all custom
params as well – see graphic below)

SERPS (Bing, Google, Ask, web.de, yahoo.com)

Other Externals

Direct

`But if you flag a param not as an referrer, there can be several
simultaneous actions to be tracked to the cookie. <http://webempowered
church.com/support/howtos/single/install_an_extension/>`_

#include following jQuery-stuff

#jquery 1.3 via google jsapi

include.jQuery.jsapi = 0

#jquery 1.3 from extension directory

include.jQuery.base = 1

#lib jquery.cookie.js

include.jQuery.cookie = 1

#lib jquery.getUrlParam.js

include.jQuery.getUrlParam = 1

#domain part to determine all internal referers (js regex style,
replace . by \.)

internalRefPart = banquo\.de

4


.. ######CUTTER_MARK_IMAGES######

.. |img-1| image:: img-1.png
.. :align: left

.. |img-2| image:: img-2.png
.. :border: 0
.. :height: 21
.. :hspace: 9
.. :id: Grafik2
.. :name: Grafik2
.. :width: 87

.. |img-3| image:: img-3.png
.. :align: left
.. :border: 0
.. :height: 134
.. :id: Grafik1
.. :name: Grafik1
.. :width: 515