XrenCJ v.3.1 Users Manual

ВНИМАНИЕ!!!


Настоятельно рекомендуется прежде чем совершать какие-либо действия с Вашим CJ, ВНИМАТЕЛЬНО прочитать данный документ от начала до конца, досконально понять принципы работы, если не поняли - перечитать, если опять не поняли - спросить автора по ICQ 2625855, и только потом начать какие-либо манипуляции со скриптом.

CJ - это не та тема, где можно что-то делать не думая. Работа с CJ требует понимания того, что Вы делаете и к чему Ваши действия приведут.


Содержание:

Идеология и алгоритмы XrenCJ

...Базовые понятия

 ......Трейдер
......NOREF
......EXOUT
......URL
......DELETED
......Группы трейдеров
......COMMON
......NO TRADERS
......TRADERS

...Базовые показатели

 ......IN
......CLICK
......OUT
......QUAL

...Вычисляемые показатели

 ......RATIO
......PROD
......EFFECT
......FIN
......FORCES
......LIMITS
......РЕЙТИНГ ТРЕЙДА

...Расчеты

 ......Расчет по событию
......Текущий расчет
......Часовой расчет
......Ежедневный расчет

Начало работы с XrenCJ

Admin&Stats Area

SETTINGS Page

 ...INFO block
...ALGORYTHM block
...FORCES & LIMITS block
...NOREF block
...NICHES & EXOUTS block
...LANGUAGES block
...TRAF QUALITY block
...SHOWS PLAN block
...RULES block
...TOPLIST block

ADD TRADER Page

MASS EDIT Page

EVENTS Page

REFERERS Page

LINKS Page

DELETED Рage

BLACKLISTED Рage

INTERFACE Page

PASSWORD Page

Add/Delete Niches Page

Add/Delete Languages Page

STATS Pages

EDIT Pages

DEL & BLACK Pages

Ротаторы тумб и дескрипшнов

Идеология и алгоритмы XrenCJ


С общим обзором алгоритмов XrenCJ и его реализации Вы можете ознакомиться ЗДЕСЬ.

БАЗОВЫЕ ПОНЯТИЯ:

 Трейдер - домен, с которым ведется обмен. Скрипт вашего CJ учитывает пришедших от трейдера посетителей, расчитывает эффективность обмена с ними и в зависимости от этих расчетов и настроек для этого трейдера отправляет ему то или иное количество посетителей в ответ.
NOREF - под этим "псевдотрейдером" учитываются все посетители, которые не опознаны как пришедшие от какого-либо активного трейдера. Для псевдотрейдера NOREF определяются все характеристики, кроме OUT - поскольку не существует URL, куда бы сиджей отправлял OUTы в ответ.
EXOUT - под этим "псевдотрейдером" учитываются все OUTы, которые отправляются сиджеем после прохождения посетителем всех активных трейдеров. Для данного псевдотрейдера определяется единственная характеристика - OUT.
URL - под этим "псевдотрейдером" учитываются все OUTы, которые отправляются сиджеем на специально указанныt владельцем URL (аргумент url в вызове out.php). Для данного псевдотрейдера определяется единственная характеристика - OUT.
DELETED - под этим "псевдотрейдером" учитываются все посетители, которые пришли от трейдеров, на данный момент удаленных владельцем из базы данных. Для этого псевдотрейдера определяются все характеристики. Этот псевдотрейдер может иметь показатели отличные от нуля в течение 24 часов с момента последнего удаления какого-либо трейдера из базы.

Для каждого трейдера и псевдотрейдера ведется отдельный учет по всем показателям, а также ведется суммарный учет для следующих групп:

COMMON - Данные для всех трейдеров и псевдотрейдеров в сумме.
NO TRADERS - Данные для всех псевдотрейдеров (NOREF, EXOUT, URL & DELETED) в сумме.
TRADERS - Данные для всех трейдеров в сумме.

БАЗОВЫЕ ПОКАЗАТЕЛИ
UNIQUE IN (или просто IN) - количество уникальных посетителей, пришедших на сиджей. Определяется для каждого трейдера и группы трейдеров, кроме EXOUT и URL.
CLICK - количество кликов по линку out.php, сделанных посетителем, пришедшим от трейдера. При этом посетитель может попасть как на трейдера, так и на урл, указанный в качестве аргумента out.php
OUT - количество посетителей, ушедших с сиджея на данного трейдера (или группу трейдеров).
Внимание!!! Скриптом учитываются только первые 5 АУТОВ НА ТРЕЙДЕРОВ, дальше ауты продолжают отправляться согласно рейтингу, но ни в кликах, ни в аутах не учитываются.

На основании этих данных расчитываются производные показатели для трейдеров и групп трейдеров.

 QUAL - качество трафа от трейдера или группы трейдеров. Позволяет оценить качество трафа от трейдера с точки зрения потенциала зарабатывания денег. Расчитывается следующим образом:
при учете каждого клика от трейдера оцениваются следующие характеристики посетителя, сделавшего клик:
- пришел через прокси или нет
- включены ли cookies
- включен ли javascript
- язык браузера (иначе говоря, из какой страны пришел посетитель)
- еще один признак, о котором я никому не расскажу (авторы клик-ботов читать умеют, я думаю, незачем им ВСЕ секреты раскрывать) :-)

В зависимости от результатов этих тестов, каждому клику присваивается определенное кол-во баллов (0-1-2).
0 - плохой, 1- нормальный, 2 - хороший.
При каждом вычислении показателей суммарное количество баллов делится на суммарное количество кликов и получается средний коэффициент качества трафа, выражаемый в процентах.
Если QUAL <100% - траф плохой, если >100% - нормальный, если приближается к 200% - превосходный.

Показатель QUAL используется в качестве дополнительного множителя для расчета всех остальных показателей, являясь модификатором качества трейда.

ВЫЧИСЛЯЕМЫЕ ПОКАЗАТЕЛИ
RATIO - показатель, демонстрирующий политику возврата трейдером трафа. Считается по формуле

IN / OUT

Смысл показателя - сколько юников вернул трейдер в обмен на 1 аут от Вас. Характеризует в основном настройки скрипта трейдера по отношению к Вам.
PROD - показатель, демонстрирующий активность трафа, пришедшего от трейдера. Считается по формуле

CLICK / IN

Смысл показателя - сколько кликов в среднем сделал юник на вашем сиджее.

Этот показатель используется многими CJ-скриптами как основной при расчете трейда, однако это не совсем корректно с точки зрения автора XrenCJ. Хотя бы потому, что при использовании данного показателя не учитывается лояльность настроек скрипта трейдера по отношению к Вам.

Простой пример:

трейдер X шлет траф с продуктивностью 300%, но отправляет Вам на 10 ваших аутов 1 юника. В результате на 10 отправленных Вами аутов Вы получаете от него 3 клика.
трейдер Y шлет в 3 раза менее продуктивный траф, 100% продуктивности, но на каждый Ваш аут отправляет Вам 1 юника. В результате на 10 аутов вы получаете 10 кликов от трейдера Y.

С точки зрения "трейда по продуктивности" скрипт должен отправлять больше аутов на трейдера Х.
А с точки зрения здравого смысла? :-)
Автору XrenCJ кажется, что существуют более эффективные алгоритмы трейда, нежели "трейд по продуктивности".
EFFECT - эффективность обмена. Основной показатель, характеризующий качество трейда. Расчитывается для любого трейдера или группы трейдеров, кроме EXOUT, URL и NOREF (поскольку для первых двух не определяется CLICK, а для третьего OUT). Этот показатель вычисляется так:

CLICK / OUT

Смысл этого показателя - сколько кликов (не юников!) отдал трейдер в обмен на 1 полученный от нашего сиджея аут.
Этот показатель может быть представлен и по-другому:
PROD * RATIO
что подтверждает его большую информационную насыщеность, нежели PROD и RATIO в отдельности.

Внимательное рассмотрение данного показателя приводит нас к важному наблюдению:

Общий показатель эффективности для конкретного сиджея постоянно колеблется около некоторого постоянного числа.

Значение этого числа определяется соотношением показов посетителю трейдеров и реального контента, а также коэффициентом качества трейда. Мы можем убедиться в этом на простом примере - допустим, мы вообще не показываем посетителю реального контента, и все его клики будут уходить на трейдеров, а после того, как трейдеры закончатся - на EXOUT. Тогда суммарные величины CLICK и OUT всегда будут равны. А показатель EFFECT для трейда с такой схемой показа всегда будет равен 100%.
Аналогично, при отправке 50% кликов на трейдеров, а остальных 50% на реальный контент, суммарное количество кликов всегда будет в 2 раза больше суммарного количества аутов и эффективность будет ~200%.

Это позволяет нам принять суммарную эффективность за базовый показатель "нейтрального" трейда, а отклонения от этого показателя в ту или иную сторону у конкретного трейдера считать методом оценки относительного качества трейда.
FIN (окончательный показатель) - поскольку количество IN, приходящих на сиджей, в конечном итоге является главным показателем роста сиджея, автор скрипта модифицировал алгоритм трейда по эфективности и предлагает окончательный рейтинг трейда расчитываеть все же не по эффективности, а по эффективности, умноженной на RATIO и QUAL. Таким образом, теперь в расчете участвуют все базовые показатели трейда - IN, OUT, CLICK, QUAL.

FIN = (IN / OUT) * (CLICK / OUT) * QUAL

Показатель FIN равный 100% означает, что трейдер на каждый отправленный к нему OUT прислал в среднем одного посетителя (IN) нормального качества, который сделал на нашем CJ один CLICK.

Кому-то могут пригодиться и два производных от FIN алгоритма:

FIN EFFECT = (IN / OUT) * (CLICK / OUT) * (CLICK / OUT) * QUAL
FIN RATIO = (IN / OUT) * (IN / OUT) * (CLICK / OUT) * QUAL

В первом случае, как мы видим, клики имеют больший вес по сравнению с юниками, во втором случае наоборот.
FORCES (форсы) - понятие, доставшееся в наследство от созданных ранее CJ-алгоритмов, обозначает принудительно отправляемый трейдеру траф, невзирая на эффективность обмена с ним. Однако, в отличие от этих алгоритмов, где форсы являются одним из основных инструментов управления трейдом, здесь они используются как вспомогательная мера влияния на траф.

Вообще говоря, любое вмешательство в трейд, основанное НЕ на расчете показателя FIN, нарушает оптимальный порядок трейда. Поэтому такое вмешательство (а форсы и являются ничем иным как принудительным изменением оптимального порядка трейда) допустимо в 2-х случаях:

- когда трейдер только что добавлен в БД и необходимо послать ему определенное количество трафа, чтобы инициализировать трейд.
- когда владелец сиджея забивает с прибором на соображения оптимизации трейда и руководствуется своими собственными мотивами. Хозяин - барин.

При этом всегда надо помнить, что принудительно отправляя траф одному трейдеру, мы отнимаем его у другого, возможно более эффективного.
Единственным приемлемым с точки зрения автора способом форсирования являются soft forces.

Более подробно о реализованых в скрипте типах форсов можно узнать здесь

LIMITS (ограничения) - еще один способ модификации трейда, но в отличие от форсов, он работает в сторону "понижения". Если установка форсов позволяет отправлять траф трейдеру, невзирая на его неудачную позицию, то установка ограничений позволяет, наоборот, лимитировать отправку трафа трейдеру, навзирая на его "успехи".
Установка ограничений, по мнению автора скрипта, имеет смысл только в одном случае: когда у трейдера не установлен CJ-скрипт и отправлять ему траф больше определенного количества просто не имеет смысла (наиболее показательный пример - трейд с топами).
Хотя вообще говоря, даже и в этом случае при использовании алгоритма расчета по FIN такой трейдер не будет получать лишнего трафа. Так что можно обойтись и без ограничений. Однако, я слышал что кое-кто этим приемом пользуется, возможно уже привык так делать - поэтому на всякий случай реализовал такую возможность, мне не трудно :-). Однако за последствия ее использования всякую ответственность с себя снимаю.
Более подробно о реализованых в скрипте типах лимитов можно узнать здесь

РЕЙТИНГ ТРЕЙДА - список, в который входят все активные трейдеры, расположенные в той последовательности, в которой скрипт предполагает отправлять им ауты. Рейтинг пересчитывается ежеминутно и базируется на ключевом показателе выбранного Вами алгоритма, а также настройках FORСES и LIMITS. В общем случае, трейдеры с большим значением ключевого показателя находятся в списке ближе к началу.
Составление оптимального рейтинга трейда на каждый момент времени, по сути и является основной задачей любого CJ-скрипта.

В скрипте XrenCJ предусмотрена возможность построения рейтинга трейда по любому из базовых и производных показателей, однако автор настоятельно рекомендует пользоваться алгоритмом трейда по FIN.

Расчет рейтинга трейда происходит в таком порядке:

- сперва обсчитываются все трейдеры с назначенными форсами, вычисляется, сколько процентов от запланированных аутов эти трейдеры получили, выстраивается рейтинг - чем меньше процент выполнения задания, тем выше трейдер располагается в рейтинге.
Трейдеры, которые получили 100% или больше от запланированных для них форсов, в этом рейтинге не участвуют, они присоединяются к списку оставшихся трейдеров.

- затем оставшиеся трейдеры проверяются на предмет соблюдения лимитов получения ими трафа. Если трейдер получил траф выше своего лимита, он выводится из списка и позже будет "подклеен" в самый низ итогового рейтинга.

- затем оставшиеся трейдеры расчитываются согласно выбраному Вами алгоритму и располагаются убывающем порядке в соответствии со значением ключевого показателя (FIN, если Вы вняли моим рекомендациям, либо другого выбранного Вами). Этот рейтинг "подклеивается" к низу рейтинга форсовых трейдеров.

- затем к низу получившегося рейтинга "подклеиваются" трейдеры, исчерпавшие лимит аутов на данный момент.

Рейтинг трейда готов.
Скрипт, помимо общего рейтинга трейда, куда входят все активные трейдеры, создает также нишевые рейтинги, по тем же принципам, но с той разницей, что туда входят только трейдеры определенной ниши. Эти рейтинги используются в первую очередь при клике серфера на нишевый линк. Если в нишевом рейтинге нету трейдеров, которым можно отправить серфера, используется основной рейтинг.

Расчеты.

Скрипт производит 4 типа расчетов.
Расчет по событию
Этот расчет происходит всякий раз, когда посетитель совершает какое-либо действие, связанное с сиджеем: вход на сиджей, клик по линку. В результате этих расчетов происходит учет события в базе сиджея (учет юника, клика и аута), а в случае обработки клика - возврат URL, куда должен быть направлен данный клик.
Текущий расчет
Инициализируется ежеминутно с помощью crontab. Результатом этого расчета является обновление рейтинга трейда и страницы статистики.
Часовой расчет
Инициализируется с помощью crontab. В ходе этого расчета очищаются данные трейдеров за истекший 24 часа назад час (сказано коряво, но не знаю, как по-другому сказать :-)) и удаляются из логов IP юников, срок действия которых истек (срок - 24 часа - считается от последнего действия, совершенного юником на Вашем сиджее).
Ежедневный расчет
Инициализируется с помощью crontab. В ходе этого расчета происходит архивация статистики за прошедшие сутки.

Начало работы с XrenCJ

Для работы с сервисом Вам необходимо
- внимательно прочесть Общее описание XrenCJ и данное Руководство пользователя, убедиться что XrenCJ - именно тот скрит который Вам нужен;
- изъявить желание установить скрипт (ICQ 2625855 или xrenoder@xrenoder.com).
Для успешной работы и инсталляции скрипта Ваш хостинг должен соответствовать следующим требованиям:
- UNIX-платформа (Linux, FreeBSD, SunOS, Solaris)
- доступ к shell (SSH, telnet) c возможностью запуска компилятора C++
- доступ к FTP;
- поддерживать запуск cgi-скриптов (не только из директории CGI-BIN)
- поддерживать запуск программ с помощью crontab
- поддерживать запуск PHP4-скриптов
- поддерживать работу PHP и cgi скриптов в директориях имеющих chmod 777

После решения финансовых вопросов и получения от автора информации об успешной установке:

- обратить внимание на файлы index.php и out.php в директории своего сиджея, а также на поддиректорию xren_cj, запомнить их и никогда не удалять и не изменять содержимое;
- создать на своем локальном компьютере index.php - файл "морды", используя в нем линки формата 
<a href=out.php?niche=nichename&link=LINKNAME&link1=LINKNAME1&link2=LINKNAME2&go=trader&url=http://www.realcontent.com/contentpage.html>
или 
<a href=out.php?niche=nichename&link=LINKNAME&link1=LINKNAME1&link2=LINKNAME2&trader=domain.com>
где (ни один из аргументов не является обязательным и может отсутствовать):

nichename - название ниши. Список ниш можно посмотреть по линку Add/View Niches в Admin&Stats Area, там же можно добавить новую нишу. Ниши, которых нет в списке, игнорируются.

LINKNAME, LINKNAME1, LINKNAME2 - любая последовательность символов, которой вы хотите охарактеризовать данный линк. Ни на что не влияет, используется для Ваших собственных исследований трафа.
Статистику кликов по различным LINKNAME's Вы можете увидеть на View Links Log в Admin&Stats Area. Если LINKNAME не указано, то клик по этому линку будет учитываться как GENERAL.

url - URL, ведущий на страницу с реальным контентом (галерой). Скрипт может отправить посетителя, кликнувшего на этот линк, либо на трейдера, либо на url, это определяется схемой показов (см Settings Page)

trader - идентификатор трейдера, домен его сайта без "http://www." (вида domain.com, domain.net etc).
При наличии этого агрумента, при любом клике по этому линку серфер будет уходить на указанного трейдера

go - директива, отправляющая посетителя либо на реальный контент (если go=url и задан URL реального контента) либо на трейд (если go=trader или любое другое значение, кроме "url"). Эта директива позволяет игнорировать в данном конкретном линке заданную для всего сиджея схему показов


Например: 
<a href=out.php?niche=anal&link=ANAL1>
всегда отправляет посетителя на очередного трейдера
<a href=out.php?niche=anal&link=ANAL1&url=http://www.content.com>
отправляет посетителя на очередного трейдера либо на http://www.content.com, в зависимости от количества сделанных им кликов и заданной Вами в Settings схемы показа.
<a href=out.php?niche=anal&link=ANAL1&go=url&url=http://www.content.com>
всегда отправляет посетителя на http://www.content.com
<a href=out.php?niche=anal&link=ANAL1&go=blahblah&url=http://www.content.com>
всегда отправляет посетителя на очередного трейдера
<a href=out.php?niche=anal&link=ANAL1&go=url>
всегда отправляет посетителя на очередного трейдера (поскольку не указан УРЛ)
<a href=out.php?niche=anal&link=ANAL1&trader=easypic.com>
всегда отправляет посетителя на трейдера easypic.com, если он есть в Вашей базе, либо на эксаут, если такого трейдера в базе нет

- в поддиректорию html залить "морду" сиджея - index.php;
- в эту же поддиректорию html Вы можете залить другие "морды" сиджея, которые будут показываться повторным посетителям - index1.php,index2.php,index3.php и т.д.;
- сюда же Вы можете залить нишевые "морды" сиджея, которые будут показываться посетителям, пришедшим от нишевых трейдеров - nichename.php,nichename1.php,nichename2.php и т.д.;
- запустить http://.../xren_cj/index.php, произвести все настройки, обязательно сделать настройки в SETTINGS и нажать Submit - после этого станет доступна страница добавления трейдеров signup.php, добавить трейдеров;
- пустить на CJ траф

Admin&Stats Area

Собственно, основное средство контроля за работой и состоянием сиджея.

Состоит из информационной части и ссылок управления.

Unique In Graph from (date)

Наглядно показывает общую динамику входящих юников по дням, с начала работы CJ. Позволяет визуально оценить прирост трафа - собственно, выполнение основной задачи CJ.
При навелении курсора на столбец диаграммы всплывает дата и значение входящего трафа в юниках на этот день.
Диаграмма появляется после завершения первого дня работы CJ.

Управляющий линк Settings

Линк Settings ведет на страницу основных настроек скрипта.

Управляющий линк Add Trader

Линк Add Trader ведет на страницу добавления новых трейдеров в БД Вашего CJ.

Управляющий линк Mass Edit

Линк Mass Edit позволяет изменять настройки форсов и лимитов всем активным трейдерам.

Управляющий линк Events

Линк Events предназначен для управления cron-образными форсами.

Управляющий линк Referers

Линк Referers ведет на страницу, где отображается статистика по URL реферов Вашего CJ.

Управляющий линк Links

Линк Links ведет на страницу, где отображается статистика по частоте кликов на линки той или иной группы. Эта статистика может помочь Вам в проведении собственных исследований трафа.

Управляющий линк Deleted

Линк Deleted ведет на страницу, где отображается список трейдеров, по той или иной причине удаленных из БД Вашего CJ.
В этом логе отражается дата/время и причина удаления трейдера, ссылки на статистику удаленных трейдеров, а также инструмент возвращения удаленных трейдеров в базу активных.

Управляющий линк Blacklist

Линк Blacklist ведет на страницу, где отображается список трейдеров, внесенных Вами в блэклист.
В этом логе отражается дата/время и причина бана трейдера, ссылки на статистику забаненых трейдеров, а также инструмент возвращения забаненых трейдеров в СПИСОК УДАЛЕННЫХ (не в базу активных!!!).

Управляющий линк Interface

Линк Interface ведет на страницу смены дизайна Вашей админской зоны.

Управляющий линк Password

Линк Password ведет на страницу смены пароля к Вашей админской зоне.

Управляющий линк Reset Daemon

Линк Reset Daemon предназначен для аварийного ресета демона. Вообще говоря, демон перезапускается каждый час, кроме того в стандартную комплектацию входит сторож демона, который каждые 5 минут проверяет его и если демон не отзывается, то сторож ресетит демона.

Управляющий линк Daemon Log

Лог в котором показываются все срабатывания сторожа, связаные с обнаружением зависшего демона и результаты ресета демона сторожем.

Отбор трейдеров (Select)

Вы можете назначить отбор трейдеров по какому-либо признаку.
Для этого Вы должны ввести в текстовое поле признак отбора и указать колонку, в которой этот признак должен быть найден.

Признак может являться:
- строкой для поиска
- сравнением
- регулярным выражением

Если Вы указываете, например, признак "no out" и колонку stat, то Вам будут показани все трейдеры со статусом "no out".
Если Вы указали признак "no" и колонку stat, будут показаны все трейдеры, в статусе которых встречается "no".
Если Вы указали признак "^s" и колонку trader, то будут показаны все трейдеры, домен которых начинается с символа "s".
Если Вы указали признак ">100" и колонку prod, то будут показаны все трейдеры с продуктивностью больше 100%.

Допустимые знаки сравнения (знак сравнения должен стоять в начале строки-признака):
> больше
>= больше либо равно
< меньше
<= меньше либо равно
= равно
!= не равно

Для показа всех трейдеров Вам нужно выбрать из списка "show all traders".

Последнее условие отбора запоминается и трейдеры показываются в соответствии с ним постоянно, до момента изменения условия.

Таблица статистики трейда

Таблица статистики ведется за последние 24 часа, включая текущий час.
Изменения в таблице происходят в режиме реального времени.

В таблице имеются следующие поля:

Trader - в этом поле отображается название трейдера и линк на его основную страницу, а также названия групп трейдеров.

Last - сколько часов назад трейдер прислал последний IN.

Qual - коэффициент качества трафа трейдера или группы трейдеров.

Prod - продуктивность (CLICK/IN) трейдера или группы трейдеров

Ratio - рацио (IN/OUT) трейдера или группы трейдеров

Eff - эффективность обмена (CLICK/OUT) с трейдером или группой трейдеров.

Fin - окончательный показатель (Ratio*Eff*Qual) с трейдером или группой трейдеров.

IN - количество уникальных посетителей CJ за последние 24 часа, пришедших от трейдера или группы трейдеров

CLK - количество кликов, сделанных посетителями, пришедшими от трейдера или группы трейдеров

OUT - количество отправленных трейдеру или группе трейдеров посетителей.

Force - форсы, назначенные трейдеру

RLim - ограничитель по рацио в процентах

ELim - ограничитель по эффективности в процентах

Status/Niche - здесь показывается ниша трейдера либо его статус:

- no out означает, что ответный траф трейдеру не возвращается;
- redirect означает что при входе на сиджей серфер сразу редиректится на определенный URL;
- no lim означает что трейдер прислал за сутки меньше юников, чем необходимо для ведения трейда;
- no return означает что трейдер не присылал юников дольше, чем определено в настройках, обмен с этим трейдером приостановлен до первого юника от этого трейдера;
- ratio lim означает что трейдер не выдерживает установленных ограничений по соотношению аутов и инов;
- prod lim означает что трейдер не выдерживает установленных ограничений по соотношению аутов и кликов;


4 поля управляющих линков:

Days - линк на ежедневную статистику трейдера или группы трейдеров (если данный трейд идет больше суток)
Edit - линк на страницу управления параметрами трейдера (и обмена с этим трейдером).
Del - линк удаления трейдера из БД Вашего CJ
Black - линк бана трейдера и удаления из БД Вашего CJ

В первой строке (COMMON) показаны суммарные показатели по активности всех без исключения посетителей Вашего CJ за последние 24 часа.

Следующие 4 строки (NOREF, EXOUT, URL & DELETED) отражают информацию по активности этих псевдотрейдеров.

6-я строка (no traders) показывает суммарную активность псевдотрейдеров.
7-я строка (traders) показана суммарная активность посетителей, пришедших от зарегистрированных в БД трейдеров и ушедших к зарегистрированным в БД трейдерам.

Далее идет статистика по трейдерам, которые расположены в том порядке, в каком их расположил алгоритм трейда на данный момент - чем выше трейдер, тем выше его приоритет в получении исходящего трафа.

Hourly IN Graph for last 24 hours

Этот график отражает почасовую динамику юников за последние 24 часа.
При навелении курсора на столбец диаграммы всплывает час и значение входящего трафа на этот час.
Красным цветом для наглядности обозначен текущий час (значение в этом столбце меняется ежеминутно, после каждого текущего расчета).

Hourly OUT Graph for last 24 hours

Этот график отражает почасовую динамику аутов за последние 24 часа.
При навелении курсора на столбец диаграммы всплывает час и значение исходящего трафа на этот час.
Красным цветом для наглядности обозначен текущий час (значение в этом столбце меняется ежеминутно, после каждого текущего расчета).

SETTINGS Page

На этой странице Вы можете задать основные настройки своего CJ.

Страница разбита на несколько блоков.

INFO block

Domain - здесь указывается домен, на котором расположен Ваш CJ, без "http://www.", например "yourdomain.com".

URL - здесь указывается основной URL Вашего сиджея, на который трейдеры будут возвращать траф.

Далее идут информационные поля - Site Name, Webmaster Name, ICQ Number, ICQ Nick, E-Mail - которые также рекомендуется заполнить: во-первых, данные из них вносятся на Вашу страницу сабмита, во-вторых, по указанному Вами e-mail Вам будет высылаться информация о новых трейдерах

ALGORYTHM block

Здесь Вы можете изменить основной алгоритм трейда.
Обратите внимание, что на главной странице статистики колонка, содержащая базовый показатель используемого в данный момент алгоритма выделяется жирным шрифтом.

FORCES & LIMITS block

Default Forces (%) - Здесь указывается режим и значение форсов по умолчанию для новых трейдеров. Всем трейдерам, внесенным в базу через сабмит-форму, будут назначены форсы указанного здесь типа и в указанном здесь размере.
Существует 3 типа форсов - дневные, почасовые и "мягкие". Для установки первых двух типов форсов Вы должны выбрать соответственно per day или per hour и указать желаемое количество форсированных аутов соответственно в день или в час.

Выбрав per day и установив в поле значение 100, вы утверждаете что по умолчанию трейдерам будет отдаваться по 100 форсированных аутов ежедневно.
Выбрав per hour и установив в поле значение 10, вы утверждаете что по умолчанию трейдерам будет отдаваться по 10 форсированных аутов каждый час.

О третьей категории форсов, soft или "мягких" форсах, стоит рассказать подробнее.

Эта опция позволяет отдавать определенную долю трафа равномерно всем трейдерам, для которых установлен такой тип форсов. Работает следующим образом.
Допустим, Вы установили значение 30%.
Каждую минуту скрипт составляет список всех трейдеров, которым назначены soft forces и считает их количество. Затем берет сумму аутов на всех трейдеров за последние сутки, делит на количество soft forces трейдеров, берет 30% от полученного значения, округляет в меньшую сторону и выставляет каждому из этих трейдеров трейдеру полученное значение в форсы.
Обратите внимание, что для всех трейдеров, которым назначены soft forces, устанавливается единое значение soft forces в поле Soft Forces, при этом значение поля Default Forces игнорируется.

Рекомендуется, чтобы для всех трейдеров был установлен этот режим, тогда, назначив например soft forces в размере 30%, Вы получите следующий результат:
30% всего трафа будет распределяться между трейдерами равномерно, остальные 70% трафа будут распределены согласно алгоритму.
Установка любого другого типа форсов для трейдера выводит его из системы soft forces.

С помощью этой опции Вы также можете распределить траф на трейдеров полностью равномерно - для этого назначьте soft forces в размере 100%.
Для сохранения распределения более-менее существенной части трафа по алгоритму необходимо, чтобы значение soft forces не превышало 50%. Чтобы эта система не действовала вообще, Вам нужно установить значение 0% или отключить soft forces у всех трейдеров, тогда трейд будет производиться исключительно по алгоритму.

Default OUTs by INs Limit (%)(ограничитель по рацио) - это значение, которое выставляется по умолчанию в качестве лимита отдачи трафа трейдерам по соотношению OUT/IN.
Если Вы назначили это ограничение, например в размере 120%, то трейдерам будет отправляться трафа не больше значения IN*1,2.
Значение этого ограничителя не может быть меньше 100%, в противном случае ограничитель будет игнорироваться.

Default OUTs by CLICKs Limit (%)(ограничитель по эффективности) - это значение, которое выставляется по умолчанию в качестве лимита отдачи трафа трейдерам по соотношению OUT/CLICK.
Если Вы назначили это ограничение, например в размере 120%, то трейдерам будет отправляться трафа не больше значения CLICK*1,2.
Значение этого ограничителя не может быть меньше 100%, в противном случае ограничитель будет игнорироваться.

Minimal INs for trade - количество INs от трейдера за сутки, необходимое для того, чтобы начать отдавать ему трафик. Устанавливается для всех активных трейдеров. Не рекомендуется выставлять в начале раскрутки сиджея.

Time Modificator - Установка этого значения позволяет понижать позицию в рейтинге трейдеров, которые слишком давно не присылали траф. Например, если значение этого поля будет выставлено в "2", то за каждый час, в течение которого трейдер не присылал траф, с рейтингового показателя будет вычитаться по 2%. При значении "0" не вычитается ничего.

Block trade - Установка этого значения позволяет отключать обмен с трейдерами, которые слишком давно не присылали траф. Например, если значение этого поля будет выставлено в "2", то после 2 часов "молчания" трейдера ему перестает возвращаться траф до момента, пока он не пришлет хотя бы одного юника. При значении "0" эта опция не действует.

Count of registered clicks to traders - Здесь указывается число аутов на трейдера, которые регистрируются скриптом.
Это ограничение сделано для того, чтобы учитывать отправку трейдерам только относительно качественного трафа (первые клики).
Очевидно, что двадцатый клик, отправленый на трейдера, много пользы ни ему, ни Вам не принесет, поэтому учитывать его смысла нет.

Рекомендуется устанавливать здесь значение не больше 5.

Алгоритм работает следующим образом:

Допустим, Вы задали здесь значение 3.

Первый клик юника. Допустим, юник попадает на первого трейдера из рейтинга (согласно Вашему плану показа).
Значение счетчика = 3 (!=0), поэтому клик юника и аут на трейдера регистрируются.
Значение счетчика уменьшается на единицу, становится равным 2.

Второй клик юника. Допустим, юник попадает на контент.
Юник попадает на контент, поэтому клик юника и аут на url регистрируются.
Поскольку клик идет не на трейдера, значение счетчика не меняется.

Третий клик юника. Юник попадает на очередного трейдера из рейтинга.
Значение счетчика = 2 (!=0), поэтому клик юника и аут на трейдера регистрируются.
Значение счетчика уменьшается на единицу, становится равным 1.

Четвертый клик юника. Юник попадает на контент, поэтому клик юника и аут на url регистрируются.
Поскольку клик идет не на трейдера, значение счетчика не меняется.

Пятый клик юника. Юник попадает на очередного трейдера из рейтинга.
Значение счетчика = 1 (!=0), поэтому клик юника и аут на трейдера регистрируются.
Значение счетчика уменьшается на единицу, становится равным 0.

Шестой клик юника. Юник попадает на контент, поэтому клик юника и аут на url регистрируются.
Поскольку клик идет не на трейдера, значение счетчика не меняется.

Седьмой клик юника. Юник попадает на очередного трейдера из рейтинга.
Значение счетчика = 0, поэтому клик юника и аут на трейдера НЕ регистрируются.

Далее клики юника на трейдера регистрироваться не будут, однако он будет отправляться на очередных трейдеров из рейтинга.
Клики на URL и exout'ы будут регистрироваться.

NOREF block

Здесь редактируются URL редиректа для двух категорий серферов:
- для серферов, пришедших вообще без рефа (NULLREF);
- для серферов, пришедших со страницы, которая не опознана как страница одного из трейдеров (NOREF);

После записи в базу информации о входе эти серферы будут отправлены на редирект по соответствующему URL

NICHES & EXOUTS block

Здесь редактируются URL exout'ов для всех имеющихся в списке ниш. Если для линка out.php не указана ниша, или указана ниша, которой нет в списке, используется URL для ниши general.
Добавляются и удаляются ниши с помощью управляющего линка Add/Delete Niches

LANGUAGES block

Здесь редактируются URL редиректов для всех имеющихся в списке языков. Добавляются и удаляются языки для редиректа с помощью управляющего линка Add/Delete Languages

TRAF QUALITY block

Три пары чекбоксов управляют дисквалификацией качества трафа по трем признакам:
- если серфер пришел через прокси;
- если у серфера отключены куки;
- если у серфера отключен JS или куки;

Выбор первого(левого) чекбокса приведет к дисквалификации всех серферов, обладающих соответсвующим признаком, то есть QUAL для них будет равно 0;
Выбор обоих чекбоксов приведет, помимо дисквалификации, еще и к тому, что все клики, сделанные серфером, обладающим соответствующим признаком, не будут идти к трейдерам, а будут отправляться на эксаут.

В поле Disquality & send to exout if "too quick click" пишется временной диапазон в секундах. Если время между кликами серфера меньше этого диапазона, клик считается накрученным ("слишком быстрым"), дисквалифицируется и отправляется на exout. Установка значение 0 ведет к отключению проверки по этому признаку.

Good Languages/Bad Languages - списки хороших и плохих языков. Каждый язык в новой строке.
Посетитель, имеющий "хороший язык" получит уровень QUAL равный 2-м (при отсутствии дисквалифицирующих признаков - отключенный js, cookie, etc), а имеющий "плохой язык" - QUAL равный 0. Посетители с остальными языками получают QUAL равный 1 (опять же, при отсутствии дисквалифицирующих признаков).

SHOWS PLAN block

Здесь настраивается схема показа посетителю трейдеров и реального контента, если он есть.

Вы указываете в каждой новой строчке значение url или trader (на самом деле, все что не "url" считается "trader") в том порядке, как предполагается показывать. Длина схемы не ограничена.
После прохождения схемы, скрипт вернется к ее началу и начнет показ заново (бесконечный цикл).

Если схема показов не заполнена, всегда будет показываться трейдер.

RULES block

Здесь Вы можете редактировать правила для трейдеров, которые будут отображаться на Вашей странице публичного сабмита.
Используйте тэги HTML по своему усмотрению.

Чекбокс "Close Submit" позволяет временно заблокировать добавление новых трейдеров.

TOPLIST block

Здесь указываются настройки для создания скриптом топлистов.

Sort by INs - этот чекбокс указывает, что трейдеров надо ранжировать по количеству юников за сутки. Если этот бокс не отмечен, трейдеры будут ранжироваться то текущему рейтингу трейда

Топы будет создаваться скриптом ежеминутно и помещаться в файлы, указанные в соответствующих полях. Заполнение поля для ниши general является обязательным, если оно пустое, то топлист будет создаваться в файле toplist.html в корне домена.
Для остальных ниш топлисты будут создаваться только в том случае, если указано имя файла топлиста.

ВНИМАНИЕ!!! Если Вы укажете имя файла, в которое скрипт не сможет записать топлист (например, укажете несуществующую директорию или не позаботитесь о правах записи в эту директорию) - возможны ошибки в работе скрипта, создающего топы.

При нажатии на линк Niche top template Вы попадаете на страницу ввода шаблона топлиста для данной ниши. Это html-код (или php-код), в котором Вы можете использовать маски для подстановки различных элементов. В общем виде маска выглядит как

!%#TraderNum#%!ElementNum

ElementNum могут быть следующими:

- 1 - порядковый номер трейдера в топе;
- 2 - URL вида out.php?trader=domain.com;
- 3 - название сайта трейдера или домен, если названия нету;
- 4 - URL трейдера;
- 5 - количество INs трейдера за последние сутки;
- 6 - количество OUTs трейдера за последние сутки;
- 7 - количество CLICKs трейдера за последние сутки;

Таким образом, маска !%#9#%!3 означает, что на ее место будет вставлено название сайта трейдера №9.

* * * * * *
После нажатия на кнопку Submit, скрипт выведет надпись Setup Complete и покажет ту же страницу с уже измененными данными. При нажатии Submit также происходит модификация Вашей сабмит-формы в соотвествии с новыми данными из INFO Block & RULES Block.

MASS EDIT Page

Данные, которые здесь вводятся, аналогичны данным на страницах EDIT Pages, но позволяют вносить изменения одновременно у всех трейдеров. Значения, поля которых остались незаполненными, изменяться не будут.

EVENTS Page

Страница управления cron-образными форсами. Состоит из трех частей:

- списка существующих правил с возможностью удаления
- списка выполняемых в данный момент заданий с возможностью удаления
- формы создания нового правила

Правила состоят из 3-х частей: cron-образной маски, определяющей время возникнования задания, трейдера (домена) и размера задания (форсов).

Cron-образная маска состоит из 5 полей, обозначающих (слева направо):

- минуты (0-59)
- часы (0-23)
- дни месяца (1-31)
- дни недели (0-6, где 0-воскресенье, 6-суббота)
- месяцы (1-12)

Каждое поле может состоять из:

- одного числа
- нескольких чисел,разделенных запятой
- знака "*", обозначающего "при любом значении"
- пустое поле интерпретируется как "*", при этом хотя бы одно поле при создании нового задания должно быть заполнено явно.

Например, маска "0 * 13 5 9,10,11" обозначает, что задание будет создаваться в

0 минут
каждого часа
по 13-м числам
в пятницу
всех осенних месяцев (сентябрь, октябрь, ноябрь)

При этом надо отметить, что для всех полей, включая дни месяцев и дни недели работает правило "И" - то есть если 13 числа в сентябре будет четвергом, то задание создано не будет, и на следующий день, в пятницу, 14 числа, задание тоже создано не будет.
Необходимо полное совпадение всех полей с текущей датой, чтобы задание было создано.

Еще один важный момент - если к моменту создания очередного задания для трейдера его предыдущее задание не выполнено, то оно удаляется и создается новое, без учета степени выполнения старого задания.

Force Now!!! - немедленная отправка форсов трейдеру: в течение минуты после нажатия этой кнопки будет создано задание для отправки выбранному трейдеру форсов в количестве, указанном в поле Force Count

ADD TRADER Page

Это форма, с помощью который Вы можете добавлять трейдеров самостоятельно либо дать ее URL трейдерам, чтобы они заполнили ее сами.
Данные, которые необходимо ввести, полностью аналогичны данным раздела INFO Block страницы SETTINGS.
Для трейдера будут выставлены значения форсов и лимитов, назначенные Вами как значения по умолчанию в разделе FORCES & LIMITS Block страницы SETTINGS.
Для изменения этих значений в отношении данного трейдера Вам необходимо воспользоваться управляющим линком EDIT.

DELETED Рage

На этой странице Вы можете увидеть всех трейдеров, удаленных Вами из списка активных, дату и причину удаления.

Stats - ежедневная статистика обмена с этими трейдерами вплоть до момента удаления.

Return - вернуть удаленного трейдера в спискок активных (возобновить трейд).

BLACKLISTED Рage

На этой странице Вы можете увидеть всех трейдеров, занесенных Вами в блэклист, дату и причину бана.

Stats - ежедневная статистика обмена с этими трейдерами вплоть до момента бана.

Return - вернуть забаненного трейдера в спискок удаленных.
Обратите внимание, что это действие не приводит к возобновлению трейда, для внесения трейдера в список активных нужно войти на страницу VIEW DELETED и там снова нажать Return.

INTERFACE Page

На этой странице Вы можете дизайн своей админ-зоны.

В блоке "Сolors" Вы можете изменить палитру админ-зоны.

Список и кнопка "Load Template" позволяет загрузить сохраненный ранее шаблон.
Кнопка "Preview Template" позволяет увидеть, как будет выглядеть основная страница админ-зоны в загруженном шаблоне.
Кнопка "Change Colors" делает настройки активными - после ее нажатия все страницы админ-зоны будут отображаться в соответствии с ними.
Обращаю Ваше внимание на то, что нажатия Load Template недостаточно для изменения вида админки, нужно еще активировать шаблон нажатием Change Colors

Чекбокс "Save as Template" позволяет сохранить данные настройки в качестве шаблона.

Линк Colors Table предназначен для облегчения выбора цветов.

В блоке "Columns" Вы можете изменить внешний вид основной таблицы Вашей админки;
- добавить, удалить отображаемые колонки, изменить порядок их показа.Для этого Вам предлагается последовательно выбрать для каждой колонки название отображаемого в ней показателя.
Некоторые названия колонок, вероятно, не требуют пояснений, остальные на всякий случай опишу:
number - порядковый номер трейдера в рейтинге на данный момент;
lim - колонки, отображающие настройки лимитов трейдера;
stat - колонка, отображающая статус трейдера (ноаут, редирект,нишу);
control - группа колонок с управляющими линками трейдера (Stats,Edit,Del,Black);
h_qual - качество трафа в текущем часе;
h_in - количество юников в текущем часе;
h_click - количество кликов в текущем часе;
h_out - количество аутов в текущем часе;
rating - значение рейтинга с учетом всех квалификаторов и дисквалификаторов - по качеству трафа, по времени последнего юника и т.д. На основании этой цифры собственно и строится рейтинг трейда;

Список "Sort By" позволяет изменить параметр, по которому сортируются записи в таблице. По умолчанию, они ранжируются по текущему рейтингу трейда ("rating").
Список "Sort Order" позволяет изменить порядок ранжирования:

ASC - по возрастанию
DESC - по убыванию

"Font Size" позволяет изменить размер шрифта в таблице

PASSWORD Page

На этой странице Вы можете изменить логин и пароль для доступа в свою админ-зону.

REFERERS Page

На этой странице Вы можете увидеть статистику по страницам, с которых серферы попадали на Вашу входную страницу.
Реферы сгруппированы по доменам, при нажатии на линк Details Вы можете увидеть подробный отчет по входам с данного домена
Метка QUERY показывает, что на страницы реферов вызывались с использованием строки параметров (QUERY STRING).
Метка POST показывает, что некоторые входы с данного домена делались с использованием метода POST, что является одним из признаков попытки накрутки.

Ресет лога производится нажатием на линк Clear Log

Вы также можете изменить порядок сортировки - по количеству хитов либо по алфавиту

LINKS Page

На этой странице Вы можете увидеть статистику кликов по различным LINKNAME's, которые Вы указывали в своих линках. Если линк создавался без этого атрибута, то клики по нему регистрируются в строке GENERAL
Ресет лога производится нажатием на линк Clear Log

Add/Delete Niches Page

На этой странице Вы можете увидеть список имеющихся ниш и URL соответствующих exout'ов и добавить или удалить нишу. Для добавления ниши, Вам нужно внести название и URL в соответствующие поля. Для удаления ниши Вам нужно отметить соответствующий бокс. Редактирование URL доступно в разделе NICHES & EXOUTS Block страницы SETTINGS.

Add/Delete Languages Page

На этой странице Вы можете увидеть список языков и URL редиректа и добавить или удалить язык. Для добавления языка, Вам нужно внести его обозначение и URL редиректа в соответствующие поля. Для удаления языка Вам нужно отметить соответствующий бокс. Редактирование URL доступно в разделе LANGUAGES Block страницы SETTINGS.

STATS Pages

Страница ежедневной статистики обмена с данным трейдером за все время работы с ним. Аналогична странице основной статистики.

EDIT Pages

Кнопка "Clear Stats for Last 24 Hours" служит для обнуления всех статсов трейдера - INs, OUTs & CLICKs.

Первые 6 полей нам уже хорошо знакомы по страницам SETTINGS и ADD TRADER, за исключением того, что значение Domain мы отныне менять не можем, поскольку оно является основным идентификатором данного трейдера.

Domain - здесь указан домен, на котором расположен CJ трейдера, без "http://www.", например "traderdomain.com".

URL - здесь указывается основной URL сиджея трейдера, на который Вы будете возвращать траф.

NO OUT - Отметив этот бокс, мы утверждаем, что трейдеру не будет отправляться ответный трафик. Он перестает фигурировать в рейтингах и топлисте. Такое может понадобиться при необходимости учитывать трафик с какого-либо URL, с которым у Вас нет трейда, например, если Вы создаете трейдера с доменом google.com, отмечаете ему NO OUT, то Вы будете видеть размер трафика с Гугля.

Важный момент - для трейдеров, помеченных noout'ом, можно назначать cron-образные форсы и они будут выполняться. Таким образом можно лимитировать траф на топы.

...and Redirect to - дополнительная возможность к боксу NO OUT - здесь указывается URL, куда будет редиректиться весь траф, пришедший от этого трейдера. В примере с Гуглем, Вы можете указать здесь URL спонсора и отправлять поисковый траф непосредственно на него, минуя морды сиджея.

Далее идут инофрмационные поля - Site Name, Webmaster Name, ICQ Number, ICQ Nick, E-Mail.
Рекомендуется заполнить, хотя принципиального значения это не имеет.

Niche - здесь Вы можете указать нишу трейдера. По умолчанию все трейдеры имеют нишу general (то есть, по сути, не имеют ниши). Изменив это значение, Вы получите следующий результат:
- при входе на сиджей юник от этого трейдера будет попадать на нишевый вход, который Вы можете создать в папке .../html/ (там же, где лежит файл главной морды) под именем "имя_ниши.htm";
- трейдер будет включен в рейтинг по этой нише, при клике на линк этой ниши серфер будет сперва отправляться на трейдеров из этого рейтинга, а затем уже - на трейдеров из общего рейтинга.

Only niche traf - пометив этот чекбокс, Вы добьетесь того, что этот трейдер не будет получать никакой траф, кроме трафа своей ниши.
Разумеется, это будет иметь эффект только для тех трейдеров, которым назначена ниша.

Далее Вы можете изменить значения ограничителей. Как упоминалось раньше, лимиты должны быть не меньше 100%, в противном случае они будут игнорироваться.

Следующий блок предназначен для изменения режима и размера форсов.
Вы Можете выбрать один из четырех переключателей.
Для режима Soft Forces устанавливается единый для всех процент в соответствующем поле разделa FORCES & LIMITS Block страницы SETTINGS.
При выборе режима почасовых форсов Вы можете внести или откорректировать значение форсов для каждого часа.

DEL & BLACK Pages

Эти два линка управления внешне идентичны - скрипт запрашивает причину, по которой Вы собираетесь удалить трейдера из активной базы, затем удаляет. В качестве причины Вы можете ввести все что угодно, можете ничего не вводить.
Разница между двумя этими действиями такая:
- при обычном удалении трейдера, он может возобновить с Вами трейд, заново зарегистрировавшись в Вашей форме.
- если же трейдер внесен в блэклист, то его регистрация будет отклонена.

Ротаторы тумб и дескрипшнов

Принцип работы ротатора тумб и десков прост.

Скрипт учитывает количество показов каждой тумбы (деска) и количество кликов по ним в течение указаного в настройках времени (обычно 24 часа), и ежеминутно расчитыват CTR каждой тумбы (деска).
По результатам пересчета, скрипт выстраивает рейтинг тумб (десков), в котором наверху находятся наиболее кликабельные, и на основе этого рейтинга и задаваемого в настройках шаблона создает файлы, которые можно вставлять в "морду" сиджея с помощью php-команды include().
Хочу обратить внимание, что скрипт создает как "общие" файлы, в которых содержатся тумбы без разделения по нишам (эти файлы имеют имена general0, general1 и т.д.) так и файлы для каждой ниши (например teen0, teen1 и т.д.)

Итак, что необходимо для нормальной работы "тумбокрута":

1. Создать одну или несколько баз тумб.
База представляет из себя текстовый файл, в котором определены фиксированые разделители записей (обычно "перевод строки" - ASCII-код 10) и полей (например, символ "|").
Каждая запись содержит описание одной тумбы.
Поля в записи могут располагаться в любом порядке, главное чтобы во всех файлах баз этот порядок и количество полей в записи сохранялись неизменными.

Поля могут содержать следующую информацию о тумбах:
- URL тумбы (должно быть обязательно)
- URL галереи, на которую будет вести ссылка под тумбой
- описание галереи
- количество фото в галерее
- название ниши
- высота тумбы
- ширина тумбы
- метка, определяющая тумбу как вертикальную или горизонтальную

2. Настроить скрипт для работы с базой.
Нажав ссылку Tmb Setup на главной странице админ-зоны, Вы попадаете на страницу настройки скрипта-"тумбокрута".
Далее идет описание всех параметров настройки скрипта.

Thumbs Files Count
Здесь указывается, сколько файлов будет создано в результате работы скрипта для общего списка и для каждой ниши.
Например, если Вы укажете здесь значение 2, и если у вас тумбы разделены на 2 ниши (teen & mature), то всего будет создано 6 файлов (2 "общих" и по 2 для каждой ниши): general0, general1, teen0, teen1, mature0, mature1.

Thumbs Files Path
Здесь надо указать полный путь к директории, в которую будут записываться файлы результатов работы скрипта. Директория должна иметь chmod 777.

Count of Thumbs in 1 File
Здесь указывается максимальное количество тумб в одном файле-результате. Например, если Вы укажете здесь "20", то в файл general0 будут помещены первые 20 тумб из рейтинга, в файл general1 - c 21-й по 40-ю тумбы, в файл teen0 - первые 20 тиновых тумб из рейтинга, в файл teen1 - с 21-й по 40-ю тиновые тумбы и т.д.

Test Shows
Здесь указывается процент тестового показа тумб - Вы можете задавать соотношение показов тумб "по кликабельности" и "равномерного показа".
Например, Вы задаете здесь значение 15%.
Каждую минуту скрипт считает общее количество показов тумб, делит его на количество тумб и берет от полученной цифры 15%. Таким образом, расчитывается, сколько раз каждая тумба должна быть показана серферам на данный момент. Те тумбы, которые не добрали нужного количества показов, выводятся в верх рейтинга и показываются, пока не наберут нужного числа показов.
С помощью этой опции мы обеспечиваем показ не только наиболее кликабельных тумб, но и постоянное тестирование всех остальных. Чем ниже процент, тем менее интенсивно тестируются все тумбы и тем чаще показываются самые кликабеьные тумбы.

Stats Expiry
Здесь указывается "время жизни" статистики по показам и кликам (обычно 24 часа).

URL of Show Counter "show.php"
URL счетчика показов тумб tmbshow.php (для десков имя файла dscshow.php)

Gallery Bases Count
Количество баз тумб. Обычно делается один файл базы, но если Вы по каким-то причинам хотите использовать несколько файлов, Вам нужно ввести их число и нажать кнопку "Setup Thumbs Rotator", после чего будет показано нужно число полей для каждой базы.

Thumbs Base N
Описание файла базы.
Содержит поле "полный путь к файлу базы", поле "ниша базы" (если будет указана какая-либо ниша, то ВСЕ тумбы из этого файла будут считаться относящимися к этой нише) и отметки "вертикальные" или "горизонтальные" (соотвественно, ВСЕ тумбы из этого файла будут определяться как вертикальные или горизонтальные).

Records Divider
Здесь указывается символ-разделитель записей либо его ASCII-код. Обычно используется символ "перевод строки", указывается его код 10.

Fields Divider
Здесь указывается символ-разделитель полей (например, "|") либо его ASCII-код

Далее идут указания, какое поле что обозначает в базе.
ОБРАТИТЕ ВНИМАНИЕ! Нумерация полей начинается с 0 (не с 1!)

Number of Thumb URL Field
номер поля "URL тумбы" (должно быть обязательно)

Number of Gallery URL Field
номер поля "URL галереи"

Number of Gallery Desc Field
номер поля "описание галереи"

Number of Pictures Count Field
номер поля "количество фото в галерее"

Number of Niche Field
номер поля "название ниши"

Number of Thumb Width Field
номер поля "высота тумбы"

Number of Thumb Height Field
номер поля "ширина тумбы"

Следующие несколько пунктов настройки позволяют определить тумбы как вертикальные или горизонтальные.
Обращаю Ваше внимание, что вертикальными считаются все "негоризонтальные" (в том числе и квадратные) тумбы. Если скрипт не определил, вертикальной или горизонтальной является данная тумба, он считает ее вертикальной.

Define Vertical/Horizontal by Height/Width
Отметив этот чекбокс, мы указываем скрипту самостоятельно определять вертикальность или горизонтальность тумбы по соотношению высота/ширина.

Number of Horisontal Flag Field
номер поля "метка, определяющая тумбу как горизонтальную"

Value of Horisontal Flag
Значение этого поля, которое сообщает скрипту, что тумба горизонтальная (например символ "h")

Number of Vertical Flag Field
номер поля "метка, определяющая тумбу как вертикальную"

Value of Vertical Flag
Значение этого поля, которое сообщает скрипту, что тумба вертикальная (например символ "v")

Далее идет описание шаблона, по которому будет формироваться файл результатов работы скрипта.

Шаблон двухуровневый: main template, или главный шаблон, описывает базовую структуру всего документа, указывает куда нужно вставлять описания тумб. Для каждой тумбы используется маска субшаблона. В соответствующем этой маске субшаблоне детально описывается информация, которая вставляется в это место для каждой тумбы.

Например, главный шаблон (Main Template) может выглядеть так:


Здесь видно, что итоговый файл будет представлять собой таблицу из двух строк, в которую будут вставлены 4 вертикальных (об этом говорит участок "!#V#" в маске субшаблона) и 4 горизонтальных ("!#H#") тумбы. Кроме того, мы видим что для детального описания формата вставляемых тумб везде использутся субшаблон 0 (участок "#U#!0").
Цифра в середине маски субшаблона означает порядковый номер вставляемой тумбы.
Маска !#SHOW#! указывает, куда будет вставлен счетчик показов тумб (если эта маска не указана, счетчик будет вставлен в начало каждого файла)

Далее, смотрим как может выглядеть описание субшаблона 0 (Template 0):


Главную информационную нагрузку здесь несут цифры после символов "#!":
0 - URL тумбы
1 - URL галеры
2 - деск галеры
3 - кол-во фото на галере
4 - ниша
5 - высота тумбы
6 - ширина тумбы
7 - ID тумбы

Седьмое поле нужно вставлять ОБЯЗАТЕЛЬНО, чтобы при клике на тумбу скрипт out.php смог этот клик учесть и однозначно привязать к данной тумбе.
Сам ID формируется скриптом на базе URL тумбы и выглядит как число (по принципу алгоритма CRC32)
По аналогичному принципу постоен и ротатор дескрипшнов, за исключением того, что там маски шаблонов и субшаблонов имеют немного другой формат.

Со всеми вопросами и неясностями обращайтесь к автору скрипта


Xrenoder

ICQ 2625855
E-mail: xrenoder@xrenoder.com