Differences

This shows you the differences between two versions of the page.

--- te3:incoming:standard [2014/11/26 06:28] – created moderator
+++ te3:incoming:standard [2016/05/06 09:05] – moderator
@@ Line 1: / Line 1: @@
+====== Incoming tracking ======
 ~~NOTOC~~
-====== Standard incoming tracking ======
+To configure “incoming traffic” tracking on your site, you'll have to add a special tracking code on all pages that receive traffic (index page and all sub pages). If you are switching from a different script and have a running site, you can safely add TE3 tracking code in addition to the existing code - both scripts will track incoming traffic simultaneously.
+----
+===== 1. Standard incoming tracking =====
 Standard incoming tracking is simple to setup:
-===== PHP extension =====
+==== 1.1. PHP extension ====
 Add the tracking code below to all your ''<nowiki>.php</nowiki>'' pages that receive traffic. Add it inside the ''<nowiki><head> </head></nowiki>'' tag. The "include" command will most likely work for everyone.
@@ Line 10: / Line 17: @@
 <code>include("/FULL/PATH/TO/public_html/your_te3_directory/in.php");</code>
-++++ Tracking code with your full path already included | We have already prepared the code with your actual full path, public html and directory - navigate to [[te3:admin_panel#Header|Main header]], select "System info" from the {{:te3:maintenance_logo.png?nolink|}} Maintenance-drop down menu and copy-paste your code.
+++++ Tracking code with your full path already included | We have already prepared the code with your actual full path, public html and directory - navigate to [[te3:admin_panel#Header|Main header]], select [[te3:system_info|System info]] from the {{:te3:maintenance_logo.png?nolink|}} Maintenance-drop down menu and copy-paste your code.
 ++++
 ----
-===== SSI extension =====
+==== 1.2. SSI extension ====
 Add the tracking code below to all your ''<nowiki>.shtml</nowiki>'' pages that receive traffic. Add it inside the ''<nowiki><head> </head></nowiki>'' tag.
@@ Line 26: / Line 33: @@
 ++++ Tracking code with your directory name already included |
-We have already prepared the code with your actual directory name - navigate to [[te3:admin_panel#Header|Main header]], select "System info" from the {{:te3:maintenance_logo.png?nolink|}} Maintenance-drop down menu and copy-paste your code.
+We have already prepared the code with your actual directory name - navigate to [[te3:admin_panel#Header|Main header]], select [[te3:system_info|System info]] from the {{:te3:maintenance_logo.png?nolink|}} Maintenance-drop down menu and copy-paste your code.
 ++++
+----
+===== 2. JavaScript tracking =====
+This method is applicable in two situations:
+++++ 2.1. If you are using caching - Wordpress users (Super Cache, Total Cache), Nginx caching, etc. |
+**Configuration for Wordpress users:**
+  - Install TE3 and Wordpress. \\ \\
+  - Open your current theme ''header.php'' file (usually found in ''wp-content/themes/THEMENAME/header.php'' location). \\ \\
+  - To set up incoming tracking place the following code after the <body> tag and rename ''domain.com'' to your actual domain name: \\ \\ <code javascript>
+<script type="text/javascript">
+<!--
+function getquery(n) {
+    var half = location.search.split(n+'=')[1];
+    return half ? decodeURIComponent(half.split('&')[0]):null;
+}
+function te3_js_tracking() {
+    // parameters to be changed
+    var domain = 'domain.com/te3/'; // domain with TE3 dir, e.g. domain.com/te3/
+    var docref = parent.document.referrer;
+    var ref= getquery('ref');
+    var rnd = Math.floor(Math.random() * 99999999);
+    if(!docref) docref='none';
+    if(!ref) ref='';
+    docref=encodeURIComponent(docref);
+    document.write('<div style=\"display: none;\"><img src=\"http://'+domain+'in.php?p=default&ref='+ref+'&rnd='+rnd+'&rImg=1&refremote='+docref+'\" width=\"1\" height=\"1\" border=\"0\"></div>');
+}
+te3_js_tracking();
+// -->
+</script>
+</code>
+  - Adjust "domain" variable in the ''te3_js_tracking()'' function. \\ \\
+  - Test it to see if traffic is being counted correctly. Point your browser to a page where you have placed the tracking code and check TE3 stats to see if it was counted.
+**Note:** \\
+We have already prepared the code with your actual full path, public html and directory - navigate to [[te3:admin_panel#Header|Main header]], select [[te3:system_info|System info]] from the {{:te3:maintenance_logo.png?nolink|}} Maintenance-drop down menu and copy-paste your JavaScript incoming tracking code.
+++++
+++++ 2.2. It allows you to install TE3 on sub.domain.com (separated server) and trade traffic on domain.com (primary server). |
+If you either can't or don't want to install TE3 on your primary server, remote incoming tracking might be a solution for you. This method allows you to install TE3 on ''sub.domain.com'' (separated server) and trade traffic on ''domain.com'' (primary server).
+**Configuration:**
+  - Install TE3 on ''sub.domain.com'' on your secondary server. \\ \\
+  - Add remote tracking code (copy paste from the frame below) to all your pages on ''domain.com'' that receive traffic. \\ \\ <code javascript>
+<script type="text/javascript">
+<!--
+function getquery(n) {
+      var half = location.search.split(n+'=')[1];
+      return half ? decodeURIComponent(half.split('&')[0]):null;
+}
+function te3_remote_track() {
+    // parameters to be changed
+    var domain = 'sub.domain.com', // te3 domain
+        path = 'te3', // te3 path
+        preventfrom = 'domain.com'; // prevent double track from domain.com
+    var docref = parent.document.referrer,
+        ref= getquery('ref'),
+        rnd = Math.floor(Math.random() * 99999999);
+    if(!docref) docref='none';
+    if(!ref) ref='';
+    docref=encodeURIComponent(docref);
+    document.write('<div style="display: none;"><img src=\"http://'+domain+'/'+path+'/in.php?p=default&rImg=1&preventfrom='+preventfrom+'&ref='+ref+'&rnd='+rnd+'&refremote='+docref+'\" width=\"0\" height=\"0\" border=\"0\"></div>');
+}
+te3_remote_track();
+// -->
+</script>
+</code>
+  - Adjust "domain", "path" and "preventfrom" variables in the ''te3_remote_track()'' function. \\ \\
+  - Test it to see if traffic is being counted correctly. Point your browser to a page where you have placed remote tracking code and check TE3 stats to see if it was counted.
+++++
+<WRAP caution>
+Javascript tracking method is less accurate than standard incoming tracking, therefore it should only be considered, if there is absolutely no other option.
+</WRAP>
+ \\ \\  \\ \\  \\ \\  \\ \\  \\ \\
+Ko/ce bomo v TE docs dodali se pages and rediretions!
+<WRAP caution>
+There are some downsides though. Rotating multiple index pages and redirecting surfers is not possible. Traffic tracking is also less accurate. Javascript incoming tracking method should only be considered, if there is absolutely no other option.
+</WRAP>