Настройка TDS

Условная маршрутизация трафика на edge Cloudflare — без того, чтобы вы сами писали или поддерживали код Worker-а. Гео, устройство, обнаружение ботов, UTM-параметры и A/B-эксперименты — всё из формы.

Что вы настраиваете

TDS-правило живёт на Cloudflare Worker, привязанном к акцепторному домену вашего сайта, и проверяется на каждом запросе. Worker генерируется и разворачивается силами 301.st; вы авторите условия и действия в форме, нажимаете Sync — и правило живёт на edge через несколько секунд.

Правила бывают двух семейств — Smart Shield для фильтрации по сигналам запроса (гео, устройство, обнаружение ботов) и SmartLink для маршрутизации по URL-параметрам (utm_source, fbclid, gclid). Оба уживаются на одном сайте и проверяются по приоритету.

Smart Shield или SmartLink

Это не два разных продукта, а два способа выразить одно правило. Разница — в том, что является триггером совпадения.

Smart Shield

Фильтрация и защита

Срабатывает на каждом запросе, читая сигналы, которые Cloudflare прикладывает к запросу — страна, устройство, ОС, браузер, признаки бота.

Когда использовать:

  • Нужно отсеять ботов или отдать им whitewash до того, как они доберутся до оффера.
  • Нужно ограничить кампанию конкретными странами или устройствами.
  • Мобильный и десктоп-трафик должны попадать на разные прокладки.

Пресеты S1–S5: Bot Shield, Geo Filter, Mobile Redirect, Desktop Redirect, Geo + Mobile.

Статистика: таблица Streams показывает per-rule клики (сегодня / всего) для правил Smart Shield, как и для SmartLink.

SmartLink

Маршрутизация по источнику

Срабатывает только если в URL есть трекинговые параметры — utm_source, utm_campaign, fbclid, gclid или любой указанный вами.

Когда использовать:

  • Нужны разные прокладки для Facebook-трафика (fbclid) и Google-трафика (gclid).
  • Нужно разделить трафик по utm_campaign или sub-id.
  • Хочется A/B-тесты вариантов в зависимости от источника.

Пресеты L1–L3: UTM Split, Facebook Traffic, Google Traffic.

Статистика: строки SmartLink показывают клики и тренд в таблице Streams, когда трафик посчитан.

Правила обоих типов уживаются на одном сайте и проверяются по приоритету — Smart Shield обычно идёт первым (отсекает нежелательный трафик независимо от URL), затем SmartLink сортирует остальное по источнику.

Что правило умеет сопоставлять и делать

  • Условия: Smart Shield использует сигналы запроса (страна, класс устройства, обнаружение ботов); SmartLink использует URL-сигналы (UTM source/campaign, path regex, referrer, click ID/sub-ID). Держите семейства раздельно — так правила проще отлаживать.
  • Действия: редирект (301/302), блокировка, pass-through к origin, страница обслуживания или multi-armed bandit (MAB) редирект — варианты Thompson Sampling, UCB и Epsilon-Greedy автоматически перераспределяют трафик в сторону лучшего по перформансу таргета по мере накопления данных.
  • Режим сборки: начните с пресета (Smart Shield S1–S5, SmartLink L1–L3) или соберите вручную с полным контролем. Sandbox-превью даёт прогнать тестовые URL против правила до sync — проверьте совпадение до того, как правило уедет на edge.

TDS или обычный редирект?

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

Используйте TDS, когда назначение зависит от запроса: слаг, страна, устройство, UTM-метка или сплит трафика.

Единый пул или по GEO?

Когда действие — MAB-редирект, вы выбираете, как сгруппированы варианты назначения.

Единый пул

Один общий список URL-назначений для всего подходящего трафика. Подходит для простого глобального сплита, когда страна не важна — например, тест offer-a.com против offer-b.com везде.

По GEO

Отдельные пулы вариантов под каждую группу стран. Нужен, когда разным группам идут разные офферы — например tier1 (US, GB, CA) → Оффер A / B, latam (BR, MX) → Оффер C / D, default → запасной.

У каждого GEO-сегмента есть название (например tier1 или default), необязательные коды стран (например US, GB, CA) и один или несколько вариантов назначения. Оставьте страны пустыми у одного сегмента, чтобы сделать его запасным — запасной допускается только один.

Возврат с режима «по GEO» на единый пул удаляет сегменты стран и их варианты, поэтому приложение сначала запросит подтверждение.

Перед началом

  • Подключённая интеграция Cloudflare с нужным доменом, синхронизированным в 301.st.
  • Сайт, чей акцепторный домен — это хост, который примет трафик (например go.example.com).
  • Реф-ссылка или целевой URL, на который должен попадать совпавший трафик.

Создание первого правила

Пример: отправить https://go.example.com/landing на партнёрский URL, а остальной трафик пропускать.

  1. Откройте сайт, перейдите на вкладку Streams и нажмите New rule.
  2. Выберите пресет (Smart Shield или SmartLink) либо Manual для полного контроля.
  3. Задайте имя правила и приоритет. Правила проверяются от высокого приоритета к низкому, побеждает первое совпадение.
  4. Добавьте условие path с regex для вашего слага (см. следующий раздел) и задайте действие — редирект 301/302 на реф-ссылку.
  5. Сохраните правило. Оно сохранено в 301.st, но ещё не активно на edge.
  6. Откройте правило и нажмите Sync, чтобы опубликовать его на Cloudflare Worker. Синхронизация выполняется из дровера правила — сохранённое правило не работает, пока не синхронизировано.

Как работает сопоставление пути

Поле path — это «сырое» регулярное выражение. Worker выполняет new RegExp(path).test(url.pathname) — незаякоренное подстрочное совпадение только по pathname. Query-строка и хост не участвуют.

  • /landing — совпадает с любым pathname, содержащим /landing: /landing, /landing-page, /go/landing.
  • ^/landing$ — совпадает только с точным pathname /landing.
  • ^/promo/ — совпадает с любым pathname, начинающимся на /promo/.
  • .* — совпадает с любым запросом. Это перехват всего.

Regex — не glob. /landin* не означает «начинается с landin»: * повторяет предыдущий символ, то есть это /landi с нулём или более n в конце. Для «начинается с» используйте ^/landing, для точного совпадения — ^/landing-page$.

Поскольку проверка идёт по приоритету и побеждает первое совпадение, правило-перехват (.*) должно иметь самый низкий приоритет, иначе оно перехватит трафик раньше более конкретных правил.

Пустое поле path тоже совпадает с любым запросом — относитесь к пустому пути как к перехвату всего.

Сопутствующий инструмент: Geo Tier Builder

Geo Tier Builder — бесплатное браузерное расширение, которое мы поддерживаем для подготовки данных, нужных правилам TDS.

  • Гео-списки: собирайте тирные списки стран (T1/T2/T3, регионы, ЕС/ЕЭП, БРИКС) и экспортируйте их для условия по стране.
  • Помощник по regex: вкладка Regex генерирует и вживую тестирует паттерн пути TDS из обычных слагов — режимы exact / prefix / contains / ends / перехват всего; вставьте примеры URL и проверьте совпадения до сохранения правила.
Установить Geo Tier Builder

Работает полностью в браузере и не имеет доступа к вашему аккаунту 301.st.

FAQ

Создал правило, но ничего не происходит. Почему?

Сохранённое правило не активно, пока не синхронизировано. Откройте дровер правила и нажмите Sync, чтобы опубликовать его на Cloudflare Worker.

Почему паттерн /landin* не работает как маска?

Поле path — это регулярное выражение, а не glob. Используйте ^/landing для «начинается с» или помощник по regex в Geo Tier Builder для корректного паттерна.

Моё правило-перехват блокирует всё остальное. Как исправить?

Перехват (.*) совпадает с любым запросом. Дайте ему самый низкий приоритет, чтобы сначала проверялись более конкретные правила — порядок по приоритету, побеждает первое совпадение.

Где выполняются правила TDS?

На Cloudflare Worker на edge, привязанном к акцепторному домену сайта, на каждом запросе к этому хосту.

Smart Shield или SmartLink — что выбрать?

Если в URL посетителя есть трекинговые параметры (utm_source, fbclid, gclid) и роутить нужно именно по ним — берите SmartLink. Для всего остального — отсеять ботов, ограничить по странам или устройствам, заблокировать нежелательный трафик — Smart Shield. Правила обоих типов могут существовать на одном сайте и проверяются по приоритету.

Связанные руководства

Smart Shield против SmartLink Начало работы Интеграция с Cloudflare Управление доменами Проекты и сайты Редиректы