Трекинг-ссылки и макросы
Как устроены трекинг-ссылки MeerPartners: формат /r/{code}, параметры sub_id, cookie атрибуции, редирект с aff_click, макросы и пиксель-фоллбэк. Как связать клик с заказом для postback.
Трекинг-ссылка — точка входа в воронку. Партнёр получает ссылку на ваш оффер, ведёт по ней трафик, а платформа на каждом клике пишет событие, ставит cookie атрибуции и редиректит пользователя на ваш лендинг — добавляя в URL click_id. Этот click_id вы потом вернёте в postback, чтобы конверсия атрибутировалась нужному партнёру.
Формат ссылки
https://<трекинг-домен>/r/{code}{code}— короткий идентификатор трекинг-ссылки партнёра.- Трекинг-домен — отдельный от API и портала (например,
go.meerpartners.com). Точный адрес выдаётся вместе со ссылкой; не конструируйте его сами.
/r/{code}🔒 —Эндпоинт публичный и вне версии /api/v1. Он отвечает редиректом 302 за единицы миллисекунд и почти никогда не отдаёт ошибку живому пользователю (чтобы не ломать рекламу).
Параметры запроса
К ссылке можно добавлять метки — они сохраняются в клике для сквозной аналитики и прокидываются дальше.
| Параметр | Назначение |
|---|---|
sub_id1 … sub_id5 | До пяти произвольных меток партнёра (источник, кампания, креатив). Принимаются и в коротком виде sub1…sub5. Каждая обрезается до 128 символов. |
utm_* и прочие deep-link параметры | Пробрасываются в целевой URL согласно настройкам оффера. |
https://go.meerpartners.com/r/a8Kf2?sub1=youtube&sub2=video-42&utm_campaign=junesub_id в postback
Если вы хотите сохранить sub_id в конверсии, передайте его в postback полем sub_id. На редиректе метки пишутся в клик, но в конверсию они попадают через postback.
Что происходит на клике
Резолв ссылки
Платформа находит трекинг-ссылку по {code} (с кэшем). Неизвестный код → TRACKING_LINK_NOT_FOUND (404).
Фильтр и дедуп
Бот-фильтр и анти-флуд: повтор клика тем же пользователем в окне 5 минут считается одним физическим кликом. Боты помечаются и не получают cookie, но всё равно редиректятся.
Запись клика и генерация click_id
Событие клика уходит в обработку, заранее формируется click_id (UUID) — он нужен и для cookie, и для редиректа.
Cookie + редирект 302
Ставится подписанная cookie aff_attr, и пользователь редиректится на лендинг оффера с добавленным параметром aff_click=<click_id>.
Cookie атрибуции aff_attr
- Содержит
{ click_uid, offer_id, affiliate_id, ts }, подписана HMAC (целостность защищена подписью). Max-Age= окно атрибуции оффера (по умолчанию ~30 дней; задаётся в оффере какattribution_window_hours).SameSite=Lax,Secure. Доступна из JS (HttpOnly=false) — её читает embed-SDK.- Модель — last-click: каждый новый клик перезаписывает cookie.
Редирект и aff_click
HTTP/1.1 302 Found
Location: https://your-product.io/promo?utm_campaign=june&aff_click=9b1f7c2e-…
Set-Cookie: aff_attr=…; Max-Age=2592000; Path=/; SameSite=Lax; Secureaff_click — это и есть click_id. Он дублирует атрибуцию на стороне сервера: cookie может потеряться (Telegram, WebView, блокировка сторонних cookie), а параметр в URL переживёт переход. Это самый надёжный способ связать клик с заказом.
Как связать клик с заказом
Это ключевой шаг для корректной атрибуции:
Поймайте aff_click на лендинге
Когда пользователь приходит на ваш лендинг, прочитайте query-параметр aff_click и сохраните его в сессии/корзине.
Сохраните рядом с заказом
При оформлении заказа запишите aff_click в запись заказа в вашей БД.
Верните его в postback как ref
Когда заказ оплачен, отправьте postback с ref = aff_click — платформа найдёт точный клик и атрибутирует конверсию партнёру.
const clickId = new URLSearchParams(location.search).get("aff_click");
if (clickId) {
// положить в long-lived storage и привязать к будущему заказу
localStorage.setItem("aff_click", clickId);
}Если aff_click не доехал
Когда ref пуст или клик не нашёлся, платформа отвечает accepted:false с POSTBACK_UNKNOWN_REF — конверсия считается органической. Чтобы такого было меньше, всегда прокидывайте aff_click со своего лендинга и сохраняйте его до момента оплаты.
Макросы в целевом URL
В настройках лендинга оффера можно использовать макросы — платформа подставит реальные значения при редиректе:
| Макрос | Подставляется |
|---|---|
{click_id} | Идентификатор клика (он же aff_click) |
{affiliate_id} | ID партнёра, по чьей ссылке пришёл клик |
{offer_id} | ID оффера |
Это удобно, если вашему лендингу нужен идентификатор клика не только в aff_click, но и в собственном параметре.
Пиксель-фоллбэк
Там, где редирект невозможен (письмо, контекст с <img>), используется пиксель — он пишет тот же клик и отдаёт прозрачный 1×1 GIF.
/p/{code}.gif🔒 —<img src="https://go.meerpartners.com/p/a8Kf2.gif" width="1" height="1" alt="" />Пиксель записывает клик так же, как /r/{code}, но без редиректа. Cookie при этом может не ставиться (зависит от контекста), поэтому для надёжной атрибуции основной механизм — редирект с aff_click.