yoy.fyiБлог yoy.fyiEnglishEspañolFrançais

2026-10-26

Яке посилання привело реєстрації й гроші: конверсії в yoy.fyi

Клік ще нічого не каже. Важливо, чи людина зареєструвалась або купила квиток. Якщо ви ставите різні посилання в Telegram, Instagram і розсилку, хочеться знати, яке з них принесло гроші, а не лише кліки.

Як це працює

  1. Створіть посилання з параметром pass_click_id: true. Тоді до адреси, куди воно веде, yoy.fyi дописує yoy_sid: номер саме цього кліку.
  2. На сайті, куди веде посилання, збережіть yoy_sid (у cookie чи прихованому полі форми) і не губіть його до реєстрації чи оплати.
  3. Коли подія сталася, сервер надсилає її в yoy.fyi з цим номером.
POST https://yoy.fyi/v1/conversions
Authorization: Bearer yfi_...

{ "click_id": "01a17...", "event": "purchase", "value": 450, "currency": "UAH", "external_id": "order-77" }

Ключу потрібен дозвіл conversions:write. Його можна вибрати на сторінці «API-ключі».

Повторні запити

external_id це ваш власний номер події, наприклад замовлення. Якщо запит надіслали двічі, друга відповідь поверне ту саму конверсію й нічого не задвоїть. Якщо під тим самим номером прийшли інші дані, yoy.fyi відповість помилкою conversion_conflict.

Де видно результат

На сторінці посилання є блок «Конверсії за 30 днів»: скільки було реєстрацій, скільки оплат і на яку суму. Суми рахуються окремо по кожній валюті, бо гривні й долари додавати не можна.

Через API те саме віддає GET /v1/analytics/conversions. А якщо yoy.fyi підключено до Claude чи ChatGPT, можна спитати: «Скільки оплат принесло посилання spring-concert цього місяця?»

Що варто знати

Конверсію можна записати лише для кліку вашого ж сервісу. Номер чужого кліку yoy.fyi не прийме. Час події не може бути раніше кліку чи в майбутньому. Це перевірка від помилок, а не захист від шахрайства: якщо ваш сервер надсилає неправдиві дані, статистика буде неправдивою.

← Усі статті