Difference between revisions of "NATS4 LinkCodes"

From TMM Wiki
Jump to navigationJump to search
m
m (Reverted edits by TMMMegan (talk) to last revision by Tmmrobc9360)
Line 5: Line 5:
 
__TOC__
 
__TOC__
  
−
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 Link Codes link under "Affiliate Quick Links."
+
[[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."
  
 
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'''''.  
+
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]].
  
−
*[[Link Domain]]
+
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.
−
*[[NATS4 track and strack|Track]]
 
−
*[[NATS4 NATSCode|NATSCode]]
 
  
 
== Unencoded Link Codes ==
 
== Unencoded Link Codes ==
Line 31: Line 29:
 
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.
  
−
*'''[[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
−
*'''Affiliate Username''' - The username of the affiliate who referred this surfer.
+
*'''Programid''' - The numeric id of the program that the surfer's transaction will be paid out under (See [[#Things to Remember|Things to Remember]])
−
*'''[[NATS4 track and strack|Track]]''' – The alias to the NATS tracking script you are using. Variations include track, ttrack, strack, qtrack, and gallery.
+
*'''Siteid''' - The numeric id of the NATS site your surfer is trying to visit
−
*'''Programid''' - The numeric ID of the program that the surfer's transaction will be paid out under (See [[#Things to Remember|Things to Remember]])
+
*'''Tourid''' - The numeric id of the site's tour that your surfer will be redirected to (See [[NATS4 Sites Admin|Sites Admin]] for details)
−
*'''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''' - This is used for extra tracking needed by some special adtool types, such as gallery builder.
+
*'''Subid1 & Subid2''' - (See explanation above)
−
*'''Subid2''' - This is available for custom use.
 
  
 
== Shortname Link Codes ==
 
== Shortname Link Codes ==
Line 51: Line 46:
  
 
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 64: Line 57:
 
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:
  
−
<big><pre>
+
<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>
 
−
 
−
== 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 [[Ct#Surfer|surfers]] with hyperlinks containing your [[Ct#Affiliate|affiliate]] [[Ct#Linkcode|linkcode]]. Just choose either
 
−
*Encoded with HTML
 
−
*Un-Encoded with HTML
 
−
*Shortname with HTML
 
−
These options will create embeded, hyperlinked [[Ct#Linkcode|linkcodes]].
 
−
If you want '''just the URL''' for your [[Affiliate Linkcodes|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:
 
−
 
−
{| 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/<?=$_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]]

Revision as of 15:28, 19 July 2013

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

Link Codes are how 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."

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. The last part of the sample URL is known as the NATS Code, which has multiple uses in NATS.

For more information on what a link domain is, please visit our Link Domain article. For the variations on track, please see our track and strack article. For how to obtain a NATS Code, please see our Getting The NATSCode article.

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.

  • Affiliate Username - The username of the affiliate who referred this surfer
  • 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 & Subid2 - (See explanation above)

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.

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
Retrieved from "https://tmmwiki.com/index.php?title=NATS4_LinkCodes&oldid=16462"