Difference between revisions of "NATS4 LinkCodes"

From TMM Wiki
Jump to navigationJump to search
 
(17 intermediate revisions by 3 users not shown)
Line 5: Line 5:
 
__TOC__
 
__TOC__
  
−
[[Ct#Link Code|Link Codes]] are how [[Ct#Affiliate|affiliates]] get credit for the traffic they redirect through [[NATS]]. To get an affiliate link code, click the Link Codes link under "Affiliate Quick Links."
+
A [[Common Terms#Link Code|linkcode]] is a referral [http://en.wikipedia.org/wiki/Uniform_Resource_Locator URL] tracked by [[Common Terms#NATS|NATS]]. Linkcodes are how [[Ct#Affiliate|affiliates]] get credit for the traffic they redirect through [[NATS]]. To get an affiliate link code, click the Linkcodes link under "Affiliate Quick Links."
  
 
There are three types of link codes that [[NATS]] will recognize:
 
There are three types of link codes that [[NATS]] will recognize:
Line 19: Line 19:
 
[[Image:NATS4_Encoded_Linkcode.jpg|frame|500px|center||||Figure 1.1 - Link Codes Explained]]
 
[[Image:NATS4_Encoded_Linkcode.jpg|frame|500px|center||||Figure 1.1 - Link Codes Explained]]
  
−
Encoded link codes are the most common variety of link code seen in [[NATS]]. All of the information required by [[NATS]] to tie an affiliate to a surfer is located in the string of characters at the end, which are '''''base64-encoded'''''. The last part of the sample URL is known as the NATS Code, which has multiple uses in [[NATS]].
+
Encoded link codes are the most common variety of link code seen in [[NATS]]. All of the information required by [[NATS]] to tie an affiliate to a surfer is located in the string of characters at the end, which are '''''base64-encoded'''''.  
  
−
For more information on what a link domain is, please visit our [[Link Domain]] article. For the variations on track, please see our [[NATS4 track and strack|track and strack]] article. For how to obtain a NATS Code, please see our [[Getting The NATSCode]] article.
+
*[[Link Domain]]
 +
*[[NATS4 track and strack|Track]]
 +
*[[NATS4 NATSCode|NATSCode]]
  
 
== Unencoded Link Codes ==
 
== Unencoded Link Codes ==
Line 29: Line 31:
 
Un-encoded link codes display a period-delimited list of all information that would be in an encoded string within your URL. This is an alternate way to display affiliate link codes; the following example will break down what is displayed in an un-encoded link code.
 
Un-encoded link codes display a period-delimited list of all information that would be in an encoded string within your URL. This is an alternate way to display affiliate link codes; the following example will break down what is displayed in an un-encoded link code.
  
−
*'''Affiliate Username''' - The username of the affiliate who referred this surfer
+
*'''[[Link Domain]]''' – This is often the third level domain of the tour site that is actually a server alias to your NATS install. It is necessary for proper cookie tracking and surfer appeal.
−
*'''Programid''' - The numeric id of the program that the surfer's transaction will be paid out under (See [[#Things to Remember|Things to Remember]])
+
*'''Affiliate Username''' - The username of the affiliate who referred this surfer.
−
*'''Siteid''' - The numeric id of the NATS site your surfer is trying to visit
+
*'''[[NATS4 track and strack|Track]]''' – The alias to the NATS tracking script you are using. Variations include track, ttrack, strack, qtrack, and gallery.
−
*'''Tourid''' - The numeric id of the site's tour that your surfer will be redirected to (See [[NATS4 Sites Admin|Sites Admin]] for details)
+
*'''Programid''' - The numeric ID of the program that the surfer's transaction will be paid out under (See [[#Things to Remember|Things to Remember]])
 +
*'''Siteid''' - The numeric ID of the NATS site your surfer is trying to visit.
 +
*'''Tourid''' - The numeric ID of the site's tour that your surfer will be redirected to (See [[NATS4 Sites Admin|Sites Admin]] for details)
 
*'''Affiliate Campaignid''' - The numeric id of the campaign associated with the affiliate (0 = the default campaign for that affiliate)
 
*'''Affiliate Campaignid''' - The numeric id of the campaign associated with the affiliate (0 = the default campaign for that affiliate)
−
*'''Adtoolid''' - If the surfer followed a link code associated with an [[ct#Adtool|adtool]], this will represent the numeric id of the adtool the surfer saw.  If no adtool was used, this will default to 0
+
*'''Adtoolid''' - If the surfer followed a link code associated with an [[ct#Adtool|adtool]], this will represent the numeric id of the adtool the surfer saw.  If no adtool was used, this will default to 0.
−
*'''Subid1 & Subid2''' - (See explanation above)
+
*'''Subid1''' - This is used for extra tracking needed by some special adtool types, such as gallery builder.
 +
*'''Subid2''' - This is available for custom use.
  
 
== Shortname Link Codes ==
 
== Shortname Link Codes ==
Line 46: Line 51:
  
 
Encoded link codes can be decoded using base64 decoding, which uses ASCII characters and binary to encode/decode links. For the admins, we built a page that allows for creating/decoding NATS code. The URL should be <nowiki>http://<NATS_URL>.com/admin_codes.php</nowiki>. The affiliates also have a page that is not shown by default. The URL should be <nowiki>http://<NATS_URL>.com/internal.php?page=code_info</nowiki>.
 
Encoded link codes can be decoded using base64 decoding, which uses ASCII characters and binary to encode/decode links. For the admins, we built a page that allows for creating/decoding NATS code. The URL should be <nowiki>http://<NATS_URL>.com/admin_codes.php</nowiki>. The affiliates also have a page that is not shown by default. The URL should be <nowiki>http://<NATS_URL>.com/internal.php?page=code_info</nowiki>.
 +
 +
For more information, see our [[NATS4 NATSCode#Decoding a NatsCode|NatsCode]] wiki.
  
 
== Things to Remember ==
 
== Things to Remember ==
Line 57: Line 64:
 
Affiliates can link directly to a NATS [[Common Terms#Pre-Join Page|pre-join page]] by appending ''/join'' to a [[ct#Linkcode|linkcode]].  For example:
 
Affiliates can link directly to a NATS [[Common Terms#Pre-Join Page|pre-join page]] by appending ''/join'' to a [[ct#Linkcode|linkcode]].  For example:
  
−
<pre>
+
<big><pre>
 
http://linkdomain/track/MjozOjE/join
 
http://linkdomain/track/MjozOjE/join
 
</pre>
 
</pre>
−
 
+
</big>
 
Affiliates can link to any other page on your site by appending a forward-slash and a relative URL to the link code.  For example, using the following linkcode to link to <nowiki>http://example.com/tour1.html</nowiki>:
 
Affiliates can link to any other page on your site by appending a forward-slash and a relative URL to the link code.  For example, using the following linkcode to link to <nowiki>http://example.com/tour1.html</nowiki>:
−
 
+
<big>
 
<pre>
 
<pre>
 
http://join.example.com/track/MjozOjE/tour1.html
 
http://join.example.com/track/MjozOjE/tour1.html
 
</pre>
 
</pre>
−
 
+
</big>
 
Affiliates can also manipulate the query string. For example, the affiliate can pass the variable ''extra_var=1234'' to a tour by appending a question mark and the variable assignment to their linkcode:
 
Affiliates can also manipulate the query string. For example, the affiliate can pass the variable ''extra_var=1234'' to a tour by appending a question mark and the variable assignment to their linkcode:
−
 
+
<big>
 
<pre>
 
<pre>
 
http://join.example.com/track/MjozOjE/?extra_var=1234  
 
http://join.example.com/track/MjozOjE/?extra_var=1234  
 
</pre>
 
</pre>
 +
</big>
 +
Affiliates can also link to any page and manipulate the query string. For example, the affiliate can pass the variable ''extra_var=1234'' to /join by appending a question mark and the variable assignment to their linkcode:
 +
<big>
 +
<pre>
 +
http://join.example.com/track/MjozOjE/join?extra_var=1234
 +
</pre>
 +
</big>
  
 
== HTML / Embeded Linkcodes ==
 
== HTML / Embeded Linkcodes ==
Line 83: Line 97:
  
 
Choose how you would like your linkcodes to be displayed with the [[Affiliate Display Settings]].
 
Choose how you would like your linkcodes to be displayed with the [[Affiliate Display Settings]].
 +
 +
 +
 +
== Redirecting to the Correct Page ==
 +
When NATS turns a linkcode into a tour URL, it automatically appends a slash (/) to the end of barewords.  You can prevent this by appending a question mark to the end of the URL. For example:
 +
 +
{| class="tmplfunc" border="1"
 +
! Tour URL
 +
! Where Linkcodes Go
 +
|-
 +
| <nowiki>http://example.com/tour</nowiki>
 +
| <nowiki>http://example.com/tour/?nats=</nowiki>''natscode''
 +
|-
 +
| <nowiki>http://example.com/tour?</nowiki>
 +
| <nowiki>http://example.com/tour?nats=</nowiki>''natscode''
 +
|}
 +
 +
== Qualified Link Codes ==
 +
If there's a extra "t" in your linkcode, you probably grabbed the wrong link code from the top of the Sites edit page.
 +
 +
<pre>
 +
http://join.site.com/ttrack/<?=(!empty($_REQUEST['nats']) && !preg_match('/[\'\"<>()\\\+\[\]]/', $_REQUEST['nats']))?$_REQUEST['nats']:'MDowOjE'?>/page.html
 +
</pre>
 +
 +
The ''ttrack'' is used for qualified clicks; ''track'' is used for normal hits.
  
 
[[Category:Also NATS4 Article]]
 
[[Category:Also NATS4 Article]]
 
[[Category:NATS4 Affiliate Information]]
 
[[Category:NATS4 Affiliate Information]]

Latest revision as of 15:14, 1 July 2023

NATS 4
For Affiliates
Affiliate Adtools
Automatic Campaigns
Affiliate Payment Information
Affiliate Defaults
Linkcodes
Affiliate Stats Dumps
ASP Query String
Deep Linking
Main Program Page
NATSCode
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

A linkcode is a referral URL tracked by NATS. Linkcodes are how affiliates get credit for the traffic they redirect through NATS. To get an affiliate link code, click the Linkcodes link under "Affiliate Quick Links."

There are three types of link codes that NATS will recognize:

  • Encoded Links
  • Un-Encoded Links
  • Shortname Links

PLEASE NOTE THAT ALL THREE TYPES ARE INTERCHANGEABLE WITH EACH OTHER.

Encoded Link Codes

Figure 1.1 - Link Codes Explained

Encoded link codes are the most common variety of link code seen in NATS. All of the information required by NATS to tie an affiliate to a surfer is located in the string of characters at the end, which are base64-encoded.

Unencoded Link Codes

Figure 1.2 - Unencoded Link Codes Explained

Un-encoded link codes display a period-delimited list of all information that would be in an encoded string within your URL. This is an alternate way to display affiliate link codes; the following example will break down what is displayed in an un-encoded link code.

  • Link Domain – This is often the third level domain of the tour site that is actually a server alias to your NATS install. It is necessary for proper cookie tracking and surfer appeal.
  • Affiliate Username - The username of the affiliate who referred this surfer.
  • Track – The alias to the NATS tracking script you are using. Variations include track, ttrack, strack, qtrack, and gallery.
  • Programid - The numeric ID of the program that the surfer's transaction will be paid out under (See Things to Remember)
  • Siteid - The numeric ID of the NATS site your surfer is trying to visit.
  • Tourid - The numeric ID of the site's tour that your surfer will be redirected to (See Sites Admin for details)
  • Affiliate Campaignid - The numeric id of the campaign associated with the affiliate (0 = the default campaign for that affiliate)
  • Adtoolid - If the surfer followed a link code associated with an adtool, this will represent the numeric id of the adtool the surfer saw. If no adtool was used, this will default to 0.
  • Subid1 - This is used for extra tracking needed by some special adtool types, such as gallery builder.
  • Subid2 - This is available for custom use.

Shortname Link Codes

Shortname link codes look very similar to un-encoded link codes, with a crucial difference. Instead of using ID number like an un-encoded link codes, this format uses the shortnames of the program, site, and tour you have specified in the URL.

Example: 

http://demo.nats4.com/track/DemoAff.pps.sitea.MAIN.0.0.0.0/

Decoding Link Codes

Encoded link codes can be decoded using base64 decoding, which uses ASCII characters and binary to encode/decode links. For the admins, we built a page that allows for creating/decoding NATS code. The URL should be http://<NATS_URL>.com/admin_codes.php. The affiliates also have a page that is not shown by default. The URL should be http://<NATS_URL>.com/internal.php?page=code_info.

For more information, see our NatsCode wiki.

Things to Remember

  • All three formats are interchangeable!
  • If moving from NATS v3 to NATS v4, your NATS3 link codes are 100% usable and compatable in NATS v4
  • The non-encoded formats are security-smart! If an affiliate alters a link code so that he/she sends traffic to a program that the affiliate does not belong to, or if they send traffic to a site/tour that does not belong to the program, the affiliate will not get paid out on any transactions that result from that traffic.
  • The non-encoded formats are NOT fool-proof! If an affiliate alters the link code so they are using a program they don't belong to or using a tour that doesn't belong to the site, they will not get desired payout or the surfer will not land on the right tour in most cases.

Deep Linking

Affiliates can link directly to a NATS pre-join page by appending /join to a linkcode. For example: 

http://linkdomain/track/MjozOjE/join

Affiliates can link to any other page on your site by appending a forward-slash and a relative URL to the link code. For example, using the following linkcode to link to http://example.com/tour1.html: 

http://join.example.com/track/MjozOjE/tour1.html

Affiliates can also manipulate the query string. For example, the affiliate can pass the variable extra_var=1234 to a tour by appending a question mark and the variable assignment to their linkcode: 

http://join.example.com/track/MjozOjE/?extra_var=1234

Affiliates can also link to any page and manipulate the query string. For example, the affiliate can pass the variable extra_var=1234 to /join by appending a question mark and the variable assignment to their linkcode: 

http://join.example.com/track/MjozOjE/join?extra_var=1234

HTML / Embeded Linkcodes

In addition to the standard link styles offered, NATS4.1 also offers the ability to attach the HTML code that is necessary in order to provide surfers with hyperlinks containing your affiliate linkcode. Just choose either

  • Encoded with HTML
  • Un-Encoded with HTML
  • Shortname with HTML

These options will create embeded, hyperlinked linkcodes. If you want just the URL for your affiliate linkcodes without any HTML code attached, simply choose a option without HTML.

Choose how you would like your linkcodes to be displayed with the Affiliate Display Settings.


Redirecting to the Correct Page

When NATS turns a linkcode into a tour URL, it automatically appends a slash (/) to the end of barewords. You can prevent this by appending a question mark to the end of the URL. For example:

Tour URL Where Linkcodes Go
http://example.com/tour http://example.com/tour/?nats=natscode
http://example.com/tour? http://example.com/tour?nats=natscode

Qualified Link Codes

If there's a extra "t" in your linkcode, you probably grabbed the wrong link code from the top of the Sites edit page. 

http://join.site.com/ttrack/<?=(!empty($_REQUEST['nats']) && !preg_match('/[\'\"<>()\\\+\[\]]/', $_REQUEST['nats']))?$_REQUEST['nats']:'MDowOjE'?>/page.html

The ttrack is used for qualified clicks; track is used for normal hits.

Retrieved from "https://tmmwiki.com/index.php?title=NATS4_LinkCodes&oldid=29772"