Differences

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

--- settings [2017/08/23 05:44] – created admin
+++ settings [2026/04/20 08:15] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+====== Settings ======
 ====== CJ Settings ======
-Most  of the options here are quite clear and don’t need additional explanation.  But still  some of them need detailed discussion.
+Most settings are straightforward, but some deserve more explanation.
-**Counted clicks Max** – the maximum  amount of clicks, which can be counted to 1 serfer. That means that the following clicks go to where they have to be sent but  are not reflected in  the statistics.
+===== Counted clicks Max =====
+The maximum number of clicks per user that will be counted in statistics. Additional clicks are still sent out but not counted.
-**Next click** is a click number – click number, which has to be counted as Next Click column ([[Second Click]])
+===== Next click is a click number =====
+Which click number is tracked for the Next Click column (see [[Second Click]])
-**Header Check** - this feature could help you to find some stupid cheaters or get some extra stats. When user's browser requests a page from your site it sends a some info about itself, script can collect and analyze this data. For example, most browsers support gzip encoding (html page compression) while some cheater\proxies dont. Select Settings→CJSEttings→Header field checks = Accept Gzip Encoding. You can also select Server Protocol and charset. Advanced user can select any field from header (click Advanced )
-**Trade Formula** –  a formula, thanks to which script finds out the priority of each trade, it’s needless to say that  the higher priority is, the higher is the  possibility of the trader to get a hit. So all the traders are divided according to  several parameters.  Some formulas created by  both users and programmers can be seen here. [[Trade Formula]]
+===== Spiders UA =====
-**Default Firstclick** - [[First Click]], notice each trader has a personal setting for this and it has a priority.
+This list identifies bot traffic by user agent strings. For advanced tools like Mindmax that use ASN detection, you can add patterns like:
-**Cookie lifetime** –  cookie lifetime in seconds, 86400 – 24 hours. Script counts surfers based on cookies. If user visits our site again within 24H - it's a raw hit, in other case - unique.
+  $MM_ASN:15169
-**Top position keywords** – keywords divided with comma to find out  your position in trader’s top. [[Top Positions]]
-**Admin Auto Refresh** – to refresh Trade screen automatically through the mentioned amount of seconds.
-**System email** - email used by script to send urgent messages to you. __This email isnt shown anywhere except admin area.__
+===== Header Check =====
+This feature validates HTTP request headers to identify bots and proxies. For example, it can check if a browser supports gzip compression (most real browsers do, but many proxies don't). To use it:
+  - Go to Settings > CJSettings > Header field checks
+  - Set it to "Accept Gzip Encoding"
+  - In Settings > Layouts, add a Header Check column
-**Check main pages changes** - this feature aimed agian server hacks. Script check pages from Settings -> CJPages and if those page had been changed , script sends email to "System email".
+Advanced users can check any header field.
-**System proxy** a proxy server used for all script's request outside server (alexa stats, top position and so on)
+**Trade Formula** – pay attention to [[Trade Formula]]
-**Advanced TOP settings**  parameters for toplists, take a look at [[Toplist]]
+**Count hits with referer other then main domain** – count hits if the referer is not our domain. For example, someone might link from their site directly to your out.
-**Processed Data** - data types that will be logged by script. Actually you should take a took at this only if your site 5M+... anyway, if your database has a problem with perfomance - let me know.
+**Default Firstclick** - default first click ([[First Click]]), works if not specified elsewhere in the URL or trader settings.
-**Extra Traffic Settings** actually in 99% of cases you don't need to change anything here. Lets take a look at what we have here..
+**Cookie lifetime** – lifetime of the cookie that the script sets (by the cookie the script determines the uniqueness of surfers), in seconds. 86400 – one day.
-ExtraHits URL - if server already clicked all of your trades he will be sent to exout url, his cookies will be deleted and he will start акь the very beginning. Actually happens only if you have something like 5 traders.
+**Top position keywords** - keywords separated by commas to determine your position in the trader's top. [[Top Positions]]
-Send exout to traders - should we send serfer to traders who owe us ?
+**Admin Auto Refresh** - automatically refresh the main Trade screen through the specified number of seconds.
-Send exout to galleries - should we send those very active clickers always to galleries ?
+**System email** - email used by the script to send you emergency messages. It is not shown on the signup page, and in general is only visible in the admin.
+**Check main pages changes** - this feature is designed to fight server hacks, or rather their consequences. The script automatically checks the pages listed in Settings -> CJPages and upon changes sends mail to "System email".
-**URL to add to galleries** - an addition to gallery URL. For example, you have a list of webmaster's galleries but you want to open in new window with you ads at the top. Here is how you can do that:
-Let's say you have out link
+===== URL to add to galleries =====
+additions for all gallery URLs. This is needed if you want to open master galleries in a frame. Here's an example of how this can be used:
+For example, you have a link:
   <a href="/out.php?url=http://webmaster/gallery.html"> Webmaster's gallery </a>
-so when you click it script sends you to http://webmaster/gallery.html
+when you click on it, the script sends to http:/webmaster/gallery.html
-First of all you create a new php file, let's say frame.php (put it at the root of your domain)
+But we want to open the gallery in a frame, that is, our ads at the top and the master's gallery below.
-  <html>
+First create a PHP file, call it frame.php and put it in the root domain
-  <head>
-  <title>Gallery</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=windows-1251">
-  </head>
-  <frameset rows="80,*" frameborder="NO" border="0" framespacing="0">
-    <frame src="http://yourdomain/your_adds.html" name="topFrame" scrolling="NO" noresize>
-    <frame src="<?=$_GET['url']?>" name="mainFrame">
-  </frameset>
-  </html>
-This file creates a frameset with your ads at the top (80px) and webmaster's gallery.
+<code>
+<html>
+<head>
+<title>Gallery</title>
+<meta http-equiv="Content-Type" content="text/html; charset=windows-1251">
+</head>
-Set 'URL to add to galleries' to
+<frameset rows="80,*" frameborder="NO" border="0" framespacing="0">
-  /frame.php?url=
+  <frame src="http:/yourdomain/your_adds.html" name="topFrame" scrolling="NO" noresize>
-and script will send you to (using our example)
+  <frame src="<?=$_GET['url']?>" name="mainFrame">
+</frameset>
+</html>
+</code>
+This script creates a frameset with your ads at the top (80px) and the gallery on the rest of the screen
+Set 'URL to add to galleries' to
+  /frame.php?url=
+and when clicking on URL
+  <a href="/out.php?url=http://webmaster/gallery.html"> Webmaster's gallery </a>
+the script will send to
   /frame.php?url=http://webmaster/gallery.html
+**System proxy** proxy used by the script for all Internet requests.
-**Send exout to galleries** (ie if surfer has visited all your trades - send him to galleries all the time)
+**Advanced TOP settings** parameters for creating top lists, described in detail in [[Toplist]]
-====== Templates ======
+**Processed Data** - data that is recorded in the database. Theoretically, if you have a very large site, for example 5+M, to reduce the load on the database you can disable processing of, for example, refs or any other information that you don't use. In practice, this is usually not necessary, if you had the idea to disable something - it's better to contact support, let's try to solve the performance issue.
-You can edit templates of different pages, the most interesting one is wm_signup.tpl – it’s a signup template for traders.
+**Extra Traffic Settings** settings that you probably won't need to change :) so here we have
+ExtraHits URL - if the surfer clicked through all traders at all or alternatively traders in the group specified in the out parameter (&group=), then the script sends him 1 time to exout, clears the cookie, and supposedly next click for the surfer starts from the beginning. In practice, such mega-active surfers more often fall into overclicks and in the exout column in the vast majority of cases will always be 0.
-====== Config Files ======
+Send exout to traders - this is the 2nd reason why exout is always 0. Even if the surfer clicked through all traders that we owe, should we send him to traders that we don't owe. That is, a surfer came, clicked through all traders that we owe something to. Now we need to send him either to those we don't owe or go through the 2nd round to those we do owe. To not breed raws at traders, by default we send traffic even to those we don't owe.
-You can edit config files for example, user agents scrips uses visiting other sites, languages, list of SE domains (to detect SE hits) and so on. In most cases you dont need to change anything here :)
+Send exout to galleries - if the server clicked through all traders (again unlikely, unless you have 5 traders in total) then all his remaining clicks can be sent to galleries (of course, if there's a &url= parameter in the out URL). Actually this parameter is read as setting 100% skimming on a surfer who clicked through all traders.
-====== Adding a trade ======
-Actually all things here exectly the same as at [[Edit Traders]] but pay attention to Settings → NewTrader  item -   every new trader will  get these settings  by default.
+===== Trade by country quality =====
+The script determines what countries the trader is sending you and tries to return the same. That is, if the trader is sending you China, the script will also return China to him.
+If you're trading with a script that has the same functionality - watch the beginning of the trade, because there could be looping on a country. For example, the first couple of hits went to China and the exchange went exclusively for China.
-====== First Click ======
+Good\bad pages are configured in Settings - Quality Settings.
-This is very usefull parameter if you operate TGP site. First clicks means that if surfers clicks on a link with content
-  for example, out.php?url=http://gallery.com/post.html
-and this is his first click on your site - script always sends him to content..
-There are several ways to setup this option
+===== After all trades from outgoing list send to =====
+Basically the script sends by the outgoing list, usually a list of 10-15 traders. see [[Out Settings]]
+After a surfer clicks through all traders in this list, he has several options.
+  * send him to traders outside this list
+  * clear the cookie and start from the beginning of the list
+  * 100% to URL (to galleries)
+  * 100% to a specific URL (exout)
+===== CJ Pages =====
+List of main site pages. see [[Start Here]]
+===== Layouts =====
+Here you can select which columns you would like to display in Trade, as well as colors for these columns.
+At the same time you can create several presets and switch between them "on the fly".
+===== Templates =====
+You can edit templates for various pages, the most interesting of which is wm_signup.tpl - this is the signup form template for traders.
+===== Config Files =====
+Various data files for the script, for example, lists of user agents with which the script goes when grabbing galleries, languages, lists of SE domains for determining SE trader in statistics, etc.
+====== New trade ======
+Pay attention to Settings -> NewTrader– these are exactly the settings a new trader will get by default.
-  - link out.php?url=somethings&fc=1. Note fc=1 parameter.
-  - Settings/ [[CJ Settings]] - Default First click , first click by default for everything
-  - Personal settings for each trader (personal first click ([[Edit traders]]))
-  - Personal Trade Scheme [[Edit traders]]
 ====== Second Click ======
-This parameter shows % of surfers who does more then 1 (or 2,3 and so on) clicks.
+A parameter showing what percentage of surfers make more than one (optionally 2nd, 3rd ...) click on your site. For this, the Next Click parameter is set in [[CJ Settings]], in the CJ Settings -> Layouts menu a Next Click column is added. The value of this parameter can be seen in the main Trade screen opposite each trader.
-Setup parameter `Next Click` in [[CJ Settings]] (it's 2 by default), add column 'Show next click'  in [[CJ Settings]] -> Display Config.
+The meaning of this parameter is something between anti-cheat and trader productivity statistics. Pay attention to the deviation of traders from the average values of this parameter for the site.
+====== Top Positions (TopPos) ======
-====== Top Positions ======
+Allows you to determine your position in the trader's top. This helps determine whether you're overflowing the trader with traffic to such a point that he can't return you the appropriate amount of traffic. This often happens if you end up in first place in the trader's top.
-Script uses this data to determinate your position in trader's top. Usually you can see description of your site od your domain name in trader's top, so that's what you have to write down in this field (comma separated), for example : Best Free Site,bestfreesite.com
+The script downloads the trader's page, tries to find the top traders on it and finds your place using the words specified in the Top positions field ([[CJ Settings]]). The accuracy of the definition is not 100%, but at a fairly high level.
+The position that the script determined is visible in the popup of each trader.
-====== Out settings ======
-Imagine the site that  has one very strong trade and the rest of the trades are so-so. According to the priority this site will  always be  on the top position, whereas  the rest of the sites will get the second, third and  other positions. This trade will get almost all hits. To avoid this situation out settings exist. We take for example first 10 traders in the line to get a hit and we give a hit to one of this 10 at random. But  to follow the priority (  the trader which is higher in the list  is more likely to get a hit than a trader  placed lower in this list) we set as chance to get a hit for each of position. For example, trader at the first place gets 50% change to get a hit, second place - 30%, third -  10 and so on.
+====== Out Settings ======
+Imagine a site that has one very strong trade and the rest are so-so. By priority for receiving hits, this site will constantly be first, because of which the rest of the sites will at best get second hits, and the first will always go to this strong one. In such a situation, the other trades either won't take off at all, or will do so very slowly. To avoid such a situation, there are out settings. We take conditionally the first 10 trades in the queue to receive a hit and randomly give the hit to one of them, but to maintain priority, the probability that the first in this list will get the hit is higher, the second is somewhat lower, and so on. In the settings we just specify the spread between places. You can make it so that the first hit goes to first place 50% or 99% of the time. This changes the meaning of the trade. From the beginning, the ratio for normal even trade is set, but feel free to experiment =)
 ====== Trade Activation ======
-Activates traders if it meets all conditions.
+Automatic activation of trade if it meets all conditions described in the menu.
-Note: System activates traders from status 'No, till trade activation' ONLY.
+Important: the activation system only processes those trades that have the status 'No, till trade activation'.
-====== Blacklist  ======
+Let's summarize the data on activation or suspension of trade.
-Blacklist  protects you from registration  from  domains you wouldn’t like to trade with. Here the usage of * is  permitted.
+Trader with status No (Not active) - does not activate, is not forced, etc., this is a completely disabled trader. Traffic will be counted on it, but nothing goes to it and it cannot auto-activate.
+Yes - active, from this status the trader can be deactivated by various systems, one of which is Trade suspend. Its settings exist for each trader and are simple: Suspend trade if we have less then X hits during Y hours in a row.
+Trade suspend - deactivates the trader to status "No, till Trade Start Limit". So if you need to auto-activate a trader if he starts sending traffic - set Trade Start Limit = 1 (or 2-3 to avoid random clicks) there as well
+Accordingly, it's convenient to set default trade suspend & trade start limit settings for all traders, but then there's a problem with new traders. That is, a trader was added, sent a couple of hits and he's already active by the Trade Start Limit rule. To prevent this, for new traders, either set status "No" and they are all reviewed manually, or "No, till Trade Activation System" and then the trader is activated in accordance with the Activation System settings.
+In total, it seems to me that the most convenient option if you want to activate \ deactivate traders:
+  * New trader has Suspend trade settings - for example, received 0 in 3 days - deactivate. Trade Start Limit = 2 and default status "No, till Trade Activation System"
+  * When it is added, its traffic should meet the Trade Activation System conditions
+  * During the trade, if it doesn't send - it is automatically deactivated to status "No, till Trade Start Limit"
+  * If it starts sending - automatically activated by the Trade Start Limit system
+====== BlackList ======
+Blacklist protects you from registering trade with domains that you don't want to trade with. Here you can use *.
 For example
-  * *.yourdomain.com -   to forbid registration from any domains subdomains yourdomain.com
+  *.yourdomain.com - forbid registration from any subdomains of yourdomain.com
-  * *.*.com -  to forbid registration   of domains of the 3rd  level.
+  *.*.com - forbid registration of 3rd level domains.
-**Banned IPs** -  to forbid registration  from the mentioned IP. Some cheaters  are not  tired  of registering  new  domains from the same IP every day.
-**Banned URLs** and **Banned Words** - take a look at [[Rotation Graber]]
+When adding a trader to the BL, if it was banned due to cheating, please write the reason for the ban and add it to the global BL. In this case, another script user who trades with a cheater will learn about this ban and can also delete this trade. Together we can create a truly convenient and full-featured BL.
 ====== Quality Settings ======
-To get a full quality assessment of the traffic from trader Quality Settings exist. For example, if a trader sends you Chinese or Russian traffic you can not count such clicks or count them with discount. You can also do the same  thing when counting  clicks through proxy and with JS turned off.
+To properly assess the quality of traffic from a trader, there are Quality Settings. For example, if a trader is sending you Chinese or Russian traffic, you can choose not to count such clicks or count them with a reducing factor. You can also count clicks through a proxy and with JS disabled with a reduced factor.
-Example. A trader sent a serfer that has made 10 clicks, all these clicks go through proxy (Proxy Discount– 20%).That means that only 8 (10 clicks – 20%) clicks will be counted to the trader.
+  Example. A trader sent a surfer who made 10 clicks, all these clicks go through a proxy. ProxyDiscount– 20%. This means we will count only 10 – 20% = 8 clicks for the trader.
-In  our case  we’ve decided that China (ch) and Russia (ru) -  are  the less solvent countries and would like to give less to traders, sending such traffic. In our example we’ll estimate a user’s page by browser’s language. This is the variable - HTTP_ACCEPT_LANGUAGE. Insert
-  Env. variable name  = HTTP_ACCEPT_LANGUAGE.
+In our case, we decided that China (ch) and Russia (ru) - are less solvent countries and we would like to return less traffic to traders who send such traffic. In our example, we will evaluate the user page by browser language. This is the HTTP_ACCEPT_LANGUAGE variable. Set
+  Env. variable name = HTTP_ACCEPT_LANGUAGE.
   Add Quality Set:
   Value = ru
   Discount % = 30
+  Skimming = 20
-Serfers with Russian languauge will be counted with 30% discount.
+With these settings, surfers with ru language will be counted with a 30% discount. If a trader sent us a surfer with ru language who made 10 clicks, we will count them as 10 - 30% = 7 clicks.
+Also for this surfer a separate skimming will apply - 20%, despite other script settings. If skimming = 0, then this parameter is not taken into account.
+  More complex example
+  Surfer made 10 clicks
+  language – ru
+  all clicks through proxy
+– 50% - 20% = only 3 clicks will be counted.
+Here there is also a Skimming parameter, this is personal skimming for the same conditions, for example
-You can also see Skimming Parameter - this is personal skimming for those conditions. Ie if you have
   Value = ru
   Discount % = 30
-  Skimming  = 40
+  Skimming = 40
+this means if someone came with ru language, their clicks will be counted with a 30% discount, and the default skimming will be 40%.
+Skimming 101 means don't apply this value, that is, use the one specified in &p= or Settings->CJSettings: Default Skimming
+<code>
+Note that discounts are applied to clicks
+For example Value = ru Discount % = 50
+Received 100 unique visitors and all from ru - unique visitors will still be 100.
+Let's say they clicked 100 times: 50 on URL and 50 on trade.
+Hourly Clicks Url, Hourly Clicks Trade and Hourly Clicks Total fields will reflect actual clicks that is 50, 50 and 100
+But Hourly Quality Url, Hourly Quality Trade and Hourly Quality Total will reflect considering discounts that is 25, 25 and 50
+Products are calculated from Quality parameters - accordingly discounts affect productivity and as a result trader debt.
+</code>
+====== Gallery domains whitelist ======
+Since initially URLs on the site look like out.php?url=... this can be used by spammers by substituting the URLs they need, that is, it will be http://your_domain/out.php?url=http://spammer/
+To avoid this, there's a Gallery domains whitelist setting where you enter a list of domains where traffic can be sent. If the field is empty, it sends to any URL, if domains are specified, it only sends to specified domains + traders.
+====== Notrade (Feeders) ======
+We have several options for what to do with notrade (Settings -> Processed Data -> Process Refs)
+  * just count as Notrade traffic
+  * add each domain as a new trade and count statistics for each separately. At the same time we add each domain as *.domain.com so we count traffic in total with m.domain.com, something.domain.com and so on. Or as sub.domain.com, that is each of the listed subdomains as a separate trader.
+  * If we buy traffic from exchanges it comes right away from a large number of domains. We can add one trader broker.com and send traffic to http://my_domain/?id=brocker.com - This way we'll see overall statistics of how much traffic comes from the broker and at the same time it will just be one line in Trade. At the same time we can also track traffic statistics from broker.com by subdomain - for this we enable add notrade as subfeeders. That is, we'll have one line broker.com but if you click on S then in its statistics there will be a subfeeders tab with the full list of domains.
+At the same time we can add both *.domain.com or each domain as sub.domain.com
+There can be edge cases where traffic arrives with links that do not look like a domain, or where the URL contains two different source markers. For example: http://your_domain/?campaign_id=123, where campaign_id changes depending on how you buy traffic and there is no referrer.
+Then to track traffic by all IDs, you can convert them to refs by adding to common.php
+  if (isset($_GET['campaign_id'])) $_SERVER['HTTP_REFERER'] = 'http://feeder_' . $_GET['campaign_id'] . '.com/';
+This way the referrer for such a hit becomes http://feeder_123.com/, and the script will automatically create a trader entry for it so you can see full statistics.
+====== Count clicks to galleries at trader's domain as clicks to trader ======
+Suppose trader trader.com has galleries, and you added them to yourself, that is, gallery URLs like http://trader/gallery/slug.html. That is, in this case traffic from you to the trader's domain can go both as to the trader and as to content (gallery). The option regulates whether to count these transitions as trade.
+====== Mail to Telegram ======
+The ability to send script messages not to email, but to Telegram (messenger).
+**System email** in settings should be written as
+  tg://bot_id@chat_id
+How to set it up:
-it means if someone comes this language RU his clicks will be counted with 30% discount and default skiming will be 40%.
-Skimming 101 means 'do not use this value', ie use &p= or Settings->CJSettings : Default Skimming
+  * In Telegram, message @botfather with /newbot and create a new bot
+  * it will give you **somehash**, it looks something like 7345345735:agADFsfjdfhSGTYJdfafhksdsdrQ
+  * send any message to that bot from your Telegram account, then open
+  https://api.telegram.org/bot**somehash**/getUpdates
+  note the word bot before the **somehash** string
+  there will be a string chat : id like 12321313
-====== CJ Pages ======
+  * enter the received data in system email, it should look like
-This is a list of your main pages. Take a look at [[Start Here]]
+  tg://7345345735:agADFsfjdfhSGTYJdfafhksdsdrQ@12321313
+That's it, messages should arrive in TG.