Відстеження конверсій

Elido відстежує дві речі з короткого посилання: клік (коли хтось переходить за посиланням) і конверсію (коли та сама особа пізніше здійснює цінну дію на вашому сайті). Відстеження конверсій пов'язує ці дві події, щоб ви могли бачити не лише те, які посилання генерують трафік, а й те, які з них приносять результати.

Що вважається конверсією#

Конверсія — це будь-яка подія, яку ви визначите — покупка, реєстрація, відправка форми, початок пробного періоду. Elido не нав'язує конкретного визначення. Ви надсилаєте подію конверсії, коли відбувається дія; ми пов'язуємо її з кліком, який привів користувача.

Панель конверсій у розділі Analytics → Conversions показує:

• Загальну кількість конверсій та загальний дохід, що приписаний до них.
• Розподіл конверсій за посиланнями, кампаніями, днями та платформами.
• Таблицю нещодавніх окремих подій конверсій з електронною поштою клієнта та доходом.

Налаштування події конверсії#

Варіант 1: серверний виклик API#

Найнадійніший метод. Коли користувач завершує дію на вашому бекенді, надішліть POST-запит на кінцеву точку конверсій:

curl -X POST https://api.elido.app/v1/conversions \
  -H "Authorization: Bearer $ELIDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": 42,
    "platform": "stripe",
    "customer_email": "[email protected]",
    "revenue_cents": 4900,
    "currency": "EUR",
    "converted_at": "2026-05-12T14:30:00Z"
  }'

Додайте customer_email або click_id для атрибуції. Якщо ви передаєте click_id (повертається в заголовках відповіді перенаправлення як X-Elido-Click-ID), атрибуція буде точною. Якщо ви передаєте лише customer_email, ми зіставимо його з останнім кліком з цієї адреси протягом вікна атрибуції.

Варіант 2: клієнтський піксель#

Додайте піксель Elido на сторінку підтвердження (підтвердження замовлення, успішна реєстрація тощо):

<script>
  window.elidoConvert = window.elidoConvert || function(opts) {
    fetch('https://api.elido.app/v1/conversions/pixel', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        workspace_id: opts.workspaceId,
        platform: opts.platform || 'web',
        revenue_cents: opts.revenueCents || 0,
        currency: opts.currency || 'EUR',
      }),
      credentials: 'include',
    });
  };
</script>

Потім викличте його на сторінці підтвердження:

<script>
  elidoConvert({
    workspaceId: 42,
    platform: 'web',
    revenueCents: 4900,
    currency: 'EUR',
  });
</script>

Піксель використовує браузерний cookie, встановлений під час перенаправлення, щоб ідентифікувати клік, який передував конверсії. Це працює для подорожей в одному браузері та на одному пристрої. Для атрибуції між пристроями або браузерами надійнішим є серверний метод з використанням click_id.

Вікна атрибуції#

За замовчуванням конверсія приписується до останнього кліку того самого користувача протягом 30-денного вікна. Якщо той самий користувач натиснув кілька посилань за цей період, конверсія приписується до останнього кліку (атрибуція за останнім дотиком — last-touch attribution).

Вікно можна налаштувати для кожного робочого простору в Settings → Attribution. Доступні варіанти включають 1 день, 7 днів, 30 днів та 90 днів.

Робота з панеллю конверсій#

Analytics → Conversions розподіляє конверсії за:

• Платформою — поле platform, яке ви передаєте у виклику API (stripe, shopify, web або будь-яка обрана вами мітка).
• Найкращими посиланнями — які короткі посилання принесли найбільше конверсій.
• Найкращими кампаніями — які кампанії мали найкращу конверсію.
• Щоденним доходом — гістограма атрибутованого доходу за певний час.

Дохід відображається як сума значень revenue_cents, які ви передали. Якщо ви не відстежуєте дохід (наприклад, для генерації лідів), ви можете залишити revenue_cents рівним 0 і використовувати лише кількість конверсій.

Усунення несправностей#

Конверсії не відображаються. Перевірте відповідь API на ваш виклик POST /v1/conversions — кінцева точка повертає ID конверсії у разі успіху та детальне повідомлення про помилку у разі невдачі. Поширені проблеми: відсутній ID робочого простору, недійсний код валюти (має бути ISO 4217, наприклад, EUR, а не €) або ключ API без дозволу conversions:write.

Атрибуція не збігається з очікуваними кліками. Якщо ви використовуєте піксель (на основі cookie), перевірте, чи не блокує браузер користувача сторонні файли cookie. ITP у Safari та деякі блокувальники реклами видаляють cookie до того, як спрацює сторінка конверсії. Використовуйте серверний метод click_id для надійної атрибуції.

Показники доходу не збігаються з даними платіжної системи. Показники в Elido — це саме те, що ви нам надсилаєте — ми не отримуємо цифри безпосередньо від Stripe або будь-якої іншої системи. Якщо є розбіжність, порівняйте значення revenue_cents у ваших викликах API конверсій зі своїми платіжними записами.

Одна конверсія відображається не під тим посиланням. Атрибуція за замовчуванням використовує останній дотик. Якщо користувач натиснув кілька посилань перед конверсією, вона зараховується останньому кліку. Якщо останній клік був з іншої кампанії, це очікувана поведінка. Налаштуйте вікно атрибуції або переключіться на атрибуцію за першим дотиком у налаштуваннях, якщо останній дотик не відповідає вашим потребам звітності.