Настройка TDS

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

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

TDS-правило живёт на Cloudflare Worker, привязанном к основному домену вашего сайта, и проверяется на каждом запросе. Worker генерируется и разворачивается 301.st в ваш же аккаунт Cloudflare.

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

Smart Shield или SmartLink

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

Smart Shield

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

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

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

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

Пресеты S1–S9: Bot Shield, Geo Filter, Mobile Redirect, Desktop Redirect, Geo + Mobile, Cloaking Standard, AI Guard, Datacenter Cloak, Geo Origin Routing. Категории ботов и бот-пресеты: Фильтрация ботов.

Статистика: таблица 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–S9, 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 тоже совпадает с любым запросом — относитесь к пустому пути как к перехвату всего.

Макросы в целевом URL

В целевой URL можно вставлять макросы — Worker подставит в них признаки самого посетителя перед редиректом. Работают в поле Целевой URL у правила-редиректа и в URL каждого варианта у SmartLink, включая гео-пулы. В дровере правила под каждым полем URL стоит ряд чипов — вставка по клику.

{country}
Двухбуквенный код страны — US, DE, BR — или XX, если Cloudflare не определил.
{device}
Либо mobile, либо desktop. Значения tablet не существует, iPad считается десктопом.
{os}
windows, macos, linux, android, ios или unknown.
{browser}
chrome, firefox, safari, edge, opera или unknown.
{path}
Путь, который посетитель запросил на вашем основном домене.
{host}
Основной домен, принявший запрос.
{clickid}
Наш сырой идентификатор клика, 32 шестнадцатеричных символа. Это не ключ атрибуции: постбэк, который его вернёт, с кликом не сопоставится. Ставьте его только в отдельное поле, которое просит сеть. В параметр, который читает ваш источник постбэков, Worker сам пишет подписанный токен и заменяет макрос.
{q.name}
Параметр входящего запроса по имени из латиницы, цифр и подчёркиваний (имя с дефисом или точкой не подойдёт): {q.clickid} — значение ?clickid= из ссылки, по которой пришёл посетитель. Кодируется для URL, не длиннее 256 символов; нет параметра — пусто. Главное применение — click id источника трафика, который уходит в сеть вторым полем: см. Постбэки → Постбэк в источник трафика.

Макрос можно повторять сколько нужно — в пути и ещё раз в трекинговом параметре: подставляются все вхождения. https://offer.com/{country}/?geo={country}&d={device} для немца с телефона превратится в https://offer.com/DE/?geo=DE&d=mobile.

Незнакомый макрос остаётся ровно как написан. Ни ошибки, ни значения по умолчанию — опечатка вроде {coutry} уедет партнёру буквально, внутри URL, который выглядит параметризованным. Дровер предупреждает о нераспознанных токенах — не игнорируйте это предупреждение.

Сопутствующий инструмент: 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 Управление доменами Проекты и сайты Редиректы