Приложение, бот, свой сайт: подключение к рекламе

События регистрации и оплаты · около 30 мин · делает разработчик

Сохраните метку клика вместе с пользователем.

Реклама добавляет к адресу yclid (Яндекс) или gclid (Google). Запомните его при первом заходе и сохраните в профиле, когда человек регистрируется. Если путь идёт через Telegram-бота — передайте метку в ссылке: t.me/your_bot?start=y_1234567890123456789.

Когда происходит событие — отправьте нам один запрос.

curl

curl -X POST 'https://in.arbilens.ru/e/<ваш-ключ>' \
  -H 'Content-Type: application/json' \
  -d '{"event":"payment","id":"user-42","yclid":"1234567890123456789","value":499,"currency":"RUB"}'

JavaScript

// при регистрации — сохраните метки из адреса страницы вместе с пользователем
const q = new URLSearchParams(location.search);
const clickIds = { yclid: q.get("yclid"), gclid: q.get("gclid") };

// на сервере, когда произошло событие
await fetch("https://in.arbilens.ru/e/<ваш-ключ>", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ event: "payment", id: user.id, ...user.clickIds, value: 499, currency: "RUB" }),
});

Какие поля передавать.

event	да	lead — заявка или регистрация, trial — пробный период, payment — оплата. Можно свои названия: мы сопоставим их с целями.
id	да	Номер пользователя или заказа. Повтор с тем же id и событием не создаст дубль.
yclid / gclid	одно из	Метка клика из адреса страницы.
client_id	одно из	ClientID Метрики — cookie _ym_uid, если есть сайт со счётчиком.
value, currency	нет	Сумма оплаты. Реклама будет учиться на выручке.
time	нет	Когда произошло (ISO или unix). Нет — момент запроса.

Можно присылать пачкой: {"events": [ … ]}, до 500 за раз. Ответ сразу скажет, что принято, а что нет.

Что мы делаем с доступом

Только читаем сделки и этапы. Ничего не меняем и не удаляем в вашей CRM.
Не храним имена, телефоны и почты клиентов — только номер сделки, этап, сумму и метки рекламы.
Ключи хранятся в зашифрованном виде. Отключить доступ можно в любой момент — удалите ключ или вебхук в CRM.