Параметры

Rola IP управляет выходом прокси через параметры, встроенные в имя пользователя (имя аккаунта) — страна, штат (регион), город, сессия и всё остальное записывается прямо в имя пользователя. Вот один полный пример имени пользователя, включающий все детальные параметры:

test_1-country-us-state-ny-city-newyork-sessiontime-10

Разберём его по частям — каждый сегмент отвечает за отдельный параметр управления:

Сегмент имени пользователя	Параметр	Значение
test	имя аккаунта	Имя вашего прокси-аккаунта (базовая, обязательная часть)
_1	sessionid	Идентификатор сессии, записывается после нижнего подчёркивания; разделяет независимые сессии и IP
-country-us	country	Целевая страна выхода, здесь — США
-state-ny	state	Целевой штат/регион — значение является кодом штата (ny); только для Динамического резидентного IP
-city-newyork	city	Целевой город — значение является названием города (newyork); только для Динамического резидентного IP
-sessiontime-10	sessiontime	Продолжительность сессии, здесь — 10 минут

Любой ненужный сегмент параметра можно опустить. Ключевые моменты:

• sessionid не записывается как параметр -sessionid-xxx — это значение после нижнего подчёркивания в имени аккаунта. sessionid для test_1 равен 1, максимум 32 символа; каждое отдельное значение sessionid — это независимая сессия, сопоставленная с отдельным IP.
• state и city поддерживаются только Динамическим резидентным IP; Динамический IP дата-центра и Мобильный IP поддерживают только таргетинг на уровне страны через country.
• sessiontime измеряется в минутах и поддерживает диапазон 1-120 минут.
• Чтобы менять IP при каждом запросе, используйте -f-1 вместо параметров сессии (это противоположность фиксированной сессии, лучше всего подходит для задач без сохранения состояния), например test-country-us-f-1.

Справочник параметров

Параметр	Обязателен	Описание	Пример
country	Нет	Целевая страна или регион. Обычно код страны.	country-us
state	Нет	Целевой штат/регион. Значение — код штата (например, ny). Поддерживается только Динамическим резидентным IP. Используется вместе с country.	state-ny
city	Нет	Целевой город. Значение — название города (например, newyork). Поддерживается только Динамическим резидентным IP. Используется вместе с country и state.	city-newyork
sessionid	Нет	Значение после нижнего подчёркивания в имени аккаунта. Разделяет независимые сессии и независимые IP. Максимум 32 символа.	1 в test_1
sessiontime	Нет	Продолжительность сессии в минутах. Поддерживает диапазон 1-120 минут.	sessiontime-10
f-1	Нет	Менять IP при каждом запросе. Лучше всего для задач, не требующих сохранения состояния входа.	test-country-us-f-1

Формат имени пользователя

Каждая сеть использует свой маркер имени аккаунта, который ставится перед sessionid:

Сеть	Маркер аккаунта	Базовый вид	С сессией
Динамический резидентный IP	нет	test	test_1
Динамический IP дата-центра	_dc	test_dc	test_dc_1
Мобильный IP	_mobile	test_mobile	test_mobile_1

Общий формат (показан для Динамического резидентного IP — для Datacenter / Mobile IP просто подставьте имя аккаунта с соответствующим маркером):

test_sessionid-country-countryCode-sessiontime-minutes

Ненужные параметры можно опустить. Все три сети используют одну и ту же структуру (меняется только маркер имени аккаунта):

test_1-country-us                    # Динамический резидентный IP
test_dc_1-country-us-sessiontime-10  # Динамический IP дата-центра
test_mobile-country-us-f-1           # Мобильный IP

Динамический резидентный IP также может дополнительно указывать state и city в этом формате:

test_sessionid-country-countryCode-state-stateCode-city-cityName-sessiontime-minutes

test_1-country-us-state-ny
test_1-country-us-state-ny-city-newyork
test_1-country-us-state-ny-city-newyork-sessiontime-15

Правила sessionid

sessionid — это значение после нижнего подчёркивания в имени аккаунта. Это не параметр вида -sessionid-xxx:

test_1
test_2
test_login001

Примечания:

• sessionid для test_1 равен 1.
• sessionid для test_2 равен 2.
• sessionid для test_login001 равен login001.
• sessionid поддерживает максимум 32 символа.
• Каждое отдельное значение sessionid — это независимая сессия, сопоставленная с отдельным IP.

На странице настройки «суффикс имени аккаунта» после нижнего подчёркивания и есть sessionid:

Если рабочему процессу нужно сохранить тот же IP на протяжении сессии, используйте одно и то же имя аккаунта и sessiontime:

test_1-country-us-sessiontime-10

Чтобы запустить несколько независимых IP, используйте разный sessionid для каждой задачи:

test_2-country-us-sessiontime-10

Ротация IP при каждом запросе

Если задаче не нужно сохранять сессию и требуется, чтобы каждый запрос использовал новый выход, добавьте -f-1 к параметрам аккаунта:

test-country-us-f-1

Если также нужно указать sessionid, можно записать так:

test_1-country-us-f-1

-f-1 означает ротацию IP при каждом запросе. Это подходит для сбора данных, массового доступа, проверок доступности и других задач без сохранения состояния. Это противоположность поведению фиксированной сессии: для входа, регистрации, оформления заказа, отправки форм и других непрерывных рабочих процессов используйте вместо этого фиксированные sessionid и sessiontime и избегайте -f-1.

Параметры локации

Динамический резидентный IP, Динамический IP дата-центра и Мобильный IP поддерживают country для таргетинга на уровне страны. Только Динамический резидентный IP дополнительно поддерживает state и city; Динамический IP дата-центра и Мобильный IP могут таргетироваться только до уровня страны.

Для Динамического резидентного IP точность локации возрастает от широкой к узкой:

country -> state -> city

Рекомендуемый порядок:

1. Начните с country и убедитесь, что прокси подключается нормально.
2. Если вы используете Динамический резидентный IP и рабочему процессу требуется большая точность, добавьте state.
3. Добавляйте city только тогда, когда таргетинг на уровне города действительно необходим на Динамическом резидентном IP.

WARNING

state и city применяются только к Динамическому резидентному IP. Динамический IP дата-центра и Мобильный IP на данный момент поддерживают только country.

Время сессии

sessiontime задаёт, сколько времени нужно сохранять сессию. Единица измерения — минуты, поддерживаемый диапазон — 1-120 минут.

test_1-country-us-sessiontime-10

Это означает:

• sessionid равен 1;
• используется выход из США;
• сессия сохраняется 10 минут в пределах поддерживаемого диапазона 1-120 минут;
• в течение времени сессии test_1 будет пытаться сохранить тот же IP.

Рекомендуемые конфигурации

Сеть	Сценарий	Рекомендуемые параметры имени пользователя
Все	Таргетинг на уровне страны	test-country-us
Динамический резидентный IP	Таргетинг на уровне штата	test-country-us-state-ny
Динамический резидентный IP	Таргетинг на уровне города	test-country-us-state-ny-city-newyork
Все	Вход или регистрация	test_1-country-us-sessiontime-10
Все	Оформление заказа или отправка формы	test_1-country-us-sessiontime-15
Все	Несколько независимых задач	test_1-country-us-sessiontime-10, test_2-country-us-sessiontime-10
Все	Ротация IP при каждом запросе	test-country-us-f-1

Имена пользователей выше показаны для Динамического резидентного IP. Для Динамического IP дата-центра и Мобильного IP подставьте имя аккаунта с соответствующим маркером, например test_dc-country-us, test_mobile_1-country-us-sessiontime-10.

TIP

Если не уверены, с чего начать, — начните с country. Используйте фиксированные sessionid и sessiontime, если рабочему процессу нужно сохранить тот же IP; используйте разные значения sessionid, если нужно несколько независимых выходов; добавляйте -f-1, если каждый запрос должен переключаться на новый IP.