Документация // Актуальность: 25/12 2014, v.1.4.4

Документация

  • Вступление

    ЕСЛИ НА СЕРВЕРЕ С ТДС 1GB RAM ИЛИ БОЛЬШЕ - НЕ ЗАБУДЬТЕ ВЫКЛЮЧИТЬ ОЧЕРЕДЬ ЗАПРОСОВ В НАТРОЙКАХ ТДС (МЕНЮ ДОПОЛНИТЕЛЬНО -> НАСТРОЙКИ).

    Панель управления ТДС проста в использовании. Меню вверху страницы испоьзуется для управления настройками ТДС. Язык интерфейса можно преключить, кликнув на флаг страны в верхнем меню. Для того чтобы разлогиниться, кликните на наш логин в правом верхнем углу меню. Там же вы можете изменить логин и пароль.

    Для проверки, есть ли связь с серверами лицензий и все ли в порядке с вашей лицензией, перейдите на главную страницу ТДС и нажмите кнопку 'Проверить лицензию...'.

    Получить детальную информацию о системе можно там же на главной странице, кликнув на 'Системная информация'.

    Каждая страница ТДС содержит встроенные подсказки. В каждом редакторе есть раздел 'Подсказка' - кликните на эту надпись стобы прочитать краткую информацию по данному редактору в целом. Кроме этого рядом с большинством полей и свойств есть зеленые знаки вопроса. При наведении курсора мыши на такой знак выводится подсказка по данному полю.

    Принцип работы ТДС очень прост: ТДС принимает трафик и редиректит его на различные адреса в соответствии с написанными вами правилами и параметрами каждого конкретного HTTP-запроса.

  • Редактор схем

    Редактор схем служит для создания и управления схемами перенаправления трафика. Каждая схема содержит один или более АУТов - это целевые страницы, куда будет уходить трафик. Вы шлете трафик на IN URL схемы, и ТДС решает, какой конкретно из АУТов выбрать для редиректа. Если ни один из АУТов не принимает данный хит, ТДС редиректит его на АУТ по умолчанию схемы.

    В редакторе вы можете видет список всех схем. Разбиения на страницы нет, поэтому для удобства работы держите количество схем в разумных пределах. В этом списке вы можете включать и выключать схемы, не переходя в редим редактирования конкретной схемы. Для создания новой схемы нажмите кнопку 'Создать новый'. Для удаления схемы нажмите красную кнопку 'удалить'. Для модификации схемы нажмите синюю кнопку 'изменить'.
    В нижней части каждой строки списканаходятся зеленые кнопки для перехода на просмотр статистики схемы и небольшая красная кнопка в виде крестика для очистки статистики.
    Для просмотра и управления АУТами схемы, нажмите на кнопку 'АУТы схемы'.

    Свойства схемы

    Увидет свойства можно нажав на кнопку 'Изменить' или при создании новой схемы.

    IN Url
    URL на который будет приходить трафик, точнее часть URL. Например, если ТДС стоит на домене http://yourdomain.com, изначение этого поля 'someurl', вы будете слать ваш траф на http://yourdomain.com/in/someurl. Поле должно быть уникальным.
    Также вы можете слать траф на этот URL с добавлением параметров (http://yourdomain.com/in/someurl?param1=val1&param2=val2), и иметь доступ к этим параметрам в АУТах схемы.
    Включен
    Если схема выключена, ТДС будет возвращать ошибку 404 всем приходящим на эту схему посетителям (как если бы схема не существовала вообще).
    Имя
    Небольшая строка для того чтобы отличить эту схему от всех остальных в списке. Не обязательно должно быть уникальным, но очень желательно.
    Метка
    Метки нужны для фильтрации схем в редакторе схем. Если у вас есть несколько схем, логически относящихся к одному проекту или как-либо иначе связанных между собой, назначьте им одинаковую метку. После этого вы сможете легко фильтровать эти схемы от всех других в редакторе схем и в отчетах. Не обязательное поле, но иногда очень полезное.
    Описание
    Краткое описание схемы, комментарий и т.п.
    АУТ по умолчанию
    Если ТДС не может отправить посетителя ни на один из АУТов (все они в соответствии с их правилами не принимают данный хит), посетитель будет перенаправлен на адрес из этого поля.
    Форматы: http://foo.bar - чтобы перенаправлять на http://foo.bar; boss://inurl - чтобы делать внутренний редирект на другую схему с IN URL равным 'inurl'; code://[code]/[message] - чтобы вернуть HTTP ответ с заданным кодом и сообщением, например code://404/Not found или code://403/Forbidden.
    Обязательное поле.
    UTTL
    Трекинг. Посетитель будет считаться неуникальным в течение этого времени (в часах) после его последнего визита.
    Уники по
    Как отслеживать уников - по IP (который бывает одинаковым у разных пользователей) или по cookie (которые могут быть легко очищены). Обе опции имеют свои плюсы и минусы.
    Включить проверку клиента
    Эта опция позволяет получать данные о свойствах клиента (браузера), таких как поддерживает ли браузер javascript, flash, открыт ли URL во фрейме или нет и размеры окна браузера. Если эта опция включена, сохранение реферера невозможно. Кроме этого, эта опция делает перенаправление более медленным, т.к. происходит 2 редиректа вместо одного, и сильне нагружает саму ТДС. После включения этой опции становится доступным правило 'Проверка клиента'.
    Спец. статистика - шаблоны
    Для получения дополнительной статистики можно назначить схеме шаблоны спец. статистики. Каждый шаблон по своей сути состоит из списка переменных, которых вы хотите сохранить в отчете. В спецотчетах можно сохранять IP адреса клиентов, HTTP заголовки, GET параметры запроса и другие переменные.
    Запись этих отчетов относительно медленная операция и в зависимости от выбранных переменных может потребовать большого количества места на диске (больше чем вы ожидаете). Поэтому старайтесь не писать больше чем нужно спец. отчетов, а в тех что пишете, выбирайте список переменных с умом и старайтесь, насколько это возможно, аггрегировать сохраняемые данные .
    Правила
    Правила схемы работают в роли предварительного фильтра. Они будут проверены перед началом выбора АУТов.
    Каждое правило либо принимает запрос, либо отклоняет.
    Если ЛЮБОЕ из правил тклоняет запрос, посетитель будет немедленно отправлен на АУТ по умолчанию без проверки АУТов.
    Больше информации по правилам и их работе можно найти в секции 'Правила' ниже на этой странице.
    Трансформации
    Переменные, созданные в результате этих трансформаций, будут доступны в каждом из АУТов схемы. В свойствах каждого из АУТов можно определить свои трансформации, которые могут перезаписать трансформации схемы, если в обоих случаях результат трансформации пишется в переменную с одним и тем же именем.
    Транформации создают переменные; эти переменные впоследствии могут использоваться в спецотчетах или как часть URL АУТов в виде http://foo.com?bar={{ varname }}. {{ varname }} при этом будет замещена значением переменной с именем 'varname'.
    Больше информации по переменным и трансформациям вы можете прочесть в секции 'Переменные и трансформации' ниже на этой странице.
    Гостевая статистика
    Используется для того, чтобы безопасно показать статистику посторонним лицам. Например покупателям вашего трафика. Если вам это не нужно, оставьте поле 'пароль' пустым.
    Гостевая статистика - пароль
    Пароль для гостевого доступа к дневным отчетам. Пустое поле - гостевой доступ отключен.
    Гостевая статистика - Действует с
    Дата начала действия пароля. Пустое поле - без ограничений по дате.
    Гостевая статистика - Действует до
    Дата окончания действия пароля. Пустое поле - без ограничений по дате.

  • Редактор АУТов

    АУТ - это конечная страница в цепочке редиректов. Трафик попадает на IN URL схемы и уходит на один из АУТов схемы. В принципе, АУТы сами по себе существовать не могут и являются неотъемлемой частью схемы. При удалении схемы вместе с ней удаляются и все ее АУТы.
    Перед созданием АУТа необходимо выбрать схему.

    Каждый АУТ или принимает запрос или отклоняет его, в соответствии с назначенными АУТу правилами. Если ни один из АУТов не принимает запрос, посетитель будет отправлен на АУТ по умолчанию схемы.
    Что происходит,когда один или более АУТов принимают запрос, зависит от того, принадлежит ли АУТ группе 'Последовательные АУТы' или группе 'Весовые АУТы'.

    Как уже было упомянуто выше, у каждой схемы есть две группы - Весовые АУТы и Последовательные АУТы. Необходимо четко понимать разницу между этими группами, т.к. она весьма существенна.

    Последовательные АУТы
    Последовательные АУТы обычно используют при фильтрации трафика по его параметрам. Эти АУТы будут проверены первыми. Посетитель будет перенаправлен на первый последовательный АУТ, который принимает запрос с его текущими параметрами. Очередь первый-последний строится в соответствии с полем 'Порядок' в свойствах АУТа, от малого к большому, АУТы с меньшим значением этого поля будут проверяться перед теми, которые имеют бОльшее значение.
    Бывают случаи, когда порядок не важен - это случается, когда АУТы имеют взаимоисключающие правила (например когда один из АУТов принимает только US траф, а другой только UK траф). Иногда порядок очень важен - это бывает в тех случаях, когда правила не являются взаимоисключающими. Например, когда один из АУТов принимает только US трафик, а другой принимает любой трафик - в этом случае нуно сделать так, чтобы АУТ, принимающий US трафик проерялся первым (имел меньший порядок), в противном случае весь траф будет уходить на АУТ, принимающий любой трафик.

    Если ни один из последовательных АУТов не принимает запрос, начинают проверяться весовые АУТы.
    Весовые АУТы
    Весовые АУТы обычно используются для ротации трафика между несколькими страницами. Эти АУТы проверяются в случае, когда ни один из последовательных АУТов не принял запрос. Каждый из весовых АУТов будет проверен, принимает ли он запрос или нет Из списка весовых АУТов, принявших запрос, будет случайным образом выбран один, на который и будет произведен редирект. При выборе АУТа принимается во внимание его вес - чем выше вес относительно других АУТов в списке, тем больше вероятность редиректа именно на этот весовой АУТ.
    Например, если у нас есть четыре весовых АУТа (назовем их A, B, C, D) с весами соответственно WA = 2.0, WB = 3.0, WC = 4.0, WD = 5.0, и A, B, C принимают запрос а D не принимает, то АУТ для редиректа будет выбран из списка [A, B, C]. Вероятность редиректа на A будет 2.0/(2.0+3.0+4.0) = 0.22 (22%) , на B 3.0/(2.0+3.0+4.0) = 0.33 (33%) , на C 4.0/(2.0+3.0+4.0) = 0.44 (44%).
    Реальный процент выбора может не соответствовать вероятностям выбора в случае, когда флажок 'Принудительная ротация неуников' включен для этой группы; в этом случае для уникальных посетителей вероятности остаются корректными, но для неуникальных АУТы, на которых посетитель еще не был, будут иметь безусловный приоритет над теми, на которые он уже перенаправлялся (каждый раз будет уходить на новый АУТ вместо абсолютно случайного). Как правило именно такое поведение нужно бльшинству из пользователей ТДС, поэтому этот флажок включен по умолчанию.
    если ни один из Весовых АУТов не принимает запрос, посетитель редиректится на URL АУТа по умолчанию схемы.

    Для каждой группы есть несколько простых элементов управления: вы можете нажать 'Новый АУТ' чтобы добавить новый АУТ в данную группу; можете воспользоваться зелеными стрелками для перемещения АУТов вверх и вниз, в том числе между группами; можете включить/выключить АУТ, изменит его или удалить.

    Только для Весовых АУТов:

    Неуники
    Три варианта ротации АУТов для неуникальных посетителей:
    • Случайный выбор - аналогично уникам, будет выбран случайный АУТ из списка АУТов, принимающих запрос;
    • Принуд. ротация - для неуников будет по возможности выбран АУТ, на котором этот посетител еще не был (поведение по умолчанию). Цель - обеспечить максимальную уникальность посетителей на каждом из АУТов;
    • Привязать к АУТу - неуник будет всегда отправляться на тот же АУТ, на который он ушел при первом посещении, если правила этого АУТа позводяют повторные посещения. Цель - не показывать посетителю все возможные АУТы.
    Кнопка Массовое добавление
    -
    Позволяет добавить сразу несколько АУТов с одинаковыми свойствами, различающиеся только URL страницы для редиректа, вместо того, чтобы добавлять каждый из них вручную. Просто вставьте в поле URL список URL страниц, по одной на строку. Для каждого URL будет автоматически создан отдельный АУТ.

    Свойства АУТов

    Перейти к свойствам АУТов можно нажав на кнопку 'изменить' в окне списка АУТов, или при создании нового АУТа.

    URL АУТа
    Адрес страницы для перенаправления туда посетителей. Форматы: http://foo.bar - для редиректа на http://foo.bar; boss://inurl - для внутреннего (быстрого) редиректа на схему с IN URL равным 'inurl'; code://[code]/[message] - чтобы вернуть HTTP ответ с заданным кодом и сообщением, например code://404/Not found или code://403/Forbidden.
    В поле можно использовать переменные: http://foo.com?bar={{ variable }}. Переменные создаются автоматически из GET параметров запроса (например, если ваша ТДС стоит на домене http://yourtds.com и посетитель пришел на http://yourtds.com/in/inurl?q=val1&p=val2, будут доступны две переменные - 'q' со значением 'val1' и 'p' со значением 'val2'). Кроме этого, переменные могут быть созданы в ручном режиме в разделе Трансформации.
    Включен
    Выключенные АУТы отклоняют любые запросы.
    Описание
    Краткий комментарий, для чего вообще нужен этот АУТ.
    Действует с
    АУТ будет принимать запросы начиная с этой даты, включительно. Формат: MM/DD/YYYY. Пустое поле - без ограничений по дате.
    Действует до
    АУТ будет принимать запросы до этой даты, включительно. Формат: MM/DD/YYYY. Пустое поле - без ограничений по дате.
    Порядок
    Последовательные АУТы проверяются один за другим - если первый АУТ принимает запрос, посетитель редиректится на этот АУТ, иначе переходим к следующему АУТу и т.д. АУТы с меньшим значением поля 'Порядок' будут проверены первыми. Поле игнорируется для весовых АУТов. Должно содержать положительное целое число. Если пустое или равно 0, АУТ будет атоматически добавлен в конец группы 'Последовательные АУТы'.
    Вес
    Чем больше вес АУТа относительно длугих АУТов группы, тем выше вероятность выбора именно этого АУТа для редиректа. Весовые АУТы с весом 0.0 никогда не будут выбраны для редиректа. Поле игнорируется для последовательных АУТов.
    Уники по
    по IP (который бывает одинаковым у разных пользователей) или по cookie (которые могут быть легко очищены). Обе опции имеют свои плюсы и минусы. Обратите внимание - можно отслеживать уников по схеме по IP, уников по одним АУТам по coookie, по другим АУТам снова по IP. Такая конфигурация будет работать корректно, в соответствии с ожидаемым поведением, но нужно это очень редко.
    Метод редиректа
    Каким способом редиректить посетителей. Location 302 созраняет реферер, остальные способы как правило меняют реферер на адрес TDS (но не всегда, зависит от браузера). '200 OK, из файла' возвращает контент файла в HTML, JSON или JSONP формате вместо редиректа. Файлы создаются в редакторе файлов ТДС, это не обычные файлы ОС.
    'Flash (.swf)' возвращает .swf файл с зашитым в него кодом редиректа. 'Flash (page)' возвращает HTML страницу с тэгом 'object', у которого флеш файл с редиректом присвоен атрибуту 'src'.
    Файл/Flash
    Имя файла или flash редиректа для '200 OK, из файлв' и Flash ответов. Недоступно для остальных типов редиректа. Файлы/редиректы должны существовать. Если вы удалили файл или flash редирект, будет возвращаться 404. response.
    Правила
    Каждое правило либо принимает запрос, либо отклоняет.
    Когда ВСЕ правила принимают запрос, посетитель будет либо перенаправлен на АУТ немедленно (если АУТ в последовательной группе) либо этот АУТ будет добавлен в список потенциальных кандидатов на редирект, если АУТ в весовой группе.
    Посетитель не будет перенаправлен на АУТ, если хотя бы одно из правил отклоняет запрос.
    Пожалуйста, держите количество правил в разумных пределах.
    Если у вас одно и то же правило на всех АУТах схемы, рассмотрите вариант переноса его в правила схемы.
    Узнать больше о доступных правилах можно ниже по тексту в этом документе в разделе 'Правила'.
    Лимиты
    Лимиты по количеству тправляемого на АУТ трафика. Полезны, например, в ситуации, когда вам надо отправить ровно X посетителей одному покупателю и Y другому.
    Макс. хитов/день
    Максимум хитов в день для этого АУТа. 0 - без ограничений.
    Макс. хитов/час
    Максимум хитов в час для этого АУТа. 0 - без ограничений.
    Всего макс. хитов
    Сколько всего хитов нужно отправить на этот АУТ. 0 - без ограничений.
    Лимиты по дням недели
    Матрица дней недели и часов. Можно назначить лимиты на каждый конкретный час каждого дня недели. '0' здесь значит ровно 0 хитов, чтобы убрать ограничения очистите ячейку.
    Трансформации
    Трансформации используются для создания переменных; переменные можно использовать в спец. отчетах и как часть URL АУТа в форме http://foo.com?bar={{ varname }}. {{ varname }} будет земещено значением переменной 'varname'.
    Если у вас одна и та же трансформация на всех АУТах схемы, рассмотрите вопрос переноса ее в Трансформации схемы, чтобы избежать лишней работы.
    Узнать больше о трансформациях можно ниже на этой странице в разделе 'Переменные и трансформации'.
    Динамический АУТ
    Эти настройки посволяют динамически включать/выключать АУТ или получать URL для редиректа из сторонних сервисов (страниц).
    Динамический режим

    • Выкл. - Динамический режим выключен.
    • Проверить код ответа HTTP - Получить код ответа HTTP на HEAD запрос к странице. Временно отключить АУТ если полученный код не равен значению поля 'HTTP Код'. Если поле 'Обратиться к этой странице' пустое, использовать для проверки URL АУТа, иначе проверять страницу из поля 'Обратиться к этой странице'.
      Обычно живые страницы возвращают код 200. Интервал проверки настраивается на странице настроек ТДС и по умолчанию равен 10 минутам.
    • Искать регексп/отсутствие регекспа на странице - скачать страницу GET запросом, проверить, есть ли на странице текст, соответствующий заданному регулярному выражению. Выключить АУТ, если такой текст найден (или не найден). Если поле 'Обратиться к этой странице' пустое, использовать для проверки URL АУТа, иначе проверять страницу из поля 'Обратиться к этой странице'.
      Интервал проверки настраивается на странице настроек ТДС и по умолчанию равен 10 минутам.
      Например, если надо проверить, содержит ли страница слово 'foo', просто добавьте 'foo' (без апрострофов) в поле 'Регексп'.
    • Получить АУТ со страницы - скачать страницу GET запросом, взять со страницы первую строку, использовать ее как URL для редиректа. Если поле 'Обратиться к этой странице' пустое, использовать для проверки URL АУТа, иначе проверять страницу из поля 'Обратиться к этой странице'.

      Если флажок 'Обращаться при каждом запросе' включен, страница будет закачиваться на каждый хит. Не рекомендуется включать этот флажок - он замедляет работу ТДС и делает потерю трафа практически неизбежной. В будущем эта опция возможно будет убрана вообще. Если флажок выключен, страница будет получаться раз в интервал проверки, который настраивается на странице настроек ТДС умолчанию равен 10 минутам.
    Форсы
    Форсы игнорируются для последовательных АУТов, т.к. они влияют только на вес АУТа. Форсы служат для того, чтобы временно уменьшить или увеличить вес АУТа в соответствии с заданным расписанием. Например, следущий сценарий можно сделать при помощи форсов: Включить АУТ только по пятницам и субботам с 18:00 до 19:30, с весом линейно увеличивающимся от 0.0 в 18:00 до 20.0 в 19:30, но остановить отправку хитов на этои АУТ по достижении 1000 хитов.
    Для форсов есть значительное число сценариев, когда они могут быть полезны. Их можно использовать для имитации живого трафика или для того, чтобы оказаться в топах трейдов в нужный момент времени. Но если вы не знаете, зачем они вам нужны - не используйте их, т.к. они несколько замедляют работу ТДС.

    Каждый форс содержит следующие поля:
    • Расписание - расписание работы форса. Когда стартовать форс и сколько времени он должен длиться.
      Есть два типа форсов: ежедневные и ежечасные.
      Формат:
      • Ежедневные: D; дни; время начала (H:M); продолжительность в минутах. Например:
        1. D;*;0:00;1440 - ежедневно, начинается в 0:00, продолжительность 24 hours (1440 = 60*24)
        2. D;1,6,7;19:25;275 - каждый понедельник, субботу, воскресенье, начинается в 19:25, продолжительность 275 минут (4 часа 35 минут), т.е. до полуночи. Обратите внимание: в настоящий момент ежедневные форсы работают в пределах одного дня, так что в данном примере нельзя сделать продолжительность больше 275 минут.
      • Ежечасные: H; дни; часы; время начала (M); продолжительность в минутах. Например:
        1. H;*;*;0;60 - каждый день, каждый час, продолжительность 60 минут
        2. H;1,6,7;11,13,19;25;35 - каждый понедельник, субботу, воскресенье, три раза в день в 11:25, 13:25 and 19:25, продолжительность каждый раз 35 минут. Обратите внимание: в настоящий момент ежечасные форсы работают в пределах одного часа, так что в данном примере нельзя сделать продолжительность больше 35 минут.
      где день - число от 1(понедельник) до 7(воскресенье); час начала - число от 0 (00:00) до 23 (23:00)
    • +Начало -Это значение добавляется к базовому Весу в начале интервала времени действия форса. Отрицательные значения разрешены.
    • +Конец - Это значение добавляется к базовому Весу в конце интервала времени действия форса. Отрицательные значения разрешены. '+Начало' and '+Конец' могут быть испольщованы для создания плоских форсов (если они равны) или форсов горкой - с течением времени линейно увеличивающаяся или уменьшающаяся вероятность, если они не равны.
    • Макс/раз - Максимальное количество хитов за один запуск форса. Как только на данный АУТ отправлено нужное количество хитов, форс приостанавливается до следующего запуска. 0 - без ограничений.
    • Макс/всего - Максимум хитов для этого форса. Когда лимит достигнут, форс будет отключен навсегда. 0 - без ограничений.
    Гостевая статистика
    Используется для того, чтобы безопасно показать статистику посторонним лицам. Например покупателям вашего трафика. Если вам это не нужно, оставьте это поле пустым.
    Гостевая статистика - Пароль
    Пароль для гостевого доступа к дневным отчетам. Пустое поле - гостевой доступ отключен.
    Гостевая статистика - Действует с
    Дата начала действия пароля. Пустое поле - без ограничений.
    Гостевая статистика - Действует до
    Дата окончания действия пароля. Пустое поле - без ограничений.
    Скрывать URL от гостей
    URL будет заменен на *hidden* в гостевых отчетах для этого АУТа.

  • Правила

    Правила это фильтры, при помощи которых можно разделять трафик на глобальном уровне (Глоб. фильтры/Трансформации), на уровне схемы (редактор Схем) и на уроне АУТов (редактор АУТов).
    Каждое правило или принимает запрос, или отклоняет его. Редирект на АУТ будет произведен только в том случае, если все назначенные ему правила принимают запрос. Если хотя бы одно правило не принимает запрос - редирект на данный АУТ произведен не будет. Аналогично на уровне схем - если хотя бы одно правило, привязанное к схеме, отклоняет запрос - посетитель сразу уйдет на АУТ по умолчанию схемы, обычные АУТы будут пропущены.

    Создавая правила и назначая их АУТам вы разделяете входящий поток трафика на разные целевые страницы в соответствии с параметрами трафика. Старайтесь держать количество правил в разумных пределах.

    Список правил
    1. Прокси
    Правило позволяет разделять трафик из-за прокси и прямой трафик. Не является 100% гарантией защиты от прокси, т.к. есть полностью недетектируемые прокси-серверы. Не следует считать, что весь трафик из-за прокси является плохим трафиком - множество живых людей выходят в интернет через прокси, даже не подозревая об этом. Но чрезмерно большое количество прокси в трафике является признаком плохого трафика.
    2. Пустой реферер
    Правило используется для разделения трафика с реферером от трафика без оного. Трафик без реферера как правило ботовый, тайпин или из закладок.
    3. Уники
    Правило для разделения уникальных и неуникальных посетителей. Посетитель может быль неуникальным по ТДС (был на любом из АУТов любой схемы), по схеме (был на любом из АУТов этой схемы), по АУТу (был на этом АУТе). У вас есть возможность выбрать любой из этих вариантов. В свойствах схемы поле 'UTTL' показывает, через сколько времени неуник снова становится уником.
    Используйте это правило, если хотите посылать посетителей на АУТ ровно один раз за определенный интервал времени.
    4. IP/Подсети
    Правило для разделения трафика в соответствии с IP клиента. Проверяет, попадает ли IP в один из интервалов из списка. Можно настроить, какой из IP будет проверяться: IP клиента - реальный IP адрес); IP пира - IP адрес прокси или реальный IP адрес если нет возможности получить IP прокси; Пир или Клиент - проверять, попадает ли хотя бы один из IP в диапазоны.
    Два поля для задания списков IP и диапазонов - 'IP/Подсети' и 'Списки IP'.
    • IP/Подсети - содержит разделенный запятой список IP адресов и подсетей в формате xxx.xxx.xxx.xxx (один IP), xxx.xxx.xxx.xxx/xx (CIDR подсеть), xxx.xxx.xxx.xxx-xxx.xxx.xxx.xxx (IP диапазон). Используйте это поле только если у вас небольшой список диапазонов. Для всего что больше 5-10 диапазонов, используйте поле 'Списки IP' для получения значительной экономии памяти и увеличения скорости работы, до 700 раз при 10000 диапазонах.
    • Списки IP - Списки IP создаются в редакторе списков IP. При изменении такого списка он автоматически обновляется во всех правилах, где этот список используется. Поиск в списках IP оптимизирован по скорости и имеет сложность O(logN), что на порядки быстрее линейного поиска при большом количестве элементов в списке.
    IP попадает в диапазон, если хотя бы один диапазон из поля 'IP/Подсети' содержит текущий IP ИЛИ этот IP попадает в любой из диапазонов хотя бы одного списка IP из поля 'Списки IP'.
    5. GeoIP
    Правило используется для фильтрации трафикапо странам, городам и регионам в соответствии с базой данных GeoIP Lite legacy от MaxMind.
    По умолчанию база горродов отключена для экономии памяти ( работает только определение стран). Эту базу можно включить на странице настроек ТДС.
    • Страна - Выберите список стран.
    • Группы стран - группы стран - это предопределенные списки стран, создаваемые в редакторе Групп стран. Часто это намного удобнее, чем подбирать каждый раз страны вручную на каждом из АУТов.
    • Город - список городов, разделитель запятая. База данных по городам не слишком точна и имеет точность около 70% для США, меньше для остальных стран. По умлчанию эта база отключена, в этом случае город будет всегда пустой строкой. Города вводятся на английском языке с большой буквы, например Moscow,London,Paris.
    • Регион - список регионов, разделитель запятая. В США регион - это аббревиатура штата, например TX,NY. В некоторых других странах регионы цифровые, например 09,71 - вводите с ведущим нулем. Используются коды регионов fips, которые не совпадают с административными кодами России. Так например, fips-код Москвы 48. См. список кодов. Начиная с версии 4.9.4 используются коды ISO 3166-2. Список кодов регионов можно посмотреть здесь: en.wikipedia.org/wiki/ISO_3166-2 - передите на страницу и нажмите на код нужной страны (столбец Entry в таблице). Можно использовать как короткие коды так и коды с указанием страны. Например MOW или RU-MOW для региона Москва в России.
    Считается, что хит удовлетворяет правилу, если страна соответствует хотя бы одной стране из списка стран ИЛИ хотя бы одной стране из любой из Групп стран И любому городу из списка городов И любому региону из списка регионов. Пустые поля игнорируются.
    6. Локаль браузера
    Браузеры в своих запросах шлют HTTP заголовок 'accept-language', который содержит список языков, которые использует пользователь в формате 'en-gb,en;q=0.7,de;q=0.3' или похожем. Это правило позволяет фильтровать трафик в соответствии с этим заголовком. Оно проверяет, есть ли ХОТЯ БЫ ОДНА из заданных локалей (например 'en,fr,ru-ru') в списке локалей из HTTP заголовка.
    Если флажок 'Только основная локаль' включен, проверяется только первая локаль из HTTP заголовка. Имеет смысл включать это флажок для en локали, которая есть почти у всех, и выключать для более редких локалей.
    7. Cookies
    Правило позволяет проверить, принимает ли клиент cookies. Для этого делается дополнительный редирект, устанавливающий cookie и пытающийся после этого их прочитать. Как правило обычные браузеры принимают cookies.
    8. GET параметр запроса
    При помощи этого правила можно разделять трафик по GET параметрам запроса. Например, если ТДС работает на домене http://yourtds.com и посетитель пришел на http://yourtds.com/in/inurl?q=val1&p=val2 будет доступно два GET параметра - 'q' со значением 'val1' и 'p' со значением 'val2'. Правило позволяет проверить, равен или не равен параметр с заданным именем заданной строке, оответствует или не соответствует регулярному выражению, меньше или больше определенного значения (в этом случае значение должно быть числом, опционально с десятичной точкой).
    Если надо проверить другой параметр просто добавьте еще один фильтр.
    Если хит пришел на схему без параметра, будет считаться что параметр содержит пустое значение.
    Имена и значения параметров нечувствительны к регистру.
    9. HTTP заголовок
    Это правило позволят разделять трафик по HTTP заголовкам. Можно проверить, соответствует или нет заголовок с заданным именем заданному регулярному выражению.
    Имена и значения заголовков нечувствительны к регистру.
    10. Браузер/OS
    Правило позволяет фильтровать хиты по содержимому User-Agent.
    • Название браузера - Firefox, IE и т.д;
    • Тип браузера - Мобильный, Десктопный, Почтовик, Текстовый, Бот, Неизвестно;
    • Движок браузера - Presto, Webkit, Trident и т.д.
    • Производитель браузера - MS, Apple, Google и т.д.
    • Название ОС - Windows, Linux, OSX, iOS, Android...
    • Тип ОС - Является ли OS Десктопной, Мобильной, Консолью и т.д;
    • Производитель ОС - MS, Google, Apple, Nokia и т.д.
    Например, если поле 'Название браузера' равно 'Firefox, IE', 'Название ОС' равно 'Windows, OSX' и 'Тип браузера' равно 'Desktop', правило будет выглядеть так: ('Название браузера' Firefox ИЛИ Internet Explorer) И ('Название ОС' равно Windows ИЛИ OSX) И ('Тип браузера' - Десктоп). В результате клиенты с Firefox под Windows будут приняты, с Firefox под Linux отклонены, с IE под Windows приняты, с Firefox под OSX приняты, с Safari под OSX отклонены, с IE 11 под Windows Phone 8 будут приняты если IE работает в 'Полной версии' и отклонены если в 'Мобильной версии' - такая настройка есть в IE11 под Windows Phone 8.
    User-agent легко подделать, но это единственный способ получить информацию по браузеру и ОС из HTTP запроса.
    11. 3G/GPRS
    Позволяет разделять мобильный трафик на 3G и WiFi - часто пользователи ведут себя по разному на одних и тех же устройствах в зависимости от того, сидят ли они с устройством дома на WiFi или на улице через 3G. Имеет смысл включать этот фильтр вместе с фильтром 'Браузер/OS', отбирающим только мобильные устройства.
    Можно выбрать, какие конкретно сотовые операторы вам интересны. Пустое поле означает 'Все операторы'.
    Правило работает на основе БД IP сотовых операторов. Эта БД может быть не совсем точной. Если есть возможность, используйте вместо этого правила правило 'GeoIP2 Типы соединений'.
    12. J2ME MIDP
    Позволяет выбирать устройства с поддержкой стандарта J2ME MIDP, опционально с поддержкой стандарта заданной версии MIDP. Поле 'Версия' должно быть пустым (в этом случае оно игнорируется) или содержать номер версии в формате '2.1'.
    Работает на основе заголовка HTTP User-Agent.
    13. Проверка клиента
    Позволяет проверять возможности и настройки браузера клиента. Это правило доступно только если флажок 'Включить проверку клиента' включен в настройках схемы.
    При этом невозможно сохранить реферер независимо от типа редиректа.
    • Javascript - проверить, поддерживает ли браузер javascript;
    • Flash - проверить, поддерживает ли браузер Adobe Flash;
    • iFrame - проверить, открыт ли линк на ТДС во фрейме;
    • Размер окна браузера - проверить высоту и ширину окна браузера.


    • Отклонять если успешна хотя бы одна проверка - если любая из проверок успешно выполнена (например если javascript не работает в клиенте и опция 'Javascript' равна 'Не поддерживается'), правило отклонит запрос;
    • Отклонять если успешны все проверки - если все проверки успешно выполнены правило отклонит запрос. Если хотя бы одна проверка будет неудасной, правило примет запрос;
    • Принимать если успешна хотя бы одна проверка - если любая из проверок будет удачной (например если javascript работает на клиенте и опция 'Javascript' равна 'Поддерживается' и Flash не работает на клиенте и опция 'Flash' тоже равна 'Поддерживается'), правило примет запрос;
    • Принимать если успешны все проверки - если все проверки успешны, запрос будет принят. Если хотя бы одна не успешна - отклонен.
    14. Последовательность хитов
    Принимать/Отклонять хиты если посетитель был уже перенаправлен на один из АУТов из заданного списка. АУТы только из текущей схемы.
    Список должен содержать ID АУТов, разделенных запятой.

    Фильтр может быть довольно медленным если список большой.

    Довольно мощный фильтр, позволяющий например пропускать купленный трафик через один АУТ, а на другом АУТе проверять, работаем ли мы с купленным уником, уже прошедшим через ТДС, или же нас проверяет кто-то посторонний.
    15. GeoIP2 Типы соединений
    Принимать или отклонять запросы, сделанные с определенных типов соединений, определенных по IP.
    Этот фильтр использует платную базу GeoIP2 Connection Type от MaxMind, необходимо приобрести базу, распаковать ее, загрузить файл GeoIP2-Connection-Type.mmdb в каталог /opt/bosstds/deps/geodata2/priv/ и активировать ее в диалоге настроек ТДС.
    Этот фильтр намного более точен чем 3G/GPRS фильтр. Используйте его если можете себе позволить приобрести базу.
    16. GeoIP2 ISP
    Принимать или отклонять запросы с определенных ISP (по IP).
    Этот фильтр использует платную базу GeoIP2 ISP от MaxMind, необходимо приобрести базу, распаковать ее, загрузить файл GeoIP2-ISP.mmdb в каталог /opt/bosstds/deps/geodata2/priv/ и активировать ее в диалоге настроек ТДС.
    • Проверять - для каждого IP база возвращает два поля - ISP и Organization. Каждое из них или оба могут быть пустыми. Часто они одинаковые, но не всегда. Эта опция позволяет выбрать, какое из этих полей выбирать для сравнения. 'Оба поля' в данном контексте означает 'любое из них'.
    • Списки ISP - Списки ISP - это обычные списки названий ISP и/или организаций, которые создаются в редакторе GeoIP2 списки ISP. Фильтр проверяет, обнаружен ли текущий ISP, определенный по IP, в одном из этих списков.

  • Переменные и трансформации

    Трансформации являются мощным механизмом для создания динамических URL АУТов на основе параметров запроса, а также для извлечения данных из параметров запроса и сохранения их в спецотчетах.
    ТДС автоматически создает переменные для каждого из GET параметров запроса, например если ТДС работает на http://yourtds.com domain и посетитель пришел на http://yourtds.com/in/inurl?var1=val1&var2=val2 будет создано две переменные - 'var1' со значением 'val1' и 'var2' со значением 'val2'. При помощи трансформация можно создавать переменные в ручном режиме.
    Переменные можно использовать в URL АУТов, в форме http://foo.bar?some={{ var1 }}&other={{ var2 }}. В этом случае, если хит пришел на to http://yourtds.com/in/inurl?var1=val1&var2=val2 и URL АУТа равен http://foo.bar?some={{ var1 }}&other={{ var2 }}, редирект будет сделан на http://foo.bar?some=val1&other=val2.
    Есть пять фильтров для использовании на переменных:

    • URLDECODE2 - urldecode делается дважды на занчении параметра (по умлчанию 1 раз_;
    • SE - из параметра, содержащего реферер SERP, извлекается название поисковой системы (например 'Google');
    • SE_FULL - из параметра, содержащего реферер SERP, извлекается домен поисковой системы (например 'google.fr');
    • KEYWORD - из параметра, содержащего реферер SERP, извлекается ключевое слово. К сожалению, в настоящее время поисковики почти никогда не шлют ключевики в реферере;
    • DOMAIN - извлекается домен из переменной, содержащей URL.

    Для фильтров используется следующий синтакис: http://foo.bar?some={{ var1|FILTERNAME }}, например http://foo.bar?some={{ var1|SE_FULL }}. Данный пример означает следующее: взять значение переменной с именем 'var1', извлечь из нее поисковую систему, поместить полученное значение в URL АУТа. Переменная 'var1' при этом должна содержать реферер поисковой системы в формате url encoded, например http%3A%2F%2Fwww.bing.com%2Fsearch%3Fq%3Dbuy%2Bshoes%2Bonline%26form%3DTMXFRH%26pc%3DUP97%26mkt%3Dfr-fr%26scope%3D%26pq%3Dsilde%26sc%3D8-5%26sp%3D2%26qs%3DAS%26sk%3DAS1

    Список трансформаций

    В настоящий момент доступно пять типов трансформаций для создания переменных в ручном режиме:

    GET параметр
    Взять значение GET параметра с заданным именем ('Вход' - имя параметра); найти 'найти' заменить на 'заменить' (эти два поля можно оставить пустыми если не надо ничего заменять); поместить результат в переменную с именем 'Переменная'. Для поиска/замены можно использовать регулярные выражения Erlang, синтаксис см. здесь: http://www.erlang.org/doc/man/re.html или обратитесь в поддержку ТДС за помощью. На поле 'Вход' можно применить фильтр в форме paramname|DOMAIN;
    HTTP заголовок
    Взять значение HTTP заголовка с заданным именем ('Вход' - имя заголовка); найти 'найти' заменить на 'заменить' (эти два поля можно оставить пустыми если не надо ничего заменять); поместить результат в переменную с именем 'Переменная'. Для поиска/замены можно использовать регулярные выражения Erlang, синтаксис см. здесь: http://www.erlang.org/doc/man/re.html или обратитесь в поддержку ТДС за помощью. На поле 'Вход' можно применить фильтр в форме referer|DOMAIN;
    Константа
    Поля 'найти' и 'заменить' игнорируются. Содержимое поля 'Вход' помещается в переменную с именем 'Переменная' без изменений. Может быть полезно, например, для показа рекламы через AJAX для хранения URL картинки.
    Случайный выбор
    Поля 'найти' и 'заменить' игнорируются. Создается переменная, содержащая случайную строку заданной длины, состоящую из латинских букв и цифр. В поле 'Вход' - число от 1 до 128 - количество символов в случайной строке. В поле 'переменная' - имя переменной;
    Вариант
    Создает переменную со значением, случайно выбранным из списка вариантов с заданным именем. Списки вариантов создаются в редакторе вариантов и представляют собой текстовый файл с одним значением на строку. Поля 'найти' и 'заменить' игнорируются. В поле 'Вход' - имя списка вариантов. В поле 'переменная' - имя переменной;

    Как уже было упомянуто выше, каждая транисформация создает переменную с заданным именем. Для каждого хита доступны следующие переменные: по одной переменной на каждый GET параметр запроса + переменные, созданные из Глобальных трансформаций + переменные, созданные из трансформаций схемы + переменные, созданные из трансформаий АУТа. Все эти переменные используются одинаково - в URL АУТа и в качестве параметров спецотчетов.

  • Редактор макросов

    Макросы используются в качестве репозиториев для регулярных выражений. Если вы используете один и тот же регексп во многих АУТах, подумайте о том, чтобы сохранить его в репозитории в виде макроса. После этого вы сможете использовать его в виде {% MACROS_NAME %} вместо регекспа.
    Редко используемая возможность, обычно она не нужна. В будущем этот функционал может быть удален. Не удаляйте макросы, если они используются хотя бы в одном АУТе.

    Свойства макроса
    Имя
    Имя макроса. Используется в форме {% MACROS_NAME %} в любом поле, где возможно использовать regexp;
    Включен
    Когда макрос выключен это то же самое, как если бы его вообще не существовало;
    Значение
    Сам регексп.

  • Редактор файлов

    Файлы используются в АУТах с типом редиректа Files are used in OUTs for '200 OK, из файла' response types. В этом случае ТДС, вместо редиректа, берет содержимое файла с заданным именем, заменяет в нем переменные актуальными значениями из параметров запроса и возвращает клиенту это содержиимое в формате HTML, JSON или JSONP. Можно использовать для создания соих клиентских редиректов или для возврата данных для другого javascript кода, например при показе баннеров или при клоакинге.

    Свойства файла
    Имя файла
    Имя файла, для использования в поле 'Файл' АУТа. Должно быть уникальным;
    Content Type
    • HTML - ответ будет с заголовком content-type 'text/html';
    • JSON - ответ будет с заголовком content-type 'application/json';
    • JSONP - ответ будет с заголовком content-type 'application/json' и контент будет завернут в callback-функцию. Имя функции будет взято из GET-параметра с именем 'callback'. Если такого параметра нет, имя функции будет равно 'callback';

      Например, контент может содержать что-то вроде {"url": "{{ __OUTURL__ }}", "pix": {{ pixparam }}, "message": "Привет, мир!", "code": 0} для JSONP
    Описание
    Краткое описание файла
    Данные файла
    Контент файла. В контенте можно использовать переменные точно так же, как и в URL АУТов - {{ varname }}. Помимо стандартных переменных (см. секцию 'Переменные и трансформации'), доступны следующие предопределенные переменные:
    • __BROWSER_NAME__ - Название браузера, с верcией, из User-Agent
    • __BROWSER_FAMILY__ - Название браузера, из User-Agent
    • __BROWSER_TYPE__ - Тип браузера, из User-Agent
    • __BROWSER_MANUFACTURER__ - Фирма-произодитель браузера, from User-Agent
    • __BROWSER_ENGINE__ - Движок браузера, из User-Agent
    • __OS_NAME__ - Название ОС, с версией, из User-Agent
    • __OS_FAMILY__ - Название ОС, из User-Agent
    • __OS_TYPE__ - Тип ОС, из User-Agent
    • __OS_MANUFACTURER__ - Производитель ОС, из User-Agent
    • __GEOIP_COUNTRY_SHORT__ - Двухбуквенный код страны (GeoIP)
    • __GEOIP_COUNTRY_FULL__ - Страна (GeoIP)
    • __GEOIP_CITY__ - Город (GeoIP)
    • __GEOIP_REGION__ - Код региона GeoIP
    • __CLIENT_IP__ - IP посетителя
    • __PEER_IP__ - IP пира (IP прокси для прозрачных прокси)
    • __DATE__ - Текущая дата
    • __TIME__ - Current time
    • __REFERER__ - Реферер
    • __OUTURL__ - URL редиректа
    • __OUTID__ - ID АУТа
    • __3G__ - '3G/GPRS' для коннектов с IP операторов сотовой связи, иначе 'No'
    • __3GCARRIER__ - Название сотового оператора (напр. 'MTS') для коннектов с IP операторов сотовой связи, иначе пустое поле
    • __MIDP__ - 'MIDP' для устройств с поддержкой J2ME MIDP, иначе 'No'.
    • __MIDP_VSN__ - Версия MIDP (напр. '2.0') для устройств с поддержкой J2ME MIDP, иначе пустое поле.
    • __CLIENT_VIEWPORT_W__ - Ширина окна браузера.
    • __CLIENT_VIEWPORT_H__ - Высота окна браузера
    • __CLIENT_VIEWPORT_WH__ - Размеры окна браузера (ширина*высота).
    • __CLIENT_JS__ - true если клиент поддерживает javascript иначе false.
    • __CLIENT_FLASH__ - true если клиент поддерживает Adobe Flash иначе false.
    • __CLIENT_FRAME__ - true если URL открыт во фрейме иначе false.
    • __PROXY__ - true если обнаружен прокси иначе false.
    • __NOREF__ - true если реферер пустой иначе false.
    • __GEOIP2_CONN_TYPE__ - GeoIP 2 Тип соединения.
    • __GEOIP2_ISP_ISP__ - GeoIP 2 ISP.
    • __GEOIP2_ISP_ORG__ - GeoIP 2 организация-владелец сети.
    • __GEOIP2_ISP_ASN__ - GeoIP 2 номер ASN сети.

  • Редактор шаблонов спец. отчетов

    Шаблоны спец. отчетов нужны для создания отчетов с произвольными данными запросов. Шаблон состоит из списка переменных (см. раздел 'Переменные и трансформации'), значения которых должны быть сохранены в отчете, который будет доступен в разделе 'Отчеты -> Специальный'. Шаблон должен быть привязан к схеме в свойствах схемы.

    Данные спецотчетов хранятся в файлах по дням, макимум 30 дней для каждого отчета. Сами отчеты можно скачать как файлы с разделителем TAB, или их можно просмотреть в HTMLинтерфейсе ТДС (первые 1000 записей). Спецотчеты могут занять значительное место на диске, более чем вы предполагаете. Кроме этого их использование замедляет работу ТДС. Не назначайте слишком много спецотчетов вашим схемам.

    Еще один совет: выбирайте переменные для спецотчетов с умом. Например, сохранять IP адрес не слишком хорошая затея (если вам конечно не нужны именно IP адреса), т.к. при каждом хите IP адреса будут разными и соответственно файл будет расти при каждом хите. Противоположный пример - хранить Имя ОС и Имя браузера затея более разумная, т.к. есть конечное число комбинаций этих параметров и после определенного момента отчет расти больше не будет.
    Если у вас есть одна переменная с ограниченным числом значений и другая с неограниченным - подумайте о том, чтобы создать два отдельных шаблона для каждой переменной вместо одного.

    Свойства шаблонов спец. отчетов
    Имя
    Имя шаблона. Должно быть уникальным;
    Список параметров
    Список переменных через запятую. Эти переменные будут сохраняться в отчете. На переменные можно применять фильтры - см. раздел 'Переменные и трансформации'.
    Помимо стандартных переменных (см. секцию 'Переменные и трансформации'), доступны следующие предопределенные переменные:
    • __BROWSER_NAME__ - Название браузера, с верcией, из User-Agent
    • __BROWSER_FAMILY__ - Название браузера, из User-Agent
    • __BROWSER_TYPE__ - Тип браузера, из User-Agent
    • __BROWSER_MANUFACTURER__ - Фирма-произодитель браузера, from User-Agent
    • __BROWSER_ENGINE__ - Движок браузера, из User-Agent
    • __OS_NAME__ - Название ОС, с версией, из User-Agent
    • __OS_FAMILY__ - Название ОС, из User-Agent
    • __OS_TYPE__ - Тип ОС, из User-Agent
    • __OS_MANUFACTURER__ - Производитель ОС, из User-Agent
    • __GEOIP_COUNTRY_SHORT__ - Двухбуквенный код страны (GeoIP)
    • __GEOIP_COUNTRY_FULL__ - Страна (GeoIP)
    • __GEOIP_CITY__ - Город (GeoIP)
    • __GEOIP_REGION__ - Код региона GeoIP
    • __CLIENT_IP__ - IP посетителя
    • __PEER_IP__ - IP пира (IP прокси для прозрачных прокси)
    • __DATE__ - Текущая дата
    • __TIME__ - Current time
    • __REFERER__ - Реферер
    • __OUTURL__ - URL редиректа
    • __OUTID__ - ID АУТа
    • __3G__ - '3G/GPRS' для коннектов с IP операторов сотовой связи, иначе 'No'
    • __3GCARRIER__ - Название сотового оператора (напр. 'MTS') для коннектов с IP операторов сотовой связи, иначе пустое поле
    • __MIDP__ - 'MIDP' для устройств с поддержкой J2ME MIDP, иначе 'No'.
    • __MIDP_VSN__ - Версия MIDP (напр. '2.0') для устройств с поддержкой J2ME MIDP, иначе пустое поле.
    • __CLIENT_VIEWPORT_W__ - Ширина окна браузера.
    • __CLIENT_VIEWPORT_H__ - Высота окна браузера
    • __CLIENT_VIEWPORT_WH__ - Размеры окна браузера (ширина*высота).
    • __CLIENT_JS__ - true если клиент поддерживает javascript иначе false.
    • __CLIENT_FLASH__ - true если клиент поддерживает Adobe Flash иначе false.
    • __CLIENT_FRAME__ - true если URL открыт во фрейме иначе false.
    • __PROXY__ - true если обнаружен прокси иначе false.
    • __NOREF__ - true если реферер пустой иначе false.
    • __GEOIP2_CONN_TYPE__ - GeoIP 2 Тип соединения.
    • __GEOIP2_ISP_ISP__ - GeoIP 2 ISP.
    • __GEOIP2_ISP_ORG__ - GeoIP 2 организация-владелец сети.
    • __GEOIP2_ISP_ASN__ - GeoIP 2 номер ASN сети.
    Например, from|SE_FULL,someparam,from|KEYWORD,__BROWSER_TYPE__ создаст отчет с доменом поисковой системы, извлеченным из переменной from, в которой должен содержаться реферер поисковой системы + значение переменной с именем 'someparam' + поисковый запрос, извлеченный из переменной from.
    Список заголовков
    Список человекочитаемых заголовков колонок отчета через запятую. Если пустой, в качестве заголовков будут использоваться имена переменных из списка параметров. Если не пустой, количество заголовков должно быть равно количеству параметров;
    Режим

    • Схема - отчет будет строиться отдельно для каждой схемы, использующей этот шаблон;
    • Глобальный - отчет будет строиться для всех схем, использующих этот шаблон, в одном файле.
    Считать количество
    Если флажок включен, строки отчета будут содержать количество хитов. Если выключен, количество хитов будет всегда 0, но работать будет несколько быстрее. Например, можно выключить флажок, если вас интересуют рефереры но не интересует количество хитов с каждого реферера;
    Описание
    Краткое описание шаблона.

  • Редактор групп стран

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

    Свойства групп стран
    Имя группы
    Имя группы, должно быть уникальным;
    Страны
    Список стран в этой группе;
    Описание
    Краткое описание группы.

  • Редактор списков IP

    Списки IP используются в правиле 'IP/подсети'. Список IP - это текстовый файл, содержащий IP адреса и диапазоны, по одному на строку. Допустимые форматы: x.x.x.x/xx (CIDR подсеть); x.x.x.x-x.x.x.x (IP диспазон); x.x.x.x,x.x.x.x (IP диапазон); x.x.x.x (один IP).
    Строки другого формата будут пропущены при импорте.

    Впоследствии можно скачать список обратно на локальный компьютер, нажав на кнопку 'скачать' в редакторе списков IP.

    Списки IP оптимизированы по скорости поиска и RAM. Поиск имеет сложность O(logN), так что списки с десятками тысяч диапазонов обрабатываются без существенного замедления TDS.

    Свойства списков IP
    Имя
    Имя списка, должно быть уникальным;
    Файл
    Текстовый файл с IP и диапазонами, по одной записи на строку;
    Описание
    Краткое описание списка.

  • Редактор вариантов

    Варианты, или если точнее, списки вариантов, используются в трансформациях типа 'Вариант'. Эти трансформации создают переменную со значением, случайным образом выбранным из заданного списка вариантов. Максимальный размер одного варианта (строки) 512 байт. Масксимальныйразмер файла 65535 bytes. Кодировка UTF-8 без BOM.

    Впоследствии можно скачать список обратно на локальный компьютер, нажав на кнопку 'скачать' в редакторе списков вариантов.

    Ту же самую функциональность можно сымитировать, создав по одному весовому АУТу на каждый вариант. Варианты как правило работают быстрее, чем отдельные АУТы, но с ними невозможно использовать фильтры и у них нет отдельной статистики (хотя их можноиспользовать в спецотчетах. Как правило варианты имеет слысл использовать в случае, когда надо заменить часть URL АУТа одним значением из многих вариантов выбора без необходимости точной статистики по каждому из вариантов.

    Свойства списков вариантов
    Имя
    Имя списка вариантов. Должно быть уникальным.;
    Файл
    Текстовый файл со списком вариантов, 1 вариант на строку. Максимальный размер файла 65535 байт, максимальный размер строки 512 байт;
    Описание
    Краткое описание списка вариантов.

  • Редактор Flash редиректов

    Flash редиректы используются для редиректов при помощи Adobe Flash (.swf) флайлов. BossTDS вставляет URL для редиректа налету прямо в тело swf файла, без перекомпиляции. В редакторе Flash редиректов можно управлять специальными Flash файлами с кодом для вставки URL внутри, которые впоследствии могут быть использованы в АУТах для редиректов соответствующего типа.

    Flash редирект представляет собой специально скомпилированный .swf файл, содержащий внутри себя код для редиректа и строковый (String) буфер для вставки актуального URL. По умолчанию добавлены три редиректа - первый редиректит тут же после загрузки, второй с задержкой в 0.3 секунды, третий только после того, как пользователь шевельнет мышью. Также вы можете добавить ваши собственные редиректы - в каталоге bosstds/priv/flash-redir-src/ лежат AS3 файлы с примерами кода и шелл скрипт для их компиляции.

    Как уже было сказано выше, ТДС вставляет актуальный URL в .swf файл на лету, без перекомпиляции. Работает это следующим образом: ТДС ищет заданную строку в Flash файле и считает, что эта строка означает начало буфера. После этого ТДС заменяет буфер актуальным URL и заполняет нулями оставшееся свободное место в буфере. Если длина актуального URL больше размера буфера, URL будет обрезан. При создании своего Flash редиректа убедитесь, что создали буфер достаточного размера - забейте его пробелами. Для примера обратите внимание на код .as файлов - исходников готовых редиректов.

    Свойства Flash редиректов
    Имя
    Имя редиректа. Должно быть уникальным;
    Flash файл
    .swf файл с кодом редиректа и буфером для URL;
    Текст в начале буфера
    Уникальная строка, означающая начало буфера в файлеТекст в начале буфера. Минимум 8 символов;
    Размер буфера
    Размер буфера для URL. Если длина актуального URL больше размера буфера, URL будет обрезан;
    Описание
    Краткое описание Flash редиректа.

  • Редактор GeoIP2 списки ISP

    Списки ISP используются в правилах GeoIP2 ISP. Для использования фильтра необходимо приобрести базу GeoIP2 ISP от MaxMind, разархивировать ее и загрузить .mmdb файл в каталог bosstds/deps/geodata2/priv/. После этого нужно активировать эту базу в редакторе настроек ТДС.

    Можно использовать поля ISP и Organization из базы ISP.

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

    Хотя поиск по вхождению ISP в список оптимизирован по скорости и даже большие списки ISP не должны замедлить работу ТДС слишком сильно, они требуют значительного количества RAM. Создавайте списки ISP с осторожностью, особенно на серверах с малым количеством памяти.

    Если вам нужен полный список содержащихся в БД ISP и организаций, зайдите на сервер по ssh, перейдите в каталог /opt/bosstds/ и выполните команду ./init.sh dumpisp. Список будт сохранен в файле bosstds/priv/ispdump.csv. Перед запуском этой команды убедитесь, что ТДС запущена и GeoIP2 ISP база активирована в диалоге настроек ТДС. Также вы можете создать шаблон спец. отчета с полями __GEOIP2_ISP_ISP__ и __GEOIP2_ISP_ORG__, привязать его к схеме и полить ее трафом. После этого посмотреть сохраненные данные в отчете.

    Свойства списков GeoIP2 ISP
    Имя
    Имя списка ISP;
    ISP
    Список названий ISP, по одному на строку. Осторожно - большие списки могут потребовать значительного количества RAM.
    Описание
    Краткий комментарий.

  • Глобальные фильтры/трансформации

    Глобальные фильтры (правила) и транисформации используются для создания правил и трансформаций, проверяемых и выполняемых при каждом хите, пришедшем на любую из активных схем ТДС.
    Глобальные фильтры могут быть полезны для отфильтровывания ботов, ненужных стран и просто плохих IP - если любое из глобальных правил не принимает запрос, посетитель сразу же уходит на АУТ по умолчанию схемы.
    Глобальные трансформации создают переменные, доступные во всех схемах и АУТах ТДС.

    Узнать больше о правилах и трансформациях можно в соответствующих разделах этого мануала.

  • Настройки

    В редакторе настроек конфигурируются глобальные настройки ТДС. Помимо этих настроек, существуют другие настройки, доступные только через редактирование файла boss.config и требующие перезапуска ТДС.

    Список настроек
    GeoIP база данных

    • GeoIP/Страны - база данных без инфрмации по городам и регионам. С этой базой нельзя делать фильтры по городам и регионам;
    • GeoIP/Города - база с информацией по городам и регионам. Требует больше оперативной памяти и несколько медленее базы стран; не слишком надежна - около 70% точность для городов США, меньше для остального мира;
    Кнопка Перезагрузить Базу
    GeoIP базы хранятся в каталоге bosstds/deps/geodata3/priv/ directory, в виде разархивированных .mmdb файлов. Вы можете добавить свои базы в этот каталог. При нажатии на эту кнопку ТДС перечитает наиболее актуальную базу с диска без перезапуска ТДС.
    Привязать к IP
    Поле должно быть заполнено, если у вас на сервере более одного IP. Введите сюда IP адрес, который вы вводили в вашей лицензии.
    При миграции на другой сервер не забудьте зайти в настройки и поправить это поле!
    Интервал проверки динамич. страниц
    Интервал времени (в минутах) для проверок доступности страниц и других проверок при использовании динамических АУТов.
    Ключ API
    Ключ API нужен, если вы используете ТДС через API.
    Имя параметра для проверки cookie:
    Имя GET параметра, используемого для проверки cookies в правиле Cookies.
    Имя параметра запроса Flash:
    Имя GET параметра, используемого для получения Flash редиректов для редиректов типа Flash (page).
    IP прокси
    Как правило это поле должно оставаться пустым.

    В некоторых случаях невозможно отличить IP вашего собственного обратного прокси от обычных прокси. В результате этого все хиты видны как хиты из-за прокси. Если вы столкнулись с этой проблемой, введите сюда IP вашего обратного прокси. В большинстве конфигураций это делать необязательно, ТДС оказывается достаточна умна. Иногда проблема решается правильной конфигураций nginx.
    Очередь запросов:
    НИКОГДА не выключайте эту опцию, если у вас VPS с 512М RAM! ТДС аварийно завершит работу, как только ей перестанет хватать памяти, и сама больше не поднимется. В любом случае, производительности даже с включенно очередью запросов обычно более чем достаточно на слабых VPS.
    ВЫКЛЮЧИТЕ эту опцию если на вашем сервере 1G RAM или более.
    • ВКЛЮЧИТЬ - запросы обрабатываются небольшим пулом рабочих процессов. Это позволяет резко сократить потребление памяти, но отрицательно сказывается на производительности.
    • ВЫКЛЮЧИТЬ - запросы обрабатываются в контексте процессов веб-сервера. В этом случае ТДС работает в режиме максимальной производительности, но требует намного больше RAM под нагрузкой.

      НИКОГДА не выбирайте ВЫКЛЮЧИТЬ если у вас VPS с 512M RAM! ТДС аварийно завершит работу в момент, когда ей не хватит памяти. В любом случае на слабом VPS производительность будет более чем адекватна даже при включенной очереди.
      Как правило, имеет смысл отключить очередь, когда у вас на сервере 1G RAM и больше и вы ожидатете серьезную нагрузку на ТДС.
    GeoIP2 Типы соединений
    Активация платной базы GeoIP2 Connection Type от MaxMind. База должна быть разархивирована и загружена в каталог /opt/bosstds/deps/geodata2/priv/.
    GeoIP2 ISP
    Активация платной базы GeoIP2 ISP от MaxMind. База должна быть разархивирована и загружена в каталог /opt/bosstds/deps/geodata2/priv/.

  • Регистрация

    После того как вы купили ТДС и скачали ваш файл лицензии bosstds.lic из клиентской области сайта bosstds.com, введите содержимое этого файла на этой странице админки ТДС.
    Не забудьте перезапустить ТДС после того как введете код лицензии - /etc/init.d/bosstds/restart из консоли ssh. также не забудьте ввести IP лицензии в поле 'Привязать к IP' на странице настроек ТДС, если у вас более одного IP на сервере.

  • API

    API это инструмент для тех, кто использует ТДС из своих скриптов. В настоящий момент доступны php и python классы для работы с API, вы их можете найти в каталоге bosstds/priv/scripts/.

    В данный момент API является экспериментальной возможностью. В будущем возможны изменения в интерфейсе API. Стабильная работа не гарантируется.

    PHP API

    Для работы с ТДС из php используйте файл bossapi.php. Файл экспортирует класс BossAPI со следующими методами:

    __construct($apikey, $tdsdomain, $port, $method = 0)
    Конструктор,
    string $apikey, Ключ API, из диалога настроек ТДС;
    string $tdsdomain, домен ТДС, без номера порта;
    int $tdsport, порт ТДС; int $method - метод для доступа к TDS, 0 - file_get_contents, 1 - fsockopen.
    public function request($selector, $client_ip=NULL, $headers = NULL)
    Функция делает запрос к ТДС и возвращает результат в dict.
    string $selector - URL схемы, например '/api/demoscheme/'. ОБЯЗАТЕЛЬНО со слешем в начале! Обратите внимание - вместо /in/ здесь /api/.
    string $client_ip - IP клиента. Если NULL, будет автоматически взят из $_SERVER["REMOTE_ADDR"];
    array $headers -дополнительные HTTP заголовки, словарь, содержит список header_name => header_value. По умолчанию класс сам извлекает все заголовки из глобальной переменной $_SERVER global и шлет их на TDS. В $headers вы можете заменить значения некоторых заголовков из $_SERVER или добавить ваши собственные заголовки;
    возвращает array dict с тремя элементами: 'status' (HTTP code, обычно 302), 'location' (URL куда редиректить, может быть пустым, если ответ не 302, 'body' - тело ответа, пустое для обычных редиректов, не пустое для HTTP 200 редиректов.

    Пример использования

    include_once("bossapi.php");
    $domain = "yourdomain.com";
    $port = 18001;
    $api_key = "LKjmadsa6m";
    $boss = new BossAPI($api_key, $domain, $port, 1);
    $result = $boss->request("/api/demoscheme/");
    if (isset($result["status"]) && ($result["status"] == 302)) {
        header("Location: ".$result["location"]);
    } else {
        print_r($result);
    }


    Python (python 2.7) API

    Для доступа к TDS из скриптов на python используйте модуль bossapi.py. Модуль экспортирует класс BossAPI со следующими методами:

    def __init__(self, apikey, tdsdomain)
    Конструктор,
    str apikey, Ключ API, из диалога Настроек ТДС;
    str tdsdomain, домен вашей ТДС, с указанием порта, например yourdomain.com:18001;
    def request(self, selector, client_ip=None, headers=None)
    Метод делает запрос на ТДС и возвращает результат в dict.
    str selector - URL схемы, например '/api/demoscheme/'. ОБЯЗАТЕЛЬНО со слешем в начале! Обратите внимание - вместо /in/ здесь /api/.
    str client_ip - IP клиента. если None, будет 127.0.0.1. Если обращаетесь к API из Django, поместите в эту переменную значение request.META.get('REMOTE_ADDR');
    dict headers - HTTP заголовки. Содержит dict, состоящий из пар {header_name : header_value}. Если обращаетесь к API из Django, итерируйте request.META, выбирайте оттуда все значения, начинающиеся с 'HTTP_', замените 'HTTP_' на '' и используйте получившийся словарь в качестве параметра;
    возвращает dict с тремя элементами: 'status' (HTTP code, обычно 302), 'location' (URL куда редиректить, может быть пустым, если ответ не 302, 'body' - тело ответа, пустое для обычных редиректов, не пустое для HTTP 200 редиректов.

    Пример

    from bossapi import BossAPI
    boss = BossAPI("LKjmadsa6m", "yourdomain.com:18001")
    result = boss.request("/api/demoscheme/", "223.14.9.4", {"referer": "http://yahoo.com", "someotherheader": "headerval"}
    print result['status'], result['location'], result['body']
    #If you use Django, you should iterate request.META, extract all values starting with 'HTTP_', replace 'HTTP_' with '' and use this dictionary as the last parameter of request(...) method
www.megastock.ru www.paypal.com www.paxum.com
Hide dock Show dock Back to top
Loading