Difference between revisions of "NATS4 track and strack"

From TMM Wiki
Jump to navigationJump to search
Line 2: Line 2:
 
| show_reporting_admin_section = true
 
| show_reporting_admin_section = true
 
}}
 
}}
 
This article explains the purpose and usage of the strack feature.
 
  
 
== What is Track? ==
 
== What is Track? ==
In NATS, primary tracking for in-bound affiliate traffic is handled by
+
[[NATS]] uses the ''track'' feature in order to handle primary tracking for in-bound affiliate traffic. This can usually be found in affiliate link codes, such as the following example:
the ''track'' feature, usually found in affiliate link codes:
 
  
 
<pre>
 
<pre>
Line 13: Line 10:
 
</pre>
 
</pre>
  
In the above link, NATS replaces ''<link_domain>'' with the actual
+
In the above link, [[NATS]] will replace ''<link_domain>'' with the actual link domain for your site and replace ''xxxxxxx'' with the proper affiliate [[Getting_The_NATSCode|NATS code]]. This can be seen in the following image:
link domain for the site and replaces ''xxxxxx'' with the affiliate NATS
 
code. See the example in figure 1.1.
 
  
 
[[File:Members_linkcodes_example.jpg|450 px|Figure 1.1  An Example link code using the standard track feature]]
 
[[File:Members_linkcodes_example.jpg|450 px|Figure 1.1  An Example link code using the standard track feature]]
  
As surfers hit track, NATS performs its tracking, cookie, and session
+
As [[Ct#Surfer|surfers]] hit the track link, [[NATS]] will perform its tracking, cookie, and session procedures before redirecting the surfer to their original destination tour URL from the [[NATS4 Sites Admin|sites admin]]. The NATS code itself, or the link domain (if no NATS code is present) will be used by NATS to match a [[Link Domain|link domain]] or site id to the correct tour URL.
procedures, before redirecting the surfer to their destination tour URL
 
from the sites admin. The NATS code itself or the link domain (if no
 
NATS code is present) are used by NATS to match a link domain or site id
 
to the correct tour URL.
 
  
 
== What is strack? ==
 
== What is strack? ==
In contrast, strack replaces one site ID or program ID with another site
+
In contrast to ''track'', ''strack'' replaces one site ID or program ID with another site or program ID. If you need to provide links from one [[NATS]] site to another, for example, you can use ''/strack/'' to replace the default site ID in the NATS code with a new site ID for the other site. This also serves the purpose of preserving relevant affiliate information, as well as ensuring that affiliates get credit for any sales that have been made.
or program ID. For example, if you need to provide links from one NATS
 
site to another, you can use ''/strack/'' to replace the site ID in the
 
NATS code with the new site ID for the other site -- while preserving
 
affiliate information and ensuring affiliates get credit for any sales.
 
  
 
== strack Formatting ==
 
== strack Formatting ==
Line 37: Line 24:
 
</pre>
 
</pre>
  
* ''linkdomain'' is the link domain of the site in NATS, usually something like tour.example.com or join.example.com, where example.com is the domain of your main tour or content site
+
* '''linkdomain''' is the link domain of the site in NATS, which will usually be something like tour.example.com or join.example.com, where example.com is the domain of your main tour or content site
* ''nats_code'' is the NATS code from your affiliate or the default NATS code for the site.  Normally this is available to you on a PHP-enabled site by usage of this in-line PHP if statement -- <code><?=$_REQUEST[nats]?$_REQUEST[nats]:xxxxxx?></code>  -- which translates to ''if there is a value for nats set in either GET, POST, or Cookie, use that value. Otherwise, use the default value provided (which is different for every site)''
+
 
* ''site_id_or_shortname'' is the ID number or shortname of the desired site. This is the target site and may be different than the site currently being visited. You may use a value of 0 to indicate that you do not wish to override the site ID number with a new one
+
* '''nats_code''' is the NATS code from your affiliate or the default NATS code for the site.  Normally this is available to you on a PHP-enabled site through the usage of the following in-line PHP if statement -- <code><?=$_REQUEST[nats]?$_REQUEST[nats]:xxxxxx?></code>  -- which translates to "If there is a value for NATS set in either GET, POST, or Cookie, use that value. Otherwise, use the default value provided (which is different for every site)."
* ''tour_id_or_shortname'' is the ID number of shortname of the desired tour. This is the target tour and may be different than the site currently being visited. You will need to have the siteid set to the site that this tour is available on.
+
 
* ''program_id_or_shortname'' is the ID number or shortname of the desired program. You can use this to switch one program to another. Switching programs is useful for special offer links. If you do not wish to change the program, set this value to 0
+
* '''site_id_or_shortname''' is the ID number or shortname of your desired site. This variable represents the target site and may be different than the site currently being viewed. If you wish to indicate that you do not want to override the site ID number with a new one, you can use the value of 0 as the site ID.
* ''track_flag'' when set to 1, counts this hit as a new hit and resets the tracking cookie
+
 
* ''optional_subdirectory_path'' specifies a path to a specific script, document, or subdirectory that is added onto the end of the URL after the tracking redirect. For example, if your sites main tour URL in the NATS sites admin is www.example.com and you pass in /tour1/videos, it will add /tour1/videos to end of the URL after redirecting
+
* '''tour_id_or_shortname''' is the ID number or shortname of your desired tour. This is the target tour and may be different than the site currently being viewed. You will need to have the site ID set to the site that your tour is available on to use this variable.
 +
 
 +
* '''program_id_or_shortname''' is the ID number or shortname of the desired program. You can use this variable to switch from one program to another in your [[NATS]]. Switching programs can be useful for things such as special offer links. If you do not wish to change the program, set this value to 0.
 +
 
 +
* '''track_flag''' when set to 1, this hit will be counted as a new hit and thus reset the tracking cookie.
 +
 
 +
* '''optional_subdirectory_path''' specifies a path to a specific script, document, or subdirectory that is added onto the end of the URL after the tracking redirect. For example, if your site's main tour URL in the [[NATS4 Sites Admin|Sites Admin]] is www.example.com and you pass in /tour1/videos, it will add /tour1/videos to end of the URL after redirecting the surfer.
  
 
[[Category:DHUPDATE]]
 
[[Category:DHUPDATE]]

Revision as of 16:53, 26 July 2010

NATS 4
Reporting Admin
The Reporting Admin
track and strack
Fraud Reports
Members Admin
The Members Admin
View Member Details
Add Member
MySQL Auth
Mod Authn DB
Multisite Access
Member Logging
Member Password Retrieval
OpenID Connect
Mod Auth OpenIDC
ID Numbers

What is Track?

NATS uses the track feature in order to handle primary tracking for in-bound affiliate traffic. This can usually be found in affiliate link codes, such as the following example:

http://<link_domain>/track/xxxxxxx

In the above link, NATS will replace <link_domain> with the actual link domain for your site and replace xxxxxxx with the proper affiliate NATS code. This can be seen in the following image:

Figure 1.1 An Example link code using the standard track feature

As surfers hit the track link, NATS will perform its tracking, cookie, and session procedures before redirecting the surfer to their original destination tour URL from the sites admin. The NATS code itself, or the link domain (if no NATS code is present) will be used by NATS to match a link domain or site id to the correct tour URL.

What is strack?

In contrast to track, strack replaces one site ID or program ID with another site or program ID. If you need to provide links from one NATS site to another, for example, you can use /strack/ to replace the default site ID in the NATS code with a new site ID for the other site. This also serves the purpose of preserving relevant affiliate information, as well as ensuring that affiliates get credit for any sales that have been made.

strack Formatting

http://<linkdomain>/strack/<nats_code>/<site_id_or_shortname>:<tour_id_or_shortname>/<program_id_or_shortname>/<track_flag>/<optional_subdirectory_path>/
  • linkdomain is the link domain of the site in NATS, which will usually be something like tour.example.com or join.example.com, where example.com is the domain of your main tour or content site
  • nats_code is the NATS code from your affiliate or the default NATS code for the site. Normally this is available to you on a PHP-enabled site through the usage of the following in-line PHP if statement -- <?=$_REQUEST[nats]?$_REQUEST[nats]:xxxxxx?> -- which translates to "If there is a value for NATS set in either GET, POST, or Cookie, use that value. Otherwise, use the default value provided (which is different for every site)."
  • site_id_or_shortname is the ID number or shortname of your desired site. This variable represents the target site and may be different than the site currently being viewed. If you wish to indicate that you do not want to override the site ID number with a new one, you can use the value of 0 as the site ID.
  • tour_id_or_shortname is the ID number or shortname of your desired tour. This is the target tour and may be different than the site currently being viewed. You will need to have the site ID set to the site that your tour is available on to use this variable.
  • program_id_or_shortname is the ID number or shortname of the desired program. You can use this variable to switch from one program to another in your NATS. Switching programs can be useful for things such as special offer links. If you do not wish to change the program, set this value to 0.
  • track_flag when set to 1, this hit will be counted as a new hit and thus reset the tracking cookie.
  • optional_subdirectory_path specifies a path to a specific script, document, or subdirectory that is added onto the end of the URL after the tracking redirect. For example, if your site's main tour URL in the Sites Admin is www.example.com and you pass in /tour1/videos, it will add /tour1/videos to end of the URL after redirecting the surfer.