Учёт конверсий и продаж

Конверсия — это продажа или платёж от поддержавшего, который LinkHarbor может отнести к клику на вашей странице. Так вы видите не только, как часто нажимали на ссылку, но и что из этого вышло. Эта статья для авторов со своим магазином и для разработчиков, которые подключают магазин. Анализировать конверсии и создавать секреты колбэков можно начиная с Creator Pro.

#Откуда берутся конверсии

• Продажи, о которых ваш магазин или сервер сообщает через колбэк продажи
• Платежи от поддержавших через Stripe; возврат платежа снова удаляет конверсию, см. Платежи от поддержавших через Stripe

Каждая конверсия наследует данные клика, к которому относится: страницу, ссылку, страну, устройство, реферер и UTM-параметры. Поэтому в статистике она появляется именно там, откуда пришёл клик.

#Как работает атрибуция

1. Посетитель нажимает на ссылку на вашей странице
2. LinkHarbor засчитывает клик и при перенаправлении добавляет к целевому URL параметр lt_click_id с уникальным ID клика
3. Ваша целевая страница (например, магазин) считывает lt_click_id из адреса и хранит его до покупки
4. После покупки ваш сервер отправляет в LinkHarbor колбэк продажи с этим ID клика
5. Конверсия появляется на панели управления и в статистике страницы

ID клика добавляется только к целям, начинающимся с http:// или https://. Ссылки на mailto: или tel: его не получают, потому что параметр испортил бы там тему письма или номер телефона. Клики ботов ID клика тоже не получают.

#Создать секрет колбэка

Колбэк продажи должен подтверждать себя секретом колбэка. Владельцы и админы управляют секретами начиная с Creator Pro в разделе «Callback и API» в блоке аккаунта в меню.

1. Откройте «Callback и API»
2. В карточке «Секреты колбэков» нажмите «+ Создать секрет»
3. При желании введите название, например «Колбэк магазина»
4. Нажмите «Создать секрет»
5. Сразу скопируйте секрет: он показывается только один раз

«Изменить»

Измените название и статус («Активен» или «Неактивен»). Неактивный секрет отклоняется.

«↺ Перевыпустить»

Создаёт новый секрет. Старый сразу перестаёт работать — поэтому сразу же внесите новый в свой магазин.

«Удалить»

Удаляет секрет после подтверждения.

«Последний колбэк:»

Показывает, когда секрет использовался в последний раз, иначе — «Ещё не использовался».

В одном рабочем пространстве можно создать до 5 секретов колбэков.

#Отправить колбэк продажи

Ваш сервер отправляет POST-запрос в API LinkHarbor. Секрет передаётся в заголовке X-Callback-Secret.

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
    "order_id": "B-10042",
    "amount": "49.90",
    "currency": "EUR"
  }'

click_id

Обязательно. ID клика из lt_click_id (от 10 до 36 символов).

order_id

Обязательно. Номер вашего заказа (от 1 до 128 символов). На один номер заказа засчитывается только одна конверсия, поэтому повторный колбэк не создаёт вторую.

amount

Обязательно. Сумма в виде десятичного числа.

currency

Обязательно. Код валюты из 3 букв, например EUR.

occurred_at, meta

Необязательно. Время покупки и до 50 собственных ключей (от 1 до 64 символов каждый) с дополнительной информацией. Значение — текст не длиннее 500 символов, число, true/false или null; вложенные объекты API отклоняет.

Ответы

Все поля и коды ошибок для разработчиков описаны в статье Передача продаж и собственных данных.

#Анализ конверсий

• Панель управления: плитки «Конверсии» и «CVR» и карточка «Конверсии» по UTM-источнику и каналу
• Статистика страницы: карточка «Конверсии» с «CVR (всего)», «CVR (уникальный)» и «Разбивка»
• CVR (всего) = конверсии, делённые на клики; CVR (уникальный) = конверсии, делённые на уникальные клики