Лендинги¶
Лендинг — промежуточная страница между рекламой и оффером. В трекере это запись, которая знает, где страница лежит и как её отдать.
Типы¶
| Тип | Когда брать |
|---|---|
| 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.
Переход с лендинга на оффер¶
Кнопка на лендинге должна вести не на партнёрку напрямую, а на трекер — иначе клик потеряется:
В текстовых файлах локального лендинга (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) в
списке доменов — пометка для вас, на маршрутизацию она
не влияет. Локальный лендинг всегда отдаётся с того домена, по которому пришёл
клик.