Для использования этого интерфейса вам необходимо создать запрос по адресу обработчика и передать параметры операции. Помимо обязательных параметров, нужно передать следующие параметры:
Параметр | Обязательный | Описание |
| idst | Нет | Если не задан, выполняется операция добавления сайтов.
Если задан, выполняется операция изменения сайтов. Содержит ID сайтов, разделенные двоеточием, например 123:234:456 |
| sites или sites[] | Да | Если производится добавление сайтов, применяется параметр sites, содержащий адреса добавляемых сайтов, каждый адрес на новой строке.
Если выполняется изменение сайтов, используется многократно в виде sites[], содержащего URL для каждого ID сайта, указанного в параметре idst. Например, если idst имеет вид 123:234, то первый параметр sites[]='http://yandex.ru' укажет URL сайта с ID 123, второй sites[]='http://google.ru' - URL для сайта с ID 234. Подробнее см. в примере ниже. |
| pkm | Нет | Количество показов в день- отрицательное число - не показывать сайт
- 0 (ноль) - отсутствие ограничений показов
- положительное число - ограничение
|
| pkh | Нет | Количество показов в час- отрицательное число - не показывать сайт
- 0 (ноль) - отсутствие ограничений показов
- положительное число - ограничение
|
| pkt | Да | Время показа. Вычисляется как время(сек)=pkt*15. Минимальное значение 2 соответствует 30 секундам (2*15=30). Максимальное значение 20 соответствует 5 минутам. |
| msf | Нет | Ручной серфинг- 0 - показывать сайт во всех видах серфинга (в том числе и в ручном)
- 1 - показывать сайт только в ручном серфинге.
|
| hsf | Нет | Скрытый серфинг- 0 - не показывать сайт в скрытом серфинге
- 1 - разрешить показ сайта в скрытом серфинге
- 2 - показывать сайт только в скрытом серфинге
|
| ipex | Нет | Эксклюзивные IP-адреса.- 0 - функция отключена
- 1-15 - номер посещения с эксклюзивного IP. (1-первое посещение, т.е. ранее в течение 48 часов посещений с этого IP не было).
|
| tml1 | Нет | Минимальный интервал между показами.- 0 (ноль) - отсутствие интервала
- положительное число - интервал
|
| tml2 | Нет | Максимальный интервал между показами.- 0 (ноль) - отсутствие интервала
- положительное число - интервал
|
| tmlrefresh | Нет | Обновить интервал между показами- 0 - не обновлять (будут обновлены границы интервала, сам интервал будет обновлен при следующем показе сайта)
- 1 - обновить интервал с учетом новых границ
|
| tmlс1 | Нет | Плавное изменение нижней границы интервала (tml1) в течение часа. Реально нижняя граница интервала будет равна tml1 + MINUTE/60*tmlc1, где MINUTE - минута часа.- 0 (ноль) - отсутствие изменения
- положительное число - увеличение интервала tml1
- отрицательное число - уменьшение интервала tml1
|
| tmlс2 | Нет | Плавное изменение верхней границы интервала (tml2) в течение часа. Реально верхняя граница интервала будет равна tml2 + MINUTE/60*tmlc2, где MINUTE - минута часа.- 0 (ноль) - отсутствие изменения
- положительное число - увеличение интервала tml2
- отрицательное число - уменьшение интервала tml2
|
| ssf | Нет | Показывать сайт только в SafeSurf- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
| ipc | Нет | Контроль уникальности посетителей- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
| second | Нет | Не показывать сайт посетителям с близкими IP-адресами.- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
| proxy | Нет | Фильтрация посетителей с прокси-серверов.- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
| iphl | Нет | Время уникальности IP-адресов, мин. значение. |
| iph | Нет | Время уникальности IP-адресов, макс. значение. |
| hideref | Нет | Скрытие HTTP_REFERER- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
| uh | Нет | Скрывать URL сайта- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
| name | Нет | Имя сайта (отображается в списке сайтов) |
| newfolder | Нет | Имя новой папки сайта (применяется только при создании новой папки) |
| fid | Нет | ID папки сайта. 0 - общая папка. |
| geo | Да | Геотаргетинг- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
| ggeo | Да при geo=1 | Геотаргетинг по миру. Содержит ID стран, подходящих для геотаргетинга, разделенные двоеточием. Для получения ID стран загрузите файл http://caps.golddengi.com/geostat-an.txt, переименуйте в php-файл и разместите его на вашем сайте. При включении его функцией include вы получите массивы gipc, gipn, gipi, элементы с одинаковыми номерами которых содержат соответственно количество уникальных IP за неделю из определенной страны, название этой страны, ID страны для передачи в интерфейс.
Например, значение 90:125:214 будет соответствовать странам Afghanistan, Aland Islands, Andorra. |
| rgeo | Да при geo=1 | Геотаргетинг по России. Содержит ID городов или иных федеральных образований, подходящих для геотаргетинга, разделенные двоеточием. Для получения ID загрузите файл http://caps.golddengi.com/geostat-an.txt, переименуйте в php-файл и разместите его на вашем сайте. При включении его функцией include вы получите массивы ripc, ript, ripn, ripi, элементы с одинаковыми номерами которых содержат соответственно количество уникальных IP за неделю из определенной области, округа или города, уровень фед. образования (2 - фед. округ, 1 - регион, 0 - город/поселение),название этого фед. образования, ID для передачи в интерфейс.
Например, значение 9:20:312 будет соответствовать Приволжскому округу, Свердловской области, г. Салехард. |
| cref | Нет | Реферер по заказу. Один реферер на одной строке. |
| prs | Нет | Режим презентации- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
| prstime | Нет | Время показа первого сайта презентации |
| prstime1 | Нет | Случайное отклонение от заданного времени |
| prsmin | Нет | Минимум страниц для просмотра презентации |
| prsmax | Нет | Максимум страниц для просмотра презентации |
| prsref | Нет | Режим передачи реферера- 0 - Передавать реферер по заказу на каждую страницу (по умолчанию)
- 1 - Передавать реферер по заказу на первую страницу, на остальные - текущую страницу в браузере как реферер
- 2 - Передавать реферер по заказу на первую страницу, на остальные - предыдущую заданную вами страницу как реферер
|
| prstime2 | Нет | Завершать показ раньше общего времени показа, случайно до 14 сек. |
| prsrnd | Нет | Случайный порядок показа страниц |
| tms[] | Да при prs=1 | Время показа команды презентации, передается для каждой команды презентации. |
| cmds[] | Да при prs=1 | Команда презентации- 0 - Переход
- 1 - Поиск ссылки
- 2 - Ввод текста
- 3 - Отметить флажок
- 4 - Отправить форму
- 5 - Отправить событие
- 6 - Очистить Cookies
- 7 - Вставить скрипт
- 8 - Переход POST
- 9 - Повысить привилегии
|
| urls[] | Да при prs=1 | Параметры команды презентации |
| addcat | Нет | Добавить в каталог сайтов- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
| sitetitle | Да при addcat=1 | Название сайта для каталога сайтов |
| sitedesk | Да при addcat=1 | Описание сайта для каталога сайтов |
| catid | Да при addcat=1 | Тематика сайта для каталога сайтов. Для получения ID тематики сайта скопируйте файл http://list.jetswap.com/catlist.txt на ваш сервер, первая строчка имеет ID - 0, вторая - 1 и т.д. |
| v2 | Да при наличии нарушений | Нарушение пунктов ** Правил системы- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
| v3 | Да при наличии нарушений | Нарушение пунктов *** Правил системы- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
| v4 | Да при наличии нарушений | Нарушение пунктов **** Правил системы- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
| v5 | Да при наличии нарушений | Нарушение пунктов ***** Правил системы- 0 - опция отключена (по умолчанию)
- 1 - опция включена
|
Параметр | Описание |
| 0 | Массив, содержащий описания ошибок. Если имеет хотя бы один элемент, операция не была выполнена успешно. Каждый элемент этого массива содержит следующие индексы:- 0 - номер ошибки. Может быть:
- 1 - внутренняя оошибка.
- 2 - для сайта с ID, переданным в элементе 1 массива (1), не задан адрес сайта.
- 3 - для сайта с номером (1) не задан адрес сайта.
- 4 - адрес сайта с ID (1) и URL (2) должен начинаться с http или https.
- 5 - адрес сайта с номером (1) и URL (2) должен начинаться с http или https.
- 6 - URL (1) находится в черном списке.
- 7 - За один раз можно редактировать не более 100 сайтов
- 8 - За один раз можно добавлять не более 25 сайтов.
- 1 - описание ошибки 1 (содержимое зависит от номера ошибки)
- 2 - описание ошибки 2 (содержимое зависит от номера ошибки)
|
| 1 | Массив, содержащий замечания по переданным настройкам сайта. Не является индикатором успеха или неудачи выполнения операции.- 0 - номер примечания. Может быть:
- 1 - Ваш сайт показывается всего 15 секунд. Этого может быть недостаточно, чтобы счетчики успели загрузиться и засчитать показ. Мы рекомендуем вам установить как минимум 30 секунд показа. Прочитайте также дополнительные рекомендации. (в данный момент не используется)
- 2 - Ваш сайт показывается без учета уникальности посетителей. Это низкоприоритетный показ. Также часть посещений может быть незасчитана счетчиками. Рекомендуем вам включить контроль уникальности посетителей в настройках сайта. Прочитайте также дополнительные рекомендации.
- 3 - Презентация на вашем сайте использует JavaScript-вставки, поэтому ваш сайт автоматически помечен галочкой ***как потенциально опасный. Вставка JavaScript должна использоваться только для управления показом сайта, запрещается создавать дополнительные элементы на сайте! Подробнее. (в данный момент не используется)
- 4 - Вы ввели настройки, запрещающие показ вашего сайта. С отрицательными настройками количества показов в день или в час ваш сайт не будет показываться.
- 5 - Вы ввели ограничение на (1) показов сайта в день. Это небольшое количество показов. Если вам его не будет хватать, увеличьте это ограничение в настройках.
- 6 - Вы отметили использование геотаргетинга, но не отметили галочку «Показывать сайт только уникальным посетителям». Такое сочетание настроек блокирует показ вашего сайта, поэтому галочка «Показывать сайт только уникальным посетителям» автоматически включена
- 7 - Показ сайта только в ручном серфинге не совместим со скрытым показом сайта, поэтому ваш сайт не будет показываться.
- 1 - описание примечания 1 (содержимое зависит от номера примечания)
- 2 - описание примечания 2 (содержимое зависит от номера примечания)
|
| 2 | Замечания о изменениях в настройках сайтов в результате применения автоматических фильтров.- 0 - тип сработавшего фильтра. Может быть:
- 1 - На вашем сайте обнаружено следующее содержимое: (2)(0). Данное содержимое нарушает правила системы, отмеченные (2)(1), поэтому соответствующая опция включена в настройках показа сайта. Это может повлиять на стоимость показа сайта, вы можете уточнить новую стоимость в настройках сайта, которые можно вызвать из списка сайтов. Если соответствующие настройки уже были включены, то изменений стоимости показа не последует.
- Вы рекламируете (2)(0). Данный сайт нарушает правила системы, отмеченные (2)(1), поэтому соответствующая опция включена в настройках показа сайта. Это может повлиять на стоимость показа сайта, вы можете уточнить новую стоимость в настройках сайта, которые можно вызвать из списка сайтов. Если соответствующие настройки уже были включены, то изменений стоимости показа не последует.
- 1 - ID сайта, к которому относится примечание.
- 2 - состоит из двух параметров, разделенных символами !=%=!. Первый параметр означает тип содержимого или URL, на который сработал фильтр, второй параметр - номер нарушения от * до ***** (см. правила системы)
|
