Отслеживание конверсий

Каждый записанный клик получает короткий уникальный ID клика. Передайте его на свой сайт, сообщите его обратно, когда кто-то совершит конверсию, и Letlink свяжет лид, продажу или регистрацию с конкретной ссылкой, кампанией, страной и устройством.

1. Передайте ID клика на свой сайт

Включите для ссылки Добавлять ID клика. Тогда посетители будут приходить на целевую страницу с ?lk_click=…. Параметр можно переименовать в настройках конверсий — многие партнёрские сети ожидают subid или clickid.

Или разместите токены в целевом URL самостоятельно. {click_id} заменяется на ID клика (и ничего не добавляется), также работают: {slug}, {country}, {device}, {utm_source}, {utm_medium}, {utm_campaign}, {utm_term}, {utm_content}.

https://shop.example.com/offer?subid={click_id}&src={utm_source}&geo={country}

2a. Сообщайте о конверсиях из браузера

Добавьте сниппет на каждую страницу вашего сайта. Он сохраняет ID клика в собственном cookie и локальном хранилище, а затем сообщает о конверсиях, когда вы вызываете letlink().

<script>window.letlink=window.letlink||function(){(letlink.q=letlink.q||[]).push(arguments)};</script>
<script async src="https://letl.ink/t.js" data-param="lk_click"></script>

<!-- on the thank-you page -->
<script>
  letlink('sale', { value: 49.90, currency: 'USD', order_id: 'ORDER-123' });
</script>

События: lead, sale, signup и custom (с event_name). Необязательные поля: value, currency (код ISO), order_id, email (используется интеграциями SendGrid и Mailchimp) и metadata (небольшой объект с дополнительными полями).

2b. Сообщайте о конверсиях с сервера на сервер

Магазины, CRM и партнёрские сети могут вызывать URL постбэка методом GET или POST:

https://letl.ink/postback?click_id={click_id}&event=sale&amount=49.90&currency=USD&txid=ORDER-123

• ID клика: click_id, clickid, cid, subid, sub_id, aff_sub.
• Сумма: amount, payout, value, revenue. Отрицательная сумма означает возврат.
• Транзакция: txid, transaction_id, order_id.
• Статус: approved (по умолчанию), pending, declined или refunded. Сначала сообщите о продаже как ожидающей, а позже одобрите её с тем же ID транзакции.
• Ключ постбэка: задайте его в настройках конверсий и добавляйте key=… к каждому постбэку; постбэки без него отклоняются.

Или вызовите POST /api/v1/conversions с вашим API-токеном (Growth и Ultimate).

Ответы

Постбэк и API всегда отвечают 200 с заголовком X-Letlink-Result: created, updated (новый статус для известной транзакции), duplicate, unknown_click, bad_key, outside_window, not_allowed (тариф) или invalid. Повторные попытки никогда не помогают, поэтому сетям не нужно их делать.

Дедупликация и атрибуция

• Конверсия засчитывается один раз для каждой комбинации ID клика, события и ID транзакции — по тому каналу, который сообщит о ней первым.
• Атрибуция по последнему клику: сниппет всегда хранит самый свежий ID клика.
• Конверсия засчитывается только в пределах окна атрибуции после клика — по умолчанию 30 дней, настраивается от 1 до 365 дней.

Передавайте конверсии в рекламные платформы

На Growth и Ultimate включите Передавать одобренные конверсии, чтобы отправлять их как события покупки, лида и регистрации в Conversions API Meta, TikTok, LinkedIn, Pinterest, Snapchat и Reddit и в ваши интеграции аналитики с привязкой к исходному клику по рекламе. Google Tag Manager, Adobe Analytics, SendGrid и Mailchimp получают их всегда.