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

Elido отслеживает две вещи для короткой ссылки: клик (когда кто-то переходит по ссылке) и конверсию (когда тот же человек совершает ценное действие на вашем сайте после этого). Отслеживание конверсий связывает эти два события, позволяя вам видеть не только то, какие ссылки приносят трафик, но и какие из них приносят результаты.

Что считается конверсией#

Конверсия — это любое определенное вами событие: покупка, регистрация, отправка формы, начало пробного периода. Elido не навязывает конкретное определение. Вы отправляете событие конверсии, когда действие происходит; мы приписываем его клику, который привел пользователя.

Панель мониторинга конверсий в разделе Analytics → Conversions показывает:

• Общее количество конверсий и общий приписанный доход.
• Конверсии в разбивке по ссылкам, кампаниям, дням и платформам.
• Таблицу последних отдельных событий конверсии с email клиента и доходом.

Настройка события конверсии#

Вариант 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>

Пиксель использует куки браузера, установленные во время перенаправления, чтобы идентифицировать клик, предшествовавший конверсии. Это работает для сценариев в одном браузере и на одном устройстве. Для атрибуции между устройствами или браузерами метод click_id на стороне сервера является более надежным.

Окна атрибуции#

По умолчанию конверсия приписывается самому последнему клику того же пользователя в течение 30-дневного окна. Если тот же пользователь нажал на несколько ссылок за этот период, конверсия приписывается последнему клику (атрибуция по последнему взаимодействию — last-touch attribution).

Окно настраивается для каждого рабочего пространства в разделе Settings → Attribution. Доступные варианты включают 1 день, 7 дней, 30 дней и 90 дней.

Чтение панели мониторинга конверсий#

Раздел Analytics → Conversions разбивает конверсии по:

• Platform — поле platform, которое вы передаете в вызове API (stripe, shopify, web или любая выбранная вами метка).
• Top links — какие короткие ссылки принесли больше всего конверсий.
• Top campaigns — какие кампании показали лучшую конверсию.
• Daily revenue — столбчатая диаграмма приписанного дохода во времени.

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

Устранение неполадок#

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

Атрибуция не совпадает с ожидаемыми кликами. Если вы используете пиксель (на основе куки), убедитесь, что браузер пользователя не блокирует сторонние куки. ITP в Safari и некоторые блокировщики рекламы удаляют куки до того, как сработает страница конверсии. Используйте метод click_id на стороне сервера для надежной атрибуции.

Цифры дохода не совпадают с моим платежным процессором. Цифры в Elido — это именно то, что вы нам отправляете; мы не запрашиваем данные напрямую из Stripe или любого другого процессора. При несовпадении сравните значения revenue_cents в ваших вызовах API конверсий со своими платежными записями.

Одна конверсия отображается под неправильной ссылкой. Атрибуция по умолчанию использует последнее взаимодействие. Если пользователь нажал несколько ссылок перед конверсией, она засчитывается последнему клику. Если последний клик был из другой кампании, это ожидаемое поведение. Измените окно атрибуции или переключитесь на атрибуцию по первому взаимодействию (first-touch attribution) в настройках, если атрибуция по последнему взаимодействию не соответствует вашим потребностям в отчетности.