Вставьте конструкцию вида <get(настройка)> в параметры любой команды презентации, чтобы вместо неё в параметре команды презентации возникло значение соответствующего параметра.
Также эту команду можно вызывать из JavaScript с помощью динамической настройки презентации.
В данный момент поддерживаются следующие команды:
- Оставшееся время выполнения презентации - time
- <get(time)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::time"); - для получения значения этого параметра из JavaScript
- Ключ презентации - key
Ключ презентации используется для динамической настройки параметров и команд презентации.- <get(key)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::key"); - для получения значения этого параметра из JavaScript (практического значения не имеет, поскольку переменная prskey в данном примере уже будет содержать этот ключ, иначе операция не сработает)
- Оставшееся время до выполнения следующей команды - cmdtime
- <get(cmdtime)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::cmdtime"); - для получения значения этого параметра из JavaScript
- Номер следующей команды - cmdindex
Выдает номер команды, которая будет выполнена после истечения времени cmdtime. Номер команды начинается с нуля. Если не включена галочка "Случайный порядок показа страниц", то номер команды будет соответсвовать фактическому номеру команды презентации, минус единица, в противном случае соответствовать не будет и команды будут следовать в случайном порядке.- <get(cmdindex)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::cmdindex"); - для получения значения этого параметра из JavaScript
- Количество команд презентации - count
- <get(count)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::count"); - для получения значения этого параметра из JavaScript
- IP-адрес посетителя - ip
- <get(ip)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::ip"); - для получения значения этого параметра из JavaScript
- HTTP-Referer - referer
- <get(referer)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::referer"); - для получения значения этого параметра из JavaScript
- Журнал выполнения презентации - log
Выдает журнал выполнения презентации(аналогично вкладке "Журнал" в программе тестирования презентации) в формате urlencoded, удобном для отправки на удаленный сайт(см. ниже). Если нужен текстовый формат, используйте ключевое слово logtxt.- <get(log)> - для вставки в параметры команд презентации(формат urlencoded)
- <get(logtxt)> - для вставки в параметры команд презентации(текстовый формат)
- var a=prompt("prs::" + prskey + "::get::log"); - для получения значения этого параметра из JavaScript в формате urlencoded
- var a=prompt("prs::" + prskey + "::get::logtxt"); - для получения значения этого параметра из JavaScript в текстовом формате
Для оптимизации работы презентации вы можете получать обратную связь о работе презентаций непосредственно с пользовательских компьютеров в режиме реального времени! Для этого выполните несколько несложных инструкций:- Скачайте архив, распакуйте его на вашем компьютере.
- Отредактируйте файл log.php следующим образом:
- В строке $pass="12345"; замените 12345 на любой другой пароль. Вы его будете вводить при доступе на страницу просмотра журналов.
- В строке $postkey="54321"; замените 54321 на любой другой пароль. Этот пароль будет использоваться во время отправки результатов выполнения презентации.
- Также можно изменить в строке $file="log.txt"; название файла, который будет использоваться для хранения журналов.
- Сохраните изменения, загрузите содержимое архива на ваш сайт. Можно также переименовать файл log.php, на который будет приходить информация о выполнении презентации.
- Для файла log.txt (или другой файл, заданный в переменной $file) задайте права доступа, позволяющие запись данных из скрипта log.php. Какие именно права доступа можно безопасно использовать и как именно их задавать, вы можете узнать у вашего хостинг-провайдера.
- Предположим, файл log.php доступен по адресу http://site.ru/log.php, при этом вы не меняли содержимое переменных $pass и $postkey в этом файле.
Создайте в конце презентации команду "Переход POST" с параметрами http://site.ru/log.php?postkey=54321;;;log=<get(log)>
где вместо 54321 нужно вписать значение переменной $postkey из файла log.php, если вы его изменяли (рекомендуется его менять).
Предусмотрите некоторое время для выполнения команды, в зависимости от скорости интернета у пользователя оно может отличаться. Лучшего поставить 10-15 секунд. - Введите в браузере адрес http://site.ru/log.php
Введите пароль 12345 (или введенное вами ранее значение переменной $pass в файле log.php)
Должна появиться надпись "Нет записей". Если это так, значит все работает нормально. Если вы видите надпись "Нет прав доступа на запись", значит вам нужно задать права доступа, разрешающие запись файла log.txt (или другого, заданного в переменной $file файла log.php) - Запустите презентацию в программе тестирования, повторно зайдите по адресу http://site.ru/log.php и вам будет показано содержимое, аналогичное вкладке "Журнал" программы тестирования.
Теперь вы сможете получать результаты выполнения презентации от пользовательских машин в режиме реально времени и оптимизировать работу презентации.
- Номер активной вкладки - activetab
При работе с несколькими вкладками может быть полезно получить номер активной на данный момент вкладки.- <get(activetab)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::activetab"); - для получения значения этого параметра из JavaScript
- Количество вкладок - tabcount
Общее количество вкладок, доступное в презентации.- <get(tabcount)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::tabcount"); - для получения значения этого параметра из JavaScript
- ID рекламируемого сайта - id
- <get(id)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::id"); - для получения значения этого параметра из JavaScript
- Объем памяти компьютера, выполняющего презентацию.
Можно использовать для определения минимального объема памяти, необходимого для выполнения презентации. Определить объем памяти, который программа занимает при выполнении презентации на вашем компьютере, можно на вкладке "Журнал" программы тестирования презентации после завершения ее выполнения. На других компьютерах презентация может требовать другой объем памяти.
Доступны следующие параметры:- memory - объем свободной физической памяти
- totalmemory - общий объем физической памяти
- virtualmemory - объем свободной виртуальной памяти
- totalvirtualmemory - общий объем виртуальной памяти.
Пример для параметра memory:
- <get(memory)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::memory"); - для получения значения этого параметра из JavaScript
- Средний пинг до популярных интернет-ресурсов - ping
Функция измеряет раз в несколько минут показатель пинга до десяти популярных интернет-ресурсов и позволяет получить его среднее значение. Выдает 0 при ошибке или положительное значение пинг в милисекундах в случае успешного измерения.- <get(ping)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::ping"); - для получения значения этого параметра из JavaScript
- Тестовый режим - test
Показывает, в каком режиме сейчас идет показ сайта - в тестовом или рабочем. При тестировании рекламодателем показа сайта через программу PrTest принимает значение 1, а при показе сайта посетителям в программе SafeSurf - значение 0.- <get(test)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::test"); - для получения значения этого параметра из JavaScript
- Скорость загрузки страниц
Программа SafeSurf позволяет получать текущую скорость загрузки страниц и больших файлов у конкретного посетителя. Можно получить как скорость загрузки с начала воспроизведения текущей презентации, так и среднюю скорость загрузки страниц у пользователя за весь сеанс работы посетителя.Различается два показателя скорости - скорость загрузки страниц и скорость загрузки файлов. В определении первой скорости участвуют файлы размером от 25 до 300 КБ, второй - более 300 КБ.
Следует учитывать, что скорость загрузки страниц на практике получается существенно ниже как максимально возможной скорости интернет-соединения, так и скорости загрузки больших файлов, поскольку включает в себя и время на отправку запроса на сервер, и время ожидания ответа с сервера.
Именно поэтому мы выделили две скорости - они могут различаться в десятки раз. Соответственно ориентироваться на первую скорость нужно при загрузке обычных сайтов, а на вторую - либо при загрузке сайтов с большим количеством тяжеловесного контента, либо при загрузке файлов большого размера.
Обратите внимание, что скорость может обновляться спустя секунду после окончания загрузки. Скорость загрузки текущей презентации не влияет на показатель средней скорости загрузки страниц до полного завершения презентации.
Доступны следующие параметры (значение выдается в Мбит/c c шагом 0.1):- speed - текущая скорость загрузки страниц (считается для текущей презентации)
- highspeed - текущая скорость загрузки больших файлов (считается для текущей презентации)
- avgspeed - средняя скорость загрузки страниц (по результатам воспроизведения нескольких презентаций)
- avghighspeed - средняя скорость загрузки больших файлов (по результатам воспроизведения нескольких презентаций)
Пример для параметра speed:
- <get(speed)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::speed"); - для получения значения этого параметра из JavaScript
- Количество открытых HTTP-соединений
Выдает количество HTTP-соединений, в данный момент выполняющихся программой SafeSurf, открытых с помощью команды request.- <get(requestcount)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::requestcount"); - для получения значения этого параметра из JavaScript
- Количество подключенных сокетов
Выдает количество подключенных сокетов, подключение которых открыто с помощью команды socketconnect.- <get(socketcount)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::socketcount"); - для получения значения этого параметра из JavaScript
- Получение информации о фрейме
Данный метод позволяет получить информацию о фрейме в формате JSON. Выдается индекс фрейма, его URL, положение полос прокрутки и размеры.- <getframeinfo(frameGuid)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::getframeinfo::frameGuid"); - для получения значения этого параметра из JavaScript
Выполняем команду: "<injectjs(http://example.org/script.js)>", затем где-то в коде скрипта: var frameGuid = "<frameGuid>"; var prskey = "<get(key)>"; var frameInfo = prompt("prs::" + prskey + "::getframeinfo::" + frameGuid); --- Результатом выполнения будет примерно следующее: [ { "Src":"http://example.org/frame1.html", "Index":0, "Scroll":{"X":0,"Y":0}, "Rect":{"Left":0,"Top":15,"Right":600,"Bottom":615,"Width":600,"Height":600,"X":0,"Y":15} }, { "Src":"http://example.org/frame2.html", "Index":1, "Scroll":{"X":0,"Y":0}, "Rect":{"Left":8,"Top":67,"Right":612,"Bottom":671,"Width":604,"Height":604,"X":8,"Y":67} } ] - Скорость пользовательского ввода
Выдает скорость имитации ввода текста, заданную в процентах. 0 означает минимальную скорость ввода, 100 - максимальную. Каждый экземпляр SafeSurf имеет свою скорость ввода.- <get(inputspeed)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::inputspeed"); - для получения значения этого параметра из JavaScript
- Параметры имитации браузера
Выдает параметры имитации браузера посетителя, такие как платформа, имя браузера и версия. Именно с этими параметрами в данный момент выполняется показ.
Доступны следующие параметры:- browserplatform - платформа браузера, может быть PC или Mobile. При запросе загрузки с сервера нового User-Agent будет иметь значение loading
- browsername - имя браузера, например Chrome. Все возможные браузеры перечислены в команде настройки User-Agent.
- browserversion - версия браузера, например 114
- browsererror - ошибка при обработке загрузки браузера
- <get(browserplatform)> - для вставки в параметры команд презентации
- var a=prompt("prs::" + prskey + "::get::browserplatform"); - для получения значения этого параметра из JavaScript
- Динамическая настройка презентации
Режим презентации позволяет использовать JavaScript для настройки параметров команд во время выполнения показа сайта. Можно изменять ряд параметров презентации, выполнять некоторые действия, в том числе добавлять или изменять команды презентации. Если в настройках сайта могут быть заданы только 30 команд, то динамически можно добавить до 1000 команд! Это дает возможность создавать презентации любой сложности и подстраивать показ презентации для конкретного пользователя непосредственно во время показа сайта, что дает практически неограниченные возможности.
Для изменения настроек используются функции JavaScript prompt и alert. Различие между функциями состоит лишь в том, что prompt выдает значение, а alert - не выдает. Таким образом, prompt обязательно использовать в том случае, если нужно получить значение, например оставшегося времени презентации, alert можно использовать для операций, которые не требуют получения значений, например очистка окна браузера. В обоих случаях можно использовать prompt.
Типичный вызов функции настройки из скрипта выглядит так:
var a=prompt("prs::" + prskey + "::COMMAND::VALUE");, где:- prs - постоянный текст, говорящий о том, что идет изменение параметров презентации,
- prskey - переменная, в которую был предварительно установлен ключ презентации, для этого нужно вписать команду презентации "Вставка JavaScript" с параметрами var prskey="<get(key)>";
Рекомендуется обеспечивать уникальность имени переменной, хранящей ключ презентации, если скрипт с управляющими командами подгружается непосредственно на рекламируемом сайте. Если вы будете использовать указанное здесь имя prskey, то есть вероятность, что скрипты отображаемого сайта получат несанкционированный доступ к настройкам презентации! - COMMAND - имя команды, возможные варианты описаны ниже.
- VALUE - параметры команды COMMAND, зависят от самой команды и описаны ниже.
Рекомендуется для подготовки презентации вводить адрес первой страницы about:blank, а затем вызывать команду "Вставить скрипт", которая вставит ключ презентации и загрузит управляющий скрипт. Скрипт можно загрузить, используя функцию <dls(адрес_скрипта)>
Например, команда "Вставить скрипт" с параметрами var prskey="<get(key)>"; <dls(http://site.ru/script.js)> загрузит скрипт с командами презентации, расположенный по адресу http://site.ru/script.js. Более подробно вы можете прочитать в примере.- Альтернативный способ динамической настройки
Замечание: на части сайтов по неизвестным причинам обработчики alert и prompt перестают работать или работают нестабильно, в этом случае можно использовать document.title="prs::" + prskey + "::COMMAND::VALUE";
Если результат выполнения команды, отправленной с помощью document.title, не важен, т.е. в базовом варианте достаточно использовать alert, то можно использовать как есть. document.title="prs::" + prskey + "::COMMAND::VALUE"; и alert("prs::" + prskey + "::COMMAND::VALUE"); - работает абсолютно одинаково. Для получения ответа аналог вызова prompt следует заранее создать функцию, которая будет получать ответ.Пример:
f(answer){ ... } - такого вида функция должна быть заранее создана на странице для получения ответа. В переменной answer будет содержаться ответ. Тогда следует выполнить следующий код:
document.title="prs::" + prskey + "::COMMAND::VALUE<<answer(f(\"<<result>>\"))>>";
<<answer(КОД)>> - вставляет любой КОД в документ. КОД обрабатывается как и любая команда презентации, т.е. например ответ может быть перенаправлен в нужный фрейм с помощью инструкции frame.
<<result>> заменяется текстом ответа.
В данном примере вставляемый код вызывает заранее определенную функцию f, в которую передает ответ от вызыванной команды презентации COMMAND.- Описание команд (параметр COMMAND)
- add - добавление команды презентации
Добавляет команду презентации и выдает номер добавленной команды. Выдает -1 если превышен лимит команд. Стандартный вызов меняется на:
var a=prompt("prs::" + prskey + "::add::COMMAND::TIME::PARAMS");, где:- COMMAND - команда презентации, может быть:
- nav - Переход
- link - Поиск ссылки
- text - Ввод текста
- check - Отметить флажок
- submit - Отправить форму
- event - Отправить Событие
- cookies - Очистить Cookies
- script - Вставить скрипт
- post - Переход POST
- click - Клик
- TIME - время выполнения команды в секундах. Обратите внимание, что на значение параметра TIME влияет случайное отклонение времени выполнения команд, заданное в настройках презентации.
- PARAMS - параметры конкретной команды. Описание параметров и примеров можно найти в разделе "Команды презентации"
- COMMAND - команда презентации, может быть:
- mod - изменение команды презентации
Изменяет команду презентации с указанным индексом. Выдает -1 если команда с указанным индексом не найдена. Стандартный вызов меняется на:
var a=prompt("prs::" + prskey + "::mod::INDEX::COMMAND::TIME::PARAMS");, где INDEX - номер изменяемой команды (начинается с нуля), остальные параметры аналогичны команде add. - get - получение параметров презентации
Содержимое параметра VALUE зависит от параметра и приведено вместе с примерами отдельно. (пример для JavaScript) - set - установка параметров презентации
Содержимое параметра VALUE зависит от параметра и приведено вместе с примерами отдельно. (пример для JavaScript) - getvar - получение значения переменной
Получение значения переменной с именем VALUE. Подробное описание работы с переменными приведено отдельно (пример для JavaScript). - setvar - установка значения переменной
Установка значения переменной, параметр VALUE принимает вид name=value, где name - имя переменной, value - устанавливаемое значение. Подробное описание работы с переменными приведено отдельно (пример для JavaScript). - debug - вывод отладочной информации
Вывод отладочной информации в программу тестирования презентации на вкладку "Журнал". Будет выведено содержимое параметра VALUE. Функция будет полезна при отладке работы презентации.
Пример: alert("prs::" + prskey + "::debug::Этот текст вы увидите во вкладке ЖУРНАЛ"); - parse - обработка текста
Команда обрабатывает переданный в параметре VALUE текст функциями замены текста, обработки параметров и переменных (т.е. любыми функциями, которые могут быть вставлены в параметры команды презентации) и выдает результат в переменную.
Пример: var a=prompt("prs::" + prskey + "::parse::<rndt(Yandex!!Rambler!!Google)>");
Переменная a может получить слово Google, т.е. мы вызвали функцию вставки случайного текста rndt - scroll - прокрутка страницы к указанному объекту
Команда прокручивает страницу к объекту JavaScript, определенному в VALUE, и задает смещение координат клика или скриншота от левого верхнего угла страницы до объекта. Может работать с фреймами, тогда смещение задается относительно всех фреймов. Смещение (x,y) и размеры объекта (width,height) сохраняются в переменных sys.scrollx, sys.scrolly, sys.scrollwidth, sys.scrollheight и могут быть использованы в целях вызова функций клика по координатам или скриншота.
Доступен вызов функции не только с помощью JavaScript, но и из команд презентации - <scroll(параметры)> - в таком виде только при работе с главным фреймом!
Внимание! Повторный вызов этой функции без выполнения клика или скриншота вызовет удвоение координат (x,y). Чтобы этого избежать, нужно сначала вызвать эту функцию с параметром clear - это обнулит координаты.
Если объект может быть получен средствами JavaScript в одну команду, то нужна только эта команда с ; в конце.
Пример: alert("prs::" + prskey + "::scroll::document.getElementById('object');<frame(name=frame1)>"); - прокрутит главную страницу, чтобы стал виден фрейм с именем frame1, затем прокрутит фрейм iframe1, чтобы стал виден объект с ID object, после чего задаст координаты объекта (верхнего левого угла) с ID object в качестве точки отсчета для функции click.
Если объект не может быть получен одной командой, то последней командой нужно присвоить объект переменной tmpbrr.hElso
Пример: alert("prs::" + prskey + "::scroll::document.getElementsByTagName('a'); tmpbrr.hElso=tmpbrr.hElso[3];"); - прокрутит главную страницу, чтобы стала видна четвертая ссылка (которая содержит индекс 3) документа, и внесет её координаты в качестве точки отсчета.
Можно использовать стандартные команды презентации для указания объекта, к которому должна быть прокручена страница
Пример: команда "Отправить событие" с параметрами a;link;jetswap.com;mousemove отправит нужной ссылке событие mousemove и запомнит эту ссылку,
затем "Вставить скрипт" alert("prs::" + prskey + "::scroll::hElsolast;"); произведет прокрутку страницы к ранее использовавшейся ссылке. - click - выполнение клика по заданным координатам (или перемещение мыши без клика)
В качестве точки отсчета для клика выступают координаты, заданные функцией scroll, либо нулевые координаты, если функция scroll не вызывалась с момента последнего вызова функции click. VALUE имеет формат x:y:MoveTime:ClickTime:FromX:FromY, где x и y - координаты клика, MoveTime - время перемещения мыши в миллисекундах, ClickTime - время между окончанием перемещения мыши в нужную точку и кликом (в мс).
FromX и FromY - необязательные параметры, соответствующие координатам X и Y начальной точки, из которой производится перемещение мыши. Если FromX и FromY не заданы, то используется либо случайная точка, либо, если включен режим реального перемещения мыши, текущая позиция курсора мыши.
Эта функция может использовать реальное перемещение курсора мыши и клики, для этого его нужно включить.
Доступен вызов функции не только с помощью JavaScript, но и из команд презентации - <click(параметры)> - в таком виде только при работе с главным фреймом!
Пример: alert("prs::" + prskey + "::click::10:15:3000:300");
Пример с заданием начальной точки (100,200): alert("prs::" + prskey + "::click::10:15:3000:300:100:200");Также есть возможность отключить выполнение клика, если нужно переместить мышь по заданным координатам, не выполняя при этом клик. Для этого нужно добавить ключевое слово move в параметры команды (в любом месте).
Например так: alert("prs::" + prskey + "::click::10:15:3000:300move");
- screenshot - выполнение скриншота страницы или её элемента
Узнайте, как выполняется ваша презентация, создав скриншот страницы браузера или отдельного её элемента в любое нужное время. В качестве точки отсчета для скриншота выступают координаты, заданные функцией scroll, либо нулевые координаты, если функция scroll не вызывалась с момента последнего вызова функции click/screenshot. Скриншот сохраняется в переменной с именем screenshot
Доступен вызов функции не только с помощью JavaScript, но и из команд презентации - <screenshot(параметры)> - в таком виде только при работе с главным фреймом!
VALUE имеет формат format:x:y:width:height, где:- format - формат сохранения изображения. Доступные форматы:
- gif
- jpeg
- bmp
- png
Добавьте также в параметр format ключевое слово save, чтобы скриншот сохранился на диске в папке SafeSurf под именем image.[FORMAT] - расширение файла зависит от заданного формата. Например, при выполнении скриншота с параметрами gifsave;0;0;max;max скриншот всей страницы сохранится по именем image.gif. Скриншот сохраняется только во время тестирования, во время просмотра через SafeSurf на диске скриншот сохранен не будет, этот параметр игнорируется. - x, y - координаты верхней левой точки прямоугольника скриншота. При использовании совместно с scroll - координаты относительно координат объекта, к которому прокручено окно браузера, при этом координаты верхней левой точки прямоугольника скриншота вычисляются как сумма полученных в этом параметре координат и координат объекта, к которому осуществлялась прокрутка - если тут ввести 0:0 - то будут сами координаты объекта прокрутки.
- width, height - длина и ширина прямоугольника. При вводе ключевого слова max используется вся длина/ширина браузера, при использовании ключевого слова last используется длина/ширина объекта, к которому прокручено окно браузера с помощью функции scroll
Примеры:
alert("prs::" + prskey + "::screenshot::jpegencode:10:15:100:200"); или <screenshot(jpegencode:10:15:100:200)> - создаст скриншот объекта с координитами (10;15) и размерами 100x200, формат скриншота - jpeg, дополнительно выходные данные будут обработаны функцией urlencode для удобства отправки через функцию "Переход POST"
Для отправки сделанного скриншота на сервер можно использовать команду Переход POST с параметрами http://site.ru/script.php;;;image=<getvar(screenshot)>
После выполнения этой команды скрипт с адресом http://site.ru/script.php в переменной image получит скриншот, закодированный base64. Чтобы сохранить исходный файл на сервере под именем image.jpg, нужно будет выполнить следующий код на php:
$image=base64_decode($_POST['image']);
file_put_contents('image.jpg',$image);Пример вызова совместно с командой scroll:
alert("prs::" + prskey + "::scroll::document.getElementById('object');<frame(name=frame1)>"); - прокрутит главную страницу, чтобы стал виден фрейм с именем frame1, затем прокрутит фрейм iframe1, чтобы стал виден объект с ID object, после чего задаст координаты объекта (верхнего левого угла) с ID object в качестве точки отсчета для функции screenshot.
alert("prs::" + prskey + "::screenshot::jpeg:0:0:last:last"); - сделает скриншот объекта, к которому была прокручена страница.Можно использовать стандартные команды презентации для указания объекта скриншота
Пример: команда "Отправить событие" с параметрами img;custom;src=logo;mousemove отправит нужной картинке событие mousemove и запомнит эту картинку,
затем "Вставить скрипт" alert("prs::" + prskey + "::scroll::hElsolast;"); произведет прокрутку страницы к ранее запомненной картинке,
после чего "Вставить скрипт" alert("prs::" + prskey + "::screenshot::gif:0:0:last:last"); сделает скриншот этой картинки. - format - формат сохранения изображения. Доступные форматы:
- cookies - управление Cookies
Возможность управления Cookies из команды JavaScript. Параметры аналогичны очистке Cookies из команды презентации.
Пример: alert("prs::" + prskey + "::cookies::ALL"); - очистка Cookies.
Пример импорта-экспорта cookies:
Экспорт: var cookielist=prompt("prs::" + prskey + "::cookies::export;list"); - в переменную cookielist будут записаны данные для экспорта, которые потом можно отправлять на сервер рекламодателя через команду request
Импорт: alert("prs::" + prskey + "::cookies::clear;" + cookielist); - предварительно в переменную cookielist получить с сервера рекламодателя данные cookies, можно с помощью команды request - request - Отправка HTTP-запроса
Отправка HTTP-запроса с возможностью задать любые HTTP-заголовки. Получение данных является асинхронным. Для больших файлов возможно получение данных по частям.
Параметры запроса передаются в формате JSON.- callback - название функции, которая выполнится после выполнения запроса (параметры чуть ниже)
- progress - название функции прогресса для получения данных по частям (параметры ниже)
- url - ссылка
- method - метод запроса (GET/POST и т.д.)
- data - тело запроса (если method == GET - то игнорируется)
- headers - заголовки. Это объект вида {ключ1: значение1, ключ2: значение2} или вида [{name: "ключ1", value: "значение1"}, {name: "ключ2", value: "значение2"}]. В качестве заголовков можно передавать следующие ключевые слова:
- Request-Timeout 60 - таймаут ожидания ответа в секундах
- Encode-Answer base64 - при передаче этого заголовка и значения base64 - ответ от функции будет передан в формате base64.
- Retry-Count 5 - количество повторных запросов при возникновении ошибок
- statusCode - код статуса ответа (-1/0 - если произошло исключение, 200, 404 и т.д)
- statusDescription - текст статуса ответа. Если исключение - то Exception.Message, в противном случае - Ok, Not Found и т.д.
- url - ссылка. Полезно, если при запросе произошло автоматическое перенаправление
- content - В progress-callback это часть полученных данных в HEX. В callback - это тело запроса, если не указан progress-callback или null, если он указан
- headers - это объект вида {заголовок1: значение1, заголовок2: значение2}, содержащий заголовки ответа.
- Не более 10 одновременных запросов
- Не более 5 МБ загруженных данных за один запрос
- requestcancel - отмена всех выполняющихся HTTP-запросов, отправленных с помощью функции request
Пример: alert("prs::" + prskey + "::requestcancel::ALL"); - get(requestcount) - получение количества HTTP-запросов, отправленных с помощью функции request, и выполняющихся в данный момент
Комплексный пример:
1. Перейдите с помощью команды "Переход" или любой другой на страницу, содержащую следующий код:<script> var req={callback: "requestcallback", url: "https://google.com/", method: "GET", headers: {Referer: "https://google.com", "User-Agent": "JetSwap", "Retry-Count": "3", "Encode-Answer": "base64"} }; function requestcallback(arg) { alert("prs::" + prskey + "::debug::" + base64_decode(arg.content)); } function base64_decode( data ) { var b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/="; var o1, o2, o3, h1, h2, h3, h4, bits, i=0, enc=''; do { h1 = b64.indexOf(data.charAt(i++)); h2 = b64.indexOf(data.charAt(i++)); h3 = b64.indexOf(data.charAt(i++)); h4 = b64.indexOf(data.charAt(i++)); bits = h1<<18 | h2<<12 | h3<<6 | h4; o1 = bits>>16 & 0xff; o2 = bits>>8 & 0xff; o3 = bits & 0xff; if (h3 == 64) enc += String.fromCharCode(o1); else if (h4 == 64) enc += String.fromCharCode(o1, o2); else enc += String.fromCharCode(o1, o2, o3); } while (i < data.length); return enc; } </script>
2. Добавьте после паузы, необходимой для полной загрузки вышеуказанной страницы, команду "Вставить скрипт" со следующим содержимым: var prskey="<get(key)>"; var id=alert("prs::" + prskey + "::request::" + JSON.stringify(req)); - socketconnect - установка соединения с помощью сокета (дает возможность обмена любыми данными и с использованием любых протоколов, не только HTTP.
Протокол обмена данными реализуется рекламодателем)
В качестве разделителя параметров запроса используется точка с запятой - ";". Параметры:- Host - имя домена или IP-адрес, с которым требуется установить соединение
- Port - номер порта
- Ssl - 0/1 - требуется ли установить защищенное соединение
- ConnectCallback - имя функции JavaScript, определенной пользователем, которая будет вызвана при установке соединения.
- RecvCallback - имя функции JavaScript, определенной пользователем, которая будет вызвана при получении данных через открытое соединение.
- ID - ID подключения, выданный функцией socketconnect
- Error - текст ошибки. Присутствует только в случае если подключение завершено неудачно.
- ID - ID подключения, выданный функцией socketconnect
- Text - полученные данные в формате base64
- Error - текст ошибки. Присутствует только в случае возникновения ошибок приема-передачи данных, внезапного разрыва соединения и т.п.
- Не более 20 одновременных запросов
- Не более 5 МБ общий размер очереди на передачу данных
- Не более 20000 байт размер одной строки для передачи
- socketsend - отправка данных через соединение, установленное с помощью команды socketconnect
В качестве разделителя параметров запроса используется точка с запятой - ";". Параметры:- Id - ID соединения, выданный командой socketconnect
- Data - данные для отправки, задаются в формате base64
- socketclose - закрытие соединения, открытого с помощью команды socketconnect.
В качестве параметра передается ID соединения или ключевое слово ALL, означающее закрытие всех открытых с помощью команды socketconnect соединений. - get(socketcount) - получение количества открытых сокетов в данный момент
Комплексный пример:
1. Перейдите с помощью команды "Переход" или любой другой на страницу, содержащую следующий код:<script> function onconnect(id,err) { if(err!="") { var txt='GET / HTTP/1.1\r\nHost: google.com\r\nUser-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:53.0) Gecko/20100101 Firefox/53.0\r\nAccept: */*\r\n\r\n'; txt=base64_encode(txt) alert("prs::" + prskey + "::socketsend::" + id + ";" + txt); } } function onrecv(id,text) { text=base64_decode(text) alert("prs::" + prskey + "::debug::" + text); } function base64_encode( data ) { var b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/="; var o1, o2, o3, h1, h2, h3, h4, bits, i=0, enc=''; do { // pack three octets into four hexets o1 = data.charCodeAt(i++); o2 = data.charCodeAt(i++); o3 = data.charCodeAt(i++); bits = o1<<16 | o2<<8 | o3; h1 = bits>>18 & 0x3f; h2 = bits>>12 & 0x3f; h3 = bits>>6 & 0x3f; h4 = bits & 0x3f; // use hexets to index into b64, and append result to encoded string enc += b64.charAt(h1) + b64.charAt(h2) + b64.charAt(h3) + b64.charAt(h4); } while (i < data.length); switch( data.length % 3 ){ case 1: enc = enc.slice(0, -2) + '=='; break; case 2: enc = enc.slice(0, -1) + '='; break; } return enc; } function base64_decode( data ) { var b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/="; var o1, o2, o3, h1, h2, h3, h4, bits, i=0, enc=''; do { h1 = b64.indexOf(data.charAt(i++)); h2 = b64.indexOf(data.charAt(i++)); h3 = b64.indexOf(data.charAt(i++)); h4 = b64.indexOf(data.charAt(i++)); bits = h1<<18 | h2<<12 | h3<<6 | h4; o1 = bits>>16 & 0xff; o2 = bits>>8 & 0xff; o3 = bits & 0xff; if (h3 == 64) enc += String.fromCharCode(o1); else if (h4 == 64) enc += String.fromCharCode(o1, o2); else enc += String.fromCharCode(o1, o2, o3); } while (i < data.length); return enc; } </script>2. Добавьте после паузы, необходимой для полной загрузки вышеуказанной страницы, команду "Вставить скрипт" со следующим содержимым: var prskey="<get(key)>"; var id=alert("prs::" + prskey + "::socketconnect::google.com;443;1;onconnect;onrecv"); - text - имитация ввода текста с клавиатуры.
Параметры имеют вид form;element;text<модификаторы>, где form и element - идентификаторы или номера формы в документе, а также элемента в пределах этой формы. text - тест для ввода.
Без модификаторов будет выполнен такой код (будет просто установлен заданный текст, без имитации его ввода): document.forms[form].elements[element].value=text; Модификаторы:-
<native> - имитация ввода текста. При этом устанавливается фокус на элемент, заданный параметрами form и element.
Например, при таком HTML-коде: <form name=theform><input name=text1></form> и параметрах <native>theform;text1;test фокус получит текстовое окно с именем text1 и форма с именем thefrom, после чего будет произведена имитация ввода текста "test" в это текстовое окно.
У каждого экземпляра SafeSurf есть индивидуальная скорость ввода текста для имитации разных пользователей - кто-то текст вводит быстрее, а кто-то медленнее. Если вам нужна определенная скорость ввода текста, вы можете ее задать с помощью функции изменения скорости пользовательского ввода - <nofocus> - не обрабатывать элементы form и element, а сразу ввести указанный текст. Предполагается, что элемент для ввода был заранее выбран. <nofocus><native>;;test - текст "test" будет введен в заранее выбранный с помощью функции JavaScript focus() элемент.
- <global> - глобальная отправка событий клавиатуры. Рекомендуется применять только при вводе текста во флеш-баннеры, в противном случае не имеет смысла. Действует только при включении реального использования мыши и клавиатуры Фокус на элемент флеш-баннера можно установить с помощью команды "Клик по координатам"
- <callback(script)> - код, заданный в качестве параметра script, будет выполнен после завершения имитации ввода текста.
- <char> - ввод одного символа с возможностью задать клавиши-модификаторы Shift, Ctrl, Alt. В этом случае параметр text будет состоять из символа, который нужно ввести, а также модификаторов, например:
Ctrla - аналог комбинации клавиш Ctrl+A - выделит весь текст в выбранном текстовом поле. Если нужно ввести только символ, то достаточно указать только его.
В данный момент с модификатором Shift разрешены любые символы, с модификатором Ctrl разрешен только Ctrla, c модификатором Alt символы запрещены. Для включения дополнительх комбинаций клавиш обратитесь к администрации с обоснованием необходимости их включения.
Доступен вызов функции не только с помощью JavaScript, но и из команды презентации "Ввод текста"
Пример: alert("prs::" + prskey + "::text::<native><callback(document.forms['form'].submit();)>form;text;Тест");
Данный пример имитирует ввод с клавиатуры слова Тест в элемент с именем text формы form, затем отправит эту форму на сервер, вставив код document.forms['form'].submit(); в документ. -
<native> - имитация ввода текста. При этом устанавливается фокус на элемент, заданный параметрами form и element.
- add - добавление команды презентации
- Пример динамической настройки - выполнение блоков команд
Этот пример показывает, как можно настроить презентацию, чтобы в зависимости от некоторых условий выполнялись не все заданные команды, а только часть из них. В данном случае, 20% посетителей посмотрят 2 страницы сайта, 50% посетителей посмотрят 4 страницы, а оставшаяся часть - 3 страницы, причем зайдет не на первую страницу, а на случайно выбранную. В зависимости от выбранной группы также изменяется состав рефереров, с которыми будет входить посетитель на первую страницу.
Для настройки динамической презентации далеко не всегда нужно обладать специальными знаниями в программировании, вполне можно использовать готовые шаблоны.
В настройках сайта установите:
- Первая страница - about:blank
- Общее время показа всей презентации - 60 секунд
- Время показа первого сайта - 1 секунда.
- Переключатель режима презентации - в положение "Показ страниц разных сайтов"
- Переключатель реферера - в положение Передавать реферер по заказу на первую страницу, на остальные - текущую страницу в браузере как реферер
- Первая команда "Вставить скрипт", время показа 60 секунд, параметры: var prskey="<get(key)>"; <dls(http://regjet.ru/prscript.js)>
Примечание 1: для настройки презентации, чтобы исключить кэширование, установите параметры команды вставки скрипта var prskey="<get(key)>"; <dls(http://regjet.ru/prscript.js?nocache=<rndr(1:999999)>)>
Примечание 2: about:blank некорректно работает с русским текстом. Если вам требуется использование опрераций с русским текстом, то вначале нужно осуществить редирект на страницу в кодировке кириллица windows (windows-1251), а затем уже вставлять скрипт, при этом для вставки скрипта следует задать большее время, чтобы успел выполниться редирект. Можно разместить скрипт прямо на этой странице, тогда он начнет работу сразу же после загрузки, однако ему нужно будет передать ключ презентации и скрипт должен корректно обрабатывать отсутсвие этого ключа (если ключ еще не передан).
- Работа с переменными
Режим презентации позволяет запомнить до 1000 переменных размером до 1000 символов каждая, при этом имя переменной не может превышать 10 символов. Переменные хранятся во время показа презентации.
- Установка значения переменной
Установка значения VALUE для переменной с именем NAME:- <setvar(NAME=VALUE)> - в параметрах команды презентации.
- alert("prs::" + prskey + "::setvar::NAME=VALUE"); - в JavaScript.
- Получение значения переменной
Получение значения переменной c именем NAME:- <getvar(NAME)> - в параметрах команды презентации.
- var a=prompt("prs::" + prskey + "::getvar::NAME"); - в JavaScript,
- Пример
Выполнение команд
- Вставить скрипт <setvar(varname=<rndt(jetswap!!jethosting!!regjet)>)>
- Отправить событие a;link;<getvar(varname)>;click
- Поиск ссылки link;<getvar(varname)>
- Отправить событие a;link;jetswap;click
- Поиск ссылки link;jetswap
- Установка значения переменной
- Общие функции вставки случайного текста
В режиме презентации предусмотрено несколько фунций вставки случайного текста. Они действуют на все параметры всех команд, также их можно использовать в поле "Реферер по заказу". Происходит это так: вы вставляете в нужном месте текста функцию, а в процессе показа презентации она будет заменена на случайный текст в соответствии с настройками.
- Случайный набор символов заданной длины
Функция вида <rnd(A:B)> выдает случайную последовательность символов длины A из заданного алфавита B. Имеется также ряд предустановленных алфавитов (т.е. не нужно вводить абвгде... а вместо этого можно ввести только #r):- #n - цифры от 0 до 9
- #c - латинские буквы от a до z
- #C - латинские буквы от A до Z
- #r - русские буквы от а до я
- #R - русские буквы от А до Я
- #! - спецсимволы ~`@#$%^&*();"':/?<>.,[]{}|\-_
- <rnd(3:#n)> выдаст 485 (любое трехзначное число)
- <rnd(5:#c#C)> выдаст HdoIW (набор из пяти случайных латинских символов в верхнем и нижнем регистре)
- <rnd(32:#nabcdef)> выдаст 7215ee9c7d9dc229d2921a40e899ec5f (такой набор символов выдает функция md5)
- <rnd(4:#C#C#C#c)> выдаст WdOF (в этом наборе из четырех случайных латинских символов появление символов в верхнем регистре в три раза более вероятно, чем в нижнем)
- Введите http://forum.jetswap.com/viewtopic.php?t=1<rnd(3:#n)> в реферере по заказу, чтобы имитировать переход на ваш сайт с разных страниц форума JetSwap
- Введите http://forum.jetswap.com/viewtopic.php?t=1<rnd(3:#n)> в команде "Переход", чтобы автоматически переходить на случайные страницы форума JetSwap.
- Выбор из набора вариантов
Функция вида <rndt(value!!value!!value!!value...)> выдает случайное значение value из списка вариантов, разделенных !! (двумя восклицательными знаками).
Примеры:- <rndt(Yandex!!Rambler!!Google)> может выдать слово Google.
- Введите http://www.jetswap.com/<rndt(index!!news!!adv!!rek!!r!!pr)>.htm в команде "Переход", чтобы произошел переход на одну из страниц: http://www.jetswap.com/index.htm, http://www.jetswap.com/news.htm и т.д.
- Случайное число с ограничением минимума и максимума
Функция вида <rndr(Min:Max)> выдает случайное число от Min до Max
Например, <rndr(10:99)> может выдать число 39 (любое число от 10 до 99 включительно).
- Случайный набор символов заданной длины
- Тестирование режима презентации
- Установите программу SafeSurf
- Запустите программу prtest.exe, входящую в состав SafeSurf. Ее можно запустить как из папки с программой SafeSurf, так и из меню "Пуск" при использовании установщика SafeSurf. Программа должна иметь сетевой доступ и запускаться от администратора.
- Нажмите на картинку
в списке сайтов для нужного вам сайта. Такая картинка появляется только при включенном режиме презентации!
- Скопируйте полученный на странице код в текстовое окно программы (около которого написано "Введите код для начала теста:") и нажмите кнопку "Пуск".
- Пример настройки презентации
- Высокое качество картинки (20 МБ)
- Низкое качество картинки, комментарии видны четко (11 МБ)
- Работа с фреймами
Список команд, поддерживающих вставку во фрейм: Поиск ссылки, Ввод текста, Отметить флажок, Отправить форму, Отправить Событие, Вставить скрипт.
Чтобы команда была вставлена во фрейм, нужно в параметре соответствующей команды в любом месте указать функцию вида <frame(идентификатор1!!идентификатор2!!идентификатор3...)>
Указание нескольких идентификаторов, разделенных !! (двумя восклицательными знаками), позволяет получить доступ к вложенным фреймам, т.е. если в главном документе содержится один фрейм, а в этом фрейме содержатся еще два фрейма, из которых нам нужен второй,то функция примет вид <frame(0!!1)> (нумерация фреймов начинается с нуля)
Идентификатор может принимать следующие значения:
- Число - номер фрейма (на текущем уровне вложенности), начинающийся с нуля. При вводе команды <frame(5)> будет найден шестой по счету фрейм документа.
- url=URL, где вместо URL нужно ввести часть адреса, которая должна содержаться в искомом фрейме. При вводе команды <frame(url=jetswap)> будет найден к примеру такой фрейм: <iframe src=http://www.jetswap.com>
- url==URL, где вместо URL нужно ввести точный адрес (совпадающий по каждому символу) искового фрейма. При вводе команды <frame(url==http://www.jetswap.com/)> будет найден ТОЛЬКО такой фрейм: <iframe src=http://www.jetswap.com/>
- name=NAME, где вместо NAME нужно ввести часть имени искомого фрейма. При вводе команды <frame(name=fra)> будет найден к примеру такой фрейм: <iframe name=megaframe src=http://www.jetswap.com>
- name==NAME, где вместо NAME нужно ввести точное имя фрейма. При вводе команды <frame(name==megaframe)> будет найден ТОЛЬКО фрейм: <iframe name=megaframe src=http://www.jetswap.com>
Пример использования
Задача: нам нужно выполнить стандартную связку команд "Отправить событие" + "Поиск ссылки", чтобы кликнуть по ссылке <a href=http://www.jetswap.com onclick=click_handler()>Ссылка</a>, находящейся во фрейме <iframe name=frame2 src=http://www.jetswap.com/frame.php>. Мы точно знаем, что нам нужен фрейм с именем frame2 или URL http://www.jetswap.com/frame.php. Какой способ поиска фрейма использовать, в данном примере значения не имеет. Обе функции сработают одинаково: <frame(name==frame2)> или <frame(url=frame.php)> Предпочтительнее использовать поиск по имени фрейма. Получаем команды:
- "Отправить событие" c параметрами <frame(name==frame2)>a;link;jetswap;click
- "Поиск ссылки" ЗАМЕНЯЕМ на "Вставить скрипт" c параметрами <frame(name==frame2)>top.location.href=hElsolast.href;
Обратите внимание! Если использовать стандартную функцию "Поиск ссылки" с параметрами last;0, то переход по ссылке произойдет в тот же фрейм, в котором находится ссылка, а это в большинстве случаев будет нежелательно.
- Работа с вкладками
Режим презентации позволяет работать сразу с несколькими вкладками браузера. Помимо основного окна, дополнительно может быть открыто до трех вкладок. Этого более чем достаточно для выполнения любых типов презентаций.Основные случаи использования нескольких вкладок:
- В одной из вкладок может быть загружен скрипт динамической настройки презентации для управления проведением презентации в режиме реального времени.
- Часть презентаций требует одновременного открытия нескольких вкладок. Обычно не больше двух, но доступно до 4.
- При использовании скриптов, вызывающих открытие нового окна при клике по элементу страницы или на самой странице не передается реферер страницы, с которой произведен клик. Использование нескольких вкладок позволяет устранить эту проблему.
- Включение дополнительных вкладок
Зайдите в управление сайтами, выберите нужный сайт и зайдите в его настройки. В подразделе "Режим презентации" введите нужное количество дополнительных вкладок в параметре "Дополнительных вкладок браузера". Если вам помимо основного окна нужна еще одна дополнительная вкладка, нужно ввести 1. Если достаточно только основного окна, введите 0. - Функции работы с вкладками
В один момент времени может быть только одна активная вкладка. Все команды презентации выполняются только с активной на данный момент вкладкой. - Настройка перенаправления всплывающих окон во вкладки
Если вам нужно настроить перенаправление всплывающих окон в отдельную вкладку - просто введите цифру 1 в поле "Дополнительных вкладок браузера" в настройках сайта. В этом случае всплывающие окна будут перенаправляться в следующую за текущей вкладку, при этом текущая вкладка будет автоматически меняться на ту, в которой открыто всплывающее окно. Если всплывающих окон несколько, то текущая вкладка будет меняться каждый раз при открытии нового окна.
Если нужно четко установить вкладку, в которой открывать всплывающие окна, воспользуйтесь командой popuptab
 Главная страница |