Потоки

Управление трафиком в Adspect организовано в контексте потоков. Поток — это канал прохождения трафика, которым можно управлять как единым целым, подобно кампании в рекламной сети или схеме в TDS. Потоки управляются в разделе «Потоки» вашего личного кабинета и создаются по кнопке «+ Создать поток». Далее мы рассмотрим назначение каждой настройки в потоке.

При создании потока вам нужно выбрать цель использования. Очень важно выбрать ту, которая максимально точно соответствует вашей задаче — от этого напрямую зависит результат. Настройки по умолчанию уже оптимизированы под выбранную цель. Заполнять все поля необязательно — обычно достаточно указать контент и белую страницу, а остальное Adspect сделает сам.

Общие настройки

Название

Название потока — это просто любое читабельное имя, которое позволит вам быстро отличить один поток от другого. Мы рекомедуем называть потоки по именам рекламных сетей и кампаний в них для сохранения ясности связей между источниками трафика и соответствующими потоками в Adspect.

Теги

В этом поле вы можете указать до 32 мнемонических тегов, которые тем или иным образом описывают суть потока, например: «gambling», «betting», «nutra», «тест» и т.п. Вы можете делать поиск по этим тегам при помощи поля «Поиск» в верхнем правом углу списка потоков.

Режим

Режим потока — это главный рычаг управления, который включает или выключает фильтрацию трафика.

Режимы потока
Режим	Описание
Фильтр	Основной режим работы, в котором происходит фильтрация переходов в реальном времени. Все технологии Adspect, в том числе машинное обучение VLA™, работают только в этом режиме.
Модерация	Специальный режим, который должен быть включен, когда ваша рекламная кампания находятся на модерации — он гарантирует, что Adspect никак не повлияет на процесс одобрения кампании. Каждому посетителю будет показана белая страница. Не переходите по ссылке потока, когда включен этот режим, иначе вы автоматически попадете в блок.
Контент	Вспомогательный режим, в котором всем посетителям показывается контент. Он удобен для тестирования настроек контента.
Белая страница	Вспомогательный режим, в котором всем посетителям показывается белая страница. Он удобен для тестирования настроек белой страницы. Включайте этот режим, когда рекламная кампания остановлена.

«Модерация» является режимом по умолчанию для вновь созданных потоков. Вам следует всегда использовать этот режим при прохождении модерации в рекламных сетях. После того, как кампания одобрена, переключите поток в режим «Фильтр» прежде, чем сеть начнет поставлять трафик.

Заметки

Это чисто информационное поле, в котором вы можете записать любые заметки.

Макросы

Adspect поддерживает множество макросов (шаблонов подстановки), которые можно использовать в разных полях настроек потока, чтобы автоматически подставлять значения разных атрибутов каждого клика. Ниже — таблица доступных макросов с примерами:

Макросы Adspect
Макрос	Описание	Примеры
`{aid}`	ID аккаунта, который получил клик.	`d1577686-0f44-4b17-82e6-e61b71e4f086`
`{sid}`	ID потока, который получил клик.	`d550554f-bf5c-43c9-af38-ffa1e4445ece`
`{ip}`	IP-адрес посетителя.	`192.0.2.1` `2001:db8::1`
`{asn}`	Номер автономной системы (ASN) Интернет-провайдера посетителя.	`65536`
`{scheme}`	Протокол из ссылки клика: `https` или `http`. Может отличаться от протокола в адресной строке браузера, если вы используете CDN.	Если ссылка клика `https://example.com/`: `{scheme}` → `https`
`{host}`	Доменное имя из ссылки клика.	Если ссылка клика `https://example.com/`: `{host}` → `example.com`
`{path}`	Путь к файлу из ссылки клика (после домена).	Если ссылка клика `https://example.com/posts/42`: `{path}` → `/posts/42`
`{path:N}`	N-я часть пути из ссылки клика, разделенного слэшами.	Если ссылка клика `https://example.com/posts/42`: `{path:1}` → `posts` `{path:2}` → `42` `{path:-1}` → `42` `{path:-2}` → `posts`
`{query}`	Все URL-параметры из ссылки клика (query string после `?`).	Если ссылка клика `https://example.com/?utm_campaign=Dating&utm_medium=banner`: `{query}` → `utm_campaign=Dating&utm_medium=banner`
`{p:параметр}`	Значение URL-параметра клика с именем `параметр`.	Если ссылка клика `https://example.com/?utm_campaign=Dating&utm_medium=banner`: `{p:utm_campaign}` → `Dating` `{p:utm_medium}` → `banner`
`{h:заголовок}`	Значение HTTP-заголовка клика с именем `заголовок` (регистр символов в имени не учитывается).	`{h:accept-language}` → `en;q=0.7`
`{c:cookie}`	Значение cookie клика с именем `cookie` (регистр символов в имени не учитывается).	Если имеем заголовок `Cookie: username=guest; language=en-US`: `{c:username}` → `guest` `{c:language}` → `en-US`
`{useragent}`	Строка user agent браузера посетителя.	`Mozilla/5.0 (iPhone; CPU iPhone OS 18_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.6 Mobile/15E148 Safari/604.1`
`{referrer}`	URL реферера клика.	`https://www.google.com/search?q=cat`
`{country}`	Двухбуквенный код страны посетителя.	`AE`
`{os}`	Операционная система посетителя (с версией, если Windows или Android).	`iOS`
`{browser}`	Название браузера посетителя.	`Apple Safari`
`{engine}`	Название движка браузера посетителя.	`WebKit`
`{language}`	Основной язык браузера посетителя.	`en-US`
`{languages}`	Все языки браузера, разделенные пробелами.	`en-US en`
`{clickid}`	Click ID (внешний или сгенерированный).	Если Click ID — `{p:gclid}` и в URL есть `gclid=EAIaIQobChMI…BwE`: `{clickid}` → `EAIaIQobChMI…BwE`
`{cost}`	Цена клика.	Если Click Cost — `{p:cost}` и в URL есть `cost=0.015`: `{cost}` → `0.015`
`{subid}`	Sub ID клика.	Если Sub ID — `{p:utm_campaign}` и в URL есть `utm_campaign=Dating`: `{subid}` → `Dating`
`{tags}`	Разделенные пробелами теги клика (сработавшие фильтры).	`BOT GEO REF`
`{unixtime}`	Unix-время клика.	`946674000`

Контент и белая страница

Контент и белая страница задают распределение трафика: какая страница будет показана реальным посетителям, а какая — ботам.

Оба поля поддерживают макросы, например:

https://example.com/offer?clickid={clickid}&geo={country}&os={os}

При использовании макросов в ссылках контента и белой страницы их значения URL-кодируются перед подстановкой в ссылку, т.к. предполагается, что вы будете использовать их для подстановки значений в URL-параметры. Если вам нужно отключить URL-кодирование для конкретного макроса, то добавьте символ подчеркивания _ после его открывающей фигурной скобки, например: {_subid}. Во всех остальных полях в настройках потока, которые поддерживают макросы, URL-кодирование не выполняется.

Контент

Контент — это ваш настоящий сайт, лендинг или CPA-оффер, который вы собираетесь рекламировать и который приносит вам доход. Вы можете указать до 32 контент-страниц для сплит-тестирования. Трафик будет распределяться между ними в соответствии с правилами выбранного ротатора.

В зависимости от выбранного действия, это поле может содержать разные значения: ссылки, пути к файлам и директориям, код на языках PHP или JavaScript, и др. Если не брать в расчет специфические действия, то основными видами значений являются ссылки и пути:

URL — это ссылка в привычном виде, в каком вы обычно указываете ее в адресной строке браузера. Это может быть ваш оффер из CPA-сети, смартлинк, ссылка на кампанию в стороннем трекере, поток TDS и т.п. Ссылка должна начинаться с http:// или https://, иначе система распознает ее как путь к файлу (см. ниже).

Действия-редиректы также поддерживают различные не-HTTP URL-ы, при помощи которых вы можете выполнять специализированные задачи на устройствах ваших посетителей. Несколько распространенных примеров:
- mailto:user@example.com откроет почтовую программу для составления e-mail на указанный адрес;
- tel:+08001234567 наберет указанный номер на мобильных устройствах и некоторых десктопах с ПО для телефонии;
- market://details?id=app откроет страницу мобильного приложения в Google Play.
Эта функциональность особенно полезна для работы с т.н. deep-ссылками, которые ведут на контент внутри мобильных приложений.
Путь к локальному файлу или директории, например page.php или /landers/page.html. Слово «локальный» в данном контексте означает, что файл или директория по указанному пути должны располагаться на том же сервере, на который загружен фильтрующий PHP-файл Adspect (эти файлы рассматриваются более детально в главе «Интеграция»), то есть на том же домене, который будет использоваться для конечной ссылки.

Действие

Это действие, которое будет совершено с посетителем. Adspect поддерживает множество разных типов действий. Как правило, вы будете пользоваться лишь парой или тройкой основных действий.

ПП (проброс параметров)

«ПП» — это сокращение от «проброс URL-параметров». Если проброс параметров включен, то все параметры из входящей ссылки будут добавлены к ссылке или имени файла контент-страницы.

Допустим, ваша страница указана в виде ссылки:

https://example.com/?utm_campaign=sweeps

Посетитель переходит на файл index.php потока по ссылке:

https://tracker.test/lander/index.php?utm_medium=ppc&utm_source=search

Если посетитель будет посчитан благонадежным, то он будет перенаправлен на контент-страницу с объединением параметров из обеих ссылок выше:

https://example.com/?utm_campaign=sweeps&utm_medium=ppc&utm_content=search

Вес

Каждая контент-страница имеет свой «вес», который по умолчанию равен 10. Этот параметр используется только при сплит-тестировании нескольких контент-страниц. Конкретный смысл веса зависит от выбранного ротатора. Если у вас только одна контент-страница, то этот параметр игнорируется.

«ВКЛ»

Настройка «ВКЛ» позволяет вам включать и выключать отдельные контент-страницы. Это удобно для исключения плохих офферов или лендингов из сплит-тестирования без их полного удаления из списка.

Ротатор контента

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

Ротатор «сплит»

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

Например, если у вас есть три контент-страницы с весами 10, 15 и 25, то первая страница получит 20 % от всего целевого трафика, вторая страница получит 30 %, а третья — 50 %.

Так как этот ротатор имеет в основе генератор псевдослучайных чисел (PRNG), при небольшом числе входящих кликов могут быть «перекосы» в распределении трафика относительно заданных весов. Однако, математические свойства PRNG гарантируют, что на дистанции распределение трафика максимально точно достигнет заданных весов.

Ротатор «таймер»

Этот ротатор переключается между контент-страницами, используя вес как число секунд, на которое активируется та или иная страница.

Например, если у вас указаны три страницы с весами 60, 120 и 180, то первая страница будет показываться посетителям в течение одной минуты, затем ротатор будет 2 минуты показывать вторую страницу, затем переключится на третью и будет отображать ее 3 минуты, а затем снова вернется к первой, и так далее.

Этот ротатор удобен для автоматической смены доменов по времени, особенно в тех случаях, когда домены быстро попадают в черные списки антивирусных компаний.

Белая страница

Белая страница (она же «вайт», «safe page», «white page») — это безопасная страница, предназначенная для модераторов, ботов, конкурентов и прочих нецелевых посетителей, которые не должны быть допущены на контент. Она не должна содержать никакой чувствительный контент, который может поставить вашу рекламную кампанию под угрозу, например из-за нарушения правил рекламной сети. Все, описанное выше для страницы контента, также относится и к белой странице: вы можете использовать URL или имя файла для отображения. В случае с файлом, если ваша контент-страница также настроена как файл, вам фактически потребуется совместить два лендинга в одной папке, с разными именами HTML- или PHP-файлов.

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

Действия

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

Важно

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

Локальный файл

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

Совет

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

Файл можно указать несколькими способами:

Синтаксис	Примеры	Описание
Относительный путь	`page.php` `folder/page.html`	Путь относительно папки, в которую загружен PHP-файл интеграции Adspect. Например, если указан путь `landers/page.html` и загрузить PHP-файл Adspect по ссылке `https://example.com/ads/index.php`, Adspect отобразит страницу `https://example.com/ads/landers/page.html`.
Абсолютный путь	`/var/www/html/index.html`	Полный путь к файлу, указанный от корня файловой системы сервера.
URL	`https://example.com/` `//example.com/page.php`	Путь из URL будет использован относительно корня текущего домена. Схема и домен в URL игнорируются. Например, если указан URL `https://dummy.test/landers/page.html` и загрузить PHP-файл Adspect по ссылке `https://example.com/ads/index.php`, Adspect отобразит страницу `https://example.com/landers/page.html`.

Важно

Обычно указывается путь к файлу HTML-страницы или PHP-скрипта. В этом случае настоятельно рекомендуется размещать PHP-файл Adspect в той же папке, иначе сломаются все относительные ссылки на странице, т.к. браузер посетителя не будет знать, что файлы страницы (изображения, стили, скрипты) лежат в другой папке — нет редиректа, через который он мог бы о ней узнать.

Конкретное действие, которое произойдет, зависит от суффикса имени файла (расширения):

Суффикс	Примеры	Действие
`/` (папка)	`folder/` `folder`	Adspect отобразит файл `index.php`, `index.html` или `index.htm` внутри папки, в указанном порядке.
`.php` `.phtml` `.php5` `.php4` `.php3`	`page.php`	Файл будет выполнен как PHP-скрипт при помощи PHP-директивы `require`.
`.html` `.htm`	`page.html`	Файл будет отображен как статическая HTML-страница.
Любой другой	`app.apk`	Файл будет скачан браузером.

При отображении страниц как локальных файлов вы также можете добавить параметры ссылки с макросами после имени файла, и они будут переданы в PHP-код, где будут доступны через суперглобальную переменную $_GET. Например:

page.php?cid={clickid}

Значение этого макроса может быть использовано в коде страницы page.php следующим образом:

<a href="https://example.com/offer?clickid=<?= $_GET['cid'] ?>">
  Это ссылка на оффер
</a>

Важно

При JavaScript-интеграции это действие загружает целевую страницу при помощи синхронного XMLHttpRequest и заменяет ею содержимое белой страницы без перенаправления. Действие сработает только в том случае, если контент и белая страница расположены на одном домене, либо если контент-страница отдается веб-сервером с правильно настроенным заголовком Access-Control-Allow-Origin, разрешающим cross-origin resource sharing (CORS).

Проксирование

Проксирование — это отображение стороннего сайта на вашем домене при помощи умного HTTP-проксирования. Фактически проксирование создает «на лету» динамическую копию сайта с сохранением навигации внутри него. Большинство сайтов проксируются без ошибок, однако в некоторых частных случаях результат может быть поломан или искажен.

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

Важно

При JavaScript-интеграции это действие загружает целевую страницу при помощи синхронного XMLHttpRequest и заменяет ею содержимое белой страницы без перенаправления. Действие сработает только в том случае, если контент и белая страница расположены на одном домене, либо если контент-страница отдается веб-сервером с правильно настроенным заголовком Access-Control-Allow-Origin, разрешающим cross-origin resource sharing (CORS).

Подгрузка HTML-кода

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

Важно

При JavaScript-интеграции это действие загружает целевую страницу при помощи синхронного XMLHttpRequest и заменяет ею содержимое белой страницы без перенаправления. Действие сработает только в том случае, если контент и белая страница расположены на одном домене, либо если контент-страница отдается веб-сервером с правильно настроенным заголовком Access-Control-Allow-Origin, разрешающим cross-origin resource sharing (CORS).

Отображение в iframe

Отображение веб-страницы при помощи HTML-тега <iframe> без изменения ссылки в адресной строке браузера.

Внимание

Сайты могут запретить отображение своего контента в iframe при помощи заголовка ответа X-Frame-Options, из-за чего это действие может не работать.

Предупреждение

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

HTTP 301 Moved Permanently

HTTP 301 Moved Permanently — постоянное перенаправление. Эти перенаправления могут быть закэшированы браузерами, то есть при повторном переходе по защищенной Adspect ссылке браузер может сразу перенаправить посетителя туда же, куда его перенаправили при первом переходе, то есть в обход фильтров.

Внимание

Кэширование перенаправления остается на усмотрение браузера. На него не стоит полагаться, если на кону стоит безопасность.

Важно

При JavaScript-интеграции это действие выполняет JavaScript-редирект replace().

HTTP 302 Found

HTTP 302 Found — это обычное перенаправление (редирект), каким его обычно знают, также известное как временное перенаправление. Эти перенаправления не кэшируются браузерами, поэтому повторный переход по «заклоаченной» ссылке приведет к повторному срабатыванию фильтров.

Совет

Если вы не знаете, какой тип перенаправления выбрать, то выбирайте HTTP 302 Found.

Важно

При JavaScript-интеграции это действие выполняет JavaScript-редирект replace().

HTTP 303 See Other

HTTP 303 See Other — вид перенаправления, который работает по принципу HTTP 302 Found.

Важно

При JavaScript-интеграции это действие выполняет JavaScript-редирект replace().

HTTP 307 Temporary Redirect

HTTP 307 Temporary Redirect — вид перенаправления, который работает по принципу HTTP 302 Found.

Важно

При JavaScript-интеграции это действие выполняет JavaScript-редирект replace().

HTTP 308 Permanent Redirect

HTTP 308 Permanent Redirect — вид перенаправления, который работает по принципу HTTP 301 Moved Permanently.

Важно

При JavaScript-интеграции это действие выполняет JavaScript-редирект replace().

Без действия

Ничего не произойдет; посетитель останется там, куда перешел. Это действие предназначено для использования совместно с обратной PHP-интеграцией. Оно также может быть использовано для пассивного трекинга переходов без фильтрации трафика: интегрируйте поток в ваш сайт и укажите «Без действия» для контента и белой страницы.

Заголовок HTTP Refresh

Специальный вид HTTP-перенаправления, который совместим с кодом ответа HTTP 200 OK. При использовании в комбинации с обратной PHP-интеграцией это действие также возвращает содержимое страницы, в которую был интегрирован код Adspect.

Важно

При JavaScript-интеграции это действие выполняет JavaScript-редирект replace().

HTML meta refresh

Перенаправление средствами HTML-тега <meta>, которое в остальном идентично предыдущему действию с заголовком Refresh и имеет то же целевое применение.

Примечание

Некоторые виды «тупых» ботов не пройдут этот редирект.

Важно

При JavaScript-интеграции это действие выполняет JavaScript-редирект replace().

Отправка формы

Редирект через отправку HTML-формы при помощи JavaScript.

Примечание

«Тупые» боты без поддержки JavaScript не пройдут этот редирект.

JavaScript-редирект assign()

JavaScript-редирект при помощи метода location.assign().

Примечание

«Тупые» боты без поддержки JavaScript не пройдут этот редирект.

JavaScript-редирект replace()

JavaScript-редирект при помощи метода location.replace(). В отличие от JavaScript-редиректа assign(), данный вид редиректа не сохраняет текущую страницу в истории браузера, поэтому посетитель не сможет вернуться обратно на страницу, с которой было осуществлено перенаправление.

Примечание

«Тупые» боты без поддержки JavaScript не пройдут этот редирект.

Выход из фрейма

JavaScript-редирект, который открывает ссылку в родительском окне браузера, даже если заклоаченная ссылка была открыта во фрейме или в iframe, тем самым осуществляя выход из фрейма. Если фрейма нет, то этот редирект аналогичен JavaScript-редиректу assign().

Важно

Этот трюк не сработает в iframe с атрибутом sandbox.

Примечание

«Тупые» боты без поддержки JavaScript не пройдут этот редирект.

Произвольный код ответа HTTP

Возвращает произвольный код ответа HTTP, указанный в поле страницы, например 404 для отображения типичной страницы «404 Not Found». Это действие может быть использовано для симуляции ошибки сервера при помощи кодов 50x, либо для явного отказа в доступе при помощи кода 403.

Важно

Это действие ничего не делает при JavaScript-интеграции.

Выполнить PHP-код

Выполняет PHP-код, указанный в поле страницы, например:

echo '<h1>Hello, world!</h1>';

Важно

Это действие ничего не делает при JavaScript-интеграции.

Выполнить JavaScript-код

Выполняет JavaScript-код, указанный в поле страницы, например:

document.write("<h1>Hello, world!</h1>");

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

Примечание

«Тупые» боты без поддержки JavaScript не будут выполнять код.

Заголовок X-Accel-Redirect

Это действие позволяет Adspect взаимодействовать с веб-приложениями, не использующими PHP. Оно возвращает ответ 200 OK с заголовком X-Accel-Redirect — это механизм внутрисерверного перенаправления, поддерживаемый веб-серверами NGINX и Cherokee.

Настройку лучше всего показать на примере. Предположим, у вас есть блок location в конфигурации NGINX, который отвечает за веб-приложение на Node.js (или проксирует сторонний сайт, отдает статические файлы, что угодно), и вы хотите его использовать в качестве контента в Adspect:

location /app {
  internal;
  proxy_pass http://127.0.0.1:8080/;
}

Вам нужно добавить еще один блок location, который будет принимать запросы к домену и отправлять их в файл интеграции потока index.php:

location ~ \.php$ {
  root /var/www/html;
  include fastcgi.conf;
  fastcgi_pass unix:/run/php/php-fpm.sock;
}

Останется лишь настроить поток, чтобы он использовал ваше веб-приложение в качестве контента:

Поле контента: /app
Действие контента: Заголовок X-Accel-Redirect

При такой настройке все целевые переходы будут бесшовно перенаправлены в ваше веб-приложение внутри NGINX без какого-либо видимого редиректа для посетителя.

Важно

При JavaScript-интеграции это действие выполняет JavaScript-редирект replace().

Заголовок X-Sendfile

Возвращает 200 OK с заголовком X-Sendfile — это механизм внутрисерверного перенаправления, поддерживаемый веб-серверами Apache, Cherokee и Lighttpd.

Важно

При JavaScript-интеграции это действие выполняет JavaScript-редирект replace().

Отложенный запуск

Отложенный запуск позволяет вам заблокировать определенное число первых переходов по потоку. Например, если вы заметили, что первые 10–15 переходов по рекламе в вашем источнике трафика принадлежат модераторам и антивирусным ботам, то вы можете настроить отложенный запуск на 20 переходов (чуть больше, чтобы наверняка), то есть отправить их на белую страницу.

Внимание

Отложенный запуск работает только когда поток находится в режиме «Фильтр».

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

Режим	Описание
Все	Учитываются все переходы.
Контент	Учитываются только целевые переходы, которые по всем остальным фильтрам прошли бы на контент (за исключением фильтра по JavaScript-отпечаткам).
Белая	Учитываются только нецелевые переходы, заблокированные любым из фильтров.

Совет

Отложенный запуск удобен, если вы запускаете множество рекламных кампаний и не можете или не хотите следить за каждой из них, чтобы вовремя переключить режим потока с «Модерация» на «Фильтр».

Настройки фильтрации

Эта группа настроек отвечает за основные параметры фильтрации трафика при помощи встроенных фильтров Adspect.

Уровень фильтрации

Уровень фильтрации позволяет вам настроить «агрессивность» фильтрации трафика путем выбора одного из нескольких уровней.

Доступные уровни фильтрации
Уровень	Описание
Минимальный	Все встроенные и внешние фильтрационные базы данных отключены. Машинное обучение VLA™ не используется. Не выбирайте этот уровень без крайней необходимости.
Низкий	Заблокированы только самые основные угрозы: IT-корпорации, крупнейшие хостинги и датацентры, антивирусные компании и т.п. Машинное обучение VLA™ не используется. Данный уровень подходит для клоакинга приложений и WebView.
Средний	Заблокированы все IT-корпорации, датацентры, хостинги и провайдеры IP-транзита. Машинное обучение VLA™ включено. Все переходы также проверяются по двенадцати конкурирующим сервисам клоакинга.
Высокий	Как «Средний», плюс включает проверку принадлежности IP-сетей заблокированным организациям за последние 3 года. Также переходы проверяются по внешним базам данных и поставщикам риск-скоринга. Данный уровень безопасен для большинства ситуаций.
Паранойя	Как «Высокий», плюс заблокированы все правительственные, военные, научные и образовательные учреждения, а также некоторые высокорисковые Интернет-провайдеры. Данный уровень наиболее безопасен, но может привести к повышенной потере трафика.

Совет

Если вы не знаете, какой уровень фильтрации выбрать, то используйте «Средний».

Включить фильтрацию по JavaScript-отпечаткам и обучение модели VLA™

Данная настройка контролирует JavaScript-фингерпринтинг — одну из самых надежных и передовых технологий фильтрации трафика Adspect. Если настройка включена, то посетители, прошедшие все «наивные» проверки (по IP-адресу, user agent, referrer, таргетингам, URL-правилам и т.п.), подвергнутся JavaScript-проверке: они получат небольшой скрипт, который соберет массив данных о внутреннем устройстве браузера и отправит нам. Этот массив называется JavaScript-отпечатком браузера.

Получив отпечаток, Adspect проанализирует его более чем сотней эвристик в поисках признаков ботов, программного обеспечения для браузерной автоматизации, подмены данных об ОС и браузере и других нежелательных сигнатур. Далее этот же отпечаток пройдет вероятностный анализ нашей моделью машинного обучения VLA™.

Примечание

Данная функциональность не реализована в нативной интеграции с Keitaro из-за технических ограничений системы пользовательских фильтров Keitaro.

Включить фильтрацию по встроенным спискам user agent

Эта настройка позволяет вам включать и выключать встроенные фильтры по строке user agent браузеров посетителей. Аналогично черным спискам IP-адресов, фильтры user agent постоянно поддерживаются нами в актуальном состоянии.

Внимание

Мы настоятельно рекомендуем оставлять эту настройку включенной во всех случаях, кроме клоакинга приложений.

Пропускать только уникальных посетителей

Эта настройка блокирует неуникальных посетителей. Если она включена, то только первый переход с конкретным IP-адресом или click ID будет допущен до контента. Все последующие переходы с тем же признаком будут заблокированы.

Пропускать только устройства с сенсорным экраном

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

Примечание

Эта проверка работает только при включенной фильтрации по JavaScript-отпечаткам.

Пропускать только посетителей с браузерными Web3-кошельками

Эта настройка пропускает только тех посетителей, у кого в браузере установлен Web3-кошелек.

Примечание

Эта проверка работает только при включенной фильтрации по JavaScript-отпечаткам.

Пропускать трафик из мобильных приложений

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

Пропускать трафик из фреймов, iframe, элементов embed и object

Эта настройка пропускает трафик из встраиваемых элементов, таких как <iframe>, <embed> и <object>. Как и в случае с мобильными приложениями, эта настройка зависит от конкретного формата и источника трафика. Если вы не уверены что выбрать, то оставьте ее включенной.

Примечание

Эта проверка работает только при включенной фильтрации по JavaScript-отпечаткам.

Пропускать трафик Google IP Protection (Chrome Privacy Sandbox)

Эта настройка пропускает посетителей, использующих технологию Google IP Protection (также известную как Chrome Privacy Sandbox) для сокрытия своих настоящих IP-адресов за специальными прокси-серверами Google. Включите ее, если вы наблюдаете повышенный объем заблокированного трафика, приходящего с IP-адресов Google.

Пропускать трафик Apple iCloud Private Relay

Эта настройка пропускает посетителей, использующих услугу iCloud Private Relay от Apple для сокрытия своих настоящих IP-адресов за специальными прокси-серверами Apple. Включите ее, если вы наблюдаете повышенный объем заблокированного трафика, приходящего с устройств Apple iOS.

Страны и устройства

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

Настройки статистики

Данные настройки отвечают за назначание Sub ID, Click ID и цены отдельным кликам. Adspect берет значение каждого поля, заменяет в нем макросы и записывает результат в соответствующий атрибут каждого клика.

Заполнять эти поля не обязательно, но может быть полезно, если вы хотите отслеживать клики, конверсии, расход, доход и статистику с разбивкой по площадкам в разделе «Статистика» вашего личного кабинета Adspect.

Sub ID

Sub ID — это атрибут клика, по которому можно делать разбивку в статистике, выбрав «Sub ID» в поле разбивки. Принцип работы проще всего показать на примере. Возьмем рекламную сеть, у которой есть понятие номеров площадок, на которых показываются рекламные объявления. Номер площадки, с которой пришел клик, помещается в рекламную ссылку для передачи в Adspect при помощи макроса, например {zoneid}:

https://example.com/?subid={zoneid}

Для каждого клика рекламная сеть заменит этот макрос {zoneid} фактическим номером площадки, с которой пришел клик, а далее Adspect извлечет его из кликовой ссылки для сбора статистики. В данном примере subid является параметром ссылки, в котором содержится номер площадки. Если вы укажете {p:subid} в поле «Sub ID» в настройках потока, то сможете получать статистику по каждой отдельной площадке в потоке и составлять черные или белые списки площадок в зависимости от числа ботов на них.

Click ID

Поле Click ID работает по тому же принципу, что и Sub ID, но используется для назначения идентификаторов отдельным кликам, которые затем используются для отстука конверсий в трекер или рекламную сеть при помощи пикселя или через механизм S2S postback.

Часто клики приходят в Adspect с уже добавленными рекламной платформой уникальными click ID, например, в параметре ссылки gclid в Google Ads или fbclid в Facebook. Поле Click ID в потоке позволяет вам извлечь этот идентификатор из URL-параметра и назначить его каждому отдельному клику в статистике. Для этого укажите в этом поле макрос {p:gclid} (в примере для Google Ads) или {p:fbclid} (в примере для Facebook).

Далее click ID может быть передан на контент или белую страницу при помощи макроса {clickid}.

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

Цена клика

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

https://example.com/?cost=0.15

Если вы укажете в поле цены клика макрос {p:cost}, то Adspect запишет этот переход в статистику с ценой 0.15, которую возьмет из параметра ссылки cost.

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

Фильтрация по IP-адресам

Данный блок настроек позволяет вам фильтровать трафик по спискам IP-адресов, диапазонов IP-адресов, CIDR-префиксов и номеров автономных систем (ASN). У каждого потока есть два списка: белый и черный. Разделяйте отдельные элементы списка переносами строки или пробелами.

Примеры форматов записи:

Формат	Описание
`192.0.2.1`	Одиночный IPv4-адрес.
`192.0.2.0/24`	IPv4 CIDR-префикс.
`192.0.2.0–192.0.2.255`	Диапазон IPv4-адресов.
`2001:db8::1`	Одиночный IPv6-адрес.
`2001:db8::/112`	IPv6 CIDR-префикс.
`2001:db8::-2001:db8::ffff`	Диапазон IPv6-адресов.
`65536`	Номер автономной системы.
`AS65536`	Номер автономной системы.
`1.10`	Номер автономной системы в формате dot+.
`AS1.10`	Номер автономной системы в формате dot+.

Режим списков IP/ASN

Режим списков IP/ASN управляет тем, как черный и белый списки взаимодействуют друг с другом.

Режим	Посетитель в черном списке	Посетитель в белом списке	Посетитель не в списках	Примечания
Черный	Блокируется, если не в белом списке	Проверяется остальными фильтрами	Проверяется остальными фильтрами	Белый список имеет приоритет над черным.
Белый	Блокируется	Проверяется остальными фильтрами, если не в черном списке	Блокируется	Черный список имеет приоритет над белым.
Специальный	Блокируется, если не в белом списке	Переходит на контент	Проверяется остальными фильтрами	Белый список отключает все проверки и отправляет сразу на контент.

Заносить все IP-адреса в черный список в режиме «Модерация»

Если эта настройка включена, то Adspect будет автоматически заносить IP-адреса всех посетителей в потоке в черный список, если поток работает в режиме «Модерация». Так как этот режим предназначен именно для прохождения модерации, то будет справедливо считать всех посетителей модераторами, а следовательно запоминать и блокировать в дальнейшем. Мы рекомендуем вам всегда включать эту опцию, но будьте внимательны и не пропустите момент, когда вашу кампанию одобрят, — вам нужно успеть переключить поток в режим «Фильтр» прежде, чем польется трафик, иначе в черный список попадут IP-адреса обычных посетителей.

Мы рекомендуем включить эту настройку.

IP-экстраполяция

IP-экстраполяция позволяет вам настроить точность проверки внутренних черных списков IP-адресов. Чем выше значения, тем большее число адресов, соседних с уже заблокированными диапазонами, будет заблокировано. Это повышает уровень защиты, но вместе с тем и шансы получить ложноположительные блокировки.

Фильтрация по user agent

Черный и белый списки user agent позволяют вам фильтровать посетителей по их user agent. В списках указываются Perl-совместимые регулярные выражения (PCRE) по одному на строку. Они проверяются по очереди до первого совпадения. Сравнение происходит с учетом регистра символов.

Режим списков user agent

Режим списков user agent управляет тем, как черный и белый списки взаимодействуют друг с другом.

Режим	Посетитель в черном списке	Посетитель в белом списке	Посетитель не в списках	Примечания
Черный	Блокируется, если не в белом списке	Проверяется остальными фильтрами	Проверяется остальными фильтрами	Белый список имеет приоритет над черным.
Белый	Блокируется	Проверяется остальными фильтрами, если не в черном списке	Блокируется	Черный список имеет приоритет над белым.
Специальный	Блокируется, если не в белом списке	Переходит на контент	Проверяется остальными фильтрами	Белый список отключает все проверки и отправляет сразу на контент.

Фильтрация по referrer

Черный и белый списки referrer позволяют вам фильтровать посетителей по их referrer. В списках указываются Perl-совместимые регулярные выражения (PCRE) по одному на строку. Они проверяются по очереди до первого совпадения. Сравнение происходит с учетом регистра символов.

Типичные способы применения:

Фильтрация посетителей с пустым referrer. Занесите в черный список:
```
^$
```
Фильтрация посетителей, перешедших не по рекламной ссылке. Поставьте режим списков «белый» и занесите разрешенные домены в белый список. Пример для Google Ads:
```
google\.com
```

Режим списков referrer

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

Режим	Посетитель в черном списке	Посетитель в белом списке	Посетитель не в списках	Примечания
Черный	Блокируется, если не в белом списке	Проверяется остальными фильтрами	Проверяется остальными фильтрами	Белый список имеет приоритет над черным.
Белый	Блокируется	Проверяется остальными фильтрами, если не в черном списке	Блокируется	Черный список имеет приоритет над белым.

URL-правила

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

Правила применяются по порядку — сверху вниз, как они указаны в настройках потока. Каждое следующее правило работает с той ссылкой, которая получилась в результате применения предыдущих. Например, если одно из правил удаляет параметр из ссылки, то следующие уже не смогут его проверить или изменить. Если же правило добавляет новый параметр, то следующие смогут с ним работать.

Правила работают с той ссылкой, по которой пришёл клик, а не с конечной ссылкой на контент или белую страницу. Поэтому любые манипуляции с параметрами (добавление, изменение, удаление) не повлияют на конечную ссылку, если только вы не включите для нее проброс параметров.

Примечание

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

Каждое правило состоит из следующих полей:

Поля URL-правил
Поле правила	Описание
URL-параметр	Имя URL-параметра, с которым будет работать правило. Например, если в ссылке есть параметр `utm_medium=banner`, то имя параметра — `utm_medium`.
Оператор	Конкретная проверка или операция, которая будет произведена с URL-параметром. См. таблицу операторов ниже.
Аргумент	Аргумент оператора, если он предусмотрен конкретным оператором (см. таблицу операторов ниже). В этом поле поддерживаются макросы.
Переключатель «Вкл»	Включает/выключает правило.

Операторы URL-правил
Оператор	Описание
существует	Проверяет, что параметр существует. Аргумент игнорируется.
не существует	Проверяет, что параметр не существует. Аргумент игнорируется.
совпадает с regexp	Проверяет параметр на совпадение с Perl-совместимым регулярным выражением (PCRE) в аргументе (с учетом регистра символов).
совпадает с regexp (без регистра)	Проверяет параметр на совпадение с регулярным выражением в аргументе (без учета регистра символов).
не совпадает с regexp	Проверяет параметр на несовпадение с регулярным выражением в аргументе (с учетом регистра символов).
не совпадает с regexp (без регистра)	Проверяет параметр на несовпадение с регулярным выражением в аргументе (без учета регистра символов).
равен не равен больше больше или равен меньше меньше или равен	Сравнивают параметр с аргументом; целочисленные и вещественные значения сравниваются как числа, строки сравниваются в соответствии с лексикографическим порядком.
присвоить значение	Назначает параметру значение из аргумента. Существующие параметры с тем же именем будут удалены.
добавить значение	Добавляет новый параметр со значением из аргумента. Существующие параметры с тем же именем останутся.
переименовать в	Задает параметру новое имя из аргумента. Существующие параметры с тем же именем останутся.
заменить	Задает параметру новое имя из аргумента. Существующие параметры с тем же именем будут удалены.
удалить	Удаляет параметр из ссылки. Аргумент игнорируется.

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

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

Расписание

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

Часовые пояса

Данное поле ограничивает круг потенциальных посетителей контента указанными часовыми поясами.

Настройка часовых поясов ограничена полночасовыми смещениями относительно UTC. Если часовой пояс посетителя смещен относительно UTC на неполное число часов (например, Индия UTC+5.5), то смещение округляется до ближайшего полного часа (в примере с Индией до UTC+5).

Проверять соответствие часового пояса браузера и местоположения

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

Мы рекомендуем включить эту настройку.

Примечание

Эта проверка работает только при включенной фильтрации по JavaScript-отпечаткам.