Перейти к содержанию

Лендинги

Лендинг — промежуточная страница между рекламой и оффером. В трекере это запись, которая знает, где страница лежит и как её отдать.

Типы

Тип Когда брать
redirect переход на внешний URL. В URL работают макросы
local файлы (HTML/JS/CSS, при желании .php) хостит сам трекер
proxy запросы на /lp/{id} проксируются на ваш сервер как есть — Apache, WordPress, что угодно

Что делает поток с proxy и preload

В потоке лендинг любого типа, кроме local, — это просто внешний URL: посетителя перенаправляет прямо на него. Прокси-режим включается, когда запрос приходит на /lp/{id} трекера, то есть когда вы ссылаетесь на этот адрес сами. Тип preload из выпадающего списка отдельного поведения в коде не имеет и работает как redirect.

Локальные лендинги

Загрузите ZIP — трекер распакует его в базу и на диск.

Лимит одной загрузки Значение
Размер архива 128 МБ
Один файл внутри 16 МБ — файл больше пропускается
Количество файлов 10 000
Суммарный распакованный объём 256 МБ

Превышение двух последних отклоняет всю загрузку (400), в базу не попадает ничего. Точкой входа становится index.html / index.htm, если его нет — index.php, дальше другой корневой index.* или любой .html в корне. Новый ZIP не стирает старое содержимое: файлы с совпадающими путями перезаписываются, остальные остаются на месте.

Редактор

Открывается по клику на имя лендинга: дерево файлов, редактор с подсветкой, предпросмотр в соседней панели.

  • сохранение — Cmd/Ctrl + S;
  • поиск и замена по всем файлам лендинга — Cmd/Ctrl + Shift + F;
  • История — 10 последних версий каждого файла. Версия снимается на каждое изменение содержимого и на удаление файла, так что удалённый файл тоже восстанавливается из истории;
  • загрузка нового ZIP и создание файлов прямо из редактора.

.php исполняется, если настроен PHP-рантайм (установка). Без него файл отдаётся как text/html — браузер отрисует разметку файла, а сам PHP-код просто не выполнится.

Как страница попадает к посетителю

Локальный лендинг рендерится прямо в ответ на клик: в адресной строке остаётся ссылка кампании, /lp/{id} посетитель не видит. Файлы самого лендинга (css, js, картинки) при этом лежат на /lp/{id}/… — туда ведёт <base href>, который трекер вставляет в HTML.

Вместе со страницей ставятся две куки: _mclick с click_id и _mtoken — пер-клик токен, которым LP SDK аутентифицирует конверсии.

Изоляция

Ответ отдаётся с CSP sandbox без allow-same-origin: страница работает как обычно, но изолирована от панели управления, которая живёт на том же домене. Заголовок ставится поверх ответа, переопределить его из PHP или с проксируемого сервера нельзя. Если лендингу нужен полный доступ к своему origin, разместите его на своём сервере и заведите тип redirect.

Переход с лендинга на оффер

Кнопка на лендинге должна вести не на партнёрку напрямую, а на трекер — иначе клик потеряется:

<a href="{offer_url}">Получить</a>

В текстовых файлах локального лендинга (HTML, JS, CSS, JSON) трекер подставляет ровно две вещи:

  • {offer_url} — адрес перехода на заранее выбранный оффер (/p/{click_id});
  • {click_id} — идентификатор клика для форм, пикселей и своей аналитики.

Остальные макросы в файлах лендинга не разворачиваются — они работают в URL (оффера, redirect-потока, внешнего лендинга).

/p/{click_id} уводит на оффер, выбранный ещё на первом клике: ротация заново не разыгрывается. Понимает и форму /p?_c={click_id}. Неизвестный или протухший click_id — это 404, на запасной URL трекер не уводит.

В исполняемый PHP click_id приходит query-параметром ?_c= — его читает хелпер minik.php из SDK.

Внешние лендинги

Если страница живёт на вашем сервере (redirect или proxy), подставить макросы в её HTML трекер не может. Что есть вместо этого:

  • к адресу лендинга трекер сам дописывает ?_c={click_id} — читайте параметр на своей стороне;
  • в самом URL лендинга макросы работают, так что можно передать что угодно ещё: https://lp.example.com/?cid={click_id}&geo={country};
  • в конец URL добавляется фрагмент #_ct=… — токен конверсии для LP SDK. Фрагмент не уходит ни в Referer, ни на домен оффера. Если в URL уже есть свой фрагмент, токен не дописывается: фрагмент автора страницы важнее.

Для proxy трекер проксирует ваш сервер прозрачно — вместе с под-путями и query, — но только на запросах к /lp/{id}. Исходящие запросы проходят через SSRF-фильтр: адрес во внутреннюю сеть или к метаданным облака не откроется.

Домены

Публичные пути — клик, /lp/…, /p/… — отдаёт любой домен, направленный на инстанс. Тип домена (tracking / landing / primary) в списке доменов — пометка для вас, на маршрутизацию она не влияет. Локальный лендинг всегда отдаётся с того домена, по которому пришёл клик.