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