Custom Tracking Code Generator

Our Custom Tracking Code Generator allows you to customize certain variables in the tracking of visitors to your site.  

These values are determined from years of experience with digital analytics best practices and client feedback.  None of these will need to be changed, in most cases.  Although they can easily be customized if needed.

Here is a summary of each available customization field.

Window Property Name

This affects how you call the tracking methods from the page's javaScript.  If you decide to name your Window Property 'foo', you would create JavaScript functions using the format; foo.setTrackingFile(),  or foo.saveMarketingVariables().

Tracking File Path and Name

By default this is /agf.gif, but if you decide to save the tracking file as something different, for any reason,  you can set the new path and name here.  For example if I saved the tracking gif as foobar.gif, in the /resources directory I would replace this field with /resources/foobar.gif.  This tells the tracking code where to request the tracking gif from. 

Hostname for Tracking Requests

Some site administrators will host certain files under a different hostname for any reason.  If you have a different hostname where you stored the tracking gif (agf.gif be default), you can set the hostname here.  This tells the tracking code on which server to look for the tracking gif.

Query Delimiter

This sets the character that separates the page request from the query parameters.  By default this is a '?' and you usually always see this in web server logs.  But you can change this if your web server does things differently.

Additional Cookies to Include

If your site creates other cookies that are stored in the browser during a session you can tell the Angelfish tracking code to search for and include these cookies in the tracking gif request query parameters.  This can allow you to see more detail in the reporting interface.

Organic Referrers

This is a list of organic referrer hostnames and the query parameter that denotes the search terms used.  For example Google organic search uses 'q=' for the search term query parameter, so in the list here you will see 'google:q'.  You can add other organic referrers to the list if they are not already included using the same pattern.

When to Use HTTPS

You're options are Auto, Always, and Never.  This tells the tracking code whether and when to use secure https protocol when transferring the tracking code data.

Query Parameters to Exclude

This allows you the remove certain query parameters from the tracking gif request when it is sent, and therefore not record these query parameters in the log for that page/site.  

Marketing Query Parameters

Source - The referring source where the visitor same from.

Medium - The medium references the mode the visit came from, such as email, blog, newsletter, etc.

Name - This is the name of the marketing effort, like banner-ad, 

Keyword - Any keywords that were used when the visitor searched for or linked to your site.


Overwrite Marketing Variables

The marketing variables can be overwritten according to specific guidelines.  Most of the time you will not need to change this setting, but  if needed you can have the tracking code never overwrite the variables, or only overwrite them when a marketing variable is present in the visit query parameter.

Session Info Cookie Name

This is the name of the tracking cookie which serves as the session timeout tracker.  This can be renamed for any reason.

User Defined Variable Cookie Name

A User Defined Variable is used for another custom query parameter that can be tracked.  Use this default name if you want to add a User Defined Variable, or change the variable name, here, if you already have a variable you wish to track.

Path to Save Tracking Cookies

Tracking cookies are saved by default in the root (/) cookie path.  You can adjust this to save the cookies in a different directory if needed.

Domain to Store Cookies Under

This is the domain name the cookies are associated with when stored.  Change this if you need the cookies to be associated with a site name other than the one creating the cookies.

Session Timeout Length

This setting controls how long a browsing session will last.  Inactivity beyond this value in minutes will cause the session timeout cookie to be reloaded as a new value.  Changing this to have visitor sessions last longer will possibly reduce the calculated number of visits to the site.  Changing this to have visitor sessions become shorter will possibly increase the calculated number of visits to the site.

Visitor Retention Length

[This assumes the cookie does not get deleted by the user or browser] 
This setting controls the visitor cookie.  Inactivity beyond this value in days will cause the visitor id to be reloaded with a new value, for that visitor.  A shorter range will possibly increase the calculated number of unique visitors, a longer range will possibly decrease the calculated number of unique visitors.

Visitor Transfer Query Parameter

This is the parameter used to transfer visitor information across domains.  The receiving domain will see these query parameters and fill in visitor information from them, enabling cross-domain visitor tracking.

Was this article helpful?
0 out of 0 found this helpful


Article is closed for comments.